Multi-step checkout
El checkout multipaso divide el checkout clásico de WooCommerce en cuatro pasos: dirección, envío, pago y revisión. Sobre el formulario aparecen los pasos numerados, y el cliente avanza con el botón Siguiente. Funciona en el checkout clásico, el formulario form.woocommerce-checkout que genera el shortcode [woocommerce_checkout].
Pasos del checkout
Sección titulada «Pasos del checkout»| Paso | Etiqueta | Qué se muestra |
|---|---|---|
| 1 | Dirección | Los campos de facturación (#customer_details .col-1) |
| 2 | Envío | Los campos de la dirección de envío (#customer_details .col-2) y la tabla del pedido, que contiene los métodos de envío |
| 3 | Pago | Los métodos de pago (#payment), sin la tabla del pedido y sin la zona de realizar el pedido |
| 4 | Revisión | La tabla del pedido, los métodos de pago, los términos y las casillas legales, y el botón de realizar el pedido |
Las etiquetas están fijadas en el plugin y se traducen mediante el dominio de texto polski-pro. El texto del botón de realizar el pedido procede del filtro woocommerce_order_button_text, así que sigue al módulo del botón de checkout del plugin gratuito Polski.
El cliente puede volver con Atrás o haciendo clic en un paso completado de la barra. Los campos conservan sus valores, porque todos los pasos forman parte del mismo formulario.
Si el formulario no tiene #customer_details o #order_review, algo que ocurre con plantillas de checkout muy reconstruidas, el script no cambia nada y el cliente ve el checkout normal.
Validación entre pasos
Sección titulada «Validación entre pasos»Siguiente en los pasos Dirección y Envío comprueba los campos obligatorios de WooCommerce de ese paso (los campos marcados con validate-required). Los campos vacíos reciben la clase polski-field--invalid y el primero recibe el foco. Los campos que no están visibles, como la dirección de envío mientras Ship to a different address está sin marcar, se omiten.
Los pasos Pago y Revisión no comprueban nada por sí mismos. El método de pago, los términos y las casillas legales los comprueba WooCommerce al realizar el pedido, y sus avisos de error aparecen como siempre.
Configuración
Sección titulada «Configuración»No hay pantalla de ajustes. El único ajuste es multistep_enabled dentro de la opción polski_pro_checkout, que se escribe por ejemplo con WP-CLI:
wp option update polski_pro_checkout '{"multistep_enabled":true}' --format=jsonfalse restaura el checkout normal.
Cómo funciona
Sección titulada «Cómo funciona»El script build/frontend-multistep.js y su hoja de estilos se cargan solo en la página de checkout (is_checkout()), en el pie. El script añade la barra de pasos al principio del formulario y los botones Atrás y Siguiente al final, y escribe el paso actual en un atributo data-polski-step del formulario. La hoja de estilos oculta las secciones que no pertenecen a ese paso.
Se hace con CSS a propósito: WooCommerce sustituye el recuadro de pago y la tabla del pedido en cada actualización del checkout, así que se pierde todo lo que se coloque dentro de ellos o se fije en ellos en línea. Pasar al siguiente paso provoca una actualización del checkout, de modo que los totales y los métodos de pago siguen a la dirección recién introducida.
La lógica de WooCommerce y los campos del formulario no se modifican.
Bloque Checkout
Sección titulada «Bloque Checkout»El módulo también registra la integración polski-pro-multistep en el bloque Checkout, que carga el mismo script. El script solo divide el formulario clásico form.woocommerce-checkout, así que en el checkout de bloques no hace nada y este queda como está.
Estilos
Sección titulada «Estilos»Cuando el módulo está activado, la página de checkout recibe la clase polski-multistep-checkout en <body>.
| Selector | Elemento |
|---|---|
form[data-polski-step="address"] (también shipping, payment, review) |
El formulario en el paso indicado |
.polski-steps |
La barra de pasos (role="tablist") |
.polski-steps__item |
Un paso de la barra, con --active, --completed o --upcoming |
.polski-steps__number, .polski-steps__label |
El número y la etiqueta de un paso |
.polski-steps__buttons |
El contenedor de los botones de navegación |
.polski-steps__prev, .polski-steps__next |
Atrás y Siguiente |
.polski-field--invalid |
Un campo obligatorio que se ha dejado vacío |
body.polski-multistep-checkout form.woocommerce-checkout { max-width: 720px; margin: 0 auto;}Cada paso de la barra es un <button> con role="tab" y aria-selected, por lo que se puede alcanzar con el teclado.
Problemas frecuentes
Sección titulada «Problemas frecuentes»El checkout no se divide en pasos
Sección titulada «El checkout no se divide en pasos»- Compruebe que
multistep_enableden la opciónpolski_pro_checkoutestrue. - Compruebe que la página de checkout usa el shortcode clásico
[woocommerce_checkout]y no el bloque Checkout. - Vacíe la caché (plugins de caché, CDN, navegador).
- Revise la consola del navegador en busca de errores de JavaScript.
Siguiente no hace nada
Sección titulada «Siguiente no hace nada»Un campo obligatorio del paso actual está vacío. Está marcado con polski-field--invalid y recibe el foco.
No hay botón Siguiente
Sección titulada «No hay botón Siguiente»Polski PRO es anterior a 1.32.6. Actualícelo.