=== Prodiseum Manual & Automatic Order Printer for WooCommerce ===
Contributors: prodiseum
Tags: woocommerce, order printer, automatic printing, thermal printer, receipt printer
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 2.2.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Manage and manually print WooCommerce orders, with optional automatic thermal printing through Nuntius Desktop PRO.

== Description ==

Prodiseum Manual & Automatic Order Printer for WooCommerce turns WordPress into a practical order and ticket desk.

The WordPress plugin works on its own for manual printing. It provides an order dashboard, search and filters, 58 mm / 80 mm ticket views, manual browser printing, print history, and new-order alerts inside WordPress admin. Automatic printing is available through the optional paid Nuntius Desktop PRO companion application.

Manual printing uses the browser print dialog and the printers installed on the computer. WordPress does not silently select a physical printer from a web page.

For businesses that need hands-free printing, the plugin can optionally connect to Nuntius Desktop PRO for Windows. Nuntius Desktop PRO is a separate paid companion application from Prodiseum Digital Dynamics. It runs on the Windows computer connected to the thermal printer and automatically receives and prints new WooCommerce orders.

The WordPress plugin remains fully usable without Nuntius Desktop PRO.

= Included features =

* WooCommerce order dashboard.
* Search and filter orders by status and date.
* Thermal-friendly 58 mm and 80 mm tickets.
* Manual ticket printing from the browser.
* Reprint previous orders.
* Print status and recent print history.
* New-order popup alerts in wp-admin.
* Optional bell sound for new orders.
* Secure API bridge for the optional desktop companion application.
* WooCommerce HPOS compatibility.

= Automatic printing with Nuntius Desktop PRO =

Nuntius Desktop PRO is a separate paid Windows companion application. It adds automatic order reception, local printer selection, background operation and automatic printing.

No paid application is required to use the order dashboard, alerts, ticket views or manual printing features included in this WordPress plugin.

== External Services and Privacy ==

The free WordPress plugin does not send WooCommerce order or customer data to Prodiseum Digital Dynamics or to any third-party service.

If the optional Nuntius Desktop PRO application is connected, that local Windows application requests order data directly from your own WordPress site's authenticated REST API. The API key can be regenerated at any time from the Automatic Printing screen.

The product page link to Prodiseum is shown only as information about the optional companion application. Opening that link is a normal user-initiated browser request.

== Installation ==

1. Install and activate Prodiseum Manual & Automatic Order Printer for WooCommerce.
2. Make sure WooCommerce is active.
3. Open Prodiseum Printer > Orders to view current WooCommerce orders.
4. Open Prodiseum Printer > Ticket Settings to choose 58 mm or 80 mm paper and configure admin alerts.
5. Use View ticket or Print from the Orders screen for manual printing.
6. If you use Nuntius Desktop PRO, open Prodiseum Printer > Automatic Printing to copy the API Base URL and API Key into the Windows application.

== Frequently Asked Questions ==

= Does the plugin work without the Windows application? =

Yes. The WordPress plugin includes order management, filters, ticket views, manual ticket printing, print history and new-order alerts.

= How do I choose the printer for manual printing? =

Click Print ticket and choose any printer installed on the computer from the browser print dialog. Setting a thermal printer as the operating system default can make repeated printing faster.

= Can WordPress automatically select my thermal printer? =

No. Browsers do not allow a normal WordPress page to silently choose and control a local printer. Automatic local printer selection is provided by the optional Nuntius Desktop PRO Windows application.

= What does Nuntius Desktop PRO add? =

It automatically receives new WooCommerce orders on a Windows computer and sends them to the selected local thermal printer without manual intervention.

= Why might the bell sound not play immediately? =

Modern browsers normally require one user interaction with a page before audio can play. The visual new-order popup still appears even if audio is blocked. Sound is optional and disabled by default on new installations.

= Is HTTPS recommended for the desktop connection? =

Yes. The desktop API can transmit customer and order information, so HTTPS is strongly recommended.

== Changelog ==

= 2.2.1 =
* Added the Nuntius product logo to the plugin administration header for a consistent Prodiseum interface.
* Added a compact version badge to the shared administration header.

= 2.2.0 =
* Renamed the WordPress.org edition to Prodiseum Manual & Automatic Order Printer for WooCommerce.
* Updated the plugin slug, main file and text domain to prodiseum-manual-automatic-order-printer-for-woocommerce.
* Updated the repository description and tags to clearly cover both manual and optional automatic printing.
* Kept automatic printing clearly identified as requiring the separate paid Nuntius Desktop PRO companion application.

= 2.1.0 =
* Renamed the WordPress.org edition to Prodiseum Order Printer for WooCommerce.
* Normalized plugin folder, main file and text domain for the WordPress.org slug.
* Added Tested up to metadata for WordPress 7.1.
* Replaced five-second custom order polling with the native WordPress Heartbeat API.
* Changed new-order sound to disabled by default on fresh installations.
* Added clear manual printer setup guidance.
* Added HTTPS guidance for the optional desktop connection.
* Added nonce protection to order filters, ticket links and status messages.
* Added missing translator comments.
* Removed the manual translation loader discouraged for WordPress.org-hosted plugins.
* Updated the optional premium companion area to separate manual printing from automatic printing more clearly.

= 2.0.0 =
* Added standalone WooCommerce order dashboard.
* Added order search, status and date filters.
* Added 58 mm and 80 mm ticket views.
* Added manual browser ticket printing and reprinting.
* Added print status and recent print history.
* Added instant new-order popup alerts across WordPress admin.
* Added optional new-order bell sound.
* Added Ticket Settings screen.
* Added Desktop PRO information and connection screen.
* Added per-installation API keys and key regeneration.
* Added WooCommerce HPOS compatibility declaration.
* Updated public author to Prodiseum Digital Dynamics.
