Activar compatibilidad con checkout clásico de WooCommerce

Compatibilidad del plugin Starken con checkout clásico y checkout por bloques en WooCommerce

El plugin Starken para WooCommerce permite tarificar envíos, seleccionar servicios de despacho y emitir órdenes de flete desde la tienda online. Para funcionar correctamente, el plugin necesita leer información del checkout, como dirección de despacho, comuna, región, datos del cliente y RUT.

WooCommerce actualmente puede trabajar con dos tipos de checkout: el checkout clásico y el checkout por bloques. Aunque ambos cumplen la misma función para el comprador, internamente funcionan de manera distinta. Por eso, el plugin Starken incluye una opción de compatibilidad para tiendas que aún utilizan el checkout clásico.

¿Qué es el checkout clásico de WooCommerce?

El checkout clásico es la versión tradicional del checkout de WooCommerce. Normalmente se muestra en una página que utiliza el shortcode:

[woocommerce_checkout]

Este checkout ha sido utilizado durante años por muchas tiendas WooCommerce. En este flujo, los campos del pedido suelen trabajarse mediante nombres tradicionales asociados a facturación y despacho, como billing_address_1, billing_city, billing_state, shipping_address_1, entre otros.

WooCommerce mantiene documentación oficial sobre sus shortcodes, incluyendo el shortcode [woocommerce_checkout], que se usa para mostrar la página de checkout clásica.

Referencia oficial WooCommerce: Shortcodes incluidos en WooCommerce

¿Qué es el checkout por bloques?

El checkout por bloques es la experiencia más nueva de WooCommerce. Está basada en el editor de bloques de WordPress y permite construir o personalizar la página de pago usando bloques específicos de WooCommerce.

En tiendas nuevas o tiendas que han adoptado la edición basada en bloques, el checkout puede estar construido con el bloque de pago de WooCommerce, en lugar del shortcode clásico.

WooCommerce indica que, para tiendas creadas después de WooCommerce 8.3, los bloques de carrito y checkout son la experiencia predeterminada cuando el sitio usa un tema compatible con bloques.

Referencia oficial WooCommerce: Personalización del carrito y checkout en WooCommerce

¿Por qué esto afecta al plugin Starken?

El plugin Starken necesita integrarse con el checkout para obtener datos necesarios para el envío. Entre ellos:

  • Nombre del cliente.
  • Dirección de despacho.
  • Región y comuna.
  • Teléfono y correo.
  • RUT, cuando es requerido para la operación con Starken.
  • Método de despacho seleccionado.

El checkout clásico y el checkout por bloques no siempre exponen o procesan estos campos de la misma manera. Por eso, una tienda que usa checkout clásico puede requerir una compatibilidad distinta a una tienda que usa checkout por bloques.

WooCommerce también señala en su documentación para desarrolladores que algunas personalizaciones de campos aplican al checkout clásico mediante filtros tradicionales, mientras que para el checkout por bloques se debe usar la documentación específica de campos adicionales para bloques.

Referencias oficiales WooCommerce:
Personalización de campos en checkout clásico
Campos adicionales en Cart y Checkout Blocks

¿Cuándo debo activar la compatibilidad con checkout clásico?

Debes activar la opción “Compatibilidad con checkout clásico de WooCommerce” solo si tu tienda utiliza el checkout tradicional basado en shortcode.

Es probable que tu tienda use checkout clásico si:

  • La página de finalizar compra contiene el shortcode [woocommerce_checkout].
  • La tienda fue creada hace varios años y ha sido actualizada con el tiempo.
  • El checkout fue personalizado con hooks o filtros tradicionales de WooCommerce.
  • El diseño del checkout depende de un tema o constructor antiguo.

¿Cuándo debo dejar esta opción desactivada?

Debes dejarla desactivada si tu tienda utiliza el checkout por bloques de WooCommerce.

Es probable que uses checkout por bloques si:

  • La página de pago fue creada con bloques de WooCommerce.
  • El sitio usa un tema basado en bloques.
  • La tienda fue creada en versiones recientes de WooCommerce.
  • Al editar la página de checkout en WordPress ves bloques como “Checkout”, “Shipping Address” o “Billing Address”.

¿Cómo revisar qué tipo de checkout tiene mi tienda?

  1. Ingresa al administrador de WordPress.
  2. Ve a Páginas.
  3. Busca la página usada como Finalizar compra o Checkout.
  4. Abre la página en modo edición.
  5. Revisa su contenido:
  • Si ves el shortcode [woocommerce_checkout], tu tienda usa checkout clásico.
  • Si ves bloques de WooCommerce relacionados con Checkout, tu tienda usa checkout por bloques.

¿Qué pasa si activo la opción incorrecta?

Si la opción no coincide con el tipo de checkout real de la tienda, el plugin puede no leer correctamente algunos datos necesarios para Starken. Esto podría generar problemas como:

  • No mostrar tarifas de envío correctamente.
  • No capturar correctamente el RUT.
  • No reconocer dirección, región o comuna.
  • Errores al intentar emitir la orden de flete.
  • Problemas de compatibilidad con otros plugins que modifican el checkout.

Recomendación

Si tu tienda usa checkout por bloques, deja la opción desactivada. Si tu tienda usa checkout clásico con el shortcode [woocommerce_checkout], activa la compatibilidad con checkout clásico.

Ante dudas, revisa la página de checkout en WordPress o solicita apoyo técnico para validar el tipo de checkout antes de cambiar la configuración.

Referencias oficiales