Migrar los helpers de tamaño de fuente heredados
Usa wp pom migrate-font-size-helpers después de actualizar un sitio que contenga las clases retiradas con nombres en píxeles fs-*. El comando sustituye esos nombres por los helpers actuales basados en rem, conservando el HTML circundante, los comentarios de bloque, los shortcodes y las estructuras de datos almacenadas.
Mapa de sustitución
| Helpers retirados | Helper actual |
|---|---|
fs-9, fs-10 |
fs-05 |
fs-11, fs-12, fs-13 |
fs-075 |
fs-14, fs-16, fs-18 |
fs-1 |
fs-20, fs-22, fs-24, fs-26 |
fs-125 |
fs-28, fs-30, fs-35, fs-40 |
fs-2 |
fs-45, fs-50 |
fs-3 |
Los destinos de sustitución corresponden a 0,5, 0,75, 1, 1,25, 2 y 3rem. fs-0375, que representa 0,375rem, también está disponible para contenido nuevo, pero no tiene un predecesor automático en esta migración.
Vista previa y aplicación
Este comando usa el motor unificado de migración de helpers, limitado a los helpers de tamaño de fuente. Para migrar fuentes, espacios y espaciados juntos con un solo escaneo, usa wp pom migrate-helpers en su lugar.
Vista previa sin escrituras de contenido:
wp pom migrate-font-size-helpers --dry-run --url=https://example.testAplica con un directorio privado existente, escribible y con modo 0700 fuera de WordPress:
wp pom migrate-font-size-helpers --apply --backup-dir=/private/migrations --url=https://example.testTodos los comandos de helpers usan la simulación por defecto; omitir --dry-run no aplica los 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 los sitios con tema POM en la red actual. Los datos compartidos de usuario, las opciones de red y las plantillas administradas compartidas requieren --include-shared; --include-network-options añade solo las opciones de red. Consulta la guía unificada para conocer 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 medias. Verifica páginas y plantillas representativas en el editor y en el frontend, y vuelve a ejecutar con --dry-run --fail-on-remaining. Los objetos o referencias serializados no admitidos, o los valores ambiguos, se conservan y se notifican para su revisión manual.