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.

120 lines
4.4 KiB

  1. =============
  2. MuK DB Filter
  3. =============
  4. This module allows to add additional filter criteria to the ``dbfilter``
  5. function using a request header. To pass a regular expression to the
  6. filter set the ``X-Odoo-dbfilter`` header field on the request and make
  7. sure that Odoo runs with an enabled proxy mode.
  8. Installation
  9. ============
  10. To install this module, you need to:
  11. Download the module and add it to your Odoo addons folder. Afterward, log on to
  12. your Odoo server and go to the Apps menu. Trigger the debug mode and update the
  13. list by clicking on the "Update Apps List" link. Now install the module by
  14. clicking on the install button.
  15. Another way to install this module is via the package management for Python
  16. (`PyPI <https://pypi.org/project/pip/>`_).
  17. To install our modules using the package manager make sure
  18. `odoo-autodiscover <https://pypi.org/project/odoo-autodiscover/>`_ is installed
  19. correctly. Note that for Odoo version 11.0 and later this is not necessary anymore.
  20. Then open a console and install the module by entering the following command:
  21. ``pip install --extra-index-url https://nexus.mukit.at/repository/odoo/simple <module>``
  22. The module name consists of the Odoo version and the module name, where
  23. underscores are replaced by a dash.
  24. **Module:**
  25. ``odoo<version>-addon-<module_name>``
  26. **Example:**
  27. ``sudo -H pip3 install --extra-index-url https://nexus.mukit.at/repository/odoo/simple odoo13-addon-muk-utils``
  28. Once the installation has been successfully completed, the app is already in the
  29. correct folder. Log on to your Odoo server and go to the Apps menu. Trigger the
  30. debug mode and update the list by clicking on the "Update Apps List" link. Now
  31. install the module by clicking on the install button.
  32. The biggest advantage of this variant is that you can now also update the app
  33. using the "pip" command. To do this, enter the following command in your console:
  34. ``pip install --upgrade --extra-index-url https://nexus.mukit.at/repository/odoo/simple <module>``
  35. When the process is finished, restart your server and update the application in
  36. Odoo. The steps are the same as for the installation only the button has changed
  37. from "Install" to "Upgrade".
  38. You can also view available Apps directly in our `repository <https://nexus.mukit.at/#browse/browse:odoo>`_
  39. and find a more detailed installation guide on our `website <https://mukit.at/page/open-source>`_.
  40. For modules licensed under a proprietary license, you will receive the access data after you purchased
  41. the module. If the purchase were made at the Odoo store please contact our `support <support@mukit.at>`_
  42. with a confirmation of the purchase to receive the corresponding access data.
  43. Upgrade
  44. ============
  45. To upgrade this module, you need to:
  46. Download the module and add it to your Odoo addons folder. Restart the server
  47. and log on to your Odoo server. Select the Apps menu and upgrade the module by
  48. clicking on the upgrade button.
  49. If you installed the module using the "pip" command, you can also update the
  50. module in the same way. Just type the following command into the console:
  51. ``pip install --upgrade --extra-index-url https://nexus.mukit.at/repository/odoo/simple <module>``
  52. When the process is finished, restart your server and update the application in
  53. Odoo, just like you would normally.
  54. Configuration
  55. =============
  56. Since this module need to be activated even if no database is selected it should
  57. be loaded right at the server start. This can be done by editing the configuration
  58. file or passing a load parameter to the start script.
  59. Parameter: ``--load=web,muk_session_store``
  60. Usage
  61. =====
  62. After loading the module, the ``dbfilter`` function reacts to request headers.
  63. Credit
  64. ======
  65. Contributors
  66. ------------
  67. * Kerrim Abdelhamed <kerrim.abdelhamed@mukit.at>
  68. * Mathias Markl <mathias.markl@mukit.at>
  69. Images
  70. ------
  71. Some pictures are based on or inspired by the icon set of Font Awesome:
  72. * `Font Awesome <https://fontawesome.com>`_
  73. Author & Maintainer
  74. -------------------
  75. This module is maintained by the `MuK IT GmbH <https://www.mukit.at/>`_.
  76. MuK IT is an Austrian company specialized in customizing and extending Odoo.
  77. We develop custom solutions for your individual needs to help you focus on
  78. your strength and expertise to grow your business.
  79. If you want to get in touch please contact us via `mail <sale@mukit.at>`_
  80. or visit our `website <https://mukit.at>`_.