e3fee2cf46
Prior to this commit, the Odoo documentation was mainly split between
two repositories: odoo/odoo/doc and odoo/documentation-user. Some bits
of documentation were also hosted elsewhere (e.g., wiki, upgrade, ...).
This was causing several problems among which:
- The theme, config, Makefile, and similar technical resources had to
be duplicated. This resulted in inconsistent layout, features, and
build environments from one documentation to another.
- Some pages did not fit either documentation as they were relevant
for both users and developers. Some were relevant to neither of the
two (e.g., DB management).
- Cross-doc references had to be absolute links and they broke often.
- Merging large image files in the developer documentation would bloat
the odoo/odoo repository. Some contributions had to be lightened to
avoid merging too many images (e.g., Odoo development tutorials).
- Long-time contributors to the user documentation were chilly about
going through the merging process of the developer documentation
because of the runbot, mergebot, `odoo-dev` repository, etc.
- Some contributors would look for the developer documentation in the
`odoo/documentation-user` repository.
- Community issues about the user documentation were submitted on the
`odoo/odoo` repository and vice-versa.
Merging all documentations in one repository will allow us to have one
place, one theme, one work process, and one set of tools (build
environment, ...) for all of the Odoo docs.
As this is a good opportunity to revamp the layout of the documentation,
a brand new theme replaces the old one. It features a new way to
navigate the documentation, centered on the idea of always letting the
reader know what is the context (enclosing section, child pages, page
structure ...) of the page they are reading. The previous theme would
quickly confuse readers as they navigated the documentation and followed
cross-application links.
The chance is also taken to get rid of all the technical dangling parts,
performance issues, and left-overs. Except for some page-specific JS
scripts, the Odoo theme Sphinx extension is re-written from scratch
based on the latest Sphinx release to benefit from the improvements and
ease future contributions.
task-2351938
task-2352371
task-2205684
task-2352544
Closes #945
138 lines
4.0 KiB
ReStructuredText
138 lines
4.0 KiB
ReStructuredText
=================
|
||
Connect a Printer
|
||
=================
|
||
|
||
When using your *IoT Box* in Odoo, you could need to use a printer.
|
||
Doing so is easy and convenient as it can be done in a few steps. Then,
|
||
you can use it to print receipts, orders or even reports in different
|
||
Odoo apps.
|
||
|
||
Connection
|
||
==========
|
||
|
||
To connect the printer to the *IoT Box*, you just have to combine the
|
||
two by cable.
|
||
|
||
.. note::
|
||
Sometimes, a serial to USB adapter may be needed.
|
||
|
||
If your printer is a `supported
|
||
one <https://www.odoo.com/page/iot-hardware>`__, there is no need to set up anything
|
||
because it will be automatically detected as soon as it is connected.
|
||
|
||
.. note::
|
||
The printer can take up to two minutes to appear in your devices list.
|
||
|
||
.. image:: media/printer_01.png
|
||
:align: center
|
||
|
||
In some cases, you may need to restart the box and download your
|
||
printer’s drivers from the box. To do so, go to the *IoT Box Home
|
||
Page* and click on *drivers list*. Then, click on load drivers.
|
||
|
||
.. image:: media/printer_02.png
|
||
:align: center
|
||
|
||
Link the Printer
|
||
================
|
||
|
||
To Work Orders
|
||
--------------
|
||
|
||
You can link *Work Orders* to printers via a *Quality Control Point*
|
||
to print labels for manufactured products.
|
||
|
||
To do so, you need to create a *Quality Control Point* from the
|
||
*Quality* app. Then, you can select the correct manufacturing
|
||
operation and the work order operation. In type, choose *Print Label*
|
||
and hit save.
|
||
|
||
.. image:: media/printer_03.png
|
||
:align: center
|
||
|
||
Now, each time you reach the quality control point for the chosen
|
||
product, a *Print Label* button will appear.
|
||
|
||
.. image:: media/printer_04.png
|
||
:align: center
|
||
|
||
To Reports
|
||
----------
|
||
|
||
You can also link a type of report to a certain printer. In the *IoT*
|
||
app, go to the *Devices* menu and select the printer you want to set
|
||
up.
|
||
|
||
.. image:: media/printer_05.png
|
||
:align: center
|
||
|
||
Now, go to the *Printer Reports* tab.
|
||
|
||
.. image:: media/printer_06.png
|
||
:align: center
|
||
|
||
Hit edit and then, click on *Add a line*. In the window that shows up,
|
||
check all the types of reports that should be linked to this printer.
|
||
Click on select and save.
|
||
|
||
.. image:: media/printer_07.png
|
||
:align: center
|
||
|
||
Now, each time you click on *Print* in the control panel, instead of
|
||
downloading a PDF, it will send it to the selected printer and
|
||
automatically print it.
|
||
|
||
Print Receipts from the PoS
|
||
---------------------------
|
||
|
||
You can link a printer to your *Point of Sale* app so you can print
|
||
receipts directly from your *PoS*.
|
||
|
||
Doing so is really easy. Go to your *Point of Sale* app and open your
|
||
*PoS* settings, under *Configuration*. There, click on *Edit* and
|
||
check the *IoT Box* feature. Then, enable the *Receipt Printer*.
|
||
|
||
.. image:: media/printer_08.png
|
||
:align: center
|
||
|
||
Now, on your *PoS* view, you will be able to print different kinds of
|
||
tickets: **receipts**, **sale details** and **bills**.
|
||
|
||
For the receipt, it will be printed once the order is validated. The
|
||
process is automated when you enable the feature in your *PoS*.
|
||
|
||
Sales details can be printed by clicking on the printer icon on the
|
||
navbar at the top of the *PoS*. It will print the details of the sales
|
||
of the current day.
|
||
|
||
.. image:: media/printer_09.png
|
||
:align: center
|
||
|
||
As for the bill, it is only available in restaurant mode. In your
|
||
restaurant settings, activate bills and a *Bill* button will appear in
|
||
the left panel. Click on it and it will print the bill.
|
||
|
||
.. image:: media/printer_10.png
|
||
:align: center
|
||
|
||
Print Orders in the kitchen
|
||
---------------------------
|
||
|
||
In restaurant mode, you can send order tickets to the kitchen.
|
||
|
||
To do so, go to the *PoS* app and open your *PoS* settings. Then,
|
||
tick *Order Printer*.
|
||
|
||
.. image:: media/printer_11.png
|
||
:align: center
|
||
|
||
Now, go to the *Printers* menu. Hit create and select the *IoT Box*
|
||
with all the categories of product that should be printed in the
|
||
*Printer Product Categories* field.
|
||
|
||
.. image:: media/printer_12.png
|
||
:align: center
|
||
|
||
In the *PoS*, when you add or remove a product from one of the
|
||
selected categories, the button *Order* will be green. If you click on
|
||
it, a ticket will be printed. |