OdooWiki OCA HUB

Website Snippet Country Code Dropdown

website_snippet_country_dropdown folder_open OCA/website open_in_new
Website Licencia: LGPL-3

Este módulo añade un snippet con un desplegable y un campo de texto de entrada, es una base para ser heredada por otros módulos en un formulario HTML.

Esto se puede insertar en elementos de formulario.

Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.

auto_awesome Qué hace este módulo

Generado por IA a partir del código · Odoo 18.0

Añade un snippet de lista desplegable de país para los formularios del sitio web, permitiendo a los visitantes elegir una bandera y un código de país que se combinan con un número escrito en un único campo oculto.

Este módulo proporciona a los creadores de sitios web un selector de país ya preparado que se puede insertar en cualquier formulario HTML de una página del sitio web.

  • El snippet muestra un botón de bandera que abre una lista desplazable con todos los países, un pequeño cuadro de solo lectura con el código del país seleccionado y un campo de texto donde el visitante escribe el resto del valor (por ejemplo, un número de IVA o de identificación fiscal).
  • Cuando se elige un país, la bandera y el código se actualizan inmediatamente, y el código se une automáticamente a lo que se escriba en el campo de texto para rellenar un campo oculto que es el que realmente se envía con el formulario.
  • El país inicial se toma de un valor predeterminado; en su defecto, del país del usuario conectado; en su defecto, del país de la compañía del sitio web; en su defecto, del primer país de la lista.
  • El snippet se puede establecer como solo lectura, y los nombres de los campos, la etiqueta y el placeholder pueden ser configurados por la persona que crea la página.
  • Las imágenes de las banderas de los países se cargan solo cuando se hacen visibles en el desplegable, lo que mantiene la página rápida.
  • Se añade una página de demostración llamada "Country dropdown demo" al menú del sitio web para probar el comportamiento, y un recorrido guiado comprueba que al seleccionar un país y escribir texto se generan los valores enviados esperados.

El módulo funciona en el frontend del sitio web y utiliza los datos de países ya almacenados en Odoo (res.country).

Texto generado por IA (DeepSeek) al leer el código de la versión 18.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. Ver el código en GitHub

Disponibilidad por versión

Revisado: 2026-11-03
Confirmado (verificado en repositorio y rama) Estimado (sin verificar) Sin información

Estado de confirmación: 6 confirmadas, 3 sin información de 9 versiones.

terminal Instalación y uso

Documentación de OCA · Odoo 18.0

Para extender esta plantilla necesitas heredar la plantilla country_dropdown y añadir tu código personal.

La plantilla tiene tres campos de texto de entrada:

  • no_country_field: Campo sin código de país.
  • country_code_field: Campo con solo el código de país (solo lectura)
  • complete_field: Campo con los dos anteriores unidos (oculto)

El nombre del campo completo es personalizable cuando el usuario inserta el snippet en un elemento de formulario con el editor del sitio web.

Desarrollo

Puedes llamar a la plantilla Qweb reutilizable llamada website_snippet_country_dropdown.country_dropdown en tus vistas para añadir un campo sensible combinado con el país, ideal para NIFs.

El país predeterminado será la primera coincidencia entre:

  • Extraerlo de la variable default_country.
  • Extraerlo de las 2 primeras letras de la variable default_value.
  • El país del usuario actual.
  • El país de la compañía del sitio web actual.
  • El primer país de la lista.

Todas las variables que puedes usar para modificar su comportamiento:

  • complete_field para darle un nombre. Normalmente coincidirá con el nombre del campo.
  • default_value para el complete_field.
  • countries como un ORM recordset res.country.
  • default_country como un registro res.country.
  • no_country_placeholder.

Puedes ver un ejemplo en website_sale_checkout_country_vat en OCA/e-commerce.

Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen. Sin información verificada en OCA: Instalación, Configuración.

info

Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.