Shortcode web_wishlist
El shortcode web_wishlist muestra una lista de productos pública compartida. No muestra la pantalla de gestión de listas de Mi cuenta del cliente actual ni la lista de publicaciones favoritas propiedad del navegador.
Uso
[web_wishlist]
Atributos
| Atributo | Valor predeterminado | Valores aceptados | Propósito |
|---|---|---|---|
el_class |
— | Cadena salvo que se indique lo contrario | Añade una o más clases CSS personalizadas al elemento exterior. |
el_id |
— | ID HTML único | Ancla opcional en el contenedor. |
show_title |
yes |
yes, no |
Muestra u oculta el título de la lista. |
title_tag |
h3 |
h2–h6 |
Nivel de título semántico; se conserva la apariencia H3 existente. |
button_label |
«Ver producto» traducido | Texto sin formato, hasta 500 caracteres | Etiqueta del enlace a la página del producto; no es una acción de carrito. |
empty_message |
Mensaje de lista vacía traducido | Texto sin formato, hasta 500 caracteres | Se muestra cuando ningún producto guardado es actualmente público y visible. |
unavailable_message |
Mensaje de no encontrado traducido | Texto sin formato, hasta 500 caracteres | Respuesta idéntica para listas inexistentes, privadas y no disponibles. |
device_visibility |
— | Lista separada por comas de web-hide-on-lg, web-hide-on-md, web-hide-on-sm, web-hide-on-xs |
Oculta la vista en los rangos de dispositivo seleccionados. |
Contexto de URL requerido
El shortcode lee el token público de la lista de deseos del parámetro de consulta list:
https://example.com/wishlist/?list=PUBLIC_TOKEN
Muestra únicamente una lista de deseos explícitamente pública, publicada y sin proteger que coincida con el token (que distingue mayúsculas de minúsculas). Las listas inexistentes, desconocidas, ambiguas, no publicadas o privadas producen la misma notificación pública, sin exponer el título de la lista.
Requisito de WooCommerce
Esta salida requiere que WooCommerce y la función de comercio electrónico POM Theme correspondiente estén activas y configuradas.
El shortcode permanece registrado con la administración de Legacy Page Builder desactivada. Los productos deben estar actualmente publicados, sin proteger, permitidos y visibles en WooCommerce. Las variaciones seleccionadas conservan su destino y también requieren un producto padre público visible y una variación habilitada. Los precios y el estado de existencias se leen en el momento de la renderización. Los productos no disponibles se omiten sin modificar la lista guardada.
La vista pública acepta listas guardadas completas, cargando los datos de los productos por lotes. Las listas ilegibles producen el mensaje de no disponible. Una lista accesible vacía utiliza el mensaje de lista vacía.
Coloca el shortcode una sola vez en la página que utilizan las URL de compartir generadas. Excluye esa página y sus URL de consulta list de la caché de página completa/CDN, en lugar de limitarte a variar una respuesta en caché por token. Las cabeceras no-cache del renderizador no pueden reparar las respuestas servidas antes de que WordPress se ejecute.
La tabla pública reutiliza los estilos existentes del tema/WooCommerce y no solicita un script de gestión de listas de deseos. Los controles reales de Mi cuenta y de la página de producto conservan ese script. El bloque Gutenberg Wishlist comparte el mismo renderizador y las mismas opciones.
Verificación
Prueba un enlace público, un token no válido, una lista privada, una lista vacía y una variación seleccionada sin haber iniciado sesión. Cambia la lista pública a privada y verifica la eliminación inmediata de su título y sus productos. Comprueba los precios actuales, las existencias, la presentación adaptable y los destinos de las páginas de producto.
Consulta la guía del bloque Wishlist y la configuración de listas de deseos del cliente.