aGo Migrator, documentación

Versión del plugin: 1.0.0 · Documentación actualizada: 2026-06-28

aGo Migrator empaqueta un sitio WordPress completo (base de datos, plugins, temas y archivos subidos) en un solo archivo ZIP, para respaldarlo o moverlo de un entorno a otro. Al importar, ajusta las URLs del sitio de origen a las del sitio de destino de forma segura, incluso dentro de datos serializados. Todo el proceso ocurre en tu propio servidor: no se conecta a ningún servicio externo.

Aviso importante. Importar un respaldo reemplaza por completo el sitio de destino: base de datos, plugins, temas, archivos subidos y usuarios. La operación no se puede deshacer. Importa siempre sobre un sitio nuevo o desechable, y nunca sobre un sitio en producción sin un respaldo previo.

---

1. Instalación y activación

1. Sube el archivo ago-migrator.zip desde Plugins → Añadir nuevo plugin → Subir plugin y actívalo.
2. Para migrar entre dos sitios, instala y activa el plugin tanto en el sitio de origen como en el de destino.
3. La herramienta queda en el menú aGo Tools → Migrator.

El plugin funciona en hosting compartido: la exportación y la importación corren por pasos y la subida del archivo se hace por bloques, de modo que no dependen de una sola petición larga. El tamaño máximo que puedes mover depende del espacio en disco y del tiempo de ejecución que permita tu servidor.

2. Exportar un respaldo del sitio

En aGo Tools → Migrator, tarjeta Exportar sitio completo:

1. Pulsa Export Backup.
2. El plugin genera el respaldo en pasos y muestra una barra de progreso con el detalle de cada etapa (manifiesto, volcado de la base de datos tabla por tabla, y carpetas de contenido).
3. Al terminar, el archivo ZIP se descarga automáticamente.

El respaldo incluye:

• La base de datos completa (todas las tablas).
• Las carpetas de contenido que existan: plugins, themes, uploads, mu-plugins y languages.
• Un archivo manifest.json con los datos del sitio de origen (URL, versión de WordPress y PHP, prefijo de tablas, plugins activos, tema activo y fecha del respaldo).

Para reducir el tamaño y evitar datos transitorios, la exportación omite carpetas de caché y de respaldos de otros plugins (cache, upgrade, updraft, ai1wm-backups, backups) y el archivo debug.log.

El nombre del archivo se compone con el nombre del sitio y la fecha y hora de generación, por ejemplo misitio-20260628-153000.zip.

3. Importar y migrar a otro sitio

En el sitio de destino, en aGo Tools → Migrator, tarjeta Importar respaldo:

1. Arrastra el archivo ZIP generado por aGo Migrator a la zona indicada, o selecciónalo manualmente. Solo se aceptan archivos .zip.
2. El plugin sube el archivo por bloques y lee el manifiesto. Verás un resumen del respaldo: sitio de origen, número de tablas, tema y fecha del respaldo.
3. Aparece una advertencia de que el sitio de destino se reemplazará por completo. Debes marcar la casilla Entiendo que se reemplazará todo el sitio para habilitar el botón.
4. Pulsa Confirm & Import. El plugin extrae los archivos, importa la base de datos y, si las URLs de origen y destino son distintas, ejecuta el reemplazo de URLs.
5. Al terminar, te redirige a la pantalla de inicio de sesión. Vuelve a entrar con las credenciales del sitio de origen, ya que la base de datos importada trae sus usuarios y contraseñas.

Reemplazo de URLs seguro

Cuando el sitio de destino tiene una dirección distinta a la del origen, el plugin reemplaza la URL antigua por la nueva en todas las tablas de texto. El reemplazo respeta los datos serializados (deserializa, sustituye y vuelve a serializar), de modo que no corrompe las opciones, los widgets ni los metadatos que WordPress y muchos plugins guardan en ese formato. También cubre variantes habituales: la URL sin protocolo, la versión con barras escapadas para JSON y las rutas de archivos del sistema.

4. Migrar con WP-CLI

Si administras el sitio por línea de comandos, el plugin registra el comando agomigrator.

Exportar:

wp agomigrator export
wp agomigrator export --output=/ruta/backup.zip

Importar:

wp agomigrator import backup.zip
wp agomigrator import backup.zip --yes

Sin la opción --yes, el comando pide confirmación antes de reemplazar el sitio, porque la importación es irreversible.

5. Advertencias antes de migrar

• Haz un respaldo del sitio de destino antes de importar. La importación reemplaza la base de datos, los plugins, los temas, los archivos subidos y los usuarios. No hay vuelta atrás.
• Importa solo en un sitio nuevo o desechable cuando estés probando. Nunca sobreescribas un sitio en producción sin un respaldo reciente que puedas restaurar.
• Vuelve a iniciar sesión después de importar: las credenciales válidas pasan a ser las del sitio de origen.
• Archivos compatibles: importa solo archivos ZIP generados por aGo Migrator. El plugin valida que el respaldo contenga su manifiesto y rechaza los que no lo tengan.

6. Privacidad y servicios externos

El plugin procesa los datos de tu propio sitio en tu servidor para construir y restaurar el respaldo. No envía datos a terceros ni se conecta a servicios externos. Durante el proceso usa una carpeta de trabajo temporal en wp-content y registros de trabajo de corta duración; al desinstalar el plugin, esa carpeta temporal y esos registros se eliminan.

Los enlaces de donación y el enlace a aGo Lab que aparecen en la pantalla de administración solo se abren cuando pulsas en ellos.

7. Soporte

aGo Migrator es un plugin gratuito de código abierto bajo licencia GPL-2.0+.

Cuando publiquemos este plugin en WordPress.org, las dudas y reportes de bugs se atenderán en su foro oficial (https://wordpress.org/support/plugin/ago-migrator/). El plugin es de código abierto bajo licencia GPL-2.0+ y se atiende según disponibilidad.

No damos soporte por correo electrónico para la versión gratuita. Para uso comercial con soporte directo y SLA, próximamente lanzaremos planes de suscripción anual y lifetime.

Importar un respaldo reemplaza por completo el sitio de destino y la operación no se puede deshacer. Haz siempre un respaldo previo y prueba primero en un sitio desechable.