Custom Category Boxes

:discourse2: Summary Custom Category Boxes will render your categories as boxes with customized backgrounds on your categories page. This component will also render each category page with a category banner if show_banner is selected.
:eyeglasses: Preview Preview on Discourse Theme Creator
:hammer_and_wrench: Repository Link https://github.com/discourse/discourse-custom-category-boxes-component
:open_book: New to Discourse Themes? Beginner’s guide to using Discourse Themes

Install Component

Features

:information_source: For this component to work desktop category page style needs to be set to either categories with Featured Topics or Boxes with Featured Topics

There are four options to choose from. The default is halftones.

Halftone Background

Halftone option

Crosshatch Background

Crosshatch option

None

None option

Custom

If you would like to create this effect with some of your own artwork, upload 4 varying .png 's with transparent backgrounds or traditional .jpg 's in the settings page. For each upload, use the naming convention of custom-0 , up to the last as custom-3 . Be sure to select custom as your category background setting.

Custom option

Settings

Name Description
category background Select one the four options
show banner If selected, a styled banner will appear on each category page, matching the look of the category box.
Translations Default
more_topics More Topics…

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

Last edited by @JammyDodger 2024-06-11T15:12:05Z

Check documentPerform check on document:
31 Likes

Simple, clean. Nice component. Thanks.

3 Likes

Great plugin! I have been searching for it for a long time, thank you.

1 Like

I think it should have auto-resize for picture or limit

3 Likes

thanks for the theme :+1:

may you consider slight changes so that the theme also works for rtl direction without any edits? (as edits go away after updates).

also where can I translate this string: “more topics …”. it was neither in the admin customize section nor in the theme :thinking: .

3 Likes

Glad you enjoy the component. I have added translation for more topics.... As for the rtl direction it is something I will look into.

Until then, make sure you copy your customization and add it back after updating the component. :smile:

3 Likes

thanks :blush:

for this, there’s only one line which needed to be commented:

a #custom-category-title{ text-align: left;}

btw, I noticed that these category boxes won’t apply for subcategories. is it possible that the same rules also applies to subcategory boxes?

2 Likes

I believe you might be able to create your changes as a seperate theme component with Overides in your component plugin.

you are right, and I’ll do that for this case.

but I believe that when the whole discourse application is compatible with both rtl and ltr directions, it means that “details matter for the creators” and “they want to build the best service, not just a service”. well, this can happen for its great themes as well.

2 Likes

I want this theme too but I’m straggling to add it.