 |
Resumen | Versatile Banner agrega 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 |
Instalar este componente del tema
Características
Este componente del tema es una evolución de los esfuerzos anteriores con banners. El objetivo es proporcionar mayor facilidad y flexibilidad mediante el uso de configuraciones del tema.
A continuación se destacan las características:
- Limitar la visualización a usuarios registrados o anónimos
- Limitar la visualización exclusivamente a móviles o escritorio
- Limitar la visualización a páginas específicas
- Opciones desechables, expandibles y siempre visibles
- Opción de ancho completo del navegador
- Gestión de colores
- Personalización de encabezados y columnas usando HTML (ver más abajo)
- Opción de estado persistente (ver más abajo)
Personalizar el contenido de tu banner
El contenido del banner se divide en el encabezado principal y las columnas. Puedes tener hasta 5 columnas en tu banner, sin embargo, se recomienda 3 o menos debido a las limitaciones de ancho. Se proporcionan plantillas HTML que pueden personalizarse para satisfacer tus necesidades individuales. También puedes controlar el ancho de cada columna y agregar cualquier imagen o icono de Font Awesome que desees en la parte superior de cada columna.
Usar 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 relativo 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 reinicia 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 reiniciará cualquier estado persistente y permitirá que el usuario cierre el banner una vez más.
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 página de inicio | Mostrar el banner en la página de inicio |
| la URL debe contener | Ingresa las rutas que deben mostrar el banner. Agrega * al final de la ruta como un comodín |
| desechable | Permitir que los usuarios cierren el banner |
| colapsable | Permitir que los usuarios expandan y colapsen el banner |
| estado colapsado predeterminado | Estado colapsado predeterminado cuando la configuración colapsable está habilitada |
| vida útil de la cookie | La vida útil de la cookie utilizada para recordar si el banner ha sido cerrado, expandido o colapsado. Si se establece en “ninguna”, NO se usarán cookies con este componente, y cualquier cookie relacionada con el banner creada anteriormente se eliminará la próxima vez que un usuario realice una carga completa de la página. Los valores se miden como una sola unidad, por lo que establecer “año” será un año, “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 asegurarte de que todos tus usuarios vean los cambios. |
| banner de ancho completo | Mostrar el banner con el ancho completo del navegador |
| intercambiar posición predeterminada | 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 coloca encima de la barra lateral, above-main-container lo coloca 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 “Subidas” de este componente. Cualquier carga agregada 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 de texto principal del banner |
| color de texto principal oscuro | El color de texto principal del banner cuando se detecta el modo oscuro del sistema |
| color de texto secundario | El color de texto del icono y los encabezados de texto, y el color de fondo del botón. |
| color de texto secundario oscuro | El color de texto del icono y los encabezados de texto, y el color de fondo del botón cuando se detecta el modo oscuro del sistema. |
| color de texto de enlace | El color de texto de los enlaces dentro del banner |
| color de texto de enlace oscuro | El color de texto de los enlaces dentro del banner cuando se detecta el modo oscuro del sistema. |
| Traducción | Predeterminado |
|---|---|
| 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.