Shortcode web_previously_purchased
Muestra los productos aptos de los pedidos recientes pagados de WooCommerce del cliente actual. El shortcode y el bloque Previously Purchased comparten su renderizador y el comportamiento existente del carrito.
Uso
[web_previously_purchased title="Order again" limit="10" guest_message="Sign in to see your products." empty_message="No recent products." button_label="Add selected" el_id="order-again" el_class="mb-1"]Atributos
| Atributo | Predeterminado | Valores aceptados | Propósito |
|---|---|---|---|
title |
Productos pedidos anteriormente | Texto sin formato; vacío lo oculta | Encabezado de la lista. |
limit |
10 | 1–50 | Máximo de productos aptos distintos. |
guest_message |
Vacío | Texto sin formato | Mensaje para invitados; vacío oculta el bloque para los invitados. |
empty_message |
Vacío | Texto sin formato | Mensaje de resultado vacío; el shortcode oculta el historial vacío a menos que se proporcione este mensaje. |
button_label |
Añadir los seleccionados al pedido | Texto sin formato | Etiqueta de la acción por lotes; vacío deja solo acciones individuales. |
device_visibility |
Vacío | Lista separada por comas de web-hide-on-lg, web-hide-on-md, web-hide-on-sm, web-hide-on-xs |
Rangos de dispositivo en los que ocultar la instancia. |
el_id |
Vacío | ID HTML único | Ancla opcional. |
el_class |
Vacío | Clases CSS separadas por espacios | Helpers existentes del tema. |
Comportamiento y límites
WooCommerce es necesario para la lista de compras. Solo se consulta la cuenta del visitante con sesión iniciada, usando las API de pedidos compatibles de WooCommerce para pedidos HPOS o respaldados por entradas. No existe anulación por ID de cliente ni correo electrónico.
La búsqueda cubre los 100 pedidos pagados más recientes, como máximo 1.000 líneas de pedido y hasta el límite de productos elegido. Se excluyen las líneas totalmente reembolsadas y los productos no disponibles, restringidos o no publicados actualmente. Los productos simples admiten cantidades y adiciones por lotes; los productos con opciones enlazan a su página de producto actual.
Las cachés compartidas deben excluir las solicitudes autenticadas. Los scripts existentes del tema o de WooCommerce se cargan mediante el descubrimiento común de activos y renderizan alternativas. No se crea ninguna hoja de estilos pública adicional para el bloque. Las plantillas de fila personalizadas de temas hijos siguen siendo compatibles mediante content-previously_purchased.php.
Consulta Creación y verificación de Previously Purchased para conocer los estados de vista previa, la confirmación del carrito y la resolución de problemas.