29,291
edits
Changes
m
→Hardware compatibility
Line 38:
Line 38:
−Example of hardware setup for receipt printers:+== D) Using the "old Web" TakePOS connector ==
−[[File:warning.png]] This method is now deprecated.+
−<pre>
−+--------+ +------------------+ +---------------------+ +--------------------------+
−|The | serial | Web server | | Your local computer | | Dolibarr server |
−|printer |<--or usb--| with the |<--tcp/ip--| Browser |--internet-->| with TakePOS |
−| | | Web Takepos conn | | | | + module "New connector" |
−+--------+ +------------------+ +---------------------+ +--------------------------+
−</pre>
−
−Once the module "New connector.zip" on Dolibarr has been installed, you must choose the print method "TakePOS connector".
−
−Video demo here: https://www.youtube.com/watch?v=AyQLOT0-SIY
−
−
==Hardware setup for receipt printers==
−== A) Using your browser print feature ==
+=== A) Using your browser print feature ===
This solution is the one available by default, it uses the standard "Print" feature of your browser.
This solution is the one available by default, it uses the standard "Print" feature of your browser.
−If you can print from your local computer (from your browser) on your standard printer, you should be able to print TakePos receipts with no need of special setup. TakePos will open the receipt in a popup on your browser as well as the print option of your browser will also open so all you have to do will be to click on the Print button.
+If you can print from your local computer (from your browser) on your standard printer, you should be able to print TakePOS receipts with no need of special setup. TakePOS will open the receipt in a popup on your browser as well as the print option of your browser will also open so all you have to do will be to click on the Print button.
<pre>
<pre>
Line 55:
Line 55:
'''Limitation''': This feature is not able to use serial ESC/POS printers but any common printers (wifi, lan, usb) are supported with no need for special setup. To use ESC/POS printer, prefer to use the next method.
'''Limitation''': This feature is not able to use serial ESC/POS printers but any common printers (wifi, lan, usb) are supported with no need for special setup. To use ESC/POS printer, prefer to use the next method.
−== B) Using the "Receipt Printer" module ==
+=== B) Using the "Receipt Printer" module ===
If the printer can be reached by the Dolibarr server (Using network TCP/IP access or using a local LPT port or using a cups shared link), you can enable the [[Module Receipt Printer]].
If the printer can be reached by the Dolibarr server (Using network TCP/IP access or using a local LPT port or using a cups shared link), you can enable the [[Module Receipt Printer]].
Line 71:
Line 71:
'''Note''': to test this method without having any printer, you can use the ESC/POS printer emulator here: https://github.com/dacduong/escpos-printer-simulator so you can launch a virtual printer on you local IP and port 9100.
'''Note''': to test this method without having any printer, you can use the ESC/POS printer emulator here: https://github.com/dacduong/escpos-printer-simulator so you can launch a virtual printer on you local IP and port 9100.
−== C) Using the old "Java connector" ==
+=== C) Using the old "Java connector" ===
[[File:warning.png]] This method is now deprecated.
[[File:warning.png]] This method is now deprecated.
Line 80:
Line 80:
|printer |<--or usb--| on the printer |<--tcp/ip--| Browser |--internet-->| with TakePOS |
|printer |<--or usb--| on the printer |<--tcp/ip--| Browser |--internet-->| with TakePOS |
| | | | | | | + module "Java connector" |
| | | | | | | + module "Java connector" |
+| | | | | | | or module "New connector" |
+--------+ +----------------+ +---------------------+ +---------------------------+
+--------+ +----------------+ +---------------------+ +---------------------------+
</pre>
</pre>
−Video demo here: https://www.youtube.com/watch?v=VLZG9BZ0HLs
+Video demo here: https://www.youtube.com/watch?v=VLZG9BZ0HLs if module "Java connector"
+Video demo here: https://www.youtube.com/watch?v=AyQLOT0-SIY if module "New connector"
−=== D) Using the Java "Hardware Bridge" server for WebApps and TakePOS connector 18+ ===
−== E) Using the Java "Hardware Bridge" server for WebApps and TakePOS connector 18+ ==
[[File:warning.png]] This method is now deprecated.
[[File:warning.png]] This method is now deprecated.
Line 115:
Line 102:
</pre>
</pre>
−=== Setup of Dolibarr module ===
+==== Setup of Dolibarr module ====
With TakePOS connector 18+, as soon as the module is activated, TakePOS will use the Java server "Hardware bridge" as a printer (see next point). To switch back to use the browser, you must disable the module.
With TakePOS connector 18+, as soon as the module is activated, TakePOS will use the Java server "Hardware bridge" as a printer (see next point). To switch back to use the browser, you must disable the module.
The Java server accept websocket from the browser of the local computer. So when the server is stopped or restarted, it can warm the browser with a popup.
The Java server accept websocket from the browser of the local computer. So when the server is stopped or restarted, it can warm the browser with a popup.
The local browser (The module TakePOS connector) is sending the print request by sending the Raw text content encoded in Base64.
The local browser (The module TakePOS connector) is sending the print request by sending the Raw text content encoded in Base64.
−=== Setup of the Java Hardware Bridge ===
+==== Setup of the Java Hardware Bridge ====
This gateway run on Windows (or Linux but dev for Linux is not complete). You can download a release at https://github.com/imTigger/webapp-hardware-bridge/releases/. Click on a the version you want, so you will reach the list of files to download.
This gateway run on Windows (or Linux but dev for Linux is not complete). You can download a release at https://github.com/imTigger/webapp-hardware-bridge/releases/. Click on a the version you want, so you will reach the list of files to download.