Cuándo tiene sentido pasarse a WordPress
Contentful es un CMS headless sólido, pero no siempre es la mejor opción. Los equipos suelen mirar WordPress cuando crece el costo de licencias y de uso de la API, cuando cada cambio de página necesita un desarrollador porque el front end es una aplicación a medida, o cuando los editores quieren previsualizar y armar las páginas ellos mismos en lugar de llenar campos.
WordPress ofrece a los editores un editor visual por bloques, un gran ecosistema de plugins y opciones de hosting para cualquier presupuesto. A cambio, asumes su mantenimiento: actualizaciones, seguridad y rendimiento. Si tu equipo publica sobre todo páginas, artículos y landing pages, el cambio suele valer la pena. Si Contentful alimenta varias aplicaciones a la vez, la migración necesita más planificación, y mantener una arquitectura headless con WordPress como fuente de contenido es una opción a considerar.
Paso 1: Relaciona el modelo de contenido
Contentful organiza el contenido en tipos de contenido con campos, y las entradas se referencian entre sí. WordPress lo organiza en tipos de entrada, taxonomías y campos personalizados. El primer paso, y el más importante, es decidir cómo se traslada cada pieza.
- Los tipos de contenido se convierten en tipos de entrada: páginas y artículos usan los tipos incluidos, y el resto se convierten en tipos de entrada personalizados.
- Los campos se convierten en campos personalizados, normalmente con Advanced Custom Fields (ACF), o en atributos de bloque cuando los editores deben controlar el diseño.
- Los campos de referencia se convierten en relaciones entre entradas, o en términos de taxonomía cuando la referencia es en realidad una categoría o etiqueta.
- Los campos Rich Text se convierten en bloques de Gutenberg. Contentful guarda el texto enriquecido como JSON estructurado, así que cada tipo de nodo necesita una regla: párrafos, encabezados, listas, entradas incrustadas y archivos incrustados.
- Los campos localizados, si usas locales en Contentful, necesitan un plan para definir cómo vivirá cada idioma en WordPress.
Escribe esta relación en una tabla y haz que la aprueben antes de ejecutar cualquier código. Todos los pasos siguientes dependen de ella, y cambiarla a mitad de camino obliga a repetir las importaciones.
Paso 2: Haz un inventario de cada URL y entrada
Exporta una lista de cada página publicada con su URL, su tipo de contenido y su tráfico según tu analítica o Search Console. Cuenta las entradas por tipo de contenido y anota lo inusual: páginas muy largas, entradas con muchas referencias o contenido publicado que no está enlazado desde ningún lugar. El inventario será tu lista de control durante la validación y la base del mapa de redirecciones.
También es el momento de decidir qué no migrar. Las páginas desactualizadas sin tráfico ni enlaces pueden retirarse, siempre que cada una redirija a la página relevante más cercana.
Paso 3: Exporta el contenido y los archivos
La CLI de Contentful puede exportar un espacio completo, con tipos de contenido, entradas, archivos y locales, a un archivo JSON, y la Content Management API cubre lo que necesite una extracción más específica. Exporta más de una vez: una exportación temprana para construir y probar los scripts de importación, y una final justo antes del cambio, tras un breve congelamiento de contenido para que no se pierda nada publicado en Contentful.
Los archivos necesitan su propia pasada. Descarga cada imagen y documento, conserva los nombres originales cuando sea posible y registra qué archivo de Contentful se convirtió en qué elemento de la biblioteca de medios de WordPress, para poder reescribir las referencias en el texto enriquecido y en los campos.
Paso 4: Transforma e importa
Los scripts de importación leen la exportación, aplican la relación del paso uno y crean el contenido en WordPress mediante WP-CLI o la REST API. El JSON de Rich Text se convierte nodo por nodo en marcado de bloques, las entradas incrustadas pasan a ser los bloques correspondientes y los enlaces entre entradas se reescriben con sus nuevas URLs de WordPress.
Haz que la importación se pueda repetir. Debe ser seguro borrar el sitio de pruebas y volver a ejecutarla desde cero, porque la correrás muchas veces mientras corriges casos especiales. Registra cada entrada que falle o necesite atención manual en lugar de omitirla en silencio.
Paso 5: Conserva URLs, redirecciones y SEO
Siempre que puedas, conserva las mismas URLs. Donde la estructura tenga que cambiar, crea una redirección 301 de cada URL antigua a la nueva usando el inventario del paso dos. Traslada los títulos de página, las meta descripciones, las imágenes para redes sociales y las URLs canónicas, que en Contentful suelen vivir en un tipo de contenido de SEO aparte y son fáciles de olvidar.
Revisa el sitemap, la configuración de robots y los datos estructurados del sitio nuevo antes del lanzamiento. El sitio de pruebas debe bloquear a los buscadores, y el día del lanzamiento hay que quitar ese bloqueo. Dejarlo puesto es una de las razones más comunes por las que un sitio desaparece de Google después de una migración. Las mismas revisiones aplican a cualquier rediseño de sitio web.
Paso 6: Valida antes del cambio
La validación es donde una migración se gana la confianza. Recorre el inventario, no te guíes por impresiones.
- Conteos: el número de entradas por tipo de contenido en Contentful coincide con el número de entradas por tipo en WordPress.
- Revisiones puntuales: compara una muestra de páginas lado a lado, incluidas las más largas y complejas.
- Enlaces: rastrea el sitio de pruebas en busca de enlaces internos rotos e imágenes faltantes.
- Redirecciones: prueba cada URL antigua del inventario y confirma que devuelve un 301 a la página correcta.
- Editores: pide a quienes usarán WordPress que creen y editen contenido real antes del lanzamiento.
Paso 7: Haz el cambio y vigila
El cambio suele ser una modificación de DNS o de proxy programada en una ventana de bajo tráfico, con el sitio antiguo disponible para revertir. Después del lanzamiento, envía el sitemap nuevo en Search Console, vigila durante unas semanas los informes de indexación y de páginas no encontradas, y corrige cualquier redirección que falte. Algo de movimiento en el posicionamiento las primeras semanas es normal; las pérdidas duraderas casi siempre vienen de redirecciones faltantes o contenido perdido.
Si quieres ayuda para planificar o ejecutar una migración así, mira mi servicio de migración de sitios web, o el caso de Nielsen para un trabajo relacionado con bloques de Gutenberg a medida.