Añade un selector de país y provincia a un formulario de WordPress
Si alguien cambia el país de Estados Unidos a Canadá en un formulario de WordPress, California debería desaparecer y dar paso a las provincias canadienses. Con dos listas fijas, te toca mantener esa relación. El widget de CountriesDB actualiza las opciones de la segunda lista según el país elegido.
La guía para formularios web explica el fragmento HTML común y cómo preparar la cuenta.
Qué necesitas
Necesitas controlar el HTML del formulario y cómo se procesan sus envíos. Puedes usar un bloque de HTML personalizado con tu propio formulario o una plantilla de tu tema. WPForms, Gravity Forms y Contact Form 7 gestionan sus propios campos y envíos. Esta guía usa el widget independiente en tu propio HTML.
Crea un proyecto de CountriesDB, genera una clave pública y añade el nombre de host de la página publicada a la lista de dominios permitidos.
Cómo añadir los campos en WordPress
1. Abre el HTML del formulario
Usa un bloque de HTML personalizado en el editor, o edita la plantilla si el tema genera el formulario. La documentación de WordPress sobre HTML personalizado explica qué permisos afectan al guardado de scripts. Si el editor elimina el script, pide a quien administra el sitio que lo cargue desde el tema.
2. Añade el widget y los campos
Coloca los dos selectores dentro del formulario existente y usa los nombres de campo que espera el sistema que recibe los datos. Carga el script una sola vez por página y sustituye el marcador por tu clave pública. Conserva el botón de envío y el sistema que procesa el formulario.
<script src="https://unpkg.com/@countriesdb/widget@latest/dist/index.js?public_key=YOUR_PUBLIC_KEY"></script>
<label for="country">País</label>
<select id="country" name="country" class="country-selection"
data-name="country" data-label="Selecciona un país" data-preselected="" required></select>
<label for="region">Estado / provincia / región</label>
<select id="region" name="region" class="subdivision-selection"
data-country="country" data-label="Selecciona una región"></select>
3. Publica y haz un envío de prueba
Abre la página publicada en el host permitido. Elige un país y una región, cambia de país y comprueba que se borra la región anterior. Haz un envío de prueba y revisa los valores en el destino, por ejemplo en tu CRM. Si las listas siguen vacías, comprueba que el HTML publicado conserva el script y que el host está permitido.
Preguntas frecuentes
¿Necesito ayuda de desarrollo?
Puedes pegar los campos si ya controlas el HTML y el procesamiento de los envíos. Pide ayuda si el tema genera el formulario o hay que adaptar su procesamiento.
¿Puedo mostrar estados y provincias?
Sí, cuando hay datos de subdivisiones para el país elegido. En un formulario internacional, usa una etiqueta amplia como «Estado / provincia / región».
¿El bloque envía correos o guarda contactos?
Tu sistema de procesamiento sigue a cargo de esas tareas. El widget rellena los dos selectores.
¿Cómo compruebo los códigos enviados?
Llama a la API de validación desde tu servidor y guarda allí la clave privada.