Descrizione
AllpaCode Ubigeo Perú permite agregar selectores dependientes de departamento, provincia y distrito en sitios WordPress, formularios personalizados, tiendas WooCommerce y plugins que necesiten datos territoriales del Perú.
El plugin entrega el código UBIGEO final del distrito seleccionado y expone componentes reutilizables mediante shortcode, funciones PHP públicas y endpoints REST.
Características principales:
- Selector dependiente mediante shortcode.
- API PHP pública para integraciones con otros plugins.
- API REST pública para consultas dinámicas.
- Integración opcional con el checkout de WooCommerce.
- Compatibilidad con Contact Form 7 mediante shortcodes.
- Datos de departamento, provincia y distrito derivados de una fuente pública basada en INEI, RENIEC y SUNAT.
- Recursos frontend ligeros, sin dependencia de jQuery.
- Preparado para traducciones.
Shortcode:
[allpacode_ubigeo_peru]
Campos obligatorios:
[allpacode_ubigeo_peru required="true"]
Prefijo personalizado para nombres de campos:
[allpacode_ubigeo_peru name_prefix="cliente"]
Funciones PHP públicas:
allpacode_ubigeo_get_departamentos()allpacode_ubigeo_get_provincias( $codigo_departamento )allpacode_ubigeo_get_distritos( $codigo_provincia )allpacode_ubigeo_get_by_code( $codigo_ubigeo )allpacode_ubigeo_is_available()
Endpoints REST:
/wp-json/allpacode-ubigeo/v1/departamentos/wp-json/allpacode-ubigeo/v1/provincias?departamento=15/wp-json/allpacode-ubigeo/v1/distritos?provincia=1501/wp-json/allpacode-ubigeo/v1/ubicacion/150101
Installazione
- Sube la carpeta
allpacode-ubigeo-perua/wp-content/plugins/. - Activa el plugin desde la pantalla de plugins de WordPress.
- Ve a Ajustes > Ubigeo Perú para revisar las opciones disponibles.
- Inserta
[allpacode_ubigeo_peru]en páginas, formularios, widgets o constructores visuales. - Activa la integración con WooCommerce si deseas agregar campos UBIGEO al checkout.
FAQ
-
¿Cuál es el shortcode?
-
Usa
[allpacode_ubigeo_peru]. -
¿Puedo usarlo desde otro plugin?
-
Sí. El plugin expone funciones PHP públicas, endpoints REST y un shortcode reutilizable.
-
¿Funciona con WooCommerce?
-
Sí. Puedes activar los campos de departamento, provincia, distrito y código UBIGEO desde Ajustes > Ubigeo Perú.
-
¿Funciona con Contact Form 7?
-
Sí. Inserta el shortcode
[allpacode_ubigeo_peru]dentro del formulario. El plugin habilita el procesamiento de shortcodes en Contact Form 7. -
¿Cuál es la fuente de datos?
-
El conjunto de datos incluido deriva de la fuente pública CONCYTEC/ubigeo-peru, que documenta equivalencias entre códigos UBIGEO de INEI, RENIEC y SUNAT. Repositorio: https://github.com/CONCYTEC/ubigeo-peru
El conjunto original se distribuye bajo la licencia Creative Commons Attribution 4.0 International. Los detalles de atribución están incluidos en
docs/data-source.md.
Recensioni
Non ci sono recensioni per questo plugin.
Contributi e sviluppo
“AllpaCode Ubigeo Perú” è un software open source. Le persone che hanno contribuito allo sviluppo di questo plugin sono indicate di seguito.
Collaboratori
Traduci “AllpaCode Ubigeo Perú” nella tua lingua.
Ti interessa lo sviluppo?
Esplora il codice segui il repository SVN, segui il log delle modifiche tramite RSS.
Changelog
1.0.1
- Actualiza la documentación pública en español.
- Cambia el shortcode público a
[allpacode_ubigeo_peru]. - Cambia las funciones PHP públicas al prefijo
allpacode_ubigeo. - Cambia los endpoints REST al prefijo
/allpacode-ubigeo/v1/. - Agrega iconos para la ficha pública del repositorio de WordPress.
1.0.0
- Versión pública inicial.
- Selectores dependientes de departamento, provincia y distrito.
- API PHP pública.
- API REST pública.
- Integración opcional con WooCommerce.
- Compatibilidad con shortcodes en Contact Form 7.