OCA reporting engine fork for dev and update.
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.

70 lines
2.5 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. Pdf watermark
  6. =============
  7. This module was written to add watermarks (backgrounds) to PDF reports. Because of the way wkhtmltopdf handles headers and footers in the current versions, it is quite impossible to have a background for the complete page using HTML and CSS. That is why this module inserts the image at the PDF level.
  8. Installation
  9. ============
  10. This module works out of the box, but is faster if you install the python library PyPDF2.
  11. Usage
  12. =====
  13. To use this module, you need to:
  14. #. go to your report
  15. #. select a PDF or image to use as watermark. Note that resolutions and size must match, otherwise you'll have funny results
  16. #. You can also fill in an expression that returns the data (base64 encoded) to be used as watermark
  17. .. image:: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas
  18. :alt: Try me on Runbot
  19. :target: https://runbot.odoo-community.org/runbot/143/8.0
  20. Known Issues
  21. ============
  22. This module depends on support for transparent backgrounds in Wkhtmltopdf, which has been flaky in the past. This module has been reported to work with Wkhtmltopdf 0.12.4.
  23. Bug Tracker
  24. ===========
  25. Bugs are tracked on `GitHub Issues
  26. <https://github.com/OCA/reporting-engine/issues>`_. In case of trouble, please
  27. check there if your issue has already been reported. If you spotted it first,
  28. help us smashing it by providing a detailed and welcomed feedback.
  29. Credits
  30. =======
  31. Images
  32. ------
  33. * Odoo Community Association: `Icon <https://github.com/OCA/maintainer-tools/blob/master/template/module/static/description/icon.svg>`_.
  34. Contributors
  35. ------------
  36. * Holger Brunn <hbrunn@therp.nl>
  37. * Stefan Rijnhart <stefan@opener.am>
  38. 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.
  39. Maintainer
  40. ----------
  41. .. image:: https://odoo-community.org/logo.png
  42. :alt: Odoo Community Association
  43. :target: https://odoo-community.org
  44. This module is maintained by the OCA.
  45. OCA, or the Odoo Community Association, is a nonprofit organization whose
  46. mission is to support the collaborative development of Odoo features and
  47. promote its widespread use.
  48. To contribute to this module, please visit https://odoo-community.org.