Skip to Content
UsingMigrar desde WordPress

Migrar desde WordPress

Usa la migración cuando tengas un blog de WordPress existente y quieras mover sus entradas a un sitio headless de Structura — por ejemplo, estás cerrando una instalación de WordPress autoalojada y sirviendo el mismo contenido desde un front-end de Next.js, Astro u otro similar.

La migración copia tus entradas publicadas (opcionalmente también los borradores) al sitio headless, realoja cada imagen en el almacenamiento duradero de Structura para que nada se rompa cuando el sitio antiguo desaparezca, conserva el slug y los metadatos SEO de cada entrada, y genera un mapa de redirecciones para que los motores de búsqueda sigan tus antiguas URLs a las nuevas.

La migración está disponible en todos los planes, incluido el gratuito — el plan gratuito importa hasta las 500 entradas más recientes; los planes de pago son ilimitados.

Antes de empezar

Necesitarás:

  • Un sitio headless de Structura ya creado (este es el destino). Consulta Modo headless para tener una visión general de la publicación headless.
  • La dirección de tu antiguo sitio de WordPress (p. ej., https://old-blog.com).
  • Mantén el antiguo sitio de WordPress en línea durante la migración. Las imágenes se copian en vivo desde él a medida que se importan las entradas — si ya está fuera de línea, las imágenes no podrán guardarse.

Opcional: conectar con credenciales

Por defecto, la migración lee el contenido público de tu sitio — cada entrada publicada, más el título/descripción SEO de Yoast o Rank Math. Esto es suficiente para la mayoría de los traslados.

Conecta con una contraseña de aplicación si también quieres traer borradores y entradas pendientes, campos SEO personalizados, o tus reglas existentes del plugin Redirection. Para crear una en el sitio antiguo:

  1. En el WordPress antiguo, ve a Usuarios → Perfil → Contraseñas de aplicación.
  2. Introduce un nombre (p. ej., “Structura migration”) y haz clic en Añadir nueva contraseña de aplicación.
  3. Copia la contraseña generada y pégala, junto con tu nombre de usuario de WordPress, en la opción Avanzado de la migración.

La contraseña de aplicación se usa únicamente durante la migración y se elimina en cuanto finaliza. Puedes revocarla en el sitio antiguo posteriormente.

Pasos

  1. Abre tu sitio headless en el portal de cliente e inicia una Migración desde WordPress.
  2. Introduce tu dirección de WordPress antigua. Opcionalmente, despliega Avanzado para conectar con un nombre de usuario y una contraseña de aplicación.
  3. Structura comprueba la conexión y muestra lo que encontró — cuántas entradas hay, qué plugin SEO se usa, y un patrón de URL sugerido que coincide con tus antiguos permalinks. Ajusta el patrón de URL de destino si quieres que las nuevas URLs coincidan exactamente con las antiguas.
  4. Inicia la migración. Una vista de progreso muestra las entradas e imágenes que se están importando. Puedes salir y volver tranquilamente — la migración sigue ejecutándose y el progreso se reanuda donde lo dejó.
  5. Cuando finalice, revisa el paso de redirecciones y descarga la configuración para tu front-end (ver más abajo).

Qué ocurre después

  • Las entradas importadas aparecen en la lista de entradas de tu sitio headless. Las entradas que estaban publicadas en WordPress se publican; los borradores llegan a revisión para que puedas verificarlos primero.
  • Cada entrada conserva su slug, título/descripción SEO e imagen destacada originales, y su contenido es completamente editable en el editor de Structura.
  • Los enlaces dentro de tus entradas que apuntaban a otras entradas de tu sitio antiguo se reapuntan automáticamente a su nuevo destino, de modo que el sitio migrado se enlaza a sí mismo. La importación muestra un recuento de enlaces corregidos cuando termina. Algunos enlaces pueden seguir apuntando a tu sitio antiguo — por ejemplo, enlaces a páginas que no son entradas del blog, entradas que elegiste no traer, o entradas que superan el límite del plan gratuito. Estos siguen funcionando y puedes actualizarlos cuando quieras.
  • La migración genera un mapa de redirecciones de tus antiguas URLs a las nuevas. Aplícalo en el servidor que sirve tu nuevo sitio para que los enlaces antiguos y los resultados de los motores de búsqueda sigan funcionando:
    • Next.js / Vercel — pégalo en las redirecciones de tu next.config o en vercel.json.
    • Apache — añade las reglas a tu .htaccess.
    • nginx — añade las reglas a tu bloque de servidor.
    • CSV / JSON — un mapa portable para cualquier otra configuración.

Una vez que el nuevo sitio esté activo y las redirecciones estén en su lugar, puedes cerrar el antiguo blog de WordPress sin problemas.

Problemas comunes

“No se pudo acceder al sitio.” Comprueba la dirección (incluye https://) y que el sitio esté en línea. Los sitios protegidos con contraseña, lista de IPs permitidas o un plugin de “próximamente” no pueden leerse.

“Error de inicio de sesión” con credenciales. El nombre de usuario o la contraseña de aplicación son incorrectos, o las contraseñas de aplicación están desactivadas en el sitio de origen. Vuelve a crear la contraseña de aplicación e inténtalo de nuevo — o deja los campos Avanzado vacíos para importar solo las entradas públicas.

Algunas imágenes no se transfirieron. Las imágenes se copian en vivo desde el sitio antiguo; si se desconectó a mitad de la migración, o si una imagen ya era un enlace roto, esa imagen se omite y el resto de la entrada se importa igualmente.

El plan gratuito se detuvo en 500 entradas. El plan gratuito importa las 500 entradas más recientes. Realiza una mejora para importar el resto de un archivo más grande.

Páginas relacionadas

Última actualización:

Modo headlessAvisos