=== Codigos Postales España - API Gratuita ===
Contributors: fichiando
Tags: codigos postales, postal codes, spain, autocompletar, autocomplete, direcciones, festivos, municipios, woocommerce
Requires at least: 5.0
Tested up to: 6.4
Stable tag: 2.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Autocompletado de direcciones y festivos locales para WordPress. 11.058 codigos postales de España y Andorra. 100% GRATIS.

== Description ==

Este plugin conecta tu WordPress con la API gratuita de [api.cerocoma.net](https://api.cerocoma.net), proporcionando:

* **11.058 codigos postales** de España y Andorra
* **8.131 municipios** con datos completos
* **5.293 municipios** con festivos locales (2023-2026)
* **6.726 municipios** con coordenadas GPS

**FUNCIONALIDADES:**

= Autocompletado de direcciones =
Cuando el usuario escribe un codigo postal, el plugin rellena automaticamente los campos de municipio y provincia. Compatible con:

* Contact Form 7
* WPForms
* Gravity Forms
* Elementor Forms
* WooCommerce Checkout
* Cualquier formulario HTML estandar

= Festivos locales =
Muestra los festivos locales de cualquier municipio de España usando shortcodes.

= 100% Gratuito =
Sin limites de uso, sin API key, sin registro. La API es completamente gratuita.

**CREADO POR:** El equipo de [Fichiando](https://fichiando.com)
**CONTACTO:** info@fichiando.com

== Shortcodes ==

**Autocompletar direcciones:**
`[cp_autocompletar campo_cp="codigo_postal" campo_municipio="ciudad" campo_provincia="provincia"]`

**Festivos por codigo postal:**
`[festivos_locales cp="30001"]`

**Festivos por codigo INE:**
`[festivos_locales ine="30030"]`

**Buscar municipio:**
`[festivos_municipio nombre="Murcia"]`

== Parametros ==

= cp_autocompletar =
* `campo_cp` - Nombre del campo de codigo postal (default: codigo_postal)
* `campo_municipio` - Nombre del campo de municipio (default: municipio)
* `campo_provincia` - Nombre del campo de provincia (default: provincia)
* `mostrar_campos` - Mostrar campos propios (true/false, default: true)

= festivos_locales =
* `cp` - Codigo postal (5 digitos)
* `ine` - Codigo INE del municipio
* `anio` - Año a mostrar (default: año actual)
* `mostrar_municipio` - Mostrar nombre (true/false)
* `mostrar_provincia` - Mostrar provincia (true/false)
* `estilo` - tarjeta, lista o minimo

== Installation ==

1. Sube la carpeta `codigos-postales-api` a `/wp-content/plugins/`
2. Activa el plugin desde 'Plugins' en WordPress
3. El autocompletado funciona automaticamente en formularios
4. Usa los shortcodes para mostrar festivos

== Frequently Asked Questions ==

= ¿Es gratuito? =
Si, tanto el plugin como la API son 100% gratuitos, sin limites.

= ¿Necesito API key? =
No, no necesitas registro ni API key.

= ¿Funciona con WooCommerce? =
Si, autocompleta los campos de checkout automaticamente.

= ¿Incluye Andorra? =
Si, incluye las 7 parroquias de Andorra (AD100-AD700).

= ¿Como puedo apoyar el proyecto? =
Si te resulta util, considera invitarnos a un cafe:
* Ko-fi: https://ko-fi.com/FichIAndo
* PayPal: https://paypal.me/FichIAndo

== Screenshots ==

1. Autocompletado de direcciones en formulario
2. Shortcode de festivos estilo tarjeta
3. Panel de administracion
4. Widget de festivos en sidebar

== Changelog ==

= 2.0.0 =
* NUEVO: Autocompletado de direcciones en formularios
* NUEVO: Deteccion automatica de campos de CP
* NUEVO: Compatibilidad con WooCommerce, CF7, WPForms, etc.
* NUEVO: Panel de administracion con documentacion
* NUEVO: Soporte para Andorra (AD100-AD700)
* Mejorado: Cache de 24 horas para mejor rendimiento
* Mejorado: Estilos CSS actualizados

= 1.0.0 =
* Version inicial con shortcodes de festivos

== Upgrade Notice ==

= 2.0.0 =
Nueva version con autocompletado de direcciones. Actualiza para obtener las nuevas funcionalidades.

== Credits ==

Desarrollado por el equipo de Fichiando.

Los datos de codigos postales y festivos provienen de fuentes oficiales (INE, BOE, boletines autonomicos) y han sido recopilados y estructurados para esta API gratuita.

Si usas este plugin en un proyecto comercial, considera hacer una donacion para apoyar el mantenimiento:

* Ko-fi: https://ko-fi.com/FichIAndo
* PayPal: https://paypal.me/FichIAndo
