Categories Tag Column

[Discourse]

	Summary	Categories Tag Column adds a column displaying tags to your categories page.
	Repository Link	https://github.com/discourse/discourse-categories-tag-column
	New to Discourse Themes?	Beginner’s guide to using Discourse Themes

Install this theme component

As this is an official theme component maintained by the Discourse team, support, bug, ux, and feature requests can be made in the respective categories here on Meta, and tagged with the appropriate theme component tag. Click on a link below to get one started.

 Support  Bug  UX  Feature

This component only works if the desktop category page style site setting is set to either categories and latest topics or categories and top topics.

Features

Settings

Name	Description
tag count	Change the number of tags that appear by default. When only a subset of tags is shown, you’ll also get a “more” button.
categories page column count	This controls the number of columns on the page in total. Note that when the browser is less than 768px wide, all the content will stack into a single column.
tag column count	The number of columns used within the tags section
hide categories column	Enabling this will hide the categories, this may be useful for sites that want to focus on tagging
categories column	The column categories appear in
categories row	The row categories appear in
tags column	The column tags appear in
tags row	The row tags appear in
topics column	The column topics appear in
topics row	The row topics appear in

Note that the column and row settings accept values that work with grid-column and grid-row… so for example, by default the topics_row value is 1 / span 2, this means topics start in row 1, and span across 2 rows. So as seen in the screenshot above, the topics column is as tall as both the categories and tags columns, which are only 1 row high.

The row and column settings grant a lot of layout flexibility. With a few changes, you can change the layout to something like this:

or this:

Hosted by us? Theme components are available to use on our Standard, Business, and Enterprise plans.

Last edited by @JammyDodger 2024-06-11T08:45:13Z

Check document

Perform check on document:

[mattdm (Matthew Miller)]

It’d be amazing if this could support tag groups!

[nplanchon (Neil)]

Thank you for creating and sharing this out @awesomerobot. I am confused and would love some handholding to create this layout on our instance. I want to exactly replicate this screenshot. Would you be willing breakdown what each setting needs to be set at for that?

and @awesomerobot, how can I sort them by name rather than count?

and is there a setting which makes showing all tags all the time, rather that having a More button? @awesomerobot

Cheers
Neil

[awesomerobot (Kris)]

Sure no problem… from the default settings, you’d change the following:

tag column count: 8
tags column: 1 / span 2
topics row: 2

@nplanchon

and is there a setting which makes showing all tags all the time, rather that having a More button?

you can make the tag count setting higher, to something like 999 perhaps?

@nplanchon

and how can I sort them by name rather than count?

There’s no option for this at the moment

[nplanchon (Neil)]

Nice to hear from you and thank you @awesomerobot

[IT_Director (Osa Isacson)]

Hi @awesomerobot, many thanks for this!

Is it possible to not just show it under /categories, but instead on the landing page?

We currently have it implemented under Tags | Latest - FIC Forum

…but we’d like to have it implemented on the landing page: https://forum.ic.org/, making the end result look like so:

Is there a way?

[IT_Director (Osa Isacson)]

…actually I think I found a way - settings > basic setup > top menu: set the first to ‘categories’ and this makes the start page view default to the above.

[IT_Director (Osa Isacson)]

This might be a bug @awesomerobot: if one has tag groups enabled then only tags from the ‘Other tags’ group are pulled in.

To replicate:

1. Enable tag groups
2. Add tags in a group
3. See that only the tags not belonging to the ‘Other tags’ group are visible
   
   
   
   
   
   
   
   
   
   
   

[nplanchon (Neil)]

@awesomerobot Hello Kris. Sounds like you might be able to guide me on a new anomaly. If you can great, otherwise, I am at ease with starting a new thread.

After a few days of stability using the theme component which adds tags on the left side of our /categories page, this morning all the names of the tags have disappeared and it looks like this! I have also attached what it looked like after we successfully installed the component and set it up the way we like it best.

What do you think is causing this behavior?
What steps can I be taking to troubleshoot?

I know that I can ever so easily revert to the original /categories page and set it up again. I need help from others who have more experience than me. First asking for support.

I look forward to hearing from you.
Cheers!
Neil

[sunjam (james.network)]

This is awesome. What I would like is to specifically enable tag columns within particular categories, so users are encouraged to browse by tag.

[Chris_Neidl]

I’m also looking to do this. Did you figure out how @sunjam ?

[albjeremias (Albatroz Jeremias)]

this makes way more sense.