---
title: "Woodofy: plugin WooCommerce para Cuba en tres tiendas"
description: "Caso Woodofy: plugin de WooCommerce con provincias, municipios y envío por peso o zona de Cuba, compartido por tres tiendas en producción."
url: https://lazarosantana.dev/casos/tiendas/
---

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.

[Ver una tienda](https://tubandeja.com) [Cómo funciona](https://lazarosantana.dev/casos/tiendas/#recorrido)

En vivo [tubandeja.com ↗](https://tubandeja.com) · [cocomarketshop.com ↗](https://cocomarketshop.com) · [engimovcaribe.com ↗](https://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

**3** tiendas en producción

**1*núcleo*** mismo código en las tres

**16** provincias 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

Tiendas

[tubandeja.com](https://tubandeja.com), [cocomarketshop.com](https://cocomarketshop.com) y [engimovcaribe.com](https://engimovcaribe.com)

// 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ásico Mi cuenta pedidos 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ío API 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 peso por 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 checkout Woodofy 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.

Woodofy LM Polylang Stats

**checkout · Cuba** paso 1 / 5

País Cuba

Provincia Holguín

Municipio filtrado por provincia

Código postal se rellena solo

Teléfono de entrega campo propio

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

**zonas de envío** paso 2 / 5

**Zona** provincias 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 peso** paso 3 / 5

Peso del carrito **1,2 kg**

Tramos de peso **× 1**

Envío **base**

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

**origen de la tienda** paso 4 / 5

Provincia de la tienda resuelta del ajuste

Provincia de entrega la del checkout

¿Coinciden? sí · tarifa

Si no coinciden aviso, sin tarifa

→ **validate_shipping_province_matches_store()**

**la familia Woodofy** paso 5 / 5

**⬢ Woodofy** núcleo · en las 3 tiendas

**⬢ LM** catálogo por ubicación

**⬢ Polylang** inventario entre idiomas

**⬢ Stats** analí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 · 3577fbb` mejorado

### 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 · 9906cc8` mejorado

### 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 · 9906cc8` mejorado

### 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 · fc45b88` mejorado

### 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 · cb4b0a4` mejorado

### 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 · 491361b1` del 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

cliente**Checkout** elige provincia y municipio, y ve la tarifa de su envío

dueño de la tienda**Panel de WooCommerce** zonas, tarifas por peso y ubicación de la tienda

otros sistemas**API REST** provincias y municipios en lectura pública

// plugin compartido

### WooCommerce + Woodofy

Direcciones de Cuba*provincias, municipios, códigos postales**mejorado*

Envío por peso y zona*calculadora y método de envío**mejorado*

Woodofy LM*catálogo por ubicación**mejorado*

Woodofy Polylang*inventario y correos por idioma**construido*

Woodofy Stats*analítica de ventas**construido*

WooCommerce y Polylang*base y traducciones**terceros*

desarrollo y empaquetado

Composer · wp-scripts · webpack npm run zip · versión automática · mejorado

tienda 1**[tubandeja.com](https://tubandeja.com)** solo el núcleo

tienda 2**[cocomarketshop.com](https://cocomarketshop.com)** núcleo y filtro por ubicación

tienda 3**[engimovcaribe.com](https://engimovcaribe.com)** núcleo y plugins del propio cliente

Nuevo Mejorado Existente

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

01**Corregir** un cambio en el núcleo

02**Empaquetar** zip con versión nueva

03**Instalar** en las tres tiendas

### Reglas que dejé en el plugin

**Nonce en cada petición AJAX** también en los manejadores que aún no están enganchados

**Permisos en la REST** lectura pública solo donde hace falta

**Sin datos de clientes en el log** nada del checkout llega a `debug.log`

**Traducción completa al español** textos del plugin y del panel en es_ES

**Pedidos con la API de WooCommerce** el municipio se guarda compatible con HPOS

// resultado

## Números del plugin

**3** tiendas en producción con el mismo núcleo

**16** provincias, con sus municipios y códigos postales

**4** plugins en la familia: núcleo, LM, Polylang y Stats

**3** versiones 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í.

WooCommerce WordPress PHP JavaScript Composer webpack REST API Polylang HPOS

// siguiente caso

04 · web corporativa · a medida

### Del diseño en Figma al tema WordPress

El rediseño de teknovud.com llevado de Figma a un tema completo: plantillas, campos editables y filtros, con una auditoría al final.

*teknovud.com*

Página de inicio de teknovud.com

[¿Necesitas algo así? → Tiendas WooCommerce para Cuba](https://lazarosantana.dev/servicios/woocommerce-cuba/)

[¿Necesitas algo así? → Plugin WordPress a medida](https://lazarosantana.dev/servicios/plugin-wordpress-a-medida/)

[← todos los casos](https://lazarosantana.dev/#trabajo) caso 3 de 4

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

[Pedir cotización](https://lazarosantana.dev/contacto/#formulario) [Ver servicios](https://lazarosantana.dev/servicios/)
