Dar soporte a los switches de diseño
La sección Display options permite a los tenants activar o desactivar elementos comunes de la tarjeta de producto y del panel de búsqueda desde el panel, sin tocar ninguna plantilla —pero eso solo funciona si el markup de tu template set realmente reacciona al interruptor. Una plantilla personalizada que fija un elemento a fuego lo muestra siempre, sin importar lo que diga el interruptor.
Para dar soporte a un switch, envuelve el markup correspondiente en un bloque {{#flag}}...{{/flag}} usando los nombres de flag de abajo. Si un elemento concreto no tiene sitio en tu diseño, simplemente puedes omitirlo del markup por completo —no hay nada que configurar, el interruptor sencillamente no tendrá nada sobre lo que actuar.
Flags de la tarjeta de producto
Se usan en card.html:
| Flag | Controla |
|---|---|
show_brand |
El elemento de marca. |
show_discount |
La insignia de descuento. Solo se renderiza cuando hay un descuento activo que mostrar —ver Condicionales avanzados. |
show_add_to_cart |
El botón de añadir al carrito. |
show_price |
El o los elementos de precio. |
show_image |
La miniatura del producto. |
open_in_new_tab |
No es un flag de visibilidad —controla los atributos target="_blank" rel="noopener" del enlace de la tarjeta. |
Ejemplo de visibilidad:
{{#show_image}}<img src="{{image}}" alt="{{title}}">{{/show_image}}
Ejemplo a nivel de atributo:
<a href="{{link}}" {{#open_in_new_tab}}target="_blank" rel="noopener"{{/open_in_new_tab}}>...</a>
Flags del panel de búsqueda
Se usan en layout.html:
| Flag | Controla |
|---|---|
show_recent_searches |
La barra de búsquedas recientes. |
show_voice_search |
El botón de búsqueda por voz. |
show_results_count |
La línea "N resultados". |
show_usual_searches |
La fila de búsquedas populares. |
Estos solo hacen algo si tu layout.html también incluye el hook correspondiente que busca el widget —envolver un flag alrededor de markup que no existe no tiene ningún efecto.
| Flag | Necesita este hook en tu markup |
|---|---|
show_recent_searches |
Un elemento con data-ss-recent |
show_voice_search |
Un botón con data-ss-mic |
show_results_count |
Un elemento con data-ss-meta |
show_usual_searches |
Un elemento con data-ss-usual |
{{#show_voice_search}}<button type="button" data-ss-mic aria-label="{{t_voice_search}}">🎤</button>{{/show_voice_search}}