 |
Resumen | Versatile Banner añade un banner personalizable a tu sitio. |
 |
Vista previa | Vista previa en Discourse Theme Creator |
 |
Enlace al repositorio | https://github.com/discourse/discourse-versatile-banner |
 |
¿Nuevo en los temas de Discourse? | Guía para principiantes sobre el uso de temas de Discourse |
Instala este componente de tema
Funcionalidades
Este componente de tema es una evolución de intentos anteriores de crear banners. El objetivo es proporcionar mayor facilidad y flexibilidad mediante el uso de configuraciones del tema.
A continuación se destaca una lista de las funcionalidades:
- Limitar la visualización a usuarios conectados o usuarios anónimos
- Limitar la visualización exclusivamente a dispositivos móviles o de escritorio
- Limitar la visualización a páginas específicas
- Opciones de cierre, colapsar/expandir y siempre visible
- Opción de ancho completo del navegador
- Gestión de colores
- Personalización del título y las columnas usando HTML (ver más abajo)
- Opción de estado persistente (ver más abajo)
Personalización del contenido de tu banner
El contenido del banner se divide en el título principal y las columnas. Puedes tener hasta 5 columnas en tu banner; sin embargo, el número recomendado es de 3 o menos debido a las limitaciones de ancho. Se proporcionan plantillas HTML que se pueden personalizar para satisfacer tus necesidades individuales. También puedes controlar el ancho de cada columna y añadir cualquier imagen o icono de Font Awesome que desees en la parte superior de cada columna.
Uso de la opción de estado persistente
La opción de estado persistente dependerá de hasta dos cookies. Estas cookies contendrán un nombre para el banner y un valor verdadero/falso relacionado con el estado del banner. Si tienes alguna preocupación sobre el uso de cookies en tu sitio, lo mejor es evitar usar esta configuración. Elegir una opción de tiempo relativa para la configuración cookie_lifespan asegurará que el banner permanezca cerrado/expandido/colapsado durante ese período de tiempo después de que el usuario presione el botón correspondiente. Sin esta configuración, el banner se restablece con cada carga completa de la página. Si realizas un cambio en el banner y quieres asegurarte de que todos los usuarios vean esos cambios, incluso aquellos que habían cerrado previamente el banner, asegúrate de cambiar el “nombre de la cookie”. Esto esencialmente restablecerá cualquier estado persistente, permitiendo luego al usuario cerrar el banner nuevamente.
Configuraciones
| Nombre | Descripción |
|---|---|
| mostrar para miembros | Mostrar el banner para usuarios conectados al foro |
| mostrar para anónimos | Mostrar el banner para usuarios anónimos |
| mostrar en móvil | Mostrar el banner en dispositivos móviles |
| mostrar en escritorio | Mostrar el banner en computadoras de escritorio |
| mostrar en la página principal | Mostrar el banner en la página principal |
| la url debe contener | Introduce rutas que deben mostrar el banner. Añade * al final de la ruta como comodín |
| cerrable | Permitir que los usuarios cierren el banner |
| colapsable | Permitir que los usuarios expandan y colapsen el banner |
| estado colapsado por defecto | Estado colapsado por defecto cuando la configuración de colapsable está habilitada |
| duración de la cookie | La duración de la cookie utilizada para recordar si el banner ha sido cerrado, expandido o colapsado. Si se establece en “none” (ninguna), NO se usarán cookies con este componente, y cualquier cookie creada previamente relacionada con el banner se eliminará la próxima vez que un usuario realice una carga completa de la página. Los valores se miden como una unidad única, por lo que configurar “year” (año) será un año, “week” (semana) será una semana, etc. |
| nombre de la cookie | Cuando se realizan cambios importantes en el banner, debes cambiar el nombre de la cookie para asegurar que todos tus usuarios vean los cambios. |
| banner de ancho completo | Mostrar el banner a todo el ancho del navegador |
| intercambiar posicionamiento por defecto | Si hay otro componente relacionado con banners activo, usa esto para intercambiar su posición con Versatile Banner |
| salida del plugin | below-site-header lo pone encima de la barra lateral, above-main-container lo pone encima del contenido al lado de la barra lateral |
| imagen de fondo del banner | La url de origen para tu imagen de fondo. Consejo: Puedes subir una imagen a tu tema principal y usar la url de esa, pero asegúrate de no usar la sección “Uploads” de este componente. Cualquier subida añadida a este componente se eliminará cada vez que se actualice. |
| imagen de fondo del banner oscuro | La url de origen para tu imagen de fondo cuando se detecta el modo oscuro del sistema. |
| color de fondo | Se usa en lugar de una imagen de fondo |
| color de fondo oscuro | Se usa en lugar de una imagen de fondo cuando se detecta el modo oscuro del sistema. |
| color de texto principal | El color principal del texto del banner |
| color de texto principal oscuro | El color principal del texto del banner cuando se detecta el modo oscuro del sistema |
| color de texto secundario | El color del texto de los iconos y los títulos de texto, y el color de fondo de los botones. |
| color de texto secundario oscuro | El color del texto de los iconos y los títulos de texto, y el color de fondo de los botones cuando se detecta el modo oscuro del sistema. |
| color del texto de los enlaces | El color del texto de los enlaces dentro del banner |
| color del texto de los enlaces oscuro | El color del texto de los enlaces dentro del banner cuando se detecta el modo oscuro del sistema. |
| Traducción | Valor por defecto |
|---|---|
| close.title | Cerrar el banner |
| close.label | Cerrar |
| toggle.title | Expandir/Colapsar el banner |
| toggle.collapse_label | Colapsar |
| toggle.expand_label | Expandir |
¿Alojado por nosotros? Los componentes de tema están disponibles para usar en nuestros planes Pro, Business y Enterprise.
¿Alojado por nosotros? Los componentes de tema están disponibles para usar en nuestros planes Pro, Business y Enterprise.