Side cart (live cart)
El carrito lateral es un panel deslizante (drawer) que aparece después de añadir un producto al carrito. El cliente ve el contenido del carrito sin salir de la página del producto, lo que acorta el recorrido de compra y reduce el abandono del carrito.
Activar el módulo
Section titled “Activar el módulo”Ve a WooCommerce > Polski > Módulos de tienda y activa Side cart. Después de añadir un producto al carrito, el panel se desliza automáticamente desde el lado elegido de la pantalla.
Funciones
Section titled “Funciones”- Panel de carrito deslizante después de añadir un producto (slide-in drawer)
- Actualización en tiempo real mediante WooCommerce Cart Fragments
- Barra de progreso animada de envío gratis
- Cambio de las cantidades de productos sin recargar la página
- Eliminación de productos del carrito en el panel
- Resumen del valor del carrito
- Overlay que atenúa el fondo de la página
- Elección del lado de visualización (izquierda/derecha)
Ajustes
Section titled “Ajustes”Configuración en WooCommerce > Polski > Módulos de tienda > Side cart.
| Ajuste | Predeterminado | Descripción |
|---|---|---|
auto_open | true | Abrir automáticamente el panel después de añadir un producto |
show_subtotal | true | Mostrar el resumen del valor del carrito |
show_shipping_notice | true | Mostrar la barra de progreso de envío gratis |
free_shipping_threshold | 200 | Umbral de envío gratis en la moneda de la tienda |
position | right | Lado de la pantalla: right o left |
overlay | true | Atenuar el fondo cuando el panel está abierto |
Opción en la base de datos: polski_live_cart.
Barra de envío gratis
Section titled “Barra de envío gratis”La barra muestra cuánto falta para el envío gratis. Una vez superado el umbral, muestra un mensaje de confirmación. El umbral se toma del ajuste free_shipping_threshold o automáticamente del método de envío de WooCommerce (si está configurado).
Ejemplo de mensajes:
- “Te faltan 45,00 zl para el envío gratis”
- “¡Enhorabuena! Tu pedido reúne los requisitos para el envío gratis”
Detalles técnicos
Section titled “Detalles técnicos”Archivos
Section titled “Archivos”- CSS:
assets/css/live-cart.css - JavaScript:
assets/js/live-cart.js
Ambos archivos se cargan de forma condicional, solo cuando el módulo está activo. El script depende de jquery y wc-cart-fragments.
Cart Fragments
Section titled “Cart Fragments”El módulo utiliza el mecanismo WooCommerce Cart Fragments para actualizar el contenido del panel en tiempo real. Tras cada cambio en el carrito (añadir, eliminar, cambiar la cantidad) el panel se actualiza sin recargar la página.
// Cambiar el umbral de envío gratis de forma dinámicaadd_filter('polski/live_cart/free_shipping_threshold', function (float $threshold): float { return 300.00;});
// Añadir tu propio contenido debajo de la lista de productosadd_action('polski/live_cart/after_items', function (): void { echo '<p class="live-cart-promo">Código de descuento: WELCOME10</p>';});
// Desactivar la apertura automática en móviladd_filter('polski/live_cart/auto_open', function (bool $auto_open): bool { if (wp_is_mobile()) { return false; } return $auto_open;});Clases CSS
Section titled “Clases CSS”.polski-live-cart- contenedor principal del panel.polski-live-cart--open- estado abierto.polski-live-cart--left/.polski-live-cart--right- posición.polski-live-cart__overlay- overlay del fondo.polski-live-cart__header- encabezado del panel.polski-live-cart__items- lista de productos.polski-live-cart__item- producto individual.polski-live-cart__subtotal- resumen.polski-live-cart__shipping-bar- barra de envío gratis.polski-live-cart__shipping-progress- relleno de la barra
ID del módulo
Section titled “ID del módulo”live_cart
Solución de problemas
Section titled “Solución de problemas”El panel no se abre después de añadir un producto - comprueba si la adición al carrito por AJAX está activada en WooCommerce > Ajustes > Productos > Activar los botones de añadir al carrito por AJAX. Comprueba también que no haya conflicto con otro plugin de carrito.
La barra de envío gratis no se muestra - asegúrate de tener configurado un método de envío con envío gratis por encima de un umbral definido, o establece el umbral manualmente en los ajustes del módulo.
El panel se muestra en el lado incorrecto - cambia el ajuste position a left o right.
Notificar problemas: github.com/wppoland/polski/issues