--- titulo: Checklist completo de migración de Avada a Astra autor: Auditour — Auditoría Turística SL web: https://auditour.eu version: 1.0 metodo: WP Staging (gratuito) + renombrado de carpetas + AB Fusion Inventory probado_en: 3 migraciones reales tags: [wordpress, avada, astra, migracion, checklist] --- # Checklist — migrar WordPress de Avada a Astra > **Cómo usarlo.** Recorre las fases en orden. Los pasos marcados con 🛑 requieren decisión o intervención humana: no los automatices. > **Antes de empezar:** copia de seguridad completa. Ninguna guía sustituye a un backup. --- ## Fase 0 · ¿Es tu web candidata? - [ ] Contar contenidos con Fusion Builder ```sql SELECT COUNT(*) FROM wp_postmeta WHERE meta_key IN ('_fusion','fusion_builder_status'); ``` - [ ] Ver qué hay fuera de `post_content` ```sql SELECT post_type, post_status, COUNT(*) AS n FROM wp_posts WHERE post_type LIKE 'fusion%' OR post_type LIKE 'avada%' OR post_type LIKE 'slide%' GROUP BY post_type, post_status; ``` | CPT | Qué contiene | Se rehace en | |---|---|---| | `fusion_tb_section` | Cabeceras, pies, plantillas globales | Constructor de Astra | | `fusion_element` | Elementos reutilizables | HTML o patrón de Gutenberg | | `fusion_template` | Plantillas de contenido | Manual | | `slide` | Slides del Fusion Slider | Decidir si se mantiene | | `fusion_form` | Formularios de Avada | Contact Form 7 u otro | **Regla práctica:** si la mayoría es texto corrido en contenedores de ancho completo, adelante. Si casi todo son maquetaciones complejas, el coste se acerca al de rehacer la web. - [ ] 🛑 **Decidir la congelación de publicaciones.** Todo lo que se publique en producción tras el clonado se pierde al promover. Pactarlo el primer día, no al final. --- ## Fase 1 · Clonar a staging - [ ] Instalar **WP Staging** y **Better Search Replace** - [ ] Crear el clon con nombre reconocible (`astra`) - [ ] 🚨 **Subir «Omitir archivos mayores de» de 8 MB a 1024 MB.** Deja fuera vídeos, PDF y ZIP sin avisar - [ ] Anotar: **prefijo de tablas** del clon, base de datos y ruta física - [ ] 🛑 Iniciar sesión en el clon (suele estar protegido por login) ### Lo que WP Staging hace por su cuenta - [ ] Pone `WP_CACHE` a `false` - [ ] **Desactiva los enlaces permanentes** → las URLs pasan a `?page_id=123` - [ ] **Excluye algunos plugins**: anotar cuáles, sus carpetas no viajarán a producción - [ ] Desactiva el firewall renombrando su `.user.ini` ⚠️ **Lo que no se puede probar en staging:** estructura de URLs ni redirecciones 301. Se evalúan desde la raíz del dominio. 💡 En el contenido que reconstruyas, usa **URLs absolutas de producción**: funcionan el día del cambio y no dependen del search-replace. --- ## Fase 2 · Limpiar el clon Desactivar **solo en la copia**: - [ ] Caché (WP Super Cache, WP Rocket, LiteSpeed…) - [ ] Firewall / seguridad (Wordfence…) - [ ] Envío a buscadores (IndexNow) - [ ] Optimizadores de imagen (Imagify, Smush…) - [ ] Chat, píxeles, newsletters - [ ] Comprobador de enlaces rotos - [ ] Backups programados ⚠️ Si el plugin de seguridad ofrece **borrar sus tablas** al desactivarse, **di que no**: producción y staging comparten base de datos. - [ ] ✅ Verificar que el **`noindex`** está activo en el clon --- ## Fase 3 · Inventario y clasificación - [ ] Instalar y activar **AB Fusion Inventory** - [ ] Herramientas → Inventario Fusion → **Resumen**: anotar el reparto simple / media / compleja - [ ] Pestaña **Entorno Avada**: anotar CPT, claves de `postmeta` y opciones - [ ] Exportar CSV | Clase | Criterio | |---|---| | **SIMPLE** | Solo contenedores + `fusion_text`, columnas `1_1` | | **MEDIA** | Elementos con equivalente HTML directo | | **COMPLEJA** | Columnas fraccionadas o elementos sin equivalente | - [ ] 🛑 **Decidir** qué contenidos proteger además de los COMPLEJOS, qué hacer con los borradores y con las páginas vacías --- ## Fase 4 · Rescatar lo que se pierde en silencio ### Logo y favicon - [ ] 🚨 Buscar el logo en la biblioteca de medios: **Avada lo guarda en `fusion_options`, no en la identidad del sitio** - [ ] 🛑 Conseguir un **favicon de 512 × 512 px como mínimo** (WordPress rechaza menos) ### Elementos globales - [ ] Localizar cada `[fusion_global id="X"]` y ver qué contiene el CPT `fusion_element` - [ ] Anotar qué contenidos los usan: al desactivar Avada se quedan en blanco - [ ] Descartar los huérfanos (habitualmente la mayoría) ### Formularios y menú - [ ] Comprobar si existe `fusion_form` y si ya hay Contact Form 7 conviviendo - [ ] 🚨 Revisar `_menu_item_fusion_megamenu`: **si hay megamenú de Avada, la navegación hay que rehacerla** --- ## Fase 5 · Activar Astra - [ ] Comprobar si hay **tema hijo** con código propio en `functions.php` → 🛑 si lo hay, hay que portarlo - [ ] Instalar y activar **Astra** - [ ] ✅ Si las páginas salen **en blanco** con cabecera y pie correctos → desactivar **Avada Core / Fusion Core** - [ ] ✅ Comprobar que los **menús** siguen asignados - [ ] ⚠️ **Dejar Avada Builder activo**: permite revertir y mantiene visible el contenido sin convertir --- ## Fase 6 · Conversión masiva - [ ] Pestaña **Conversión** → «Añadir todas las COMPLEJAS» a la lista de exclusión - [ ] Añadir los IDs que se hayan decidido proteger - [ ] Elegir formato de salida: **HTML estándar** (editor clásico) o **bloques Gutenberg** - [ ] **Simulacro (no escribe)** → ✅ debe dar **0 omitidas** y **0 residuos** - [ ] 🛑 **Validar el simulacro** antes de escribir - [ ] **Convertir de verdad** y confirmar ### ✅ Verificación obligatoria tras convertir - [ ] Recuento: convertidas = simple + media · errores = 0 - [ ] 🚨 **Comprobar que las imágenes sobrevivieron.** El simulacro NO lo comprueba ```js // En la consola del navegador, con sesión iniciada. Debe devolver cero. const RE = /(^|\n|>)[ \t]*(https?:\/\/[^\s<"']+\.(?:jpg|jpeg|png|webp|gif))[ \t]*(?=\n|<|$)/gi; for (const tipo of ['pages','posts']) { const r = await fetch(`/wp-json/wp/v2/${tipo}?per_page=100&context=edit&_fields=id,title,content`, { credentials: 'same-origin' }); (await r.json()).forEach(p => { const n = (p.content.raw.match(RE) || []).length; if (n) console.log(tipo, p.id, p.title.raw, '→', n); }); } ``` - [ ] Abrir 3-4 páginas en el frontal: encabezados, negritas, enlaces y shortcodes ajenos --- ## Fase 7 · Reconstruir los contenidos complejos Por grupos, no uno a uno. Orden recomendado de menos a más trabajo: - [ ] Contenidos que solo tienen `fusion_global` → volcar el elemento - [ ] Contenidos con `fusion_youtube` → `