caso 03 · tiendas WooCommerce · Cuba

Tres tiendas,
un solo motor

Woodofy es un plugin de WooCommerce que enseña a una tienda cómo funciona Cuba: provincias, municipios, zonas y envíos por peso. Tres tiendas en producción lo comparten. Yo lo mantengo, lo endurezco y lo extiendo desde julio de 2026.

En vivotubandeja.com ↗ · cocomarketshop.com ↗ · engimovcaribe.com ↗

engimovcaribe.com
Página de inicio de engimovcaribe.com, tienda WooCommerce de materiales de construcción
cocomarketshop.com
Página de inicio de cocomarketshop.com, tienda WooCommerce
tubandeja.com
Página de inicio de tubandeja.com, tienda WooCommerce con envíos a toda Cuba
3tiendas en producción
1 núcleomismo código en las tres
16provincias y sus municipios
Qué es

Un plugin de WooCommerce con direcciones, zonas y envíos de Cuba, más una familia de extensiones

Punto de partida

El núcleo existe desde 2025, creado por el equipo; yo entré en julio de 2026

Mi papel

Envíos por ubicación, campos del checkout, seguridad, traducción, empaquetado y extensiones

// el reto

WooCommerce
no conoce Cuba

Una tienda lista para usar pide un país, una provincia y un código postal. En Cuba el cliente elige provincia y municipio, el envío depende del peso y de la zona, y cada tienda reparte desde un lugar distinto.

Se puede resolver con parches en cada sitio. Con tres tiendas ya son tres copias que arreglar cada vez. La respuesta fue un solo plugin que lo sabe todo, y extensiones pequeñas para lo que cada tienda necesita de más.

01

Direcciones

Provincia, municipio y código postal en el orden que usa el cliente, en el checkout y en Mi cuenta.

02

Envíos

Tarifa por peso y por zona, con cada provincia asignada a la zona que le toca.

03

Origen

Cada tienda reparte desde un lugar. El plugin compara la provincia de entrega con la de la tienda.

04

Mantenimiento

Una corrección en el núcleo tiene que llegar a las tres tiendas sin tocar cada una a mano.

// recorrido de un pedido

Del checkout
al envío

Cinco piezas del plugin, en el orden en que las cruza un cliente. Baja y míralas una a una.

01 · dirección

Provincia, municipio y código postal

En el checkout, al elegir Cuba, la lista de municipios se filtra por provincia. El código postal se rellena solo y queda en solo lectura. En Mi cuenta y en los pedidos se muestra el nombre del municipio, no su código.

checkout clásicoMi cuentapedidos HPOS
02 · zonas

Cada provincia en su zona

En el panel de WooCommerce, cada zona de envío lista las provincias que cubre. Una API REST expone provincias y municipios en lectura pública, y deja el código postal solo para administradores.

zonas de envíoAPI REST
03 · tarifa

El peso decide el precio

Una calculadora toma el peso total, el umbral configurado y el coste base de la ubicación. Si la tarifa se duplica por tramo, cada umbral de peso duplica el coste.

por pesopor zona
04 · origen

Reparte solo desde donde vende

El plugin resuelve la provincia de la tienda y comprueba que la de entrega encaje. Si no encaja, avisa en el checkout en lugar de cobrar un envío imposible. Woodofy LM añade el selector de ubicación en el catálogo.

validación en checkoutWoodofy LM
05 · familia

Extensiones para lo que cambia

El núcleo se instala en las tres tiendas. Woodofy LM filtra el catálogo por ubicación, Woodofy Polylang, que hoy corre solo en la tienda de demostración, comparte un inventario entre idiomas y Woodofy Stats muestra analítica de ventas.

WoodofyLMPolylangStats
checkout · Cubapaso 1 / 5
PaísCuba
ProvinciaHolguín
Municipiofiltrado por provincia
Código postalse rellena solo
Teléfono de entregacampo propio

orden de campos: país, provincia, municipio, código postal

zonas de envíopaso 2 / 5
Zonaprovincias asignadas
GET/provincias · lectura pública
GET/municipios · lectura pública
ADMIN/códigos postales · con permiso

rutas REST del plugin, nombres simplificados

tarifa por pesopaso 3 / 5
Peso del carrito1,2 kg
Tramos de peso× 1
Envíobase

ejemplo ilustrativo: umbral de 1,3 kg, sin precios reales

origen de la tiendapaso 4 / 5
Provincia de la tiendaresuelta del ajuste
Provincia de entregala del checkout
¿Coinciden?sí · tarifa
Si no coincidenaviso, sin tarifa
→ validate_shipping_province_matches_store()
la familia Woodofypaso 5 / 5
⬢ Woodofynúcleo · en las 3 tiendas
⬢ LMcatálogo por ubicación
⬢ Polylanginventario entre idiomas
⬢ Statsanalítica de ventas
// problemas reales

Lo que se rompe
al mantenerlo

Seis casos de mi historial en estos repositorios. Cada tarjeta lleva el commit que lo resolvió.

fix · 3577fbbmejorado

Un atajo de depuración abría la API

Con WP_DEBUG activo, la REST aceptaba un nonce de repuesto. Lo quité: provincias y municipios son de lectura pública y los códigos postales exigen permiso de administrador.

fix · 9906cc8mejorado

El log guardaba datos de clientes

Dos llamadas a error_log volcaban los campos del checkout, con datos personales, en debug.log. Las eliminé.

fix · 9906cc8mejorado

El script del panel daba 404 en producción

Se cargaba desde src/, que el zip de distribución no incluye. Ahora vive en assets/ y el empaquetado lo copia.

fix · fc45b88mejorado

El municipio se perdía en Mi cuenta

La dirección guardada no mostraba municipio y los pedidos enseñaban un código. Ahora se inyecta en la dirección formateada y se resuelve a su nombre en español.

fix · cb4b0a4mejorado

El aviso del código postal salía dos veces

.woocommerce-checkout es también la clase del body, así que el aviso aparecía sobre la cabecera. Ahora apunta solo al formulario.

revert · 491361b1del cliente

Una auditoría que tocó código que no era mío

En una de las tiendas, las correcciones de la auditoría llegaron a plugins del cliente. Las revertí: esos plugins quedan de solo lectura y los cambios se guardan como parche.

// bajo el capó

Un núcleo,
tres tiendas

Por dónde pasa una visita

clienteCheckoutelige provincia y municipio, y ve la tarifa de su envío
dueño de la tiendaPanel de WooCommercezonas, tarifas por peso y ubicación de la tienda
otros sistemasAPI RESTprovincias y municipios en lectura pública
// plugin compartido

WooCommerce + Woodofy

Direcciones de Cubaprovincias, municipios, códigos postalesmejorado
Envío por peso y zonacalculadora y método de envíomejorado
Woodofy LMcatálogo por ubicaciónmejorado
Woodofy Polylanginventario y correos por idiomaconstruido
Woodofy Statsanalítica de ventasconstruido
WooCommerce y Polylangbase y traduccionesterceros
desarrollo y empaquetado
Composer · wp-scripts · webpacknpm run zip · versión automática · mejorado
tienda 1tubandeja.comsolo el núcleo
tienda 2cocomarketshop.comnúcleo y filtro por ubicación
tienda 3engimovcaribe.comnúcleo y plugins del propio cliente
NuevoMejoradoExistente
// método

Se arregla
una vez

De una corrección a tres tiendas

El plugin se corrige en su repositorio, se empaqueta con la versión sumada sola y se instala en cada tienda. Las tres reciben el mismo código.

01Corregirun cambio en el núcleo
02Empaquetarzip con versión nueva
03Instalaren las tres tiendas

Reglas que dejé en el plugin

Nonce en cada petición AJAXtambién en los manejadores que aún no están enganchados
Permisos en la RESTlectura pública solo donde hace falta
Sin datos de clientes en el lognada del checkout llega a debug.log
Traducción completa al españoltextos del plugin y del panel en es_ES
Pedidos con la API de WooCommerceel municipio se guarda compatible con HPOS
// resultado

Números
del plugin

3tiendas en producción con el mismo núcleo
16provincias, con sus municipios y códigos postales
4plugins en la familia: núcleo, LM, Polylang y Stats
3versiones publicadas en un solo día (1.0.7 a 1.0.9)

Cifras tomadas del código y del historial de git de los repositorios. No incluyo cifras de ventas de las tiendas porque no son resultado mío. Un cuarto sitio, también con Woodofy, sigue en modo «próximamente» y no aparece aquí.

WooCommerceWordPressPHPJavaScriptComposerwebpackREST APIPolylangHPOS
// tu proyecto

¿Quieres algo así para tu negocio?

Cuéntame qué necesitas. Te respondo en menos de 24 h y, si encaja, recibes una propuesta cerrada por escrito.