Super Smart Print Order

🔄 Updating from an Earlier Version

Your settings are preserved

1. Go to Plugins → Installed Plugins
2. Deactivate then Delete the old version
3. Upload and activate the new ZIP file

Deleting the plugin does not delete your settings, your print history, or your printer connection — those live in the database and are picked up again automatically.

🏪 Shop Information

This info appears on all printed receipts and documents

Shop Name

Your business or restaurant name. Displayed prominently at the top of every receipt and document.

Shop Address

Your full street address. Shown in the header area of printed orders and invoices.

Shop Phone

Your contact phone number. Displayed below the address on printed documents.

Shop Logo

Click "Upload Logo" to open the WordPress Media Library. Select or upload an image. The logo appears in the header of every print. You can control its position (left, center, right) and size (50px–300px) in the Template Editor.

🏢 Additional Business Info (Optional)

Extra details for multi-location or franchise businesses

Business / Brand Name

A secondary name — useful for branches, departments, or franchise names. Example: "Downtown Branch" or "Kitchen #2".

Business Address

A secondary address line. Use this for a kitchen or warehouse address that differs from the shop address.

Additional Info

Free text field for any extra content you want on every print: tagline, opening hours, Wi-Fi password, legal notice, VAT number, etc.

🖨️ Print Settings

Configure default printing behavior

Default Template

Choose which paper size opens by default when you click the print button:

• A4 — Standard European paper (210×297mm). Best for office printers.
• Letter — US standard (8.5×11"). Same layout as A4 with US margins.
• POS — Thermal receipt paper. For restaurant receipt printers.

Auto Print

When enabled, clicking the print button immediately opens the browser's print dialog without showing the preview first. Saves one click for high-volume kitchens.

🖨️ How to Print an Order

Two locations where print buttons appear

Method 1: Orders List Page

Go to WooCommerce → Orders. Each order row has a small 🖨️ printer icon button in the Actions column. Click it to print that order instantly using your default template.

Method 2: Individual Order Page

Open any order. In the print meta box in the right sidebar, you'll find buttons for each document type: Order Receipt, Invoice, Packing Slip, and Delivery Label.

Method 3: Reprint from History

Go to Super Print Order → Print History. Every past print has a Reprint button that prints the same order with the same template again.

What Happens When You Click Print

1. A new browser tab/window opens with the formatted print layout
2. If Auto Print is on → the browser print dialog opens immediately
3. If Auto Print is off → you see a preview and can click the browser's print button
4. The print is logged in Print History with timestamp and user info

🎨 Using the Template Editor

Full control over what appears on your printed documents

The Template Editor has a settings panel on the left and a live preview on the right. Every change you make updates the preview in real-time. At the top, select which paper size you want to edit: A4, Letter, or POS.

Show / Hide Fields

Each section and field has an on/off toggle. Turn off anything you don't want on the printout. Available toggles include:

• Logo — your shop logo image
• Shop Info — name, address, phone
• Business Info — secondary business details
• Order Number & Date — order reference info
• Customer Info — name, email, phone
• Billing Address — full billing details
• Shipping Address — full shipping details
• Product Items — item names, quantities, prices
• SKU Column — product SKU in items table
• Order Totals — subtotal, tax, fees, total
• Payment Method — how the customer paid
• Order Notes — customer-provided notes
• Custom Fields — each custom field individually
• Footer — bottom section with additional info

Drag & Drop Element Order

The sections listed in the editor panel can be dragged and dropped to rearrange their order on the printed document. Grab the handle (≡) next to any section and drag it to a new position.

Colors & Fonts

Customize the look of your printed documents:

• Primary Color — used for headers, borders, and accents (color picker)
• Text Color — main body text color
• Border Color — lines and separators
• Header Font Size — size of title and shop name
• Body Font Size — size of regular content text
• Footer Font Size — size of footer text

Logo Position & Size

• Position — Left, Center, or Right alignment in the header
• Size — Width in pixels from 50px to 300px (height adjusts proportionally)

Paper Margins

Set custom margins for each paper size. POS typically uses small margins (5–10mm) to maximize receipt width. A4/Letter can use wider margins (15–30mm) for professional look.

📑 Additional Document Types

Available from the print meta box on each order

🧾 Invoice

A professional invoice document with:

• Auto-generated invoice number based on the order number
• Payment status badge (Paid / Unpaid / Refunded)
• Itemized billing with quantities, unit prices, and line totals
• Tax breakdown and grand total
• Your shop details and customer billing address

📦 Packing Slip

A warehouse-ready packing list for order fulfillment:

• Checkboxes next to each item for staff to tick off
• Product name, SKU, and quantity (no prices — for privacy)
• Shipping address prominently displayed
• Delivery instructions and order notes

🏷️ Delivery Label

A large, clear shipping label:

• Customer name and full shipping address in large font
• Order number and date for reference
• Barcode placeholder area
• COD (Cash on Delivery) badge — automatically shown for cash payment orders
• "FROM" section with your shop address

How to Print These Documents

Open any order in WooCommerce. In the print meta box in the right sidebar, you'll see buttons for each document type. Click the one you need — it opens in a new tab ready to print.

📝 How Custom Fields Work

Automatic detection with individual visibility controls

The plugin automatically scans each order's metadata and detects custom fields added by checkout editor plugins. These fields appear on your printed documents without any manual configuration.

Compatible Plugins

• WooCommerce Checkout Field Editor — official WooCommerce extension
• Checkout Field Editor by ThemeHigh — popular free/pro plugin
• Flexible Checkout Fields by WP Desk — another popular option
• Any plugin that saves to order meta — the auto-detection works with any plugin that stores data as WooCommerce order meta

Individual Show/Hide Control

In the Template Editor, each detected custom field gets its own toggle. You can show or hide individual fields per paper size. For example, show "Delivery Instructions" on POS receipts but hide "Company Registration Number" — which is only needed on A4 invoices.

Excluded Internal Fields

The plugin intelligently filters out WooCommerce internal meta so only meaningful custom fields appear. Fields with the following prefixes are automatically hidden:

Field Label Formatting

Meta key names are automatically converted into human-readable labels:

🔔 Setting Up Order Alerts

Never miss a new order with audio notifications

Enable Sound Notifications

Check the "Enable Sound Notifications" box. When enabled, the plugin polls for new orders in the background and plays a sound alert when a new order arrives.

Sound Type

Choose from the built-in notification sounds:

• 🔔 Ding — Classic short notification beep
• 🎵 Chime — Melodic, pleasant alert tone
• 🔊 Bell — Traditional bell ring sound
• ⚠️ Alert — Attention-grabbing alert (louder, for noisy kitchens)
• 📁 Custom — Upload your own MP3 file via WordPress Media Library

Volume

Slider from 0% to 100%. Set this based on your environment's noise level. For busy kitchens, use 80–100%. For quiet offices, 30–50% is usually enough.

Check Interval

How often the plugin checks for new orders, in seconds. Accepts values from 10 to 300 seconds. Shorter intervals mean faster alerts but slightly more server load.

📋 Using Print History

Track every print job across your team

Every time an order is printed — by a person or automatically — it's logged in the Print History. This gives you a complete audit trail.

What Gets Logged

• Timestamp — exact date and time of the print
• Order Number — which order was printed (clickable link to the order)
• Template Type — which template was used (POS, A4, Invoice, Packing Slip, etc.)
• Print Type — MANUAL (someone clicked print) or AUTOMATIC (cloud printer)
• User — which WordPress user triggered the print

Search & Filter

Use the search bar to find prints by order number, date range, or user. Results can be filtered by template type and print type.

Quick Actions

• View Order — jump directly to the order in WooCommerce
• Reprint — print the same order again with the same template

Statistics

At the top of the Print History page, summary statistics show: total prints today, this week, and this month. Useful for tracking order volume trends.

☁️ What Automatic Printing Does

New orders print by themselves — no computer, no clicking

When automatic printing is switched on, every new order is printed on your thermal printer within seconds of the customer placing it. Nobody has to be logged in, no browser tab needs to be open, and no computer needs to be connected to the printer. The printer only needs power and an internet connection.

Supported Printers

Any Star Micronics printer with CloudPRNT support:

• TSP100IV / TSP143IV
• TSP654II CloudPRNT
• mC-Print2 / mC-Print3
• SP700 with an HI01X interface card

Why There Are Two Methods

A Star printer never waits to be contacted. Instead, it asks a question every few seconds: "is there anything to print?" Somebody has to answer that question. That's the only difference between the two methods below — who does the answering.

🟢 Method A — Direct Setup

The recommended path. About 10 minutes, no technical knowledge needed.

Step 1 — Switch the method on

1. Go to Super Print Order → Settings
2. Under Printing method, choose Direct — printer connects to this website
3. Set Paper width: 80 mm for normal receipt rolls, 58 mm for narrow ones
4. Click Save Changes

Step 2 — Copy your Server URL into the printer

The Settings page shows your Server URL with a Copy button. It looks like this:

1. Switch the printer off. Hold down the FEED button, switch it back on, and keep holding for about 5 seconds. The printer prints a page showing its IP address, such as 192.168.1.50
2. Type that IP address into a browser on the same network. The printer's own settings page opens
3. Find the CloudPRNT section and switch it ON
4. Paste your Server URL into the box named Server URL
5. Set Polling interval to 5 seconds. Leave username and password empty
6. Click Save. The printer restarts on its own — wait about 30 seconds

Step 3 — Confirm it worked

Reload the Settings page and look at the Printers connected to this website table. Your printer should be listed and marked Online, showing its MAC address, when it last checked in, and how many jobs it has printed. Press Send Test Print to confirm.

If the printer doesn't appear

First check the endpoint is alive. Open https://yoursite.com/wp-json/ in a browser and search the page for sspo/v1. If you find it — it may appear as sspo\/v1, which is normal JSON formatting — the endpoint is working and the problem is at the printer end. If you don't find it, a security plugin is probably blocking the WordPress REST API.

Settings also shows an alternative URL form that often gets through when the first is blocked:

Extra options

• Print shop logo — off by default. Only enable it if your printer has recent firmware; older models print a blank space instead of the image.
• Clear queue — discards receipts waiting to print. Useful after a paper jam, or if a backlog built up while the printer was offline.

🔵 Method B — Star Cloud Service Setup

Only needed if Direct doesn't work for your setup

Step 1 — Create your Star account

1. Sign up at starprinter.online
2. Create a Device Group with a short name, no spaces — for example myshop

Step 2 — Point the printer at Star

1. Copy the CloudPRNT URL shown for your Device Group
2. Open the printer's settings page (same FEED button trick as Method A)
3. Paste Star's URL into Server URL, set polling to 5 seconds, and Save
4. Back in the Star dashboard, your printer appears. Copy its Application Access ID — a short code like e9042f5f

Step 3 — Create your API Key

1. In the Star dashboard go to API Keys → Create key
2. Give it the PrintToDevice permission
3. Copy the key — it looks like 6800ffd6-2367-4c8d-b067-d6a28151276a

Step 4 — Build your API URL

Combine your group name and Application Access ID like this:

Paste it into the API URL box, paste the key into API Key, choose Star Cloud service as the method, and Save. Then press Send Test Print.

Keyless alternative

Star also accepts a URL that needs no key at all:

Leave the API Key box empty when using this form. It is simpler but less secure — anyone who learns the URL can print to your printer.

🧾 What the Automatic Receipt Contains

Built specifically for thermal receipt printers

• Shop name in large bold text, plus address, phone and any extra business info
• Order number, printed large so kitchen staff can read it at a glance
• Date, payment method, customer name and phone
• Delivery or billing address
• All items with quantities and prices, including variations and add-ons
• Full totals, with the grand total in double height
• Customer note, if one was left
• Automatic paper cut at the end

⏱️ When Orders Print

Three triggers, one receipt

To make sure no payment gateway is missed, printing is triggered when the order is created, when the customer reaches the thank-you page, and when the order status becomes Processing. Whichever happens first wins.

Each order is protected by two independent duplicate checks, so it prints once and only once no matter how many triggers fire.

🔧 Troubleshooting

What each problem means and how to fix it

🆘 Setup Help Inside WordPress

No separate document to find, no printer manual to decode

The plugin includes a complete setup guide as its own admin page, written in plain language for people with no technical background. It is reachable from four places, so it's always one click away:

• The Help & Setup item in the Super Print Order menu
• A button above the printer settings on the Settings page
• A Help & Setup link on the Plugins list, next to Deactivate
• The standard Help tab at the top-right of every plugin screen

Live Status Banner

The top of the page reads your actual configuration and tells you exactly where you stand — whether printing is switched off, whether the printer has ever connected, and whether it's responding right now.

Side-by-Side Method Comparison

The two printing methods are laid out with their advantages and drawbacks, so you can choose before starting rather than discovering the trade-offs halfway through.

API URL Builder

For the Star Cloud method, instead of asking you to assemble a long URL by hand, the page gives you two boxes — group name and printer ID — and builds the finished URL as you type, with a copy button. A toggle switches between the keyed and keyless URL formats.

Test Print Button

Available directly on the help page, so you can finish the setup and confirm it works without navigating back and forth.

Troubleshooting Table & FAQ

Every error message the plugin can produce is listed with its meaning and its fix, followed by answers to the questions that come up most often — which method to choose, whether a computer must stay on, how to use more than one printer, and where to see what has been printed.

🚗 How SDP Data Appears on Receipts

Automatic — no configuration needed

If you use the Super Delivery & Pickup plugin, all order details are automatically displayed on printed receipts via the custom fields system.

Fields That Appear

• Order Type — "Delivery" or "Pickup"
• Date — the selected delivery/pickup date
• Time Slot — the selected time window (e.g., "12:00 - 12:15")
• Delivery Zone — zone name with zip codes (e.g., "Paris (75019, 75020)")
• Pickup Location — location name (e.g., "Main Store - Rue de Rivoli")

Hidden Internal Fields

These SDP meta keys are automatically excluded from printouts (they're internal IDs):

• _sdp_delivery_zone_id — numeric zone ID (the display name is shown instead)
• _sdp_pickup_location_id — numeric location ID (the name is shown instead)
• _sdp_tip_amount — tip amount (already visible as a fee line in order totals)

SDP Order Notes

SDP also adds a formatted order note with all details. If "Order Notes" is enabled in the Template Editor, the SDP summary appears as well:

🌍 Translating the Plugin

Compatible with Loco Translate, WPML, Polylang

Using Loco Translate (Recommended)

1. Install and activate the Loco Translate plugin
2. Go to Loco Translate → Plugins → Super Smart Print Order
3. Click New language and select your language
4. Translate each string and click Save

French Translation Included

A complete French translation (.po/.mo files) is included in the languages/ folder. Labels like "Order Type", "Time Slot", "Invoice", "Packing Slip" are all translated to French.

What Gets Translated

All user-facing and admin-facing strings: settings labels, template section titles, print history columns, notification messages, document headers ("Invoice", "Packing Slip", "Delivery Label"), button labels, field names on printed documents, and the entire Help & Setup guide.

☁️ Extra Requirements for Automatic Printing

Only if you want receipts to print by themselves

• A Star CloudPRNT printer — TSP100IV, TSP143IV, TSP654II CloudPRNT, mC-Print2/3, or SP700 with HI01X
• The printer connected to the internet — network cable is easiest, Wi-Fi also works
• For the Direct method — your website reachable from the internet, with the WordPress REST API not blocked by a security plugin
• For the Star Cloud method — a starprinter.online account, and outgoing HTTPS allowed by your web host
• HTTPS strongly recommended — so order details are encrypted between your site and the printer