The S550 Tag inserts a menu for selecting a year range.
Application
UI Controls
How to Enter Using the Content Editor Toolbar
This S-Tag cannot be added using the Content Editor toolbar. Add the S-Tag code to the HTML using the Plain Text View.
Luminate CMS Compatible?
Yes, this S-Tag can be added using the Luminate CMS Content Editor.
Format
- Standard
[[S550:BD=[Backwards Differential]:FD=[Forward Differential]:SV=[Selected Value]:FV=[Future View]]] - XML
<convio:session name="*" param="BD=[Backwards Differential]:FD=[Forward Differential]:SV=[Selected Value]:FV=[Future View]"/>
Parameters
- BD (Backward Differential) - The value for this parameter is an integer indicating the number of years relative to the current year that the drop-down should display. If the current year is 2000 and a value of 10 or -10 is provided, the drop-down will start from 1990. This parameter is optional. Default value for this parameter is 0. Positive and negative integers are acceptable for this parameter.
- FD (Forward Differential) - The value for this parameter is an integer indicating how many years beyond the current year that the drop-down menu should display. If the current year is 2010 and a value of 10 is provided the drop-down menu will end at 2020. This parameter is optional. Default value for this parameter is 10.
- SV (Selected Value) - The value for this parameter is an integer indicating which year should be selected by default. This parameter is optional. If this parameter is not specified, the first option is selected.
- FV (Future Value) - The value for this parameter is a string value which can be either "true" or "false." This parameter represents whether the drop-down menu should display in descending or ascending order. If "true," the years in the drop-down menu will display in descending order, and if "false" the years will display in ascending order. The default value for this parameter is "false." This is an optional parameter.
Sample Code
For the following example, the option to be selected is stored in template parameter [[A1]] and the current year is 2010.
Default Usage:
[[S550 : : : SV = [[A1]]]]
This will result in a drop-down menu that runs from 2010to 2019.
Future View Usage:
[[S550 : : : SV = [[A1]]:FV=True]]
This will result in a drop-down menu that runs from 2019 to 2010.
Specific Year Range:
[[S550 : BD = -10 : FD = 10 : SV = [[A1]]]]
This will result in a menu that runs from 2010 to 2019.