Skip to content

List:The formatter "Dynamic list: Content filters"

A list collects contents according to the preset search criteria and shows them with the selected teasers.

The content filters allow the user to interactively limit the results of a dynamic list. The following filters are available:

  • Full text search (in the list results)
  • Filter by categories
  • Filter by date
  • Filter by storage folder

Available element settings

Allows to change the element layout using predefined CSS modifications.

Please note that a specific element may not support all listed modifications.

Controls if a full text search input filter is shown.

Sets an individual placeholder that is used for the text search input.

If this is not set, the default text "Search list" is used.

Controls if reset buttons for active filters are shown.

Controls if a category selection filter section is shown.

This requires that the elements in the list are attached to categories.

The section can be displayed either folded or unfolded when the page is loaded.

Controls how the categories are displayed.

OpenCms organized all categories in a tree structure. Any category can have sub-categories, which can be displayed similar to file paths .

Lets assume there is a category "Topic" with sub-categories "Sports" und "Politics". The following output can be generated:

All categories without path - Topic, Sports, Politics.
Only sub-categories without path - Sports, Politics.
All categories with path - Topic, Topic/Sports, Topic/Politics.
Only sub-categories with path - Topic/Sports, Topic/Politics.

Controls if the total result count for a category is displayed after the name of the category.

Controls which categories are either shown or hidden in the filter.

You have to provide a comma separated list of (prefixes of) category names, e.g. "Theme, Loc".

For a match, a category has to start with any given name. For example "Loc" would match categories "Location" and "Locomotion". If a parent category is matched, all sub-categories are automatically matched, too.

If you provide category names, only matched categories are shown by default. If you prefix your list of names with "blacklist:", the matched categories are hidden and only the others are shown.

Sets an individual heading that is used for the categories section.

If this is not set, the default text "Categories" is used.

Controls if a monthly archive filter section is shown

This requires that the elements in the list have a date, e.g. like events.

The section can be displayed either folded or unfolded when the page is loaded.

Sets an individual heading that is used for the monthly archive section.

If this is not set, the default text "Archive" is used.

Controls if a folder filter section is shown.

This requires that the elements in the list are located in a folder structure, e.g. like a list of documents for download.

The section can be displayed either folded or unfolded when the page is loaded.

Sets an individual heading that is used for the folder section.

If this is not set, the default text "Folders" is used.