mirror of
https://github.com/OCA/report-print-send.git
synced 2025-02-16 07:11:31 +02:00
194 lines
6.3 KiB
ReStructuredText
194 lines
6.3 KiB
ReStructuredText
=================
|
|
Report to printer
|
|
=================
|
|
|
|
..
|
|
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
|
|
!! This file is generated by oca-gen-addon-readme !!
|
|
!! changes will be overwritten. !!
|
|
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
|
|
!! source digest: sha256:b6075c1e1dd7cdecda74534f415e34eff210a7eb45270a9f9b086cb2c06563b1
|
|
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
|
|
|
|
.. |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/16.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-16-0/report-print-send-16-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=16.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:
|
|
|
|
#. Install PyCups - https://pypi.python.org/pypi/pycups
|
|
|
|
.. code-block:: 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:
|
|
|
|
#. 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>` 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:%2016.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>
|
|
|
|
* `Tecnativa <https://www.tecnativa.com>`_:
|
|
|
|
* Sergio Teruel
|
|
* David Vidal
|
|
|
|
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/16.0/base_report_to_printer>`_ project on GitHub.
|
|
|
|
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
|