Speak to our experts today 0333 004 0333
Speak to one of our experts today
User Guides

EKM Tag: [ekm:category_jumplist]

This tag outputs a drop down navigation menu allowing the user to select categories from a dropdown and drill-down into categories using a second and third drop down menu. This makes navigating to sub-categories much quicker.

  • Tag Information
  • Nesting This Tag
Basic Use
In its basic use you will be presented with upto 3 menus, depending on the depth of your category structure. When selecting a category that contains sub-categories you will be presented, in the second box, with those sub-categories.

[ekm:category_jumplist][/ekm:category_jumplist]
                                
This would output something like...

Full Use

If used with a font_formatting attribute (set to no) the name will be output without any of the systems predefined formatting. This strips out all <font> tags and will not prepend or append the name with a h1 tag.

If you wish to output H1 tags around the name using font_formatting='no'; you will need to manually add these.


[ekm:category_jumplist]
    depth='3';
    location='0';
    default_value='';
    default_blank_value='';
    excludelist='';
    includelist='';
    output_item='[category1]<br>[category2]<br>[category3]';
[/ekm:category_jumplist]
                                
Tag Attributes
Depth
depth='3';

Specify the number of drop down menues you wish to show. This can be a up to three. When using with many categories at higher depths you may see speed issues.

Value
Description
1
Will show only the top level categories
2
Will show top level categories and direct sub-categories of them.
3
Will show top level categories, direct subcategories of them and also sub-categories of those.
Location
location='0';

Specify the starting location for the drop-down menu to begin. This is useful if you have a brands category and want to offer filtering through categories quickly. This must be the location ID for a category.

Value
Description
0
Top level / Homepage
{user defined}
This must be a user defined category ID (integer).
Default Value
default_value='Select A Category';

Specify the name of the default option. This is the option that appears before you have selected anything.

Value
Description
{user defined}
Define your own text to be displayed in the default (top item) option. By default this is Please Select...
Default Blank Value
default_blank_value='Choose A Category';

Specify the name of the default option when the currently select option has no subcategories.

Value
Description
{user defined}
Define your own text to be displayed in the default (top item) option when no sub-categories can be displayed. By default this is Please Select...
Exclude List
excludelist='32,98,16';

Specify the IDs of any categories you want to exclude from the dropdown menu. These IDs must be for categories and must be comma delimited.

Value
Description
{user defined}
Define a list of category IDs to exclude from the dropdown, each seperated by a comma.
Include List
includelist='32,98,16';

Specify the IDs of only the categories you want to appear within the dropdown menu. Only categories defined by IDs will be included. These IDs must be for categories and must be comma delimited.

Value
Description
{user defined}
Define a list of category IDs to include in the dropdown, each seperated by a comma.
Output Item
output_item='[category1]<br>[category2]<br>[category3]';

Specify any HTML or Text you want to output around the dropdown lists. This is useful for defining a layout.

Value
Description
{user defined}
Define your own HTML or Text.

To output the dropdown lists you must use the following attribute tags.

Value
Description
[category1]
Outputs the dropdown for the first category jump list.
[category2]
Outputs the dropdown for the second category jump list.
[category3]
Outputs the dropdown for the third category jump list.

The EKM system allows for some tags to be nested within other tags.

This tag cannot be nested within other tags