README.rst

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.

Table of contents

• Usage
  • Development
• Known issues / Roadmap
• Bug Tracker
• Credits
  • Authors
  • Contributors
  • Maintainers

Usage

To extend this template you need to inherit country_dropdown template and add your personal code.

The template have three input text:

1. no_country_field: Field without code country.
2. country_code_field: Field with only country code (read only)
3. 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:

1. Extract it from the default_country variable.
2. Extract it from the first 2 letters of the default_value variable.
3. The current user's country.
4. The current website's company's country.
5. 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.

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

Authors

• Tecnativa

Contributors

• Tecnativa:
  • 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.