Migrar el contenido de Finder a la búsqueda por facetas
POM ofrece un comando de WP-CLI para convertir los shortcodes heredados de Finder almacenados a los elementos actuales de búsqueda por facetas. Úsalo solo en un sitio que todavía contenga contenido de Finder.
El comando convierte el contenido almacenado compatible, crea los contextos de búsqueda por facetas correspondientes, activa la función cuando se aplican los cambios y reindexa. También informa de las referencias que aún requieren revisión.
Esto es opcional e independiente de crear un Finder en Gutenberg. Los bloques nativos de Finder conservan el motor de Finder existente; crear uno no ejecuta esta migración, no activa la búsqueda por facetas ni crea un índice. El comando está dirigido al contenido de shortcodes heredados, no a los bloques nativos de Finder.
Requisitos previos
- El código actual de POM Theme está activo.
- WP-CLI puede cargar el sitio de WordPress de destino.
- Existe una copia de seguridad actual de la base de datos.
- Conoces la URL exacta del sitio en una instalación multisitio.
- Las páginas de Finder y su comportamiento esperado están documentados para compararlos.
Previsualizar la migración
Ejecuta:
wp pom migrate-finder-to-faceted-search --dry-run --url=https://example.comLa previsualización informa de las sustituciones, los contextos generados, las advertencias y las referencias restantes de Finder almacenadas sin escribir cambios.
Resuelve las advertencias que harían ambiguo el resultado. Usa --fail-on-remaining cuando una comprobación automatizada o mediante script deba terminar sin éxito si quedan advertencias o referencias almacenadas:
wp pom migrate-finder-to-faceted-search --dry-run --fail-on-remaining --url=https://example.comAplicar
Después de revisar la ejecución de prueba y la copia de seguridad:
wp pom migrate-finder-to-faceted-search --url=https://example.comPara las opciones de red multisitio que contienen contenido de Finder de forma intencionada, añade --include-network-options.
Una ejecución aplicada imprime un ID de ejecución de reversión cuando se realizaron sustituciones. Registra ese ID junto con el sitio y las notas de verificación.
Verificar las páginas convertidas
- Abre la lista de contextos de búsqueda por facetas e inspecciona los contextos generados.
- Espera a que la reindexación termine.
- Compara los resultados iniciales con la antigua página de Finder.
- Prueba cada filtro convertido, el comportamiento de envío, el restablecimiento, la ordenación, la paginación, los mapas y el diseño adaptable.
- Busca en el sitio las referencias de Finder restantes indicadas por el comando.
- Mantén disponibles los componentes heredados hasta que esta revisión esté completa.
Revertir una ejecución
Si la verificación falla y los valores almacenados deben restaurarse, usa el ID de ejecución registrado:
wp pom migrate-finder-to-faceted-search --rollback=20260712-120000-abc123 --url=https://example.comLa reversión restaura los valores registrados por esa ejecución aplicada. No sustituye la necesidad de la copia de seguridad previa a la migración ni deshace ediciones no relacionadas realizadas después.