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.

109 lines
3.2 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. Multiple Images Base
  6. ====================
  7. This module extends the functionality of any model to support multiple images
  8. (a gallery) attached to it and allow you to manage them.
  9. Installation
  10. ============
  11. This module adds abstract models to work on. Its sole purpose is to serve as
  12. base for other modules that implement galleries, so if you install this one
  13. manually you will notice no change. You should install any other module based
  14. on this one and this will get installed automatically.
  15. Usage
  16. =====
  17. To manage all stored images, you need to:
  18. * Go to *Settings > Configuration > Multi images*.
  19. ... but you probably prefer to manage them from the forms supplied by
  20. submodules that inherit this behavior.
  21. Development
  22. ===========
  23. To develop a module based on this one:
  24. * See module ``product_multi_image`` as an example.
  25. * You have to inherit model ``base_multi_image.owner`` to the model that needs
  26. the gallery::
  27. class MyOwner(models.Model):
  28. _name = "my.model.name"
  29. _inherit = ["my.model.name", "base_multi_image.owner"]
  30. # If you need this, you will need ``post_init_hook_for_submodules``
  31. old_image_field = fields.Binary(related="image_main", store=False)
  32. * Somewhere in the owner view, add::
  33. <field
  34. name="image_ids"
  35. nolabel="1"
  36. context="{
  37. 'default_owner_model': 'my.model.name',
  38. 'default_owner_id': id,
  39. }"
  40. mode="kanban"/>
  41. .. image:: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas
  42. :alt: Try me on Runbot
  43. :target: https://runbot.odoo-community.org/runbot/149/8.0
  44. Known issues / Roadmap
  45. ======================
  46. * *OS file* storage mode for images is meant to provide a path where Odoo has
  47. read access and the image is already found, **not for making the module store
  48. images there**. It would be nice to add that feature though.
  49. Bug Tracker
  50. ===========
  51. Bugs are tracked on `GitHub Issues
  52. <https://github.com/OCA/server-tools/issues>`_. In case of trouble, please
  53. check there if your issue has already been reported. If you spotted it first,
  54. help us smashing it by providing a detailed and welcomed `feedback
  55. <https://github.com/OCA/
  56. server-tools/issues/new?body=module:%20
  57. base_multi_image%0Aversion:%20
  58. 8.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
  59. Credits
  60. =======
  61. Original implementation
  62. -----------------------
  63. This module is inspired in previous module *product_images* from OpenLabs
  64. and Akretion.
  65. Contributors
  66. ------------
  67. * Pedro M. Baeza <pedro.baeza@serviciosbaeza.com>
  68. * Rafael Blasco <rafabn@antiun.com>
  69. * Jairo Llopis <yajo.sk8@gmail.com>
  70. Maintainer
  71. ----------
  72. .. image:: https://odoo-community.org/logo.png
  73. :alt: Odoo Community Association
  74. :target: https://odoo-community.org
  75. This module is maintained by the OCA.
  76. OCA, or the Odoo Community Association, is a nonprofit organization whose
  77. mission is to support the collaborative development of Odoo features and
  78. promote its widespread use.
  79. To contribute to this module, please visit http://odoo-community.org.