Reindexar los precios de productos por zona de país

Usa los comandos de WP-CLI de ámbito de sitio cuando el índice de administración necesite instalación, inspección, validación o una reconstrucción controlada. Esta guía está pensada para administradores de sitios con acceso a la línea de comandos.

Antes de empezar

• Haz una copia de seguridad de la base de datos del sitio según tu política habitual de operaciones.
• Confirma que WooCommerce y POM Tweaks están activos en el sitio de destino.
• Usa --url para seleccionar exactamente un sitio. El comando nunca recorre automáticamente todos los sitios de una red multisitio.
• Ejecuta los comandos desde la instalación de WordPress o proporciona la opción de ruta global de WP-CLI adecuada.

Sustituye https://store.example en los ejemplos por la URL del sitio de destino.

Inspeccionar el sitio actual

Ejecuta:

wp pomtweaks country-zone-pricing status --url=https://store.example

Revisa el ID de blog seleccionado, el número de zonas, la preparación del esquema, el número de productos guardados, el número de filas indexadas, el estado de reconstrucción, el cursor y el número de errores.

Validar sin realizar escrituras

Ejecuta:

wp pomtweaks country-zone-pricing reindex --dry-run --batch-size=50 --url=https://store.example

La ejecución en seco valida el documento de precio por país de cada producto en lotes delimitados. No instala el índice, no cambia los metadatos de los productos ni escribe filas en el índice.

Instalar o reconstruir

Para instalar o actualizar el índice vacío del sitio actual sin escanear productos, ejecuta:

wp pomtweaks country-zone-pricing install --url=https://store.example

Para reconstruir todos los productos principales y sus variaciones, ejecuta:

wp pomtweaks country-zone-pricing reindex --batch-size=100 --url=https://store.example

Para una ventana de mantenimiento con una cantidad fija de trabajo, limita el número de lotes:

wp pomtweaks country-zone-pricing reindex --batch-size=50 --max-batches=10 --url=https://store.example

Si quedan productos, el comando imprime un cursor de reanudación. Continúa con el mismo sitio seleccionado y el cursor:

wp pomtweaks country-zone-pricing reindex --batch-size=50 --start-after=12345 --url=https://store.example

El resultado esperado es cero errores de validación y un estado final de complete. Una ejecución limitada deliberadamente informa de paused hasta que se reanuda.

Verificar el resultado

1. Ejecuta de nuevo el comando status.
2. Confirma que schema_ready es yes y que reindex_errors es 0.
3. Confirma que reindex_status es complete después del lote final.
4. Abre Products → All Products y comprueba las columnas de zonas habilitadas para productos representativos simples, variables, de suscripción y de suscripción variable.
5. Abre Tools → Site Health → Status y confirma que Country pricing product index está en buen estado.

Solución de problemas

Un producto falla en la validación

El comando identifica el producto. Edita ese producto, corrige el valor regional indicado, guárdalo y reanuda desde un cursor anterior al producto fallido para que se procese de nuevo.

El comando apunta al subsitio equivocado

Detenlo y vuelve a ejecutarlo con el --url exacto de la tienda deseada. Los datos de productos y el índice están deliberadamente aislados por sitio.

Una ejecución limitada se detiene con productos restantes

Esto es lo esperado cuando se usa --max-batches. Copia el cursor --start-after impreso en el siguiente comando.

Site Health indica que el índice se está reconstruyendo

Espera a que termine el proceso en segundo plano delimitado, o ejecuta el comando de reindexado explícito durante una ventana de mantenimiento adecuada.