Comprobar el estado y la compatibilidad de las zonas de país

Site Health proporciona comprobaciones acotadas para los servicios, la configuración y el índice de productos que utiliza la fijación de precios por zonas de país. Las comprobaciones no analizan el catálogo de productos.

Ejecutar las comprobaciones

1. Ve a Tools → Site Health → Status.
2. Busca las comprobaciones con la insignia POM Country Pricing.
3. Revisa los nueve resultados:
   • Country pricing WooCommerce runtime
   • Country pricing plugin conflicts
   • Country pricing zone configuration
   • Country pricing geolocation
   • Country pricing proxy trust
   • Country pricing product index
   • Country pricing product-type compatibility
   • Country pricing universal cache safety
   • Country pricing Product Add-Ons execution
4. Usa Open country zone settings cuando un resultado de configuración necesite atención.

Interpretar los resultados

Tiempo de ejecución de WooCommerce

Un buen resultado significa que los servicios de cliente, sesión, lista de países y geolocalización están disponibles. Un resultado crítico significa que WooCommerce debe estar activado antes de que se pueda confiar en el contexto de zonas.

Conflictos de plugins

Un resultado crítico significa que WooCommerce Price Based on Country o su complemento Pro está activo. Dos motores de precios por país no deben controlar la misma solicitud, por lo que los filtros de precio comercial y de consulta de catálogo de POM permanecen sin registrar hasta que el motor en conflicto esté inactivo.

Configuración de zonas

• Correcto: el esquema almacenado, los UUID, las asignaciones de países, la alternativa habilitada y la revisión son válidos.
• Recomendado: todavía no se ha creado ninguna zona.
• Crítico: el documento almacenado está mal formado o es incoherente. Abre los ajustes y guarda una configuración corregida.

Geolocalización

• Correcto: la geolocalización del lado del servidor de WooCommerce puede resolver a los visitantes anónimos antes de la alternativa del país base.
• Recomendado: WooCommerce utiliza la dirección base de la tienda o la geolocalización AJAX como modo de ubicación del cliente. El resolvedor sigue pidiendo a WooCommerce un país de IP del lado del servidor antes de usar el país base de la tienda, pero las primeras respuestas anónimas y los valores predeterminados de cliente de WooCommerce necesitan una estrategia de caché deliberada antes de introducir precios regionales.

La búsqueda de país utiliza los datos de geolocalización del lado del servidor configurados en WooCommerce. No hace que una solicitud de la tienda espere a una búsqueda saliente de IP externa; cuando los datos configurados no pueden resolver la dirección de cliente de confianza, se aplica la alternativa normal de la tienda base.

Confianza en el proxy

• Correcto: la solicitud llega directamente al origen, o el modo estricto acepta una dirección de cliente válida de un proxy inmediato explícitamente confiable.
• Recomendado — modo de compatibilidad: no hay rangos de proxy confiables configurados y POM acepta un valor válido de X-Real-IP o la primera dirección válida en X-Forwarded-For. Esto preserva la compatibilidad con WooCommerce sin configuración, pero no puede demostrar que la cabecera de reenvío fue escrita por la infraestructura de la tienda.
• Recomendado — modo estricto: hay rangos de proxy confiables configurados, pero el proxy inmediato o la cadena de direcciones suministrada no se puede validar. POM ignora la cabecera de reenvío y utiliza la dirección directa del par de origen.

El resultado nunca muestra ni almacena direcciones de visitantes ni de proxies.

El modo de compatibilidad es el predeterminado. Elige la primera dirección válida disponible en este orden:

1. X-Real-IP.
2. La primera dirección separada por comas en X-Forwarded-For.
3. El par de origen directo REMOTE_ADDR.

La dirección seleccionada se utiliza únicamente como entrada para la resolución de país. Los precios y las solicitudes de compra siguen siendo recalculados por el servidor, el cliente de WooCommerce confirmado o el país de pago tiene prioridad, y la lista efectiva de países de venta de WooCommerce sigue siendo la autoridad. Sin embargo, un visitante que pueda suministrar una cabecera de reenvío aceptada puede seleccionar temporalmente el precio, la disponibilidad, la configuración de Product Add-On o de Composite de otra zona. Usa el modo estricto cuando esas diferencias requieran un límite de infraestructura autenticado.

Para habilitar el modo estricto en la instalación de WordPress, define al menos una dirección de proxy exacta o un rango CIDR y selecciona la cabecera que el borde confiable sobrescribe:

define( 'POM_TWEAKS_COUNTRY_ZONE_PRICING_TRUSTED_PROXIES', [ '203.0.113.0/24' ] );
define( 'POM_TWEAKS_COUNTRY_ZONE_PRICING_PROXY_HEADER', 'HTTP_CLOUDFRONT_VIEWER_ADDRESS' );

Sustituye el rango de ejemplo por direcciones propiedad del despliegue. Las cabeceras seleccionadas admitidas son HTTP_X_FORWARDED_FOR, HTTP_X_REAL_IP, HTTP_CF_CONNECTING_IP y HTTP_CLOUDFRONT_VIEWER_ADDRESS. Una vez que existe al menos un rango confiable válido, POM deja de usar automáticamente el modo de compatibilidad. Para X-Forwarded-For, el modo estricto recorre la cadena desde el origen hacia atrás hasta la primera dirección que no sea un proxy confiable.

En multisitio, las constantes wp-config.php se aplican a todos los sitios de esa instalación de WordPress. Dejar las constantes sin definir mantiene el modo de compatibilidad sin configuración en todos los sitios.

Índice de productos

• Correcto: el índice de productos versionado del sitio actual está listo y la última reconstrucción no tiene errores reportados.
• Recomendado: el índice no se ha reconstruido, o hay una reconstrucción acotada en cola, en ejecución o deliberadamente pausada. La edición puede continuar mientras termina.
• Crítico: el índice no está disponible o un producto falló la validación durante la sincronización. Ejecuta el comando de reindexación a nivel de sitio y revisa el producto reportado.

Compatibilidad de tipos de producto

• Correcto: todos los tipos de producto observados por el tiempo de ejecución pertenecen a una familia admitida.
• Recomendado: un tipo de producto personalizado llegó al motor. Ese tipo conservó deliberadamente su precio normal de WooCommerce; revisa el tipo listado antes del lanzamiento.

Seguridad de caché universal

• Correcto: el marcado de precio público puede usar una única página neutral compartida y la respuesta regional es privada y no almacenable en caché.
• Recomendado: mantén las páginas de producto y de catálogo fuera de la caché de páginas compartida. El resultado enumera códigos de motivo conservadores para un cliente faltante, un modo de geolocalización en conflicto, un tipo de producto no admitido o una integración de precios activa que aún no proporciona datos públicos neutrales.

Después de una migración heredada, un resultado recomendado puede listar rollout_cache_bypass incluso cuando todas las superficies técnicas son compatibles. Esto significa que el propietario del lanzamiento en producción aún no ha aprobado el HTML compartido universal, o ha devuelto deliberadamente el sitio al modo de omisión. Mantén la omisión activa hasta que se complete la revisión operativa.

La advertencia de proxy de compatibilidad no bloquea por sí misma el HTML universal. La página compartida sigue siendo neutral en cuanto al país y la respuesta regional sigue siendo privada y no almacenable en caché. Una cadena fallida sí bloquea el HTML universal después de que se haya configurado el modo de proxy estricto, porque ese despliegue requiere explícitamente reenvío autenticado.

Sigue Entender la carga universal de precios antes de habilitar la caché compartida para las superficies de producto de WooCommerce.

Ejecución de Product Add-Ons

• Correcto: ninguna devolución de llamada heredada de precios por país de Product Add-Ons puede ejecutarse junto al puente de POM.
• Crítico: Price Based on Country Pro está activo. El puente de POM permanece omitido para evitar una segunda conversión; mantenlo omitido hasta que la integración heredada esté inactiva y el documento regional revisado de Product Add-Ons esté listo.

Verificar el comportamiento del contexto

Usa un sitio de pruebas o una vista previa controlada de administrador suministrada por una función de POM compatible.

1. Comprueba un país asignado a una zona habilitada y confirma una anulación representativa, una oferta, un producto no disponible y un rango variable.
2. Comprueba un país no asignado a ninguna zona y confirma que sigue la política de visualización de precios alternativa seleccionada.
3. Comprueba un país fuera de la lista efectiva de países de venta de WooCommerce y confirma que la compra está bloqueada incluso si un precio alternativo es visible.
4. Compara el orden de precios ascendente y descendente, los filtros de precio mínimo y máximo, y los productos en oferta en ambas zonas.
5. Confirma que una oferta futura utiliza su importe normal y tiene acciones de inicio y fin programadas.
6. Deshabilita una zona que no sea alternativa y confirma que sus países usan la alternativa.
7. Repite las comprobaciones en cada subsitio de WooCommerce que habilite la herramienta.

Cambiar la zona resuelta debe cambiar únicamente los valores efectivos de esa zona. Volver a la primera zona debe restaurar sus valores originales sin contaminación de la caché de variaciones.

Recuperación

Si un resultado de estado se vuelve crítico después de un cambio de ajustes, corrige las filas de zona y guarda de nuevo. Si se requiere una reversión inmediata, deshabilita Country pricing zones en Settings → POM Tweaks → E-Commerce → Products. Una herramienta deshabilitada no registra ganchos de precio regional, consulta de catálogo, contexto ni diagnóstico, y deja su configuración específica del sitio disponible para su corrección posterior.

Para la recuperación del índice, sigue Reindexar los precios de productos por zonas de país. El comando explícito valida el catálogo en lotes acotados mientras que el Site Health rutinario permanece acotado.