Welcome, Guest Login

Support Center

Our documentation is moving:

Please check for the most up-to-date LiveWhale CMS and LiveWhale Calendar documentation. The below legacy documentation will remain available as a reference until the documentation migration is complete.

Displaying a tag selector for a widget

Last Updated: Jun 21, 2017 02:00PM PDT

Many widgets support a special arg, “show_tags”, which will display a list of tags next to the widget. This will allow users to check off tags of interest and see the results of the widget change dynamically according to their selections.

This feature can be turned on for a widget simply by setting “show_tags” to “true”.

The show_tags arg will be added to your widget in the widget editor.

<widget type="news">
<arg id="group">me</arg>
<arg id="show_tags">true</arg>

By default (through LiveWhale 1.6.1), you will be allowed to select multiple tags for filtering. However, you can instead allow only one tag to be selected at a time by wrapping your widget in <div data-options="exclusive_tags=true"> ... </div>.  Starting in LiveWhale 1.6.2, this is the new default. If you'd like a multi-select tagger, we recommend isotope.js.
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
Invalid characters found