Enlaces destacados del banner

:information_source: Resumen Banner Featured Links te permite crear un banner de enlaces.
:eyeglasses: Vista previa Theme Creator
:hammer_and_wrench: Repositorio GitHub - Arkshine/discourse-banner-featured-links · GitHub
:question: Guía de instalación Cómo instalar un tema o un componente de tema
:open_book: ¿Nuevo en los temas de Discourse? Guía para principiantes sobre el uso de los temas de Discourse

Instalar este componente de tema

Resumen

Banner Featured Links te permite crear un banner de enlaces.
Ofrece una amplia gama de opciones de personalización.

Es una función inspirada en el fantástico tema de Discourse “Meta Branded”.

Características

La apariencia predeterminada: utiliza el color del tema.
image

El botón se puede estilizar por separado:
image

Puedes colocar los enlaces en varios lugares mediante la configuración plugin outlet.
En la descripción se proporciona una lista de ubicaciones comunes.

:information_source: ¡Recomiendo usar el componente de tema Developer Toolbar para ver dónde se encuentran los plugin outlets!

Por ejemplo, si quieres imitar el tema Meta Brand, usa el outlet search-banner-below-input. Esto asume que has instalado el componente Search Banner.

Detalles

El estilo actual se puede lograr con la siguiente configuración:

¡Te animo a que pruebes tu propio estilo!

Configuración

General

Nombre Descripción
links Enlaces de texto que se mostrarán en la cabecera.
show_for_members Mostrar los enlaces para los usuarios conectados.
show_for_anon Mostrar los enlaces para los usuarios anónimos.
display_on_mobile Mostrar los enlaces en dispositivos móviles.
display_on_desktop Mostrar los enlaces en ordenadores de escritorio.
display on homepage Mostrar los enlaces en la página de inicio.
url must contain Introduce las rutas que deben mostrar el banner. Añade * al final de la ruta como comodín.
plugin outlet La ubicación donde se mostrarán los enlaces.
Ubicaciones comunesabove-main-containerabove-site-headerafter-headerbefore-header-panelbefore-list-areabefore-topic-listbelow-site-headerheader-list-container-bottomtopic-above-post-stream
Componente Search Banner:
search-banner-below-headlinesearch-banner-below-input

Configuración links:

Nombre Descripción
Icono El icono de FontAwesome o el emoji que se mostrará para los enlaces.
Atajos
Windows: Win + ..
Mac: Cmd + Ctrl + Space
ChromeOS: Launch + Shift + Space
Título El título del enlace.
URL La URL a la que enlazar.
Target Abre el documento enlazado:
_blank: en una nueva ventana o pestaña (este es el predeterminado)
_self: en el mismo marco en el que se hizo clic
_parent: en el marco padre
_top: en el cuerpo completo de la ventana.

También puedes estilizar por botón. Esto sobrescribirá el estilo global.

Nombre Descripción
Ancho El ancho del botón.
Fuente La fuente del botón.
Redondeo La cantidad de redondeo que se aplicará al botón.
Fondo El color de fondo del botón.
Fondo al pasar el ratón` El color de fondo del botón al pasar el ratón.
Color` El color del texto del botón.
Color al pasar el ratón` El color del texto del botón al pasar el ratón.
Borde El borde del botón.
Borde al pasar el ratón El borde del botón al pasar el ratón.
Sombra La sombra del botón.
Nombre de clase CSS Una clase CSS personalizada que se aplicará al botón.
Útil si quieres estilizar el botón de forma diferente y la configuración no es suficiente.
Puedes dirigirla con .banner-featured-links__link.tu-clase {}

Estilizado global

Personaliza el espaciado y la apariencia predeterminados de los enlaces.
Puedes sobrescribir el estilo de cada botón individualmente.

Estilizado del contenedor de botones

Personaliza el contenedor de los enlaces.

Nombre Descripción
ancho máximo del contenedor de botones El ancho máximo del contenedor de botones.
margen del contenedor de botones El margen del contenedor de botones.
ancho máximo del contenedor de botones en móviles El ancho máximo del contenedor de botones en móviles.
margen del contenedor de botones en móviles El margen del contenedor de botones en móviles.

Espaciado de botones y fuente de texto

Personaliza el espaciado de los botones y el tamaño de fuente del texto.

Nombre Descripción
justificación de botones Cómo distribuir el espacio entre y alrededor de los enlaces.
hueco entre botones El hueco entre los botones.
fuente de botones La fuente de los botones.
justificación de botones en móviles Cómo distribuir el espacio entre y alrededor de los enlaces en móviles.
hueco entre botones en móviles El hueco entre los botones en móviles.
dirección de botones en móviles La dirección de los botones en móviles.
fuente de botones en móviles La fuente de los botones en móviles.

Estilizado de botones

Personaliza la apariencia predeterminada de los botones.

Nombre Descripción
ancho del botón El ancho del botón.
relleno del botón El relleno del botón.
redondeo del botón La cantidad de redondeo que se aplicará al botón.
fondo del botón El color de fondo del botón.
fondo del botón al pasar el ratón El color de fondo del botón al pasar el ratón.
color del botón El color del texto del botón.
color del botón al pasar el ratón El color del texto del botón al pasar el ratón.
borde del botón El borde del botón.
borde del botón al pasar el ratón El borde del botón al pasar el ratón.
sombra del botón La sombra del botón.

Personalización avanzada

Puedes usar el siguiente CSS para personalizar aún más:

.banner-featured-links {
  &__wrapper {

  }

  &__wrapper-links {

  }

  &__link {

  }
}

Si proporcionas una personalización por botón, puedes especificar un nombre de clase en la configuración CSS Classname.

Luego, puedes dirigirla de esta manera:

.banner-featured-links {
  &__link.mi-clase {

  }
}

Enlaces útiles

Créditos

  • Discourse por la idea, inspirada en el increíble tema Meta Branded.
  • Don y nolo – Ellos crearon una versión inicial; tomé algunas de sus ideas.
20 Me gusta

Un comentario meta para mejorar una introducción de componente de buena calidad: una captura de pantalla de un móvil. Ahorraría tiempo al elegir entre utilidad, pros y contras.

3 Me gusta

¿Se inspiró en el tema Meta Branded?

Creo que sí :wink:

3 Me gusta

Debí haberlo leído por encima, estaba mirando la sección de ‘Créditos’ :laughing:

3 Me gusta

No te preocupes. He actualizado la sección de créditos para que quede más clara. ¡Gracias!

3 Me gusta

Hice un pequeño arreglo si instalaste el componente por primera vez. :+1:
Mi último commit renombró una configuración, pero los valores predeterminados no se actualizaron.
¡Gracias a @manuel por reportar el problema!

5 Me gusta

Hola @Arkshine, ¡muchas gracias por este plugin!

Lo he estado usando por un tiempo, pero después de agregar otro botón hoy, rompió todo el foro, así que ahora se ve así:

¿Sabes por qué podría suceder esto?

2 Me gusta

Oye, ¿eso significa que si quitas este botón, no se rompe?

Bueno, tuve que contactar al equipo de Discourse para deshabilitar el plugin, así que todo ha vuelto a la normalidad, sí.

Ahora dudo en restaurar la configuración anterior para probar la teoría :sweat_smile:

2 Me gusta

Entendido, no te preocupes. ¡Lamento lo sucedido! Eres el primero en tener este problema.
¿Todavía recuerdas los valores que ingresaste para el botón? Si puedo reproducirlo, ¡sería de gran ayuda!

3 Me gusta

Claro, ¡muchas gracias por tu ayuda!

Esto es realmente extraño, porque hice cambios no hace mucho y funcionó perfectamente.
Eliminé uno de los botones y agregué el nuevo:

Aquí están los registros, por si sirven

[{“url”:“Topics tagged new-widget Widgets”,“target”:“_self”,“button_color_hover”:“#197bff”},{“url”:“Topics tagged In-Progress Progreso”,“target”:“_self”,“button_color_hover”:“#197bff”},{“url”:“CSS Codes - Elfsight Community CSS”,“target”:“_self”,“button_color_hover”:“#197bff”},{“url”:“Ask the Community - Elfsight Community Mensuales”,“target”:“_self”},{“icon”:“:trophy:”,“text”:"¡Únete a nuestro Programa de Campeones! ",“url”:“Elfsight Champion Program: Help us grow our community forum! - Announcements - Elfsight Community”}]

Anterior: [{“url”=>“Topics tagged new-widget”, “icon”=>“:fire:”, “text”=>“Nuevos Widgets”, “target”=>“_self”, “button_color_hover”=>“#197bff”}, {“url”=>“Topics tagged In-Progress”, “icon”=>“”, “text”=>“En Progreso”, “target”=>“_self”, “button_color_hover”=>“#197bff”}, {“url”=>“CSS Codes - Elfsight Community”, “icon”=>“”, “text”=>“Códigos CSS”, “target”=>“_self”, “button_color_hover”=>“#197bff”}, {“url”=>“Ask the Community - Elfsight Community”, “icon”=>“”, “text”=>“Soporte”, “target”=>“_self”, “button_color_hover”=>“#197bff”}, {“url”=>“Elfsight Champion Program: Help us grow our community forum! - Announcements - Elfsight Community”, “icon”=>“:trophy:”, “text”=>“¡Únete a nuestro Programa de Campeones! “, “target”=>”_self”}]

3 Me gusta

Gracias a la ayuda de @Helga_Razinkova en PM, pude reproducir el problema.
Empujé una solución :+1:.

En resumen, el componente no esperaba que la configuración se actualizara a través del Editor de configuración y, con un campo icon faltante, ocurrió un error.

2 Me gusta

¡Esto es brillante! Es tan completo y personalizable; parece que has pensado en casi todo.

He notado un pequeño error donde los iconos no son visibles en ocasiones.

Así es como se ven mis enlaces:
image

Esto es lo que sucede cuando:

  1. Usas Chrome (no he probado otros navegadores, lo siento)
  2. Te alejas de una página con los enlaces destacados del banner
  3. Regresas a la página usando el botón ‘Atrás’ del navegador

image

Puedes demostrarlo tú mismo en ehealthforum.nz

4 Me gusta

¡Gracias Nathan! He enviado una corrección. ¡Avísame si todavía sucede!

4 Me gusta

¡¡¡Maravilloso!!! Todo arreglado.

Tengo otro error menor (pero desconcertante) de UX:

El texto de los botones todavía es capturado por la pseudo-clase :visited, lo que significa que el color del texto se comporta de manera extraña al pasar el cursor una vez que cada enlace ha sido visitado.

Esto es sin pasar el cursor:

image

Esto es al pasar el cursor antes de visitar (tanto el icono como el texto cambian)
image

Esto es al pasar el cursor después de visitar (nota que el icono cambia pero no el texto)
image

3 Me gusta

@nathank ¿Puedes intentar actualizar y ver si mejora?

2 Me gusta

Eso fue con una instancia actualizada. Hubo una pequeña PR en el Search Banner, pero ninguna en este TC para aplicar. A pesar de eso, hice una reconstrucción. ¡Todavía está ahí!

No aparece en incógnito, supongo que porque no guarda mi estado de visitado.

4 Me gusta

¿Es esto compatible con el tema AIR para que sirva en la parte superior de la página de la comunidad con botones que enlacen a WordPress?

Intentando colocar esto debajo de la barra de búsqueda (como en este sitio) usando ‘search-banner-below-input’ para el “Plugin outlet” – fui y vine con la IA y me explicó que ahora, debido a que la búsqueda es central y no una extensión, esa ubicación no funcionará. Solo me pregunto si eso es correcto.

1 me gusta