Migrar los helpers de separación heredados
Usa wp pom migrate-gap-helpers después de actualizar un sitio que contenga los helpers basados en píxeles web-gap* retirados, los valores de separación heredados [web_gap] o [web_parallax_layer_text], o un bloque dinámico anterior pom/gap. El comando traslada esos valores a la escala rem actual y convierte los bloques Gap antiguos a su forma HTML estática.
Mapa de sustitución
| Helper o valor de shortcode retirado | Helper actual | Altura |
|---|---|---|
web-gap-10, gap_space="10" |
web-gap-075, gap_space="075" |
0.75rem |
web-gap, web-gap-20, gap_space="20" |
web-gap-125, gap_space="125" |
1.25rem |
web-gap-30, gap_space="30" |
web-gap-2, gap_space="2" |
2rem |
web-gap-40, web-gap-50, gap_space="40", gap_space="50" |
web-gap-3, gap_space="3" |
3rem |
web-gap-60, gap_space="60" |
web-gap-4, gap_space="4" |
4rem |
web-gap-8 y web-gap-12 ofrecen nuevas opciones de 8rem y 12rem sin predecesores heredados.
El mismo mapa gap_space se aplica a web_parallax_layer_text, que usa estos helpers para el espacio antes de su encabezado.
Previsualizar y aplicar
Este comando usa el motor unificado de migración de helpers, limitado a los helpers de separación. Para migrar fuentes, separaciones y espaciados juntos con un solo análisis, usa wp pom migrate-helpers en su lugar.
Previsualiza sin escribir contenido:
wp pom migrate-gap-helpers --dry-run --url=https://example.testAplica con un directorio privado existente, con permisos de escritura y modo 0700, fuera de WordPress:
wp pom migrate-gap-helpers --apply --backup-dir=/private/migrations --url=https://example.testTodos los comandos de helpers simulan por defecto; omitir --dry-run no aplica cambios. El progreso se muestra por fase, y --verbose enumera cada ubicación propuesta. El comando guarda los originales exactos y los valores propuestos en una copia de seguridad privada antes de aplicar los cambios. Deja todas las cachés y los recursos generados sin modificar.
Usa --network para sitios POM-theme en la red actual. Los datos de usuario compartidos, las opciones de red y las plantillas gestionadas compartidas requieren --include-shared; --include-network-options añade solo las opciones de red. Consulta la guía unificada para el alcance, los límites de formato, el progreso, la gestión de escrituras simultáneas y la recuperación tras una interrupción.
Las conversiones completadas se conservan en ejecuciones repetidas, incluso después de que una migración anterior se detuviera a mitad de camino. Verifica páginas y plantillas representativas en el editor y en el frontend, y luego vuelve a ejecutar con --dry-run --fail-on-remaining. Los objetos o referencias serializados no compatibles y los valores ambiguos se conservan y se informan para su revisión manual.
Los bloques antiguos autocerrados pom/gap se expanden al marcado estático guardado. Sus clases personalizadas se sanean y se conservan; los valores heredados size en bloques Gap emparejados también se convierten. Verifica que los bloques Gap migrados sigan siendo seleccionables y se muestren correctamente tanto en el editor como en el frontend.