Ir al contenido

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].

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.

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.

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:

Ventana de terminal
wp option update polski_pro_checkout '{"multistep_enabled":true}' --format=json

false restaura el checkout normal.

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.

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á.

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.

  1. Compruebe que multistep_enabled en la opción polski_pro_checkout es true.
  2. Compruebe que la página de checkout usa el shortcode clásico [woocommerce_checkout] y no el bloque Checkout.
  3. Vacíe la caché (plugins de caché, CDN, navegador).
  4. Revise la consola del navegador en busca de errores de JavaScript.

Un campo obligatorio del paso actual está vacío. Está marcado con polski-field--invalid y recibe el foco.

Polski PRO es anterior a 1.32.6. Actualícelo.

Esta página tiene únicamente carácter informativo y no constituye asesoramiento legal. Consulta a un abogado antes de la implementación. Polski for WooCommerce es software de código abierto (GPLv2) proporcionado sin garantía.