=================
Report to printer
=================
..
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! This file is generated by oca-gen-addon-readme !!
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! source digest: sha256:7761acf7bc8cae2f3c56913a0da0ebc3d646ee29311fb4682bde14452b3a69d8
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
:target: https://odoo-community.org/page/development-status
:alt: Beta
.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
:target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
:alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Freport--print--send-lightgray.png?logo=github
:target: https://github.com/OCA/report-print-send/tree/18.0/base_report_to_printer
:alt: OCA/report-print-send
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
:target: https://translation.odoo-community.org/projects/report-print-send-18-0/report-print-send-18-0-base_report_to_printer
:alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
:target: https://runboat.odoo-community.org/builds?repo=OCA/report-print-send&target_branch=18.0
:alt: Try me on Runboat
|badge1| |badge2| |badge3| |badge4| |badge5|
This module allows users to send reports to a printer attached to the
server.
It adds an optional behaviour on reports to send it directly to a
printer.
- Send to Client is the default behaviour providing you a downloadable
PDF
- Send to Printer prints the report on selected printer
It detects trays on printers installation plus permits to select the
paper source on which you want to print directly.
Report behaviour is defined by settings.
You will find this option on default user config, on default report
config and on specific config per user per report.
This allows you to dedicate a specific paper source for example for
preprinted paper such as payment slip.
Settings can be configured:
- globally
- per user
- per report
- per user and report
**Table of contents**
.. contents::
:local:
Installation
============
To install this module, you need to:
1. Install PyCups - https://pypi.python.org/pypi/pycups
.. code:: bash
sudo apt-get install cups
sudo apt-get install libcups2-dev
sudo apt-get install python3-dev
sudo pip install pycups
Configuration
=============
To configure this module, you need to:
1. Enable the "Printing / Print User" option under access rights to give
users the ability to view the print menu.
The jobs will be sent to the printer with a name matching the
print_report_name of the report (truncated at 80 characters). By default
this will not be displayed by CUPS web interface or in Odoo. To see this
information, you need to change the configuration of your CUPS server
and set the JobPrivateValue directive to "none" (or some other list of
values which does not include "job-name") , and reload the server. See
cupsd.conf(5)
<`https://www.cups.org/doc/man-cupsd.conf.html\\> <https://www.cups.org/doc/man-cupsd.conf.html\>>`__
for details.
Usage
=====
Guidelines for use:
- To update the CUPS printers in *Settings > Printing > Update
Printers from CUPS*
- To print a report on a specific printer or tray, you can change
these in *Settings > Printing > Reports* to define default
behaviour.
- To print a report on a specific printer and/or tray for a user, you
can change these in *Settings > Printing > Reports* in *Specific
actions per user*
- Users may also select a default action, printer or tray in their
preferences.
When no tray is configured for a report and a user, the default tray
setup on the CUPS server is used.
Known issues / Roadmap
======================
- With threaded printing there's no download fallback when the issue
isn't detected by the CUPS Odoo backend. To able to do it, we would
need to notify the bus or use web_notify for it.
Changelog
=========
13.0.1.0.0 (2019-09-30)
-----------------------
- [RELEASE] Port from V12.
12.0.1.0.0 (2018-02-04)
-----------------------
- [RELEASE] Port from V11.
Bug Tracker
===========
Bugs are tracked on `GitHub Issues <https://github.com/OCA/report-print-send/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
`feedback <https://github.com/OCA/report-print-send/issues/new?body=module:%20base_report_to_printer%0Aversion:%2018.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
Do not contact contributors directly about support or help with technical issues.
Credits
=======
Authors
-------
* Agile Business Group & Domsense
* Pegueroles SCP
* NaN
* LasLabs
* Camptocamp
* Open for Small Business Ltd
Contributors
------------
- Ferran Pegueroles <ferran@pegueroles.com>
- Albert Cervera i Areny <albert@nan-tic.com>
- Davide Corio <davide.corio@agilebg.com>
- Lorenzo Battistini <lorenzo.battistini@agilebg.com>
- Yannick Vaucher <yannick.vaucher@camptocamp.com>
- Lionel Sausin <ls@numerigraphe.com>
- Guewen Baconnier <guewen.baconnier@camptocamp.com>
- Dave Lasley <dave@laslabs.com>
- Sylvain Garancher <sylvain.garancher@syleam.fr>
- Jairo Llopis <jairo.llopis@tecnativa.com>
- Graeme Gellatly <graeme@o4sb.com>
- Rod Schouteden <rod@schout-it.be>
- Alexandre Fayolle <alexandre.fayolle@camptocamp.com>
- Matias Peralta <mnp@adhoc.com.ar>
- Hughes Damry <hughes.damry@acsone.eu>
- Akim Juillerat <akim.juillerat@camptocamp.com>
- Jacques-Etienne Baudoux (BCIM) <je@bcim.be>
- Tris Doan <tridm@trobz.com>
Other credits
-------------
The migration of this module from 17.0 to 18.0 was financially supported
by Camptocamp.
Maintainers
-----------
This module is maintained by the OCA.
.. image:: https://odoo-community.org/logo.png
:alt: Odoo Community Association
:target: https://odoo-community.org
OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.
This module is part of the `OCA/report-print-send <https://github.com/OCA/report-print-send/tree/18.0/base_report_to_printer>`_ project on GitHub.
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
Raw data
{
"_id": null,
"home_page": "https://github.com/OCA/report-print-send",
"name": "odoo-addon-base-report-to-printer",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": null,
"author": "Agile Business Group & Domsense, Pegueroles SCP, NaN, LasLabs, Camptocamp, Odoo Community Association (OCA), Open for Small Business Ltd",
"author_email": "support@odoo-community.org",
"download_url": null,
"platform": null,
"description": "=================\nReport to printer\n=================\n\n.. \n !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n !! This file is generated by oca-gen-addon-readme !!\n !! changes will be overwritten. !!\n !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n !! source digest: sha256:7761acf7bc8cae2f3c56913a0da0ebc3d646ee29311fb4682bde14452b3a69d8\n !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n\n.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png\n :target: https://odoo-community.org/page/development-status\n :alt: Beta\n.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png\n :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html\n :alt: License: AGPL-3\n.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Freport--print--send-lightgray.png?logo=github\n :target: https://github.com/OCA/report-print-send/tree/18.0/base_report_to_printer\n :alt: OCA/report-print-send\n.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png\n :target: https://translation.odoo-community.org/projects/report-print-send-18-0/report-print-send-18-0-base_report_to_printer\n :alt: Translate me on Weblate\n.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png\n :target: https://runboat.odoo-community.org/builds?repo=OCA/report-print-send&target_branch=18.0\n :alt: Try me on Runboat\n\n|badge1| |badge2| |badge3| |badge4| |badge5|\n\nThis module allows users to send reports to a printer attached to the\nserver.\n\nIt adds an optional behaviour on reports to send it directly to a\nprinter.\n\n- Send to Client is the default behaviour providing you a downloadable\n PDF\n- Send to Printer prints the report on selected printer\n\nIt detects trays on printers installation plus permits to select the\npaper source on which you want to print directly.\n\nReport behaviour is defined by settings.\n\nYou will find this option on default user config, on default report\nconfig and on specific config per user per report.\n\nThis allows you to dedicate a specific paper source for example for\npreprinted paper such as payment slip.\n\nSettings can be configured:\n\n- globally\n- per user\n- per report\n- per user and report\n\n**Table of contents**\n\n.. contents::\n :local:\n\nInstallation\n============\n\nTo install this module, you need to:\n\n1. Install PyCups - https://pypi.python.org/pypi/pycups\n\n.. code:: bash\n\n sudo apt-get install cups\n sudo apt-get install libcups2-dev\n sudo apt-get install python3-dev\n sudo pip install pycups\n\nConfiguration\n=============\n\nTo configure this module, you need to:\n\n1. Enable the \"Printing / Print User\" option under access rights to give\n users the ability to view the print menu.\n\nThe jobs will be sent to the printer with a name matching the\nprint_report_name of the report (truncated at 80 characters). By default\nthis will not be displayed by CUPS web interface or in Odoo. To see this\ninformation, you need to change the configuration of your CUPS server\nand set the JobPrivateValue directive to \"none\" (or some other list of\nvalues which does not include \"job-name\") , and reload the server. See\ncupsd.conf(5)\n<`https://www.cups.org/doc/man-cupsd.conf.html\\\\> <https://www.cups.org/doc/man-cupsd.conf.html\\>>`__\nfor details.\n\nUsage\n=====\n\nGuidelines for use:\n\n - To update the CUPS printers in *Settings > Printing > Update\n Printers from CUPS*\n - To print a report on a specific printer or tray, you can change\n these in *Settings > Printing > Reports* to define default\n behaviour.\n - To print a report on a specific printer and/or tray for a user, you\n can change these in *Settings > Printing > Reports* in *Specific\n actions per user*\n - Users may also select a default action, printer or tray in their\n preferences.\n\nWhen no tray is configured for a report and a user, the default tray\nsetup on the CUPS server is used.\n\nKnown issues / Roadmap\n======================\n\n- With threaded printing there's no download fallback when the issue\n isn't detected by the CUPS Odoo backend. To able to do it, we would\n need to notify the bus or use web_notify for it.\n\nChangelog\n=========\n\n13.0.1.0.0 (2019-09-30)\n-----------------------\n\n- [RELEASE] Port from V12.\n\n12.0.1.0.0 (2018-02-04)\n-----------------------\n\n- [RELEASE] Port from V11.\n\nBug Tracker\n===========\n\nBugs are tracked on `GitHub Issues <https://github.com/OCA/report-print-send/issues>`_.\nIn case of trouble, please check there if your issue has already been reported.\nIf you spotted it first, help us to smash it by providing a detailed and welcomed\n`feedback <https://github.com/OCA/report-print-send/issues/new?body=module:%20base_report_to_printer%0Aversion:%2018.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.\n\nDo not contact contributors directly about support or help with technical issues.\n\nCredits\n=======\n\nAuthors\n-------\n\n* Agile Business Group & Domsense\n* Pegueroles SCP\n* NaN\n* LasLabs\n* Camptocamp\n* Open for Small Business Ltd\n\nContributors\n------------\n\n- Ferran Pegueroles <ferran@pegueroles.com>\n- Albert Cervera i Areny <albert@nan-tic.com>\n- Davide Corio <davide.corio@agilebg.com>\n- Lorenzo Battistini <lorenzo.battistini@agilebg.com>\n- Yannick Vaucher <yannick.vaucher@camptocamp.com>\n- Lionel Sausin <ls@numerigraphe.com>\n- Guewen Baconnier <guewen.baconnier@camptocamp.com>\n- Dave Lasley <dave@laslabs.com>\n- Sylvain Garancher <sylvain.garancher@syleam.fr>\n- Jairo Llopis <jairo.llopis@tecnativa.com>\n- Graeme Gellatly <graeme@o4sb.com>\n- Rod Schouteden <rod@schout-it.be>\n- Alexandre Fayolle <alexandre.fayolle@camptocamp.com>\n- Matias Peralta <mnp@adhoc.com.ar>\n- Hughes Damry <hughes.damry@acsone.eu>\n- Akim Juillerat <akim.juillerat@camptocamp.com>\n- Jacques-Etienne Baudoux (BCIM) <je@bcim.be>\n- Tris Doan <tridm@trobz.com>\n\nOther credits\n-------------\n\nThe migration of this module from 17.0 to 18.0 was financially supported\nby Camptocamp.\n\nMaintainers\n-----------\n\nThis module is maintained by the OCA.\n\n.. image:: https://odoo-community.org/logo.png\n :alt: Odoo Community Association\n :target: https://odoo-community.org\n\nOCA, or the Odoo Community Association, is a nonprofit organization whose\nmission is to support the collaborative development of Odoo features and\npromote its widespread use.\n\nThis module is part of the `OCA/report-print-send <https://github.com/OCA/report-print-send/tree/18.0/base_report_to_printer>`_ project on GitHub.\n\nYou are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.\n",
"bugtrack_url": null,
"license": "AGPL-3",
"summary": "Report to printer",
"version": "18.0.1.0.0.5",
"project_urls": {
"Homepage": "https://github.com/OCA/report-print-send"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3007403af6b99cbcc8b8d5007aa90826d4ee0546322136792b95d8887fee0ced",
"md5": "bd6e953e474444f39184b24ec85803f3",
"sha256": "fda66b400092419c3737d41042c964118705deac5bdbbe87a758e09cafcbad54"
},
"downloads": -1,
"filename": "odoo_addon_base_report_to_printer-18.0.1.0.0.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "bd6e953e474444f39184b24ec85803f3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 181889,
"upload_time": "2025-07-22T13:27:18",
"upload_time_iso_8601": "2025-07-22T13:27:18.754630Z",
"url": "https://files.pythonhosted.org/packages/30/07/403af6b99cbcc8b8d5007aa90826d4ee0546322136792b95d8887fee0ced/odoo_addon_base_report_to_printer-18.0.1.0.0.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-22 13:27:18",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "OCA",
"github_project": "report-print-send",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "pycups",
"specs": []
}
],
"lcname": "odoo-addon-base-report-to-printer"
}
JSON
