.. image:: https://img.shields.io/badge/licence-LGPL--3-blue.svg
:target: http://www.gnu.org/licenses/lgpl-3.0-standalone.html
:alt: License: LGPL-3
=====================================
Website Snippet Country Code Dropdown
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.
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 the complete_field
.countries
as a res.country
ORM recordset.default_country
as a res.country
record.no_country_placeholder
.
You can view an example in website_sale_checkout_country_vat
in
OCA/e-commerce.
.. image:: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas
:alt: Try me on Runbot
:target: https://runbot.odoo-community.org/runbot/186/9.0
Known issues / Roadmap
- Add tests.
- Flag images should be lazy-loaded to optimize loading.
- Snippet drag and drop
seems to be blocked by Odoo for some unknown reason. <https://github.com/OCA/website/pull/230#issuecomment-236681777>
_.
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 <https://github.com/OCA/website/issues>
_. In case of trouble, please
check there if your issue has already been reported. If you spotted it first,
help us smashing it by providing a detailed and welcomed feedback.
Credits
Images
- Odoo Community Association:
Icon <https://github.com/OCA/maintainer-tools/blob/master/template/module/static/description/icon.svg>
_.
Contributors
Maintainer
.. image:: https://odoo-community.org/logo.png
:alt: Odoo Community Association
:target: https://odoo-community.org
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.
To contribute to this module, please visit https://odoo-community.org.