Table of Contents
Este proyecto comenzó como un tema PHP estándar y evolucionó hacia una demostración técnica de una Migración de Clásico a FSE. Roteiro de Viagem es un blog de viajes minimalista diseñado con un enfoque “Mobile-First”, centrándose en la velocidad y la experiencia de lectura.
Visión General del Proyecto
Inicialmente, construí este proyecto utilizando la estructura tradicional de WordPress (Tema Clásico) para consolidar mis habilidades en PHP y manipulación de loops. Sin embargo, a medida que el ecosistema evolucionó, decidí refactorizar todo el código base, convirtiéndolo en un Block Theme. Este ejercicio fue crucial para entender el puente entre el código heredado y la arquitectura de bloques moderna.
El Desafío: Realizar una Migración de Clásico a FSE
El desafío principal no fue solo construir un blog, sino cambiar completamente el motor que lo ejecuta.
- Fase 1 (Legado): Construido con PHP puro,
style.cssy jerarquía de plantillas estándar (index.php,single.php). - Fase 2 (Modernización): El objetivo era eliminar la dependencia de plantillas PHP para el diseño y delegar el control al Editor del Sitio, requiriendo una estrategia completa de Migración de Clásico a FSE.
Ejecución Técnica: Cómo se realizó la Migración
Para lograr una Migración de Clásico a FSE exitosa, seguí pasos de desarrollo estrictos:
- Refactorización HTML y CSS: Limpié el HTML “hardcoded” y convertí partes del diseño en Patrones de Bloques flexibles.
- Adoptando theme.json: Reemplacé las hojas de estilo CSS masivas con un archivo
theme.jsonestructurado para controlar la tipografía, paleta y configuraciones de diseño globalmente. - Conversión de Plantillas: Retiré las plantillas PHP y reconstruí los diseños de Single Post e Inicio usando marcado de bloques HTML, dando al usuario control total para cambiar logotipos, enlaces y banners a través del editor.
¿Por qué sin Page Builders?
Este proyecto evita estrictamente constructores de páginas como Elementor o Divi. Al usar funciones nativas del núcleo de WordPress y Git para control de versiones, aseguré que el código permaneciera ligero. La Migración de Clásico a FSE resultó en un sitio que obtiene altas puntuaciones en pruebas de rendimiento porque no carga librerías externas innecesarias.
Conclusión
“Roteiro de Viagem” sirve como una prueba de concepto. Demuestra mi capacidad para navegar tareas de refactorización complejas y confirma que puedo manejar tanto sistemas heredados como los flujos de trabajo más recientes de Migración de Clásico a FSE requeridos por las agencias modernas.
Preguntas Frecuentes (FAQ)
¿Qué es una Migración de Clásico a FSE?
Es el proceso de convertir un tema de WordPress tradicional basado en PHP en un moderno Block Theme (FSE). Esto implica mover la lógica de archivos PHP a plantillas HTML y theme.json, dando al usuario control total de edición.
¿Por qué migrar de Clásico a FSE?
Una Migración de Clásico a FSE reduce la complejidad del código (“código espagueti”), mejora el rendimiento del sitio al cargar menos scripts y empodera al cliente para editar encabezados y pies de página sin necesitar un desarrollador para cada pequeño cambio.



