Regenerar referencias de medios del Page Builder
Esta guía de WP-CLI está destinada a administradores y desarrolladores que actualizan contenido creado antes de que POM almacenara los medios locales del Page Builder como referencias de adjuntos persistentes.
El comando vuelve a guardar cada entrada y página de WordPress en un sitio. También procesa las entradas que pertenecen a los tipos de contenido personalizados configurados en los ajustes de POM Theme cuando el tipo de entrada registrado admite la edición de contenido. Durante cada guardado normal, POM añade atributos de shortcode complementarios *_attachment_id para las URL de medios locales. Las URL de medios externos permanecen sin cambios.
Antes de empezar
- Crea una copia de seguridad de la base de datos o ejecuta el comando primero en un entorno de pruebas.
- Ejecuta el comando con un
--urlexplícito en multisitio. - Comprueba que POM Theme y su Page Builder incluido estén activos para el sitio de destino.
- Permite que otras integraciones normales de
save_postse ejecuten mientras el comando esté activo.
El comando no solicita una purga global de la caché y no llama directamente a ningún plugin de caché. WordPress y los plugins activos pueden seguir invalidando una entrada individual a través de sus ganchos de guardado normales.
Vista previa del alcance
Cuenta las entradas y páginas aptas sin guardar el contenido:
wp pom regenerate-media-references --url=https://example.com --dry-runLos borradores automáticos, las revisiones, los adjuntos, los bloques reutilizables y los tipos de contenido personalizados no creados a través de los ajustes de POM Theme quedan fuera del alcance de este comando. Un tipo de contenido personalizado configurado por el tema se incluye únicamente cuando sus soportes registrados contienen editor. Se incluyen los contenidos publicados, programados, en borrador, privados, pendientes y en la papelera.
Regenerar las referencias
Ejecuta el comando de forma interactiva:
wp pom regenerate-media-references --url=https://example.comPara una ejecución desatendida, confirma la operación de forma explícita:
wp pom regenerate-media-references --url=https://example.com --yesPOM procesa 100 IDs a la vez de forma predeterminada. Los sitios grandes pueden elegir un tamaño de lote entre 1 y 1.000:
wp pom regenerate-media-references --url=https://example.com --batch-size=250 --yesEl comando muestra los slugs exactos de los tipos de entrada que va a procesar. Conserva las fechas de modificación existentes de cada entrada. Su resumen final informa del total de elementos aptos, los guardados correctos, las entradas cuyo contenido de shortcode cambió y los fallos.
Comprobar el resultado
- Comprueba que el comando termina sin fallos.
- Edita una entrada o página que contenga una imagen local del Page Builder.
- Inspecciona su contenido de shortcode y confirma que el parámetro de URL tiene un parámetro complementario como
get_image_attachment_id="345-medium". - Abre la página con Query Monitor y confirma que la URL local correspondiente ya no llama a
attachment_url_to_postid(). - Comprueba un shortcode que contenga una imagen externa y confirma que su URL se sigue mostrando y no tiene ninguna referencia de adjunto.
Resultado esperado: las URL de imágenes locales heredadas en entradas, páginas y tipos de contenido personalizados de POM aptos adquieren IDs de adjunto y tamaños persistentes, mientras que las URL externas y las fechas de modificación existentes permanecen sin cambios.
Solución de problemas
Si una entrada falla, el comando informa de su ID y del error de WordPress. Resuelve ese error y ejecuta el comando de nuevo; las referencias existentes se actualizan de forma idempotente.
Si una URL local sigue sin resolverse, confirma que pertenece al directorio de subidas del sitio actual y que su registro de adjunto aún existe. Los medios de otro sitio multisitio se tratan intencionadamente como externos.