=== Provincias y Distritos de Panamá para Woocommerce ===
Contributors: saulmoralespa
Tags: woocommerce, panama, states, districts, shipping, provinces, panama states
Requires at least: 6.0
Tested up to: 6.8
Requires PHP: 8.1
Stable tag: 2.0.0
WC requires at least: 8.9
WC tested up to: 10.2.2
Requires Plugins: woocommerce
License: GNU General Public License v3.0
License URI: http://www.gnu.org/licenses/gpl-3.0.html

Agrega las provincias y distritos oficiales de Panamá a WooCommerce para una gestión precisa de direcciones y envíos.

== Description ==

**Provincias y Distritos de Panamá para Woocommerce** es un plugin esencial para tiendas WooCommerce ubicadas en Panamá que necesitan gestionar direcciones de envío con las divisiones administrativas oficiales del país.

Este plugin reemplaza los campos genéricos de estado/provincia y ciudad de WooCommerce con las **provincias** y **distritos** oficiales de Panamá, proporcionando una experiencia de checkout más precisa y profesional para tus clientes.

= Características principales =

* **Provincias oficiales de Panamá** - Incluye todas las provincias y comarcas indígenas
* **Distritos por provincia** - Listado completo de distritos organizados por provincia
* **Integración nativa con WooCommerce** - Se integra perfectamente con los campos de dirección estándar
* **Orden inteligente de campos** - Reorganiza automáticamente los campos de provincia y distrito para mejor UX
* **Compatible con HPOS** - Totalmente compatible con las tablas personalizadas de pedidos de WooCommerce
* **Selectores dinámicos** - Los distritos se cargan dinámicamente según la provincia seleccionada
* **Compatible con checkout y cuenta de usuario** - Funciona en checkout, registro y edición de direcciones
* **Optimizado para envíos** - Facilita la configuración de zonas de envío por provincia y distrito

= Provincias incluidas =

El plugin incluye todas las provincias y comarcas indígenas de Panamá:

* Bocas del Toro
* Coclé
* Colón
* Chiriquí
* Darién
* Herrera
* Los Santos
* Panamá
* Panamá Oeste
* Veraguas
* Comarca Emberá-Wounaan
* Comarca Guna Yala
* Comarca Ngäbe-Buglé

= Casos de uso =

* **Tiendas de e-commerce** - Direcciones precisas para envío de productos
* **Servicios de delivery** - Cálculo de tarifas por zona geográfica
* **Configuración de zonas de envío** - Crear zonas de envío específicas por provincia o distrito
* **Reportes y analytics** - Análisis de ventas por región geográfica
* **Cumplimiento normativo** - Uso de divisiones administrativas oficiales

= Mejoras en la experiencia de usuario =

* **Previene errores**: Los clientes no pueden ingresar nombres incorrectos de provincias o distritos
* **Autocompletado**: Selectores tipo dropdown facilitan la selección
* **Validación automática**: WooCommerce valida que las direcciones sean correctas
* **Coherencia de datos**: Todas las direcciones usan la misma nomenclatura oficial

= Integración con zonas de envío =

El plugin permite configurar zonas de envío de WooCommerce utilizando:
* Provincias específicas
* Distritos específicos
* Combinaciones de provincia + distrito

Esto facilita la configuración de:
* Tarifas de envío diferenciadas por región
* Métodos de envío específicos por zona
* Restricciones de envío geográficas

= Compatibilidad =

* Compatible con WordPress Multisite
* Compatible con WooCommerce High-Performance Order Storage (HPOS)
* Compatible con temas y plugins de WooCommerce populares
* Compatible con plugins de envío como Servientrega Panamá

= Requisitos del sistema =

* WordPress 6.0 o superior
* WooCommerce 8.9 o superior
* PHP 8.1 o superior
* País de la tienda configurado en Panamá (PA)

= Instalación manual =

1. Descarga el archivo ZIP del plugin
2. Ve a tu panel de administración de WordPress
3. Navega a Plugins > Añadir nuevo > Subir plugin
4. Selecciona el archivo ZIP y haz clic en "Instalar ahora"
5. Activa el plugin

= Configuración =

El plugin **no requiere configuración**. Una vez activado:

1. **Configuración automática**: El plugin se activa automáticamente
2. **Verifica tu tienda**: Ve a WooCommerce > Ajustes > General
3. **Confirma el país**: Asegúrate de que "País / Estado de la tienda" esté en Panamá
4. **Prueba el checkout**: Ve a tu página de checkout y verás los campos actualizados

= Verificación de la instalación =

Para verificar que el plugin está funcionando correctamente:

1. Ve a tu página de checkout (puedes añadir un producto al carrito)
2. En la sección de dirección de envío, verás:
   * Campo "Provincia" con un selector dropdown
   * Campo "Distrito" con opciones que cambian según la provincia seleccionada
3. Selecciona una provincia y verifica que los distritos correspondientes aparezcan

= Configuración de zonas de envío =

Para configurar zonas de envío por provincia o distrito:

1. Ve a WooCommerce > Ajustes > Envío
2. Añade una nueva zona de envío o edita una existente
3. En "Regiones de la zona", selecciona "Panamá" como país
4. Podrás seleccionar provincias específicas (ej: "PA - Panamá")
5. Añade métodos de envío a esa zona
6. Guarda los cambios

== Frequently Asked Questions ==

= ¿El plugin requiere configuración? =

No, el plugin funciona automáticamente al activarse. No necesita ninguna configuración adicional.

= ¿Funciona con cualquier tema de WooCommerce? =

Sí, el plugin utiliza los hooks estándar de WooCommerce, por lo que es compatible con cualquier tema que siga las mejores prácticas de WooCommerce.

= ¿Puedo usar este plugin si mi tienda no está en Panamá? =

El plugin está diseñado específicamente para tiendas ubicadas en Panamá. Si tu tienda está en otro país, no necesitas este plugin.

= ¿El plugin afecta el rendimiento de mi sitio? =

No, el plugin es muy ligero y solo carga los datos necesarios cuando se requieren. No afecta negativamente el rendimiento.

= ¿Los distritos se actualizan automáticamente al cambiar la provincia? =

Sí, cuando un cliente selecciona una provincia, el campo de distrito se actualiza automáticamente con los distritos correspondientes mediante JavaScript.

= ¿Es compatible con WooCommerce HPOS (High-Performance Order Storage)? =

Sí, el plugin declara compatibilidad completa con las tablas personalizadas de pedidos de WooCommerce.

= ¿Funciona en el área de administración? =

Sí, el plugin funciona tanto en el frontend (checkout) como en el backend (cuando editas pedidos o direcciones de clientes desde el panel de administración).

= ¿Puedo configurar tarifas de envío diferentes por provincia? =

Sí, puedes crear zonas de envío en WooCommerce y asignar provincias específicas a cada zona, configurando tarifas diferentes para cada una.

= ¿El plugin incluye corregimientos? =

En esta versión, el plugin incluye provincias y distritos. Los corregimientos podrían añadirse en futuras versiones según la demanda.

= ¿Qué hace el filtro de prioridad de campos? =

El plugin reorganiza automáticamente el orden de los campos para que la "Provincia" aparezca antes que el "Distrito", mejorando la lógica y experiencia de usuario en el formulario de dirección.

= ¿Es compatible con plugins de envío de Panamá? =

Sí, el plugin es compatible con otros plugins de envío para Panamá, como el plugin de [Shipping Servientrega Panamá Woocommerce](https://github.com/saulmoralespa/shipping-servientrega-pa-woo).

= ¿Funciona con WordPress Multisite? =

Sí, el plugin es compatible con instalaciones WordPress Multisite.

= ¿Los datos de las provincias y distritos están actualizados? =

Sí, el plugin utiliza las divisiones administrativas oficiales de Panamá actualizadas.

== Screenshots ==

1. Selector de provincias en el checkout
2. Selector de distritos que se actualiza según la provincia seleccionada
3. Campos de dirección reorganizados con provincias y distritos
4. Configuración de zonas de envío por provincia
5. Edición de direcciones en el área de cuenta del usuario

== Changelog ==

= 2.0.0 - 2025-01-15 =
* Actualización mayor a PHP 8.1+
* Compatibilidad con WooCommerce 8.9 - 10.2.2
* Compatibilidad con WordPress 6.0 - 6.8
* Declaración de compatibilidad con HPOS (High-Performance Order Storage)
* Declaración de dependencia de WooCommerce mediante "Requires Plugins"
* Mejoras en la reorganización de prioridad de campos
* Optimización del código para PHP moderno
* Mejoras en el manejo de hooks y filtros
* Código refactorizado y limpio

= 1.0.0 =
* Lanzamiento inicial
* Incluye todas las provincias de Panamá
* Incluye todos los distritos por provincia
* Selectores dinámicos de distrito según provincia
* Integración con campos de dirección de WooCommerce
* Soporte para checkout y área de cuenta

== Upgrade Notice ==

= 2.0.0 =
Actualización importante: Requiere PHP 8.1+ y WooCommerce 8.9+. Por favor, asegúrate de cumplir con estos requisitos antes de actualizar. Esta versión incluye compatibilidad completa con HPOS y las últimas versiones de WooCommerce.

= 1.0.0 =
Primera versión del plugin.

== Additional Info ==

= Créditos =

* Desarrollado por Saúl Morales Pacheco
* Sitio web: https://saulmoralespa.com

= Estructura de datos =

El plugin almacena las provincias y distritos siguiendo la estructura estándar de WooCommerce:
* **Provincias**: Se mapean al campo "state" de WooCommerce
* **Distritos**: Se mapean al campo "city" de WooCommerce

Esta estructura permite una integración perfecta con:
* Zonas de envío de WooCommerce
* Cálculos de impuestos por región
* Reportes y analytics
* Plugins de terceros

= Reorganización de campos =

El plugin incluye un filtro que reorganiza automáticamente los campos de dirección para que aparezcan en el orden más lógico:

1. País
2. **Provincia** (State)
3. **Distrito** (City)
4. Dirección
5. Código postal (si aplica)

Esto mejora significativamente la experiencia de usuario al completar formularios de dirección.

= Funcionalidad JavaScript =

El plugin incluye JavaScript optimizado para:
* Actualizar dinámicamente los distritos al seleccionar una provincia
* Validar campos en tiempo real
* Mejorar la experiencia de usuario en dispositivos móviles
* Versión minificada para producción (district-select.min.js)

= Hooks y filtros disponibles =

El plugin respeta los hooks estándar de WooCommerce:
* `woocommerce_default_address_fields` - Reorganiza la prioridad de campos

= Compatibilidad de país =

El plugin está diseñado específicamente para el código de país **PA** (Panamá) según el estándar ISO 3166-1 alpha-2.

= Soporte =

Si tienes problemas o preguntas:
* Visita: https://saulmoralespa.com
* Revisa la sección FAQ de este readme
* Verifica que tu instalación cumple con los requisitos mínimos

= Contribuciones =

Las contribuciones son bienvenidas. Si deseas mejorar el plugin o reportar errores, por favor contacta al desarrollador.

= Licencia =

Este plugin es software libre distribuido bajo la licencia GNU General Public License v3.0. Eres libre de usar, modificar y distribuir este plugin bajo los términos de esta licencia.

== Privacy Policy ==

Este plugin no recopila, almacena ni transmite ninguna información personal de los usuarios. Toda la información de direcciones se gestiona directamente por WooCommerce siguiendo sus políticas de privacidad estándar.

El plugin solo proporciona datos de divisiones administrativas públicas (provincias y distritos) de Panamá, que no constituyen información sensible o privada.