#
# Template configuration file.
#
# This file can be maintained either by an external text editor or the online
# iNomads maintenance screen "Maint" in the library "*plus/inomads/templates/maint.en"
#
# The format of this file is:
#  - Comment lines start with '#'
#  - Description of each paramater start with ';' 
#     (These will be used by the maintenance program and must appear before the value)
#
#  - Main title description lines start with ';;' 
#     (Placed in maintenance screen hdr and must be first)

#  - Values start with a alphabetic variable name followed by an equal sign and value

#  - Validation rules should be included before any variable and start with a $
#    Rules have two forms:  
#         $RULE=..... which apply standard iNomads validation processing or comma sep list of values
#         $LIST=..... indicates a drop box with the values from file/directory
#                      (When a directory the file names are converted to 
#                       lowercase if directory starts with *)
#         $TBL=...  Can be provided if a $LIST supplied to define translation values
#         $FMT=.....  which apply standard BB formating
#                     if LONG then the input will be a longer unformated input line
#                     if LONG followed by a number (i.e. LONG2) that number of extra lines will be 
#                     left before drawing the unformatted input line

#    Both may be provided.  These will be used by the maintenance program
#
# Comments that precede the value and start with "##" will be converted into Help text
#

;; These are the template configuration settings which are used to control the display
;; and formatting for the template.  

# -------- Panel Layout information

<General>

! Panel position and style 

; Alignment of the panel on the screen.
## Setting this defines how the panel will be aligned on the screen.

$Rule=left,center,right
PANEL_ALIGN=center

; Width of the border to include around panel (Zero will result in no border).
## This is the width of the border around the panel rendering in pixels.

$Fmt=#0
PANEL_BORDER=1


; Overlay windows as opposed to creating popup windows.
## When enabled new panels will overlay the current panel instead of creating a new browser popup window.
## Overlaying windows improves performance and avoids problems with popup blockers.

$CheckBox
OVERLAY_WDWS=1

; Use PxPlus 2016 popup overlays to display sub-panels
## When enabled, the system will use overlaid floating panels based on iFrames.

$CheckBox
USE_IFRAMES=1

! Resizing options 

; Resize the windows on initial load to accommodate the panel size.
## If enabled the system will attempt to grow/shrink the windows to match the size of the panel
## on the initial load of a panel.

$CheckBox
SetWdwSize=1

; Shrink the window to fit size of panel.
## If resize option is enabled (above) this controls whether to shrink the windows as
## Windows will always be expanded if required.

$Checkbox
Shrink=0

; Force browser to occupy full screen when 'SHOW'(2) issued.  
## Note: Not applicable to all browsers and not a 'true' maximize.

$Checkbox
Maximize_Browser=0

; When running a modal popup window, clicking on the panel windows 'mask' will close the child.

$Checkbox
Modal_Close_child=1

# -------- Panel/Display sizes 

<Sizing>

! Logical Row and Column size in Pixels

; Number of pixels high that each logical line occupies.

## The pixel size should be chosen based on the standard text size chosen for
## the template.

$Fmt=#0
$Rule=1-99

LINE_PX=16

; Number of pixels wide that each logical column occupies.
## This value should accomodate the standard text size chosen for template.
## If using TABLE rendering its value must be evenly divisble by COL_PX.

$Fmt=#0
$Rule=1-99

CHR_PX=9

! Margins to add to outer edge of your panel

; Pixels to be added to window width to compensate for external margins.
## When determining panel sizes this number of pixels will be added to allow for margin width.

$Fmt=##0
FRAME_WIDTH=4

; Pixels to be added to window height to compensate for external margins.
## When determining panel sizes this number of pixels will be added to allow for margin height.

$Fmt=##0
FRAME_HEIGHT=4

# -------- Overrides

<Overrides>

! Colors and Font settings

; Use application defined font information when displaying text.

## Normally the system uses Style Sheets to control the font of text.
## Enabling this option forces iNomads to use Fonts from the panel 
## definition/application code. \n\n
## Note that some standard fixed width fonts
## such as Courier are always used as defined in panel/application.

$CHECKBOX
USE_FONTS=0

; Use application defined background colors when displaying controls/text.

## Normally the system uses Style Sheets to control the background colors.
## Enabling this option forces iNomads to use Background colors from the panel definition.

$CHECKBOX
USE_BACKCOLOR=1

; Use application defined text colors when displaying controls. Simple text always uses application defined color.

## Normally the system uses Style Sheets to control the text colors.
## Enabling this option forces iNomads to use Text colors from the panel definition.

$CHECKBOX
USE_TEXTCOLOR=1

! Style overrides

; Include all static application defined images.  Style sheets will provide images. 
; Dynamic images will be included.

## Normally the system uses Style Sheets to provide images.
## Enabling this option forces iNomads to use images from the panel definition.

$Checkbox
USE_IMAGES=1

; Force all Image-only buttons to be 'Flat' (no visible button -- image only).

$Checkbox
FLAT_IMG_BTN=0

; How to handle list view alternate highlighting.

## Option is to ignore the setting, 'Use' the colors provided by program, or use the 'StyleSheet' colors.

$Rule=Ignore,Use,StyleSheet,
LVUE_HILITE=Use

; Use Enhanced tooltips for all TIPs.

## Info style Tips are rendered.

$Checkbox
USE_FANCY_TIP=1

;Assign a Theme
## Themes override text and background colors, font and misc. other visual properties to provide a consistent visual look and feel.
THEME=

# ---- Check boxes
<ChkBox>
! Check Boxes

; Don't use standard check boxes.  Always use style sheet defined button check boxes.

## Normally the system uses style sheet defined check box for Tri-state boxes or those with a background color.  
## Setting this causes the system to use style sheet boxes for all check boxes.

$Checkbox
CBX_USE_CSS=0

! Style sheet generated Check Box contents (Must select Don't use std. above)
; Off text value for text/html within style sheet check boxes (normally blank/empty).
CBX_CSS_VAL0=&nbsp;
; On text value for text/html within style sheet check boxes (normally check mark).
CBX_CSS_VAL1=&#10004;
; 3rd state text values for text/html within style sheet check boxes (normally 'X').
CBX_CSS_VAL2=&#10006;

# -------- Lists
<Lists>

! List view presentation options
; Use Paged output for list views.
## If enabled, list views and formated list boxes will be presented as paged output.
$CheckBox
LVUE_PAGE_OUTPUT=1

; Text to present in front of Page numbers.
LVUE_PAGE_TEXT=&nbsp;Page:

; Desired minimum number of items to send when updating screen during initial paint and scrolling.
## Leave as zero for all list views to use just what is required.

$FMT=####0
LVUE_SEND_CNT=100

! Height adjustments for List View/Grid
; The number of pixels in excess of the standard line height for list view rows.
## Default is 2 pixels more than line height.
$FMT=#0
ROW_HI_PAD=2

; The number of pixels in excess of the standard line height for list view headers.
## Default is 6 pixels more than line height.
$FMT=#0
HDR_HI_PAD=6

; The number of pixels in excess of the standard line height for grid rows.
## Default is 5 pixels more than line height.
$FMT=#0
GRID_HI_PAD=5

# -------- Folders
<Folders>

! Folder Size and type

; Folder tab height in pixels. Generally this should be between 1.5 and 2 times line height. 
; If zero then 1.5 times line height used.

$FMT=#0
TAB_HEIGHT=0

; Use Web style vertical tabs for folders as opposed to horizontal tabs.
## Default tabs look like folders.  Enabling this causes each folder to render vertically.

$CHECKBOX
USE_WEBTAB=0

! iNomads unique folder options

; Folder Auto-invoke option.  If enabled, using the arrow keys to change tab will cause folder to be changed immediately.
## If disabled system will require the user to click on folder tab to switch to it.

$CHECKBOX
AUTO_FOLDER=0


! Special Tweaks for folders

; Folder height factor.  The folder height (in lines) will be multiplied by this value
; to determine height in HTML (default 0: 1-Without frames, 1.2-With). 
## If borderless frames are suppressed we suggest 1 otherwise 1.2.

$FMT=#0.00
FOLDER_FACTOR=0

; Height multiplication factor to apply to controls over 4 lines high within folders. (Only when using Table rendering).

## Setting this will increase the size of controls within Folders in an attempt to compensate for size increase caused by FOLDER_FACTOR (0=no compensation).

$FMT=#0.00
FOLDER_CONTROL_FACTOR=0

# -------- Frame settings
<Frames>

! Frame rendering options

; Enable suppression of 'Frames' that do not have titles associated with them.
## Frames with titles are always display in the HTML, however in some cases it may be desirable to suppress simple Non-titled frames due to overlaps.

$CheckBox
FRAME_SUPPRESS=0

; Use <HR> for single line high frames instead of standard frame display.
## Frame will be rendered as a horizontal line.

$Checkbox
FRAME_USE_HR=1

; Frame header height override in pixels (0 means use 1 line).
## If non-zero this field specifies the height of a frame header in pixels. Only used in Absolute rendering.
$FMT=##0
FRAME_TITLE_HI=0

; Frame bottom height to allow for corners etc. in pixels (0 means use 1 line).
## If non-zero this field specifies the height of a frame bottom in pixels. Only used in Absolute rendering.
$FMT=##0
FRAME_BOTTOM_HI=0

; On frames with text (Headers), don't use end frame header formatted cells if frame is 1 line high.

$Checkbox
SINGLE_FRAME_CROP=0

! Frame Tweaks

; Frame bottom adjustment. Logical number of lines the bottom of a frame will be moved up to 
; compute true bottom.

$Fmt=#0.00
FRAME_BTM_ADJ=0.00


# -------- Text displays

<Text>

! Text message contents for messages display by system

; The text word to be displayed that will 'Close' a window.  Default is 'Close'
; but in multilingual systems you can change this.

TEXT_CLOSE=Close


; Text to display during disconnect countdown when device is left idle too long.
; Insert ##:## where the countdown is to appear.

$Fmt=LONG
TEXT_TIMEOUT=Time limit has been reached.\n\nYour session will be terminated in ##:##.;Timeout

; Text to display when a screen is refreshed due to transmission errors or user sending out of sequence.
; Also displayed after session rescue.

$Fmt=LONG1
TEXT_RESTORE=Screen restored


# -------- Layout

<Layout>

; Enable absolute rendering as opposed to old-style table base rendering.
## Preferred is Absolute over old-style table based.  It provides more accurate screen layouts
$Checkbox
RENDER_ABSOLUTE=1

; Use 3 Line (hamburger ICON) option for menu bar initiation.
## If enabled the system will render a 3 line (&equiv;) option on the panel title to indicate a menu bar.
$Checkbox
USE_HAMBURGER=1

! Table rendering options which are ignored if using absolute rendering

; Number of pixels used to define each table column when generating panels.

## This defines the resolution used when converting panels to HTML tabular displays
## Its value must be a integral factor of CHR_PX; generally 1/2 or 1/3.

$Fmt=#0
$Rule=1-99

COL_PX=4
; Vertical allowance to use when generating HTML.  Controls that start within this 
; distance of proceeding control are to be considered on the same line.

## If non-zero controls positions are compared relative prior controls for alignment. If zero
## controls are positioned using simple rounding.

$Fmt=#0.00
VERT_ALLOWANCE=0.00

; Use "Original" line spacing algorithm when applying vertical allowance (above).

$CHECKBOX
VERT_ADJ_METHOD=0

; Suppress the vertical allowance (above) when rendering frames. 
## This is only applicable if the vertical allowance is non-zero, otherwise ignored

$CheckBox
VERT_ALLOW_NOFRAMES=0

; Don't force table row heights, but allow browser to determine height based on content.
## If disabled this option has been shown to cause random line spacing in FireFox
$CHECKBOX
DISABLE_TR_HEIGHT=0

; Dynamically 'Snap' (align) all controls to standard lines increments.
## Set this option to have system 'Snap' your controls to standard vertical positions.

$fmt=#0.00
$List==0.00,0.20,0.25,0.50,1.00,
SNAPTO_LINES=0.00

; Refresh screen when hiding/showing controls.
## When using a table based layout special logic has to be applied to hide controls that occupy same cell.
## Usually the overlap logic work but in some instances it is better to have system just redraw screen on a hide/show.
$CHECKBOX
HIDE_SHOW_REDRAW=1


# -------- Tweaks

<Tweaks>

! Adjustments based on changes to Style sheet (CSS) and Font from default

; The number of pixels higher your style sheet will make grid rows.
## Default style sheet increases row height by 1 pixel.

$FMT=-#0
GRID_HI_ADJ=0

; The number of pixels wider your style sheet will make grid columns.
## Default style sheet increases width by 1 pixel.

$FMT=-#0
GRID_WD_ADJ=0

; The number of pixels higher your style sheet will make list view rows.
## Default style sheet increases row height by 1 pixel.

$FMT=-#0
LVUE_HI_ADJ=0

; The number of pixels wider your style sheet will make list view columns.
## Default style sheet increases width by 1 pixel.

$FMT=-#0
LVUE_WD_ADJ=0

; Right justified Check box/Radio Button pixel adjustment.

## In Nomads the actual placement of right justified check boxes and radio buttons
## varies based on the font.  Use this to apply minor adjustments.

$fmt=-##0
CBX_RBT_ADJUST=0

; Amount to adjust button size/position in order to assist alignment.

## Buttons beside inputs are often made slightly bigger and positioned slightly above
## corresponding input field.  This adjustment only applies to buttons < 2 lines high.

$FMT=#0.00
BTN_SZ_ADJUST=0.00


# -------- HTML inclusions
<HTML>

! HTML elements to be used/included in rendering

; Additional header META tags to be included in the HTML.

$Fmt=LONG
META_TAGS=

; JavaScript Window.open parameters to use when creating popup windows. 

## Position and size parameters are generated by system.
$FMT=Long
WINDOW_OPEN=toolbar,directories,location,status,menubar,scrollbars,resizable

! Popup windows suppression
; Avoid using popup windows.
## If set system will attempt to avoid using Popup windows to open new browser sessions.
$CHECKBOX
Avoid_popups=0

; Message box text to show when avoiding Popups and viewing .pdf report.
$Fmt=LONG
Popup_pdf_msg=Report file available. View?

; Message box text to show when avoiding Popups and viewing other file/site.
$Fmt=LONG
Popup_msg=Okay to open new browser window?

# -------- Query options

# <Query> 

# ! Query settings

# ; Use Listview based Query display as opposed to full screen queries.
# $Checkbox
# QRY_LISTVIEW=1

# ! Full screen query options (ignored if using Listview above)

# ; Number of lines to display per "Page" on the query display.
# ## The default we suggest is 25 although the allowable raneg is between 5 and 500

# $Rule=5-500
# $Fmt=##0

# QRY_PAGELEN=15

# ; Do you want to use the full width of the display when showing querys or use the screen width
# ; as defined in the query definition?

# $Rule=Yes,No
# QRY_FULLSCREEN=No

# ; Force a popup for the Query regardless of whether popups are suppressed.

# $Checkbox
# QRY_POPUP=0

# -------- Misc options

<Misc> 

! URL settings

; Image web based URL (In HTML will have "/" appended - Default 'images').

IMG_DIR=

! Miscellaneous

# ; URL to image to display as background for checkbox and radio buttons with focus (IE only)
# ## Leave empty for no background -- Image aligned top/left no repeat
# IE_FOCUS_GLOW=/sysimage/focusglow.png

; Outline to use to highlight current input field.  Format is "Color Type Width" such as "Orange solid 1px" or "Invert dotted thin".
FOCUS_OUTLINE=SaddleBrown solid 1px

; Charting object to use.  If -none- then no chart will be available.  
; Path must be relative *plus/inomads/add-ons.

## Product includes FusionChartFree from Infosoft www.fusioncharts.com/free.
$list=*plus/inomads/add-ons/charts
Chart_obj=fusionfree

; Mask used to test Query to determine if JavaScript calendar can be used.
## If empty only standard test for the existence of a Query panel with than word 'calendar' used.
CALENDAR_QRY_MASK=

; Set the Drop Query as the default query display.
## Set the Drop Query as the default query display for this template. To set this as the default for all templates, set %nomads'Drop_Qry_All=1.
$CHECKBOX
DROP_QRY_ALL=0

; Option to include Function key pull down on Caption line.
## A Function key pull down will be included on the caption line to assist on devices without function keys based on the setting of this option.
$LIST==Never,Always,Touchscreens,
$TBL=NAT
FKEY_PULLDOWN=A

; Option to include Right Mouse click button on Caption line.
## When active a button on the caption line allows the user to indicate the next click submitted to the panel should be considered a Right mouse click.
$LIST==Never,Always,Touchscreens,
$TBL=NAT
RCLICK_OPTION=A

; Browsers to enable Bar Code Reader Icon on.
## Comma separated list of browsers whose caption line allows the user to initiate bar code reader for current input field.
BARCODE_OPTION=Android

; Accepted Bar code that the reader will process (Blank = UPC_A,EAN_13).
## Comma separated list of bar codes that the integrated reader will accept.
BARCODE_TYPES=

# ; Option to include Fast Drag/Drop button on Caption line
# ## When active a button on the caption line allows the user to initiate a fast two click Drag/Drop emulation.
# $LIST==Never,Always,Touchscreens,
# $TBL=NAT
# QUICK_DRAGDROP=A

