---
title: "ix-wp-envsync: sincroniza WordPress y plan · Lázaro Santana"
description: "ix-wp-envsync: plugin de WordPress que sincroniza local, staging y producción con plan previo, sin pisar cambios del cliente y con rollback. Código abierto."
url: https://lazarosantana.dev/proyectos/ix-wp-envsync/
---

proyecto en coautoría · código abierto

# Sincroniza WordPress sin pisar *a nadie*

ix-wp-envsync mantiene un sitio WordPress al día entre local, staging y producción. Sube solo lo que cambió el equipo, respeta lo que cambió el cliente y enseña un plan antes de mover nada.

[Ver el código](https://github.com/yojahny55/ix-wp-envsync) [Cómo piensa](https://lazarosantana.dev/proyectos/ix-wp-envsync/#como-piensa)

*wp envsync diff prod*

**Plan**

- sube lo local
- respeta el remoto
- gana el remoto

Nada se mueve hasta aprobar el plan

Qué es

Un plugin de WordPress que sincroniza local, staging y producción con una comparación a tres bandas

Autoría

Coautoría con Yojahny Chavez, mantenido a dos manos desde septiembre de 2026

Para quién

Trabajo freelance con hosting mixto (Hostinger, IONOS, Plesk, Coolify), sin SSH en producción

Licencia

Código abierto en GitHub, GPL-2.0 o posterior, versión 0.9.22

// cómo piensa

## Tres versiones, una *decisión*

Comparar solo dos sitios no dice quién cambió qué. Por eso cada pull guarda una línea base, una huella del sitio en ese momento, y cada diff compara tres versiones: la base, local y el remoto (staging o producción).

01

### Pull antes de push

Sin línea base solo se pueden comparar dos lados, y el plugin lo avisa en lugar de adivinar.

02

### Gana producción

Si el equipo y el cliente cambiaron la misma fila, se queda la versión de producción y la edición local no se aplica.

03

### Conflictos a la vista

Cada fila o archivo en conflicto se lista por nombre, para revisarlos antes de cada push.

04

### Archivos igual que filas

Un archivo de tema editado sube. Un plugin que se actualizó solo en producción se queda como está.

// probar un caso

Se elige qué pasó con una fila en local y en el remoto, y el plan muestra qué versión sobrevive. Son las mismas reglas de la lista, una a una.

1. Qué pasó Resultado
2. 01 Una fila cambió en local y no en producción Se sube
3. 02 Una fila cambió en producción y no en local Se conserva, no se toca
4. 03 La misma fila cambió en los dos lados **Gana producción**, se avisa como conflicto
5. 04 Una fila se creó en local Se inserta
6. 05 Una fila se borró en local y producción no la tocó Se borra
7. 06 Producción la borró o la cambió y local la borró Se conserva

// quién es quién

## Un portátil, un *cliente*

El sitio desde el que se lanzan los comandos es el hub y necesita WP-CLI. Cada remoto, normalmente producción o staging, solo necesita el plugin y un token. Las peticiones van firmadas y el token no viaja.

*diagrama · hub y remoto*

*Herramientas → EnvSync · pantalla real, en inglés*

Pantalla real del plugin, en inglés: Tools, EnvSync del escritorio de WordPress, con el token del sitio, los entornos, los últimos pushes y las exclusiones, con datos de ejemplo

- **Token del sitio** Es el que se copia en el hub para registrar este sitio como remoto.
- **Entornos** Nombre, etiqueta, URL y línea base de cada remoto registrado.
- **Últimos pushes** Cuándo se subió a cada entorno y cuántas filas y archivos.
- **Exclusiones** Las carpetas marcadas (aquí cache y backups) las saltan pull, diff y push.

// un día de trabajo

## Cinco comandos, sin *sorpresas*

1. 01
### Estado
Dice dónde está cada sitio y qué comando toca después
2. 02
### Pull
Copia fresca de producción, y guarda la línea base
3. 03
### Diff
Vista previa de lo que cambiaría. Solo lee y cuenta, sin mover nada
4. 04
### Push
Enseña el plan y pide confirmar. El remoto guarda copia previa; con `--dry-run` no escribe nada
5. 05
### Rollback
Si algo no convence, restaura la copia previa. Lo que cambió el cliente se conserva

Si un push muere a medias, `unlock` libera el bloqueo sin deshacer nada.

En un WordPress recién instalado, el estado recomienda `push --force --dry-run` antes de enviar nada.

// leer un diff

## Una fila, una *columna*

El diff lee y cuenta, no cambia nada. Cada fila entra en una sola columna. La terminal de abajo es la salida real del plugin, que está en inglés, con datos de ejemplo; se puede seleccionar y copiar. Pasar el cursor por una columna, o tocar una nota, resalta lo que cuenta.

*wp envsync diff prod · salida real, en inglés, datos de ejemplo*

```
$ wp envsync diff prod

prod  ←  local
  baseline: 2026-09-08 02:06
  512 files · 38.4 MB · 131 rows

DATABASE
                 1      2       3         4            5         6
+-------------+------+--------+--------+-------------+-------------+-------+
| table       | push | insert | delete | remote-wins | kept-remote | same  |
+-------------+------+--------+--------+-------------+-------------+-------+
| wp_posts    |   12 |      3 |      1 |           2 |          39 |   611 |
| wp_postmeta |   87 |     19 |      4 |           0 |         310 |  8904 |
+-------------+------+--------+--------+-------------+-------------+-------+

PLUGINS 8
+-----------------------+-------+--------+-----------------+----------+
| plugin                | files | size   | version         | active   |
+-----------------------+-------+--------+-----------------+----------+
| polylang              |   535 | 9.8 MB | 3.6.1 → 3.7.0   | stays on |
| wp-mail-smtp          |   875 | 7.2 MB | — → 4.4.0       | turns on |
+-----------------------+-------+--------+-----------------+----------+

THEMES
+--------------+-------+--------+---------+--------+
| theme        | files | size   | version | active |
+--------------+-------+--------+---------+--------+
| mk-adventure |    14 | 0.3 MB | 1.4     | active |
+--------------+-------+--------+---------+--------+

OTHER FILES
+---------------+-------+---------+
| folder        | files | size    |
+---------------+-------+---------+
| uploads/2026/ |    88 | 21.1 MB |
+---------------+-------+---------+

CONFLICTS (prod wins) 7
  wp_posts             #2231  Services

plan saved: …/plans/plan-prod-20260908-020644.json
manifest: …/plans/diff-prod-latest.json
```

// pruébalo

## Instalación en 3 *pasos*

Se instala como un plugin más en cada sitio y se maneja desde WP-CLI.

1. ### Plugin en cada sitio
Se sube el zip del plugin en **Plugins → Añadir nuevo → Subir** y se activa, en el sitio local y en cada remoto.
2. ### Token del remoto
En cada remoto, en **Herramientas → EnvSync**, se copia el token que aparece.
3. ### Registrar y comprobar
En el sitio local (el hub) se registra el remoto y se comprueba la conexión. `status` dice si funciona y qué comando toca después.

*terminal · en el hub*

# registrar el remoto # comprobar la conexión

Empieza por un staging. El primer diff no cambia nada.

[Ver el código](https://github.com/yojahny55/ix-wp-envsync) [Contacto](https://lazarosantana.dev/contacto/#formulario)

[¿Necesitas algo así? → Migración y rescate de WordPress](https://lazarosantana.dev/servicios/migracion-wordpress/)

[← todas las herramientas](https://lazarosantana.dev/#p-tools) proyecto en coautoría

// tu proyecto

## ¿Tienes un proyecto en mente?

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