Search 1.9 billion lines of Odoo code on GitHub
base_report_to_printer
<h1 class="title">Report to printer</h1>
<p><a class="reference external" href="https://odoo-community.org/page/development-status"><img alt="Beta" src="https://img.shields.io/badge/maturity-Beta-yellow.png" /></a> <a class="reference external" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.png" /></a> <a class="reference external" href="https://github.com/OCA/report-print-send/tree/16.0/base_report_to_printer"><img alt="OCA/report-print-send" src="https://img.shields.io/badge/github-OCA%2Freport--print--send-lightgray.png?logo=github" /></a> <a class="reference external" href="https://translation.odoo-community.org/projects/report-print-send-16-0/report-print-send-16-0-base_report_to_printer"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a> <a class="reference external" href="https://runbot.odoo-community.org/runbot/144/16.0"><img alt="Try me on Runbot" src="https://img.shields.io/badge/runbot-Try%20me-875A7B.png" /></a></p>
<p>This module allows users to send reports to a printer attached to the server.</p>
<p>It adds an optional behaviour on reports to send it directly to a printer.</p>
<ul class="simple">
<li><cite>Send to Client</cite> is the default behaviour providing you a downloadable PDF</li>
<li><cite>Send to Printer</cite> prints the report on selected printer</li>
</ul>
<p>It detects trays on printers installation plus permits to select the
paper source on which you want to print directly.</p>
<p>Report behaviour is defined by settings.</p>
<p>You will find this option on default user config, on default report
config and on specific config per user per report.</p>
<p>This allows you to dedicate a specific paper source for example for
preprinted paper such as payment slip.</p>
<p>Settings can be configured:</p>
<ul class="simple">
<li>globally</li>
<li>per user</li>
<li>per report</li>
<li>per user and report</li>
</ul>
<p><strong>Table of contents</strong></p>
<div class="contents local topic" id="contents">
<ul class="simple">
<li><a class="reference internal" href="#installation" id="id3">Installation</a></li>
<li><a class="reference internal" href="#configuration" id="id4">Configuration</a></li>
<li><a class="reference internal" href="#usage" id="id5">Usage</a></li>
<li><a class="reference internal" href="#changelog" id="id6">Changelog</a><ul>
<li><a class="reference internal" href="#id1" id="id7">13.0.1.0.0 (2019-09-30)</a></li>
<li><a class="reference internal" href="#id2" id="id8">12.0.1.0.0 (2018-02-04)</a></li>
</ul>
</li>
<li><a class="reference internal" href="#bug-tracker" id="id9">Bug Tracker</a></li>
<li><a class="reference internal" href="#credits" id="id10">Credits</a><ul>
<li><a class="reference internal" href="#authors" id="id11">Authors</a></li>
<li><a class="reference internal" href="#contributors" id="id12">Contributors</a></li>
<li><a class="reference internal" href="#maintainers" id="id13">Maintainers</a></li>
</ul>
</li>
</ul>
</div>
<a name="installation"></a>
<h2><a class="toc-backref" href="#id3">Installation</a></h2>
<p>To install this module, you need to:</p>
<ol class="arabic simple">
<li>Install PyCups - <a class="reference external" href="https://pypi.python.org/pypi/pycups">https://pypi.python.org/pypi/pycups</a></li>
</ol>
<pre>
<code lang="bash">sudo apt-get install cups
sudo apt-get install libcups2-dev
sudo apt-get install python3-dev
sudo pip install pycups</code>
</pre>
<a name="configuration"></a>
<h2><a class="toc-backref" href="#id4">Configuration</a></h2>
<p>To configure this module, you need to:</p>
<ol class="arabic simple">
<li>Enable the "Printing / Print User" option under access
rights to give users the ability to view the print menu.</li>
</ol>
<p>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 "job-name", and reload the server. See <cite>cupsd.conf(5)
<https://www.cups.org/doc/man-cupsd.conf.html></cite> for details.</p>
<a name="usage"></a>
<h2><a class="toc-backref" href="#id5">Usage</a></h2>
<p>Guidelines for use:</p>
<blockquote>
<ul class="simple">
<li>To update the CUPS printers in <em>Settings > Printing > Update Printers
from CUPS</em></li>
<li>To print a report on a specific printer or tray, you can change
these in <em>Settings > Printing > Reports</em> to define default behaviour.</li>
<li>To print a report on a specific printer and/or tray for a user, you can
change these in <em>Settings > Printing > Reports</em> in
<em>Specific actions per user</em></li>
<li>Users may also select a default action, printer or tray in their preferences.</li>
</ul>
</blockquote>
<p>When no tray is configured for a report and a user, the
default tray setup on the CUPS server is used.</p>
<a name="changelog"></a>
<h2><a class="toc-backref" href="#id6">Changelog</a></h2>
<a name="id1"></a>
<h3><a class="toc-backref" href="#id7">13.0.1.0.0 (2019-09-30)</a></h3>
<ul class="simple">
<li>[RELEASE] Port from V12.</li>
</ul>
<a name="id2"></a>
<h3><a class="toc-backref" href="#id8">12.0.1.0.0 (2018-02-04)</a></h3>
<ul class="simple">
<li>[RELEASE] Port from V11.</li>
</ul>
<a name="bug-tracker"></a>
<h2><a class="toc-backref" href="#id9">Bug Tracker</a></h2>
<p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/report-print-send/issues">GitHub Issues</a>.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us smashing it by providing a detailed and welcomed
<a class="reference external" href="https://github.com/OCA/report-print-send/issues/new?body=module:%20base_report_to_printer%0Aversion:%2016.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">feedback</a>.</p>
<p>Do not contact contributors directly about support or help with technical issues.</p>
<a name="credits"></a>
<h2><a class="toc-backref" href="#id10">Credits</a></h2>
<a name="authors"></a>
<h3><a class="toc-backref" href="#id11">Authors</a></h3>
<ul class="simple">
<li>Agile Business Group & Domsense</li>
<li>Pegueroles SCP</li>
<li>NaN</li>
<li>LasLabs</li>
<li>Camptocamp</li>
<li>Open for Small Business Ltd</li>
</ul>
<a name="contributors"></a>
<h3><a class="toc-backref" href="#id12">Contributors</a></h3>
<ul class="simple">
<li>Ferran Pegueroles <<a class="reference external" href="mailto:ferran@pegueroles.com">ferran@pegueroles.com</a>></li>
<li>Albert Cervera i Areny <<a class="reference external" href="mailto:albert@nan-tic.com">albert@nan-tic.com</a>></li>
<li>Davide Corio <<a class="reference external" href="mailto:davide.corio@agilebg.com">davide.corio@agilebg.com</a>></li>
<li>Lorenzo Battistini <<a class="reference external" href="mailto:lorenzo.battistini@agilebg.com">lorenzo.battistini@agilebg.com</a>></li>
<li>Yannick Vaucher <<a class="reference external" href="mailto:yannick.vaucher@camptocamp.com">yannick.vaucher@camptocamp.com</a>></li>
<li>Lionel Sausin <<a class="reference external" href="mailto:ls@numerigraphe.com">ls@numerigraphe.com</a>></li>
<li>Guewen Baconnier <<a class="reference external" href="mailto:guewen.baconnier@camptocamp.com">guewen.baconnier@camptocamp.com</a>></li>
<li>Dave Lasley <<a class="reference external" href="mailto:dave@laslabs.com">dave@laslabs.com</a>></li>
<li>Sylvain Garancher <<a class="reference external" href="mailto:sylvain.garancher@syleam.fr">sylvain.garancher@syleam.fr</a>></li>
<li>Jairo Llopis <<a class="reference external" href="mailto:jairo.llopis@tecnativa.com">jairo.llopis@tecnativa.com</a>></li>
<li>Graeme Gellatly <<a class="reference external" href="mailto:graeme@o4sb.com">graeme@o4sb.com</a>></li>
<li>Rod Schouteden <<a class="reference external" href="mailto:rod@schout-it.be">rod@schout-it.be</a>></li>
<li>Alexandre Fayolle <<a class="reference external" href="mailto:alexandre.fayolle@camptocamp.com">alexandre.fayolle@camptocamp.com</a>></li>
<li>Matias Peralta <<a class="reference external" href="mailto:mnp@adhoc.com.ar">mnp@adhoc.com.ar</a>></li>
<li>Hughes Damry <<a class="reference external" href="mailto:hughes.damry@acsone.eu">hughes.damry@acsone.eu</a>></li>
</ul>
<a name="maintainers"></a>
<h3><a class="toc-backref" href="#id13">Maintainers</a></h3>
<p>This module is maintained by the OCA.</p>
<a class="reference external image-reference" href="https://odoo-community.org"><img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" /></a>
<p>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.</p>
<p>This module is part of the <a class="reference external" href="https://github.com/OCA/report-print-send/tree/16.0/base_report_to_printer">OCA/report-print-send</a> project on GitHub.</p>
<p>You are welcome to contribute. To learn how please visit <a class="reference external" href="https://odoo-community.org/page/Contribute">https://odoo-community.org/page/Contribute</a>.</p>