Optional components to customize the layout are:
- Variable and parameter specifications.
Once the start template tag has been placed, you may set any needed variables or parameters. Below is a listing of special variables. As mentioned above, you may pass needed search parameters and category values. Here, you may also override default sorting and items per page.
Syntax to pass variables is: <!--variable_name=value-->
- Multiple row specifications.
Within the listing template, you can specify alternating row formats (such as color) or image separators between rows. The script will loop through the row specs until there are no more items to display. Any unused row specs, will be excluded.
- Multiple column specifications
You can specify more than one column spec within the row spec to achieve 2, 3 or more columns across.
The script will loop through the data records for each new column until the row is full, or there are no more items to display. Any unused column specs, will be filled with an empty cell by the script. Or, you can specify HTML to use for an empty column.
- Empty cell specification
When multiple columns are specified and in the event that any blank columns are left over, the script will generate a blank cell. When the generated "blank cell" is not adequate, alternate empty cell contents can be specified.
<!--begin_blank_cell-->. . . . <!--end_blank_cell-->
- Null row specification
You can specify what will be displayed if no results are found. Any HTML or text within the null row tags will be substituted for any HTML outside of the null row tags. This tag can be placed either before or after row tags.
Example:
<!--begin_null--><tr><td align=center>
Sorry, no results were found in the {{category_name}} section.
</td></tr>
<!--end_null-->
- Navigation bar specification
The script will calculate and generate navigation links depending on the number of results and items per page specified. You can completely control the look of this navbar, while utilizing these generated links. Or, if you prefer, you can simply place a default navigation bar within the navbar spec. The default navigation bar is text oriented and can be changed in the Template settings on the Wizard Panel.
The navbar spec can be placed practically anywhere in the listing template, except within row tags. Top, bottom, or in a cell at the side of the listing are all possibilities. Images can be used in the navbar, if they are named correctly. Example navbar structures are found below, after this section.
- Result Status/ Page status
You may specify placement, format, and included text, when displaying result status. These variables are described and listed in the next section.
- Product Options Specifications
On product listing templates, you can specify as many product options as necessary within column tags.
If a product does not have specified options, the HTML and values within the option tag will not display.
Example option specifications are found below, after this section.
- Sort Order Specifications
To specify sort order, use the following tag to tell the script what field to sort on and whether it is ascending or descending.
<!--sort_field1=field name -->
<!--sort_type1=ASC --> or <!--sort_type1=DESC-->
<!--sort_field2=field name --> etc.
|