The Category List Widget lets you display a list of categories in a sidebar. It is typically used as form of navigation. You can see an example of it on this forum (in the left sidebar).
Follow this guide to install and administer this widget: Installation and Setup
Parents and subcategories
The widget will show parent categories and subcategories in a hierarchy, like you see in the example on this forum. Clicking on a parent will display a list of subcategories if the parent has any subcategories. If the parent doesn’t have any subcategories clicking on it will navigate to that category.
Excluded categories
You can exclude categories from the list by adding their category “slugs” to the excluded categories setting in the theme component setttings. You can find the category slug in the category’s settings (it’s also in the category url).
Order by activity (advanced)
The default order is the order the categories appear on the /categories page. You can change this order using the admin controls on the categories page.
The order by activity setting orders sub-categories by activity in that category (latest post created in the category), however this relies on additional data being sent from the server to the client, which we currently do in another plugin. The upshot of this is this won’t work out of the box. You need to have a plugin installed that includes this:
add_to_serializer(:site_category, :latest_post_created_at) { object.latest_post&.created_at }
Unless this makes sense to you, do not use this setting. We will be adding additional order settings in the future.
Show unread
If a category slug is included in this setting the category and any sub-categories will display their “unread” count. If you are a client of ours you will see this in action.
Category logos
If a category has a Category Logo Image set in its category settings, that will appear to the left of the category name in the list. You can see that in use in the category list widget on this site.
