Shortcodes del front-end
Fenómenus registra un pequeño conjunto de shortcodes que usan las plantillas de archivo y que están disponibles en cualquier parte del front-end.
Los shortcodes
| Shortcode | Salida |
|---|---|
[category_nav] |
La navegación de categorías del archivo del menú actual |
[allergens_filter] |
El formulario de filtro de alérgenos |
[allergens_list] |
La biblioteca de alérgenos, con el interruptor de visibilidad y el panel de información |
[post_allergens] |
Los iconos de alérgenos de un elemento |
[favorite_posts] |
Los elementos guardados del invitado |
[langswitcher] |
Un selector de idioma |
[current_post_type_plural] |
La etiqueta en plural del tipo de menú actual |
[active_post_type_columns] |
Una cuadrícula de tarjetas que enlaza a los menús habilitados |
[category_nav]
Muestra la navegación del contexto actual: un archivo de menú o un archivo de categoría.
| Atributo | Valor predeterminado | Efecto |
|---|---|---|
show_subnav |
true |
Si se muestran las subsecciones de la categoría actual |
Todo lo demás proviene de los ajustes: el modo plano/anidado y los interruptores de utilidades son por tipo de menú. La navegación no devuelve nada cuando no hay contexto, no hay términos o solo hay un único término.
También se inyecta automáticamente en las plantillas de archivo que aún no la contienen, por lo que añadirla manualmente solo es necesario en marcado personalizado.
[allergens_filter]
Muestra las etiquetas de alérgenos seleccionables y la acción Filter. No genera nada fuera de un archivo de menú cuyo tipo de contenido contenga información de alérgenos.
Aplicar el filtro establece una cookie de 30 días y recarga el archivo con el parámetro de consulta a_la_carte_allergens.
[allergens_list]
Muestra la biblioteca de alérgenos.
| Atributo | Valor predeterminado | Efecto |
|---|---|---|
show_toggle |
yes |
Muestra el interruptor Show allergens in dishes |
toggle_default |
on |
El estado inicial del interruptor para un invitado sin preferencia guardada |
Fuera de un archivo compatible, muestra una línea breve que invita a los invitados a preguntar al personal por los alérgenos.
[post_allergens]
| Atributo | Valor predeterminado | Efecto |
|---|---|---|
post_id |
Entrada actual | El elemento cuyos alérgenos se muestran |
No devuelve nada cuando el elemento no tiene alérgenos.
[favorite_posts]
Muestra los elementos guardados del invitado, agrupados por tipo de menú y sección. La colección vive en el navegador del invitado; el shortcode muestra lo que contenga ese dispositivo.
Nada de la colección se almacena en el servidor, por lo que no hay datos que leer desde una integración.
[current_post_type_plural]
Devuelve la etiqueta en plural del tipo de menú actual —útil para títulos que deben seguir a un menú renombrado.
[active_post_type_columns]
Una cuadrícula de tarjetas que enlaza a los menús habilitados, pensada para una página de inicio.
| Atributo | Efecto |
|---|---|
show_<post_type> |
Incluir o excluir un tipo de menú específico |
add_home_link |
Incluir una tarjeta de inicio |
add_lang_switcher |
Incluir un selector de idioma en la fila superior |
link_target |
category_archive (predeterminado) o el archivo del tipo de entrada |
extra_link_url, extra_link_label, extra_link_background_image |
Una tarjeta personalizada adicional |
El link_target predeterminado es category_archive, porque un tipo de menú no publica necesariamente un archivo propio.
Guía
- Usa
[category_nav]en lugar de construir la navegación a partir de los términos: reproduce el orden, el ajuste plano/anidado y los interruptores de utilidades. - Espera una salida vacía. Todos estos no devuelven nada cuando falta su contexto.
- No uses
[allergens_list]como sustituto de los datos de alérgenos por elemento; muestra la biblioteca, no un plato.