This module adds a snippet with a dropdown and an input text field, is a base for be inherited by others modules into an HTML form.
This can be inserted into form elements.
Table of contents
Usage
To extend this template you need to inherit country_dropdown
template and
add your personal code.
The template have three input text:
no_country_field
: Field without code country.country_code_field
: Field with only country code (read only)complete_field
: Field with the previous two joined (hidden)
The name of the complete field is customizable when user insert the snippet into a form element with the website editor.
Development
You can call the reusable Qweb template called
website_snippet_country_dropdown.country_dropdown
in your views to add a
sensible country-combined field, ideal for VATs.
The default country will be the first match among:
- Extract it from the
default_country
variable. - Extract it from the first 2 letters of the
default_value
variable. - The current user’s country.
- The current website’s company’s country.
- The first country in the list.
All variables you can use to modify its behavior:
complete_field
to give it a name. Usually it will match the field name.default_value
for thecomplete_field
.countries
as ares.country
ORM recordset.default_country
as ares.country
record.no_country_placeholder
.
You can view an example in website_sale_checkout_country_vat
in
OCA/e-commerce.
Known issues / Roadmap
- Add tests.
- Snippet drag and drop seems to be blocked by Odoo for some unknown reason.. Given the main purpose of this module is to provide a reusable template for other modules to use, did not take the time to fix that use case.
Bug Tracker
Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.
Do not contact contributors directly about support or help with technical issues.
Credits
Contributors
- Sergio Teruel
- Jairo Llopis
- Alexandre Díaz
- Carlos Roca
- Ernesto Tejeda
Maintainers
This module is maintained by the OCA.
OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.
This module is part of the OCA/website project on GitHub.
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.