I need to do little changes to some views: Eg: change the datetime format to extended one (DD/MM/YYY HH:MM) [Screenshot 2024-02-28 at 12.14.36] add a tooltip to long category titles [Screenshot 2024-02-28 at 12.21.37] view long category titles on two rows [Screenshot 2024-02-28 at 12.21.56] Do I need to create a plugin for every change? even if is really small like only css? Thanks for your help.

No, plugins are only required if you intend to change the back-end. If it’s just a local change you can go to Admin → Customize → Theme and enter changes into a new Theme Component, then add it to your current Theme. Take a look at https://meta.discourse.org/c/documentation/theme-developers/127, especially: [image] Developing Discourse Themes & Theme Components Developer Guides Discourse Themes and Theme Components can be used to customize the look, feel and functionality of Discourse’s frontend. This section of the developer guides aims to provide all the reference materials you need to develop simple themes for a single site, right up to complex open-source theme components. This introduction aims to provide a map of all the tools and APIs for theme development. If you prefer a step-by-step tutorial for theme development, jump straight to: Themes vs. Theme Compon…

thanks! So if I need to change a label or add a tooltip I need to create a theme but if I need to add a new column to a page (eg: the topic list) I need to create a plugin?

The distinction is this: If you need to change the API, e.g. any data in .json route, changes to authorisation, back-end processing of data, you need a plugin For many front end changes that don’t need different data, you only need a TC. ie a lot of presentational changes, or any logic in javascript that is not sensitive.

And a gray area (which doesn’t apply here, I think) is if you need data that is not available (like user custom fields) you could either use AJAX to pull that data with javascript when you need it, or have a plugin that adds the data to the serializer.

ok thanks. In the guide I don’t undestand how can I setuo and import a TC locally, there’s only an example for a remote one.

I would suggest using this wonderful tool, to create TC easily locally: [image] Install the Discourse Theme CLI console app to help you build themes Developer Guides The [discourse] Discourse Theme CLI is a ruby gem that allows you to use your editor of choice when developing Discourse themes and theme components. As you save files the CLI will update the remote theme or component and changes to it will appear live! Installing To play with it, make sure you have Ruby 2.5 or up installed. [image] If you are on Windows, you have 2 options: Option 1: Windows Subsystem for Linux. Windows 10 has access to a full Linux environment, you can use it to install …

Unless you have a very small CSS change, I’d recommend using a remote theme or the CLI tool. But if you click the “install theme” dialog will allow you to create a theme (or theme component if you do it on the component page)

inside the category topics list I need to add a new column with the “created_at” column and change the date from “tiny” to extended (eg: DD/MM/YYYY HH:MM)

If you want to add new stuff to a template, I would start with GitHub - discourse/discourse-theme-skeleton: Template for Discourse themes · GitHub, but I don’t know how to go about adding a column there. I guess there’s some javascript magic you could do, but that’s not my wheelhouse. You know that you can see that information if you mouse-over, right? [image] Also see Plugin outlet locations theme component, but there’s no plugin outlet there.

[image] Jay Pfaffman: but there’s no plugin outlet there. You have these plugin outlets: topic-list-after-columns and topic-list-header-after. https://github.com/discourse/discourse/blob/main/app/assets/javascripts/discourse/app/raw-templates/list/topic-list-item.hbr#L90 https://github.com/discourse/discourse/blob/main/app/assets/javascripts/discourse/app/raw-templates/topic-list-header.hbr#L27

When to use a plugin vs theme component?

Development

Arkshine March 1, 2024, 3:10pm 7

I would suggest using this wonderful tool, to create TC easily locally:

Topic		Replies	Views
Theme-Component v Plugin: What's the difference Development	22	6178	June 9, 2020
"theme-component" should be a subcategory instead of a tag Site feedback	15	1896	July 18, 2022
How do I go about making a very customized theme? Development	3	2235	November 8, 2023
Plugin vs. theme component Development	6	1490	October 5, 2022
Dumb question: do I want to make a theme, plugin or component? Development	3	1115	April 14, 2020

When to use a plugin vs theme component?

Related topics