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: https://discourse.pluginmanager.org/t/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.
Settings
Excluded categories
You can exclude categories from the list by adding their category āslugsā to the excluded categories
setting in the theme component settings. 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 latest
If a category slug is included in this setting the category and any sub-categories will display their ālatestā count. If you are a client of ours you will see this in action.
Collapsible sidebar
Adds a nice Minimise
button and arrow which collapses down the widget nicely. This is automatic when the available width is constrained.
You can also choose if this toggle should be at the top or the bottom.
Category logos
You can choose to have category logos auto-generated. This means that 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.
You can also manually set each one using the custom logos
setting.
Custom links
You can add links unrelated to your Categories, either above or below the Category list.
You can also set a Header before these links (which can also carry a link)
Category lock icon
This allows you to set an alternative category lock icon, for example unlock-alt
!
to display in the Widget.
Theme translations
You can personalise the button labels on the Widget