You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

67 lines
2.4 KiB

  1. .. image:: https://img.shields.io/badge/licence-AGPL--3-blue.svg
  2. :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
  3. :alt: License: AGPL-3
  4. =========================
  5. Filters for x2many fields
  6. =========================
  7. This module was written to allow developers to add filter buttons to an x2many field.
  8. .. image:: /web_x2m_filter/static/description/screenshot.png
  9. :alt: Screenshot
  10. Usage
  11. =====
  12. To use this module, you need to:
  13. #. add a key ``web_x2m_filter`` to the field's ``options`` dictionary
  14. #. this key should contain a list if dictionaries which describe a button by the properties ``name`` and ``domain``::
  15. {'web_x2m_filter': [{'name': 'Only admins', 'domain': [('groups_id', '=', %(base.group_erp_manager)s)]}]}
  16. #. to have one filter being active on form load, add a key named ``default`` with value ``True``
  17. #. the string in ``name`` is subject to the standard translation mechanism
  18. #. the domain is evaluated with the user's context and the current form values
  19. .. image:: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas
  20. :alt: Try me on Runbot
  21. :target: https://runbot.odoo-community.org/runbot/162/8.0
  22. Bug Tracker
  23. ===========
  24. Bugs are tracked on `GitHub Issues
  25. <https://github.com/OCA/web/issues>`_. In case of trouble, please
  26. check there if your issue has already been reported. If you spotted it first,
  27. help us smashing it by providing a detailed and welcomed feedback.
  28. Credits
  29. =======
  30. Images
  31. ------
  32. * Odoo Community Association: `Icon <https://github.com/OCA/maintainer-tools/blob/master/template/module/static/description/icon.svg>`_.
  33. Contributors
  34. ------------
  35. * Holger Brunn <hbrunn@therp.nl>
  36. Do not contact contributors directly about help with questions or problems concerning this addon, but use the `community mailing list <mailto:community@mail.odoo.com>`_ or the `appropriate specialized mailinglist <https://odoo-community.org/groups>`_ for help, and the bug tracker linked in `Bug Tracker`_ above for technical issues.
  37. Maintainer
  38. ----------
  39. .. image:: https://odoo-community.org/logo.png
  40. :alt: Odoo Community Association
  41. :target: https://odoo-community.org
  42. This module is maintained by the OCA.
  43. OCA, or the Odoo Community Association, is a nonprofit organization whose
  44. mission is to support the collaborative development of Odoo features and
  45. promote its widespread use.
  46. To contribute to this module, please visit https://odoo-community.org.