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.

110 lines
3.7 KiB

  1. ===============
  2. Pos Ticket Logo
  3. ===============
  4. .. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  5. !! This file is generated by oca-gen-addon-readme !!
  6. !! changes will be overwritten. !!
  7. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  8. .. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
  9. :target: https://odoo-community.org/page/development-status
  10. :alt: Beta
  11. .. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
  12. :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
  13. :alt: License: AGPL-3
  14. .. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fpos-lightgray.png?logo=github
  15. :target: https://github.com/OCA/pos/tree/12.0/pos_ticket_logo
  16. :alt: OCA/pos
  17. .. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
  18. :target: https://translation.odoo-community.org/projects/pos-12-0/pos-12-0-pos_ticket_logo
  19. :alt: Translate me on Weblate
  20. .. |badge5| image:: https://img.shields.io/badge/runbot-Try%20me-875A7B.png
  21. :target: https://runbot.odoo-community.org/runbot/184/12.0
  22. :alt: Try me on Runbot
  23. |badge1| |badge2| |badge3| |badge4| |badge5|
  24. A different receipt template is used if the PoS ticket is printed via web or
  25. via proxy. In the case the ticket is printed via web (through the browser) the
  26. company logo isn't printed. This module adds it.
  27. In other hand, company_logo is loaded using `/web/binary/company_logo`
  28. controller `that returns a 150px wide logo <https://github.com/odoo/odoo/blob/11.0/addons/point_of_sale/static/src/js/models.js#L481>`_:
  29. but after that logo is resized to 300px width, so a pixelled logo appears even
  30. original logo is 300px wide.
  31. That's why we override how company_logo is loaded. We also resized it to 260px
  32. (not 300px) wide because appears cut in PDF.
  33. **Table of contents**
  34. .. contents::
  35. :local:
  36. Configuration
  37. =============
  38. To add a logo to any given company:
  39. #. Go to *Settings > Users & Companies > Companies*
  40. #. Edit one and add the logo editing the top left corner image.
  41. To configure receipt web print in the PoS (is the default setting):
  42. #. Go to *Point of Sale > Configuration > Point of Sale*.
  43. #. Edit the one you want to configure.
  44. #. If the *PosBox* setting is enabled the *Receipt Printer* setting should be
  45. disabled.
  46. Usage
  47. =====
  48. #. Open a new PoS session.
  49. #. Make an order and validate it.
  50. #. You should see the company logo in the receipt preview.
  51. Bug Tracker
  52. ===========
  53. Bugs are tracked on `GitHub Issues <https://github.com/OCA/pos/issues>`_.
  54. In case of trouble, please check there if your issue has already been reported.
  55. If you spotted it first, help us smashing it by providing a detailed and welcomed
  56. `feedback <https://github.com/OCA/pos/issues/new?body=module:%20pos_ticket_logo%0Aversion:%2012.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
  57. Do not contact contributors directly about support or help with technical issues.
  58. Credits
  59. =======
  60. Authors
  61. ~~~~~~~
  62. * Tecnativa
  63. Contributors
  64. ~~~~~~~~~~~~
  65. * Endika Iglesias <endikaig@antiun.com>
  66. * `Tecnativa <https://www.tecnativa.com>`_:
  67. * Antonio Espinosa
  68. * David Vidal
  69. Maintainers
  70. ~~~~~~~~~~~
  71. This module is maintained by the OCA.
  72. .. image:: https://odoo-community.org/logo.png
  73. :alt: Odoo Community Association
  74. :target: https://odoo-community.org
  75. OCA, or the Odoo Community Association, is a nonprofit organization whose
  76. mission is to support the collaborative development of Odoo features and
  77. promote its widespread use.
  78. This module is part of the `OCA/pos <https://github.com/OCA/pos/tree/12.0/pos_ticket_logo>`_ project on GitHub.
  79. You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.