 |
Resumen | Right Sidebar Blocks 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 de 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 la lista de principales contribuyentes se rellene. Si tu lista está en blanco, busca
enable user directoryen tu configuración de administrador para asegurarte de que está habilitada.
* Solo disponible cuando se usa con el plugin Calendario.
** Solo disponible cuando se usa con el plugin Gamificación.
También puedes usar otros componentes Ember como bloques, solo necesitas usar el nombre correcto. Por ejemplo, el núcleo incluye un componente 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 puedes construir tu propio componente Ember en un tema separado y referenciarlo simplemente por su nombre en la configuración blocks de la barra lateral.
Puedes controlar algunas funciones para los bloques proporcionados a través de parámetros.
| nombre | descripción | 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 separado por comas) | category-topics, category-list | |
content |
contenido a mostrar | html | custom-html | |
scopeToCategory |
solo se 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 para mostrar el widget | todos | números separados por comas | popular-tags |
id |
id del tablero de clasificación | número | minimal-gamification-leaderboard | |
tag |
qué etiqueta mostrar | nombre de etiqueta | tag-topics | |
period |
período de tiempo de los temas principales | semanal | todos, anual, trimestral, mensual, semanal, diario | top-topics |
title |
título del bloque | varía | cadena | tag-topics, category-list, top-contributors |
excludedGroupNames |
excluye grupos especificados | Nombres de grupo | top-contributors | |
order |
ordena a los contribuyentes | Cadena (likes_received o likes_given) | top-contributors | |
period |
período de tiempo para los principales contribuyentes | anual | todos, anual, trimestral, mensual, semanal, diario | top-contributors |
includeSubcategories |
incluye eventos de subcategoría | falso | falso, verdadero | upcoming-events-list |
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, la mostrará en todas las rutas de descubrimiento excepto en /categories.
| Traducción | Predeterminado |
|---|---|
| top_contributors.heading | Principales contribuyentes |
| top_contributors.view_all | Ver todos |
| popular_tags.heading | Etiquetas populares |
| popular_tags.view_all | Ver todos |
| 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, la suposición es que los administradores que usen el componente añadirán su propio estilo en su propio tema.
Interacciones
Cuando se usa junto con el plugin Discourse Calendar, puedes añadir 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 ). También puedes configurar qué tan lejos en el futuro buscar, y si se incluyen eventos de subcategoría (ver la tabla anterior)
