La barra lateral proporciona acceso rápido a las secciones importantes de tu sitio Discourse. Aunque los usuarios pueden personalizar su propia barra lateral según sus preferencias, ofrecer una configuración predeterminada bien pensada ayuda especialmente a los nuevos usuarios y visitantes de tu foro, facilitándoles la navegación.
Esta guía explica cómo personalizar las secciones existentes y crear secciones adicionales en la barra lateral. También aprenderás qué ajustes puedes modificar para configurar los valores predeterminados de las preferencias de usuario relacionadas con la barra lateral.
Personalizar el contenido predeterminado de cada sección
Sección Comunidad
La sección superior de tu barra lateral (sin un título visible) se denomina sección “Comunidad”. Esta sección es visible para todos los usuarios y contiene enlaces de navegación esenciales.
Para personalizar esta sección:
- Haz clic en Más en la barra lateral.
- Selecciona Personalizar esta sección en la parte inferior del menú extendido.
Puedes realizar los siguientes cambios:
- Reordenar los enlaces arrastrando el icono .
- Editar el icono, el nombre y el enlace de cada entrada.
- Agregar nuevas entradas a la sección.
Comprender los enlaces predeterminados
Algunos de los enlaces predeterminados tienen comportamientos especiales:
- Mis publicaciones - Este enlace siempre se muestra como “Mis publicaciones” de forma predeterminada. Sin embargo:
- Si el usuario tiene uno o más borradores, al hacer clic en el enlace se dirige a sus borradores, no a su actividad de publicación.
- Si el usuario pertenece a un grupo seleccionado en la configuración del sitio
experimental_new_new_groups, el texto del enlace también cambia a “Mis borradores” cuando hay borradores presentes.
- Mis mensajes - Solo visible para usuarios en
personal_message_enabled_groups.- Muestra un indicador de no leído o el número de mensajes no leídos para tu bandeja de entrada personal y las bandejas de entrada de los grupos de los que eres miembro.
- Siempre te lleva a tu bandeja de entrada personal, incluso si el único mensaje no leído está en una bandeja de entrada de grupo.
- Revisar - Solo visible para el personal y moderadores de categorías.
- Administración - Solo visible para administradores y moderadores.
- Invitar - Solo visible para usuarios que pueden invitar a otros.
Trabajar con traducciones
Los enlaces predeterminados se muestran automáticamente en el idioma de la interfaz seleccionado por el usuario. Sin embargo:
- Personalizar el texto de un enlace predeterminado lo sobrescribe para todos los idiomas.
- Para editar el texto de idiomas específicos o elementos ocultos como “Mis borradores”, sigue las instrucciones de la guía sobre cómo personalizar texto en Discourse.
Manejo de enlaces agregados por plugins
Los enlaces agregados por plugins no se pueden personalizar actualmente a través del editor de la barra lateral. Sin embargo, puedes reemplazarlos con tus propias versiones utilizando el siguiente enfoque:
- Oculta el enlace original agregado por el plugin.
- Agrega un enlace personalizado con el comportamiento y la apariencia que desees.
Algunos enlaces se pueden ocultar en la configuración del plugin. Por ejemplo, el enlace de próximos eventos se puede ocultar desactivando la configuración sidebar_show_upcoming_events.
Si no existe tal configuración, puedes ocultar el enlace usando CSS personalizado.
Ejemplo de CSS para ocultar o mover enlaces de plugins
Ocultar completamente un enlace agregado por un plugin
Este ejemplo oculta el enlace agregado por el plugin ActivityPub:
.sidebar-section-link-wrapper[data-list-item-name="activity-pub-about"] {
display: none;
}
Ocultar un enlace solo del menú “Más”
Útil si estás moviendo un enlace del menú “Más” para que siempre esté visible:
.sidebar-more-section-content
.sidebar-section-link-wrapper.dropdown-menu__item[data-list-item-name="anniversaries"] {
display: none;
}
Ocultar un enlace solo de la sección principal (no en el menú “Más”)
Útil si deseas que el enlace aparezca en el menú “Más” en lugar de estar siempre visible:
.sidebar-section.sidebar-section-wrapper:not(.sidebar-more-section-content)
.sidebar-section-link-wrapper[data-list-item-name="docs"] {
display: none;
}
Para obtener más detalles sobre cómo realizar cambios de CSS en tu sitio, consulta la guía sobre cómo realizar cambios de CSS.
Sección Categorías
Puedes configurar qué categorías aparecen de forma predeterminada en las barras laterales de los usuarios en la configuración del sitio default_navigation_menu_categories. Puedes acceder a ella de la siguiente manera:
- Haz clic en “Configurar valores predeterminados” en la parte inferior de la sección de categorías (solo visible mientras no se configuren valores predeterminados).
- Accede a esta configuración a través de Administración > Todas las configuraciones del sitio y busca la configuración.
La visibilidad de las categorías respeta los permisos de usuario: los usuarios solo verán en su barra lateral las categorías a las que tienen permiso de acceso, incluso si incluyes categorías restringidas en los valores predeterminados. Si configuras solo categorías restringidas como predeterminadas:
- Los visitantes verán una lista vacía.
- Los usuarios registrados verán las categorías más populares (igual que si hubieran deseleccionado todas las categorías).
La opción “Editar categorías de la barra lateral” en el menú junto a “Categorías” personaliza solo tu vista personal, no el valor predeterminado para todos los usuarios.
Sección Etiquetas
Puedes configurar qué etiquetas aparecen de forma predeterminada en las barras laterales de los usuarios en la configuración del sitio default_navigation_menu_tags. Puedes acceder a ella de la siguiente manera:
- Haz clic en “Configurar valores predeterminados” en la parte inferior de la sección de etiquetas (solo visible mientras no se configuren valores predeterminados).
- Accede a esta configuración a través de Administración > Todas las configuraciones del sitio y busca la configuración.
La visibilidad de las etiquetas respeta los permisos de usuario: las etiquetas de un grupo de etiquetas oculto no aparecerán en las barras laterales de los usuarios, incluso si se incluyen en los valores predeterminados. Si configuras solo etiquetas restringidas como predeterminadas:
- Todos los usuarios (incluidos los visitantes) verán las etiquetas más populares (igual que si hubieran deseleccionado todas las etiquetas).
Secciones de chat
Todas las secciones de chat solo están disponibles cuando el chat está habilitado[1], el usuario tiene permiso para usar el chat[2] y no ha deshabilitado el chat en sus preferencias.
Sección de búsqueda de chat
La búsqueda de chat está controlada por la configuración del sitio chat_search_enabled.
Sección de hilos
La sección de hilos solo aparece para usuarios que son miembros de al menos un chat donde los hilos están habilitados.
Sección de canales
La sección de canales muestra los canales de chat a los que el usuario se ha unido. Los usuarios verán esta sección si hay al menos un canal al que podrían unirse según los permisos de categoría. La sección estará vacía hasta que se hayan unido a al menos un canal.
Puedes automatizar la membresía de canales a través de la configuración del canal:
- Habilita la adición automática de miembros en la configuración del canal.
- Los nuevos usuarios que cumplan los criterios verán el canal en su barra lateral automáticamente.
Sección de mensajes directos (MD)
La sección de mensajes directos muestra conversaciones de chat uno a uno y grupales. Para ver esta sección, los usuarios deben pertenecer a alguno de los direct_message_enabled_groups.
No puedes configurar conversaciones predeterminadas para esta sección. En lugar de una sección vacía, los usuarios verán un botón “Iniciar nuevo MD” que reemplaza esta sección.
Agregar una sección personalizada
Puedes crear secciones adicionales en la barra lateral que contengan enlaces personalizados. Estas aparecerán debajo de la primera sección y encima de la sección de categorías. Para agregar una nueva sección:
- Haz clic en el botón + en la parte inferior de la barra lateral.
- Ingresa un título para tu sección.
- Para cada enlace que desees agregar:
- Selecciona un icono.
- Ingresa un nombre para el enlace.
- Especifica la URL de destino.
- Haz clic en “Agregar otro enlace” para agregar más enlaces.
- Marca “Visible para todos” para que esta sección aparezca para todos los usuarios.
- Haz clic en “Guardar” para crear la sección.
El pequeño icono junto al título de una sección personalizada solo es visible para administradores e indica que la sección es visible para todos.
Personalizar etiquetas de texto
Puedes personalizar todas las etiquetas de texto en la barra lateral, incluidos los títulos de las secciones:
- Navega a Administración > Apariencia > Textos del sitio.
- Busca el texto que deseas personalizar.
Dado que muchas etiquetas de la barra lateral utilizan palabras comunes, encontrar la clave de texto específica puede ser complicado. Para ayudar con esto:
- Utiliza la característica de localización detallada para identificar la clave de texto correcta.
Personalizar valores predeterminados de preferencias de usuario
Los usuarios pueden personalizar sus preferencias de barra lateral en /my/preferences/navigation-menu. Puedes establecer los valores predeterminados para estas preferencias utilizando las siguientes configuraciones del sitio:
Enlace predeterminado de la barra lateral a lista filtrada
Esta configuración controla si los enlaces de la barra lateral a listas de temas (incluidos “Todos los temas” y los enlaces en las secciones de Categorías y Etiquetas) conducen a:
- Cuando está habilitado: Listas filtradas para mostrar solo temas no leídos o nuevos.
- Cuando está deshabilitado: Listas que incluyen todos los temas.
Mostrar predeterminado de la barra lateral con recuento de elementos nuevos
La configuración controla cómo se muestran los elementos nuevos en la barra lateral:
modo de barra lateral separado de chat
Cuando está habilitado, se agrega un botón de chat o foro al menú de navegación. Esto permite a los usuarios cambiar entre una experiencia de chat de pantalla completa y la vista del foro de manera más eficiente. En el modo de chat de pantalla completa, solo se muestran en la barra lateral las secciones relacionadas con el chat (como Mis hilos, Canales y MD). Si se establece en “siempre”, las secciones relacionadas con el chat en la barra lateral se ocultan mientras se navega por el foro. Esta configuración ayuda a mantener claramente separadas las experiencias de foro y chat.
Existe una configuración del sitio default_sidebar_switch_panel_position que te permite decidir si el botón de alternancia debe mostrarse en la parte superior o inferior de la barra lateral. Los usuarios no pueden cambiar la posición en sus preferencias.
Personalización adicional
Puedes mejorar aún más la barra lateral en tu foro utilizando componentes de tema. Para explorar las opciones disponibles, busca temas en la categoría #theme-component::category etiquetados con sidebar (enlace). Sin embargo, no todos los componentes tienen un tema en Meta. Algunos también se enlazaron en otros temas.
Los componentes de tema pueden agregar funcionalidad a tu barra lateral. Algunos ejemplos incluyen:
- Cambiar la visibilidad predeterminada de la barra lateral:
- Cerrar la barra lateral de forma predeterminada: GitHub - VaperinaDEV/closed-sidebar-by-default
- Colapsar las secciones de forma predeterminada: GitHub - Arkshine/discourse-collapsed-sidebar- sections-by-default
- Cambiar los iconos de la barra lateral y hacerlos dinámicos: Discourse Dynamic Sidebar Icon
- Cambiar el orden de las secciones de la barra lateral:
- Secciones adicionales de la barra lateral:
- Secciones personalizadas visibles solo para grupos seleccionados: Discourse Group Sidebar Menus
- Sección para mensajes personales para mostrar enlaces directos a bandejas de entrada de grupo: Sección de mensajes para la barra lateral
- Componentes que te permiten mostrar u ocultar secciones específicas para diferentes grupos de usuarios, como visitantes o personal:
- Componentes que indentan subcategorías, como:
Recursos relacionados
- Creating quick access links to Discourse preference pages
- Customize text in Discourse
- Find a translation key with verbose localization