List of components or PluginOutlets with explanatory documentation

AI-generated summary

The discussion revolves around finding components or PluginOutlets with explanatory documentation in Discourse. omppatil asked for a list of components or PluginOutlets with documentation and sought guidance on modifying avatars of posters in the topic list.

Arkshine replied that there is no specific documentation available, but suggested using the Plugin Outlet Locations theme component to see available plugin outlets (except those in raw templates) and reading the source code for context. For the second question, Arkshine provided links to raw templates (topic-list-item.hbr and posters-column.hbr) where the posters from the topic lists can be found, and advised against overwriting the posters-column raw template unless necessary.


Hello,

I have a couple of questions regarding the documentation and functionality of components or PluginOutlets in our system:

  1. Where can we get the list of components or PluginOutlets with explanatory documentation? Where do I find this documentation that provides a thorough explanation of where each component or PluginOutlet can be used and what its purpose is?
  2. What is the component, PluginOutlet, or function used to get the avatar of a poster from the topic list, where we can modify or change the avatars of the posters?

I would appreciate any guidance or links to the relevant resources. Thank you!

Hi,

You can use this theme component to see the available plugin outlets (except the ones in raw templates):

  1. There is no specific documentation at the moment. You can read the source code to understand the context. The component gives you a link to the source code. You can always ask Development if you don’t understand something. :+1:

  2. The posters from the topic lists can be found in these raw templates:

https://github.com/discourse/discourse/blob/main/app/assets/javascripts/discourse/app/raw-templates/list/topic-list-item.hbr#L58
https://github.com/discourse/discourse/blob/main/app/assets/javascripts/discourse/app/raw-templates/list/posters-column.hbr

Depending on your precise needs, you may need to overwrite the posters-column raw template (which is not recommended). What are you trying to achieve here?

Useful links: