|
Template Directory Structure/Files |
To allow NOMADS screens to be presented on the Web in a manner consistent with a client's website, a series of control files is used to generate the required HTML. These control files (file suffix of .tpl) reside in the templates directory.
By default, the normal template files reside in a sub-directory called default. These should not be changed, but rather user custom template directories should be created.
For each template that you want to create, you need to create a new sub-directory in the templates directory, add customized template files and a CSS Style Sheet (if needed).
Two basic types of windows are currently supported:
The main window: This is the format used by the initial panel displayed when iNomads starts a transaction/process.
A popup window: This is used for all subsequent windows.
Generally, the main window will contain more information about the website such as a banner and additional hyperlinks, whereas a popup window will only show an abbreviated heading.
The template files used by iNomads are listed below:
|
File |
Description |
|
style.css |
Standard CSS Style Sheet |
|
close_popup.tpl |
Special HTML used to force switch from Ajax interface to a new HTML request |
|
footer.tpl |
Final footer contents for main window |
|
footer_popup.tpl |
Final footer for popup window |
|
header.tpl |
Initial HTML contents for main window |
|
header_popup.tpl |
Initial HTML contents for popup window |
|
maximize.tpl |
Logic to insert 'Maximize' panel button on panel header |
|
mbx_btn.tpl |
Generic template used to create a button as used in message box and progress bar |
|
msgbox.tpl |
Message box HTML template |
|
normal.tpl |
Basic panel template for main window |
|
normal_popup.tpl |
Basic panel template for popup window |
|
popmbx.tpl |
Special HTML wrapper to allow display of message box when no panel is currently rendered (used by MSGBOX directives between panel displays) |
|
popmbx_btn.tpl |
Button template for above |
|
post_header.tpl |
Fully customizable HTML to include after header. This is an empty template file that is intended to be overridden by the user templates. |
|
pre_footer.tpl |
Fully customizable HTML to include after panel contents by before the footer of the HTML document. This is an empty template file that is intended to be overridden by the user templates. |
|
qry_btn.tpl |
Query button |
|
qry_gobtn.tpl |
Query 'GO' button |
|
qry_sort.tpl |
Query Sort options drop box |
|
query.tpl |
Query HTML template |
|
restore.tpl |
Logic to insert 'Restore' panel button on panel header |
|
template.conf |
Template internal configuration parameters |
Customized templates can replace any of the above files with ones in the template-specific directory. To provide an easy method of wrapping all panels, the post_header and pre_footer templates, in the default template, have no contents and thus are available for easy customization in each template directory.
The template files themselves contain HTML code and specialized <?bb …xxx… ?> tags. These tags, when found, will be processed internally by iNomads and the value associated with …xxx… will be evaluated and inserted into the HTML stream.
In addition, when a template is invoked, it can be passed up to 10 parameters in the variables param1$ through param10$. The contents of these parameters vary between template files, and each template file contains documentation for the parameters.
The tag <?bb ! ….. ?> can be used to include comments within the template file and will not be output in the final HTML output.
There may also be a template.conf file present in the template sub-directory. It contains the template-specific configuration settings. You can edit these manually using a text editor or directly from the admin functions in the system.
The style.css file within each template directory can be used to override the default style sheet that exists in the default directory.