Componente de encabezados de categorías de Discourse

Este componente de tema ofrece varias mejoras para el encabezado de categoría de Discourse.

El encabezado de categoría ‘estándar’ de Discourse se muestra en la parte superior de cada página de categoría, encima de los enlaces de navegación y la lista de temas. Normalmente solo es visible si se ha subido una imagen de logotipo de categoría en la configuración de la categoría. El encabezado muestra el logotipo y una breve descripción de la categoría, tomada del primer párrafo del tema ‘Acerca de la… categoría’.

Este componente de tema ofrece las siguientes mejoras

El encabezado de categoría ahora se muestra de forma predeterminada para todas las categorías. Ahora incluye el nombre de la categoría además del logotipo (si está configurado) y la descripción de la categoría. También puede incluir una imagen de fondo para el logotipo y puede estilarse para mostrarse como una ‘caja’ o un ‘banner’, utilizando la configuración de color de la categoría. Hay una amplia gama de opciones configurables en la configuración del tema.

Configuración del tema

  • mostrar nombre de categoría: Mostrar el nombre de la categoría en el encabezado
  • mostrar descripción de categoría: Mostrar el texto de descripción de la categoría (el primer párrafo del tema “Acerca de esta categoría”)
  • tamaño del texto de descripción: Tamaño del texto dentro de la descripción de la categoría
  • alineación del texto: Alineación del texto dentro del encabezado de la categoría
  • mostrar encabezado de subcategoría: Mostrar encabezado para subcategorías
  • mostrar nombre de categoría principal: Añadir el nombre de la categoría principal como prefijo en los encabezados de subcategoría (esto actúa como un enlace de ruta de navegación hacia la página de la categoría principal)
  • mostrar icono de candado: Mostrar el icono de candado en las categorías protegidas por permisos
  • mostrar logotipo de categoría: Mostrar la imagen del logotipo de la categoría dentro del encabezado
  • mostrar logotipo de categoría principal: Mostrar el logotipo de la categoría principal cuando no se ha configurado un logotipo de subcategoría
  • mostrar logotipo del sitio: Mostrar el pequeño logotipo del sitio si no se ha configurado un logotipo de categoría
  • posición del logotipo: Posición del logotipo dentro de la caja
    – ‘izquierda’ y ‘derecha’ muestran el logotipo en línea con el texto.
    – ‘arriba’ muestra el logotipo encima, alineado con el texto
  • tamaño del logotipo: Tamaño del logotipo dentro del encabezado.
    – Pequeño: 50px de alto, similar al logotipo de una caja de subcategoría.
    – Estándar: 150px de alto.
    – Original: el tamaño de la imagen subida
  • stilo del encabezado: Establecer el estilo del encabezado en:
    – Caja: el encabezado de categoría se muestra con el mismo estilo que las cajas estándar de Discourse
    – Banner: establecer el fondo del encabezado con el color de fondo de la categoría y el texto con el color de primer plano
    – Ninguno: sin borde ni estilo de fondo
  • imagen de fondo del encabezado: Se aplica si has subido una imagen de fondo de categoría
    – ‘contain’, ‘cover’ y ‘resize’ muestran el fondo dentro del encabezado.
    – ‘outside’ es la configuración predeterminada de Discourse, que lo muestra fuera del encabezado, sobre toda la página.
  • mostrar en móvil: Mostrar encabezado de categoría en dispositivos móviles
  • forzar alineación en móvil: Forzar la alineación en móviles del logotipo y texto hacia el centro superior del encabezado
  • ocultar si no hay descripción de categoría: Ocultar el encabezado si no se ha establecido la descripción de la categoría
  • ocultar excepciones de categoría: Los encabezados no se mostrarán para estas categorías

Instalar el componente de tema

:hammer_and_wrench: Repositorio Git: https://github.com/naidihr/discourse-category-headers

:thinking: ¿Cómo instalo un tema o un componente de tema?

Créditos

Gracias a @Johani por su excelente Guía del desarrollador para temas de Discourse
Este componente de tema fue inspirado por otros temas, especialmente el tema Banners de categorías de Discourse de @awesomerobot

Ejemplos

Estilo caja: El encabezado de categoría se muestra con el mismo estilo que las cajas de subcategoría

Subcategoría, observa que la subcategoría no tiene logotipo pero está configurada para heredar el logotipo de la categoría principal. El nombre de la categoría principal también está configurado para mostrarse como un enlace de ruta de navegación.

Si la subcategoría tiene su propio logotipo, lo mostrará en su lugar.

Vista móvil mostrando una alineación diferente de texto e icono.

Configuraciones de tamaño de texto.



Ejemplo de opciones de alineación: texto centrado, logotipo a la derecha.

Estilo banner: Usa los colores de fondo y primer plano de la categoría

Imagen de fondo: Usa la imagen de fondo de la categoría

82 Me gusta

La gran variedad de opciones hace que esto sea realmente flexible, ¡se ve genial!

21 Me gusta

¡Esto es un trabajo increíble! :clinking_beer_mugs::smiling_face_with_sunglasses::+1:

5 Me gusta

Esto se ve excelente.

3 Me gusta

Rhidian, ¿podrías compartir tu configuración para que las categorías aparezcan en formato de cuadrícula como en la captura de pantalla que compartiste? (enlace a continuación)

He instalado este componente del tema y solo puedo ver encabezados de tipo “caja” en la parte superior de cada página de categoría. ¡Gracias!

3 Me gusta

De hecho, creo que lo resolví. :slight_smile: Me faltaba lo siguiente bajo Configuración:

Screen Shot 2020-07-08 at 1.23.35 PM

5 Me gusta

¡Genial @labrumfield :grin:! Gracias por compartir la respuesta también; sospecho que será útil para otros también. Espero que el componente de tema funcione bien para ti.

1 me gusta

¿Sabes por casualidad si hay alguna forma de previsualizar esta configuración de Cuadros con subcategorías con un nuevo tema sin publicarlo?

No estoy seguro de a qué te refieres con vista previa. Puedes previsualizar temas y componentes de temas en la configuración de administración de personalización.

Idealmente, me gustaría poder previsualizar la configuración ‘Cajas con subcategorías’ sin publicarla. O bien, si existe alguna forma de asociar esta configuración solo con tu componente de tema y no con otros temas o componentes de tema.

No creo que haya una manera de hacerlo, pero solo quería ver si alguien tenía alguna idea. ¡Gracias!

Las cajas con la configuración de subcategoría no forman parte de este componente. Se trata de una configuración de categoría de Discourse.

No puedes ‘previsualizarla’, pero puedes activarla temporalmente para ver cómo queda. Las configuraciones de categoría sirven para mostrar las subcategorías como filas o cajas.

2 Me gusta

Hola,

Acabo de cambiar una configuración de categoría y los encabezados de las categorías se han desordenado un poco. (ver imagen)

La configuración que se modificó fue el Estilo de lista de subcategorías, que pasó de “Cajas” a “Cajas con temas destacados”. No creo que se haya cambiado ninguna otra configuración. ¿Tienes alguna idea sobre cómo devolver el banner a la parte superior en lugar de dejarlo como una caja en la esquina superior izquierda?

Además, cuando cambio la configuración de nuevo a “Cajas”, no vuelve a la normalidad.

Muchísimas gracias. Este es un componente realmente, realmente, realmente agradable.

Probé mi suerte e intenté incluir un video de YouTube y un podcast de SoundCloud, pero, lamentablemente, no se mostraron en el cuadro de categoría.

Sería una forma increíble de dar a las personas una introducción sobre de qué trata la categoría si pudiera elegir entre imagen y/o video y/o audio. Podría hacer un breve video de introducción para cada categoría en lugar de una imagen. De esta manera, un miembro potencial podría obtener una visión general a partir de un pequeño texto, ver un video con una introducción sobre de qué trata la categoría y escuchar una versión de audio o un podcast de introducción si esa es su preferencia.

Pero muchas gracias por tu trabajo y contribución.

1 me gusta

¿Cuáles son las mejores dimensiones y opciones para hacer un banner adaptable? ¿Quizás necesito revisar otro componente?

Creo que sería genial mostrar la información de la categoría con un buen diseño.

Gracias por ese módulo. Es increíble.

1 me gusta

Los banners utilizan las plantillas responsivas estándar de Discourse, por lo que deberían redimensionarse automáticamente para tu dispositivo.

1 me gusta

Bueno, veo que la configuración de ajuste automático no funciona bien para el ancho completo del banner en dispositivos de escritorio y móviles.

¿Tienes algún ejemplo de ello? Quizás pueda hacerlo desde CSS, usando algunas consultas de medios, pero podría ser útil para todos. O tal vez me estoy perdiendo algo en mi configuración.

Gracias por tu respuesta, Rhidian.

Hola,

Estoy usando vuestro brillante componente de tema, pero sin importar qué ajustes haga, nada cambia en el diseño. La descripción no se muestra y, si muevo el logotipo entre arriba, izquierda o derecha, no se ven los efectos.

¿Qué me estoy perdiendo, por favor?

¿Alguien está monitoreando este tema todavía, o este componente de tema ya no se mantiene?

No ha habido ningún cambio en el componente. En estos casos, es probable que sea otro componente el que interactúe con él. Te sugiero desactivar los componentes uno por uno para ver si puedes identificarlo. Si lo logras, por favor avísanos.

2 Me gusta

El enlace en la descripción de mi categoría se muestra como código normal debido a la regla CSS a,a:visited {color: inherit;} en component.css.

¿Es este el resultado esperado?