=== eStorePOS – Point of Sale (POS) for WordPress eCommerce ===
Contributors: estorepos
Tags: point of sale, pos, ecommerce pos, retail pos, barcode pos
Requires at least: 6.5
Requires PHP: 7.4
Tested up to: 7.0
Stable tag: 1.0.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A complete point of sale (POS) system for WordPress eCommerce with barcode scanning, inventory sync, checkout, receipts, reports, and labels.

== Description ==

**eStorePOS** is a fast, responsive point of sale (POS) plugin for WordPress eCommerce that brings in-person checkout to your store. Sell online and in store from one system with shared products, customers, orders, inventory, taxes, and coupons.

There is no separate product catalog to import or maintain. eStorePOS connects your retail counter to your existing store data, keeping online and in-person sales together.

**Current eCommerce integration:** eStorePOS currently works with FluentCart. Support for additional WordPress eCommerce platforms is planned.

### A Complete Point of Sale (POS) for WordPress eCommerce

Open the full-screen POS register from your WordPress dashboard, find or scan a product, add a customer, take payment, and print the receipt. Every completed sale becomes an eCommerce order and follows the inventory and tax rules of your connected store platform.

eStorePOS is designed for retail stores, boutiques, grocery shops, bookshops, electronics stores, market stalls, pop-up shops, service counters, and other businesses that sell both online and in person with WordPress.

### Why Choose eStorePOS?

* **Built for WordPress eCommerce:** Use your existing products, variations, customers, orders, inventory, coupons, and taxes.
* **Fast counter checkout:** Sell from a responsive, full-screen POS interface with product search, category filters, barcode scanning, and keyboard-friendly controls.
* **Powerful free version:** Process sales, manage customers, print branded receipts, create barcode labels, issue refunds, and view reports without moving your store data to another platform.
* **One source of truth:** Keep online and in-store sales inside the same WordPress eCommerce system.
* **Self-hosted and private:** eStorePOS does not call an external service. Your store and POS data remain on your website.
* **Works with common POS hardware:** Use a standard barcode scanner, a supported device camera, and receipt or label printers available through your browser.

== eStorePOS Features ==

Here is a quick look at what you can do with eStorePOS.

### Fast Product Search and Selling

* Full-screen POS interface for desktop, tablet, and mobile
* Visual product grid with category tabs
* Live product search
* Product quick view
* Product variations and attributes
* Hardware barcode scanner support
* Barcode scanning with a supported device camera
* Light and dark display modes

### Cart and Checkout

* Add, remove, and update products from the POS cart
* Per-line quantity controls
* Per-line discounts
* Coupon support from your connected eCommerce platform
* Cash checkout with automatic change calculation
* Manual card checkout
* Optional card reference or last four digits
* Walk-in guest checkout
* Customer lookup and customer creation at the counter

### Shared Inventory, Orders, and Tax

* Create orders in your eCommerce store
* Use the same products and variations as your online store
* Update your store inventory after a sale
* Apply your existing tax rules
* Keep POS and eCommerce customer records together
* View POS orders and complete order details
* Reprint receipts from previous sales
* Process refunds through your connected store platform

### Receipt Printing and Customization

* Print receipts automatically or manually
* Add your store name and logo
* Customize receipt header and footer content
* Show or hide receipt fields
* Print through any receipt printer available to your browser

### Barcode Generator and Label Printing

* Design and print product barcode labels inside WordPress
* Include product name, price, SKU, barcode, variations, and attributes
* Set the exact label width and height
* Print one label per page for thermal roll printers
* Use browser printing for thermal or sheet label printers

### POS Reports and Dashboard

* Daily sales totals
* Payment-method breakdown
* Sales reports
* Order reports
* Customer reports
* Product reports
* Custom date ranges
* Period-over-period comparisons

== eStorePOS Pro ==

Need more control across staff, registers, and locations? eStorePOS Pro adds advanced tools for growing retail operations.

### Cashiers and PIN Login

* Create unlimited cashier accounts with fast PIN login
* Track sales and performance by cashier
* Force logout from the admin area
* Use a role-permission matrix to control what each role can do

### Shifts and Cash Drawer Control

* Open a shift with a counted cash float and close it with expected-versus-actual totals
* Count cash by denomination with currency-aware values
* Detect overages and shortages with required reasons and configurable alert thresholds
* Enable blind close mode so cashiers count without seeing the expected amount
* Handover shifts with the opening amount pre-filled from the previous close
* Record Cash In, Cash Out, and Safe Drop activity with a complete audit log
* Log drawer openings and track No Sale events
* Generate a cash-reconciliation report for every shift

### Multiple Outlets and Counters

* Create unlimited outlets and counters
* Bind each device to a counter so staff can start with a PIN
* Track inventory separately for each outlet
* Transfer stock between outlets with a complete transfer history
* Configure outlet-specific settings and tax overrides
* Assign staff to specific counters

### Advanced Selling

* Open multiple cart tabs to serve several customers at once
* Hold or park unlimited carts and resume them later
* Split a payment between cash and card
* Apply percentage or flat discounts with limits for each role
* Show a live cart on a customer-facing second screen

### Loyalty Points

* Award points on every sale using a configurable earning rate
* Redeem points manually, after a checkout prompt, or automatically
* Protect previously earned value when the points rate changes
* Show points on receipts and maintain a complete customer points history
* Award loyalty points for online orders

### Advanced Receipts and Reports

* Print gift receipts with prices hidden
* View cashier performance reports
* View shift and cash-reconciliation reports
* Compare outlet performance
* Review payment-method breakdowns
* Export report data to CSV

### POS Hardware and Device Support

eStorePOS runs in a modern web browser and adapts to desktop, tablet, and mobile screens. You can use a standard keyboard-style USB or Bluetooth barcode scanner. Camera scanning depends on browser camera access and device support.

Receipts and barcode labels use your browser's print system. If your browser and operating system can print to a receipt, thermal, or sheet printer, eStorePOS can generate print-ready output for it.

### Card Payment Notice

eStorePOS records card payments manually. Process the payment on your own card terminal, confirm the sale in the POS, and optionally enter a reference or the last four digits.

eStorePOS does not connect to a card processor and does not collect, store, or transmit card numbers.

### Privacy and Data Ownership

eStorePOS does not call an external service. Products, customers, orders, inventory, taxes, payment records, receipts, and reports remain on your WordPress website.

== Installation ==

1. In your WordPress dashboard, go to **Plugins > Add New Plugin**.
2. Search for **eStorePOS** and click **Install Now**, or upload the `estorepos` plugin folder to `/wp-content/plugins/`.
3. Activate **eStorePOS** from the Plugins screen.
4. Open **eStorePOS** in the WordPress admin sidebar.
5. Click **Open POS** and start selling.

== Frequently Asked Questions ==

= What is eStorePOS? =

eStorePOS is a point of sale plugin for WordPress eCommerce that turns an online store into an in-person retail checkout system. It lets you scan products, build carts, accept cash or manually recorded card payments, print receipts, and create orders from one POS screen.

= Which eCommerce platforms does eStorePOS support? =

Version 1.0.3 supports FluentCart. Support for additional WordPress eCommerce platforms is planned for future releases.

= Do my online store and POS share the same inventory? =

Yes. eStorePOS creates orders through your connected store platform and updates the same inventory used by your online store. You do not need to maintain a second POS catalog.

= Can I scan product barcodes? =

Yes. You can use a standard hardware barcode scanner or a supported device camera to find and add products at the counter.

= Can eStorePOS generate and print barcode labels? =

Yes. The built-in barcode-label designer can include a product name, price, SKU, barcode, variations, and attributes. Set the required label dimensions and print through your browser.

= Which payment methods are supported? =

The free version supports cash and manually recorded card payments. For cards, process the payment on your own terminal and optionally save a reference or the last four digits with the POS order. eStorePOS does not process or transmit card data.

= Can I apply discounts and coupons at the POS? =

Yes. eStorePOS supports per-line discounts and coupons available through the current eCommerce integration.

= Can I create or find customers during checkout? =

Yes. Search existing customers or create a customer directly from the POS. You can also complete a sale using a walk-in guest customer.

= Can I print custom receipts? =

Yes. Add your store name and logo, customize the header and footer, choose which fields appear, and print automatically or manually through your browser.

= Can I refund a POS order? =

Yes. Open the POS order and process the refund through your connected store platform. You can also view order details and reprint the receipt.

= Does eStorePOS include sales reports? =

Yes. The free plugin includes Sales, Orders, Customers, and Products reports with date-range filters and comparison data. The dashboard also shows daily totals and payment breakdowns.

= Does eStorePOS support cashiers, shifts, and multiple outlets? =

The free version uses existing WordPress users as Admin, Manager, or Cashier POS operators. Dedicated cashier accounts with PIN login, shifts, cash-drawer management, and multiple outlets are available in eStorePOS Pro.

= Which receipt and label printers work with eStorePOS? =

You can use any printer available through your browser. Set the required output size for receipt printers, thermal roll label printers, or sheet printers, then print using your browser's standard print dialog.

= Does eStorePOS send store data to an external service? =

No. eStorePOS does not call an external service. POS sales, customers, products, inventory, payments, receipts, and reports stay on your WordPress website.

== Screenshots ==

1. Full-screen POS register with product grid, categories, live search, stock status, and cart.
2. POS list view with product search, stock availability, favorites, and cart.
3. POS checkout with cash and card payment options, amount due, cash received, and order notes.
4. eStorePOS dashboard with revenue, orders, average order value, refunds, sales growth, and recent activity.
5. Product management with pricing, stock status, sales channels, barcode labels, and editing controls.
6. Receipt customization with configurable elements, live preview, paper size, tax breakdown, and print settings.
7. Barcode label designer with field controls, live preview, label size, and typography settings.
8. POS orders with invoice details, totals, payment status, refund status, and date filtering.
9. Customer management with contact details, order counts, total spent, and customer tags.
10. Sales reports with date filters, gross sales, refunds, revenue, orders, items sold, and top-selling products.

== Changelog ==

= 1.0.0 =
* Initial release.
