| Resumen | Bloques de barra lateral derecha muestra una barra lateral a la derecha de las listas de temas con una lista configurable de bloques. | |
| Vista previa | Vista previa en Discourse Theme Creator | |
| Enlace al repositorio | https://github.com/discourse/discourse-right-sidebar-blocks | |
| ¿Nuevo en los temas de Discourse? | Guía para principiantes sobre el uso de temas de Discourse |
Instalar este componente del tema
Características
El componente incluye algunos bloques que puedes mostrar en la barra lateral:
- popular-tags
- top-contributors
- recent-replies
- category-topics
- custom-html
- category-list
- subcategory-list
- upcoming-events-list*
- minimal-gamification-leaderboard**
El directorio de usuarios debe estar habilitado para que se rellene la lista de principales colaboradores. Si tu lista está en blanco, busca
enable user directoryen tu configuración de administración para asegurarte de que esté habilitado.
* Solo disponible cuando se usa con el plugin Calendar.
** Solo disponible cuando se usa con el plugin Gamification.
También puedes usar otros componentes de Ember como bloques; solo necesitas usar el nombre correcto. Por ejemplo, el núcleo incluye un componente de Ember signup-cta, y puedes usarlo en la barra lateral tal cual. Ten en cuenta que no puedes usar componentes que esperen un conjunto de parámetros, pero sí puedes crear tu propio componente de Ember en un tema separado y referenciarlo solo por su nombre en la configuración blocks de la barra lateral.
Puedes controlar algunas características de los bloques proporcionados mediante parámetros.
| nombre | descripción | valor predeterminado | valor | disponible para |
|---|---|---|---|---|
count |
limita el número de resultados | varía | número | todos excepto custom-html |
excerptLimit |
limita la longitud de cada extracto de respuesta | 150 | número | recent-replies |
id |
ID de categoría | ID de categoría (category-list usa separados por comas) | category-topics, category-list | |
content |
contenido a mostrar | html | custom-html | |
scopeToCategory |
solo muestra en la categoría o subcategoría X | ID de categoría | popular-tags | |
excludedTags |
lista de etiquetas excluidas | nombres de etiquetas | popular-tags | |
displayInSpecificCategories |
lista de categorías donde mostrar el widget | todas | números separados por comas | popular-tags |
id |
ID del tablero de clasificación | número | minimal-gamification-leaderboard | |
tag |
etiqueta a mostrar | nombre de etiqueta | tag-topics | |
period |
período de tiempo de los principales temas | semanal | all, yearly, quarterly, monthly, weekly, daily | top-topics |
title |
título del bloque | varía | cadena | tag-topics, category-list, top-contributors |
excludedGroupNames |
excluye grupos especificados | nombres de grupos | top-contributors | |
order |
ordena los colaboradores | Cadena (likes_received o likes_given) | top-contributors | |
period |
período de tiempo para los principales colaboradores | anual | all, yearly, quarterly, monthly, weekly, daily | top-contributors |
upcomingDays |
eventos iniciados antes del valor proporcionado | 180 | número | upcoming-events-list |
timeFormat |
formato de fecha/hora del evento | LT | formato momentjs | upcoming-events-list |
Configuración
| Nombre | Descripción |
|---|---|
| blocks | |
| show in routes | Solo para usuarios avanzados: limita la barra lateral a las rutas seleccionadas. Ejemplos: discovery.latest, discovery.unread, discovery.new, discovery.top, tag.show, “c/category-slug” (para categorías), “tag/sample-tag” (para etiquetas). Cuando está vacío, la barra lateral se muestra en todas las rutas de lista. |
blocks: elige los bloques a mostrar y ajusta su orden
show_in_routes: decide en qué rutas de lista de temas mostrar la barra lateral. Por defecto, se mostrará en todas las rutas de discovery excepto en /categories.
| Traducción | Predeterminado |
|---|---|
| top_contributors.heading | Principales colaboradores |
| top_contributors.view_all | Ver todos |
| popular_tags.heading | Etiquetas populares |
| popular_tags.view_all | Ver todas |
| recent_replies.heading | Respuestas recientes |
| subcategory_list.heading | Subcategorías |
| top_topics.heading | Temas principales |
| category_list.heading | Categorías |
Capturas de pantalla
Ten en cuenta que el componente viene con un estilo muy básico; se asume que los administradores que usan el componente agregarán su propio estilo en su propio tema.
Interacciones
Cuando se usa junto con el plugin Discourse Calendar, puedes agregar un bloque de barra lateral para tus próximos eventos. El nombre del bloque es upcoming-events-list, y el formato de fecha se puede personalizar siguiendo esta sintaxis (por ejemplo, MMMM D, YYYY).
¿Alojado por nosotros? Los componentes de tema están disponibles para usar en nuestros planes Pro, Business y Enterprise.




