=== Warehouse Manager ===
Contributors: warehousemanagementsolutions
Tags: inventory, warehouse, stock management, purchase orders, invoices
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 8.2
Stable tag: 3.6.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Manage warehouse inventory, stock movements, purchase orders, sales orders and invoices directly from WordPress.

== Description ==

Warehouse Manager turns your WordPress site into a warehouse and inventory system. Your team works in a fast, focused app at `yoursite.com/wms/`, with its own sign-in page, menu and screens, kept apart from wp-admin and your site's theme.

= Inventory =

* Products with SKU, barcode, category, unit, cost and selling price, and a reorder level
* Variable products (e.g. size and colour) with their own SKU, price and stock per variation
* Stock on hand, reserved and available, with a full stock movement history
* "Low Stock" filter and red quantities for products at or below their reorder level
* Stock adjustments with a reason, kept in the history
* Categories and units of measure

= Buying and selling =

* Purchase orders: draft, order, receive in full or in part, with stock added on receipt
* Sales orders: draft, confirm (reserves stock), deliver in full or in part, complete or cancel
* Invoices from sales orders: issue, record payments (cash, bank transfer, e-wallet and your own methods), void
* Suppliers and customers, with contact details and status
* Purchase orders, sales orders and invoices keep the supplier, customer and product names they were made with, even after those records are deleted

= Dashboard =

* Monthly totals of purchases, sales and invoices for the year, as a chart
* Each month's documents, with links to open them

= Team and permissions =

* Three roles following common separation-of-duties rules:
  * **Manager**: everything in the app
  * **Accounting**: dashboard, purchase and sales orders (view), invoices and payments, customers, suppliers
  * **Sales**: sales orders, draft invoices, customers, products (prices and stock, without costs)
* System User page for administrators to add, edit and remove the app's users
* Users with the plugin's roles work in the app only: no wp-admin, no toolbar
* Visitors without a warehouse role are sent to the website instead of the app

= Your brand =

* Theme colour and logo, used across the app and its sign-in page
* Currency setting
* Light and dark mode, following the device's setting
* Works on phones, tablets and desktops

= For developers =

* Override any screen from your theme (`{theme}/wms/`), like WooCommerce templates
* Filters and actions to change pages, settings, redirects and more
* A REST API (`/wp-json/wpwm/v1/`) used by the app itself, with the same permission checks
* Developer guide in `docs/core.html`

== Installation ==

1. Upload the `warehouse-manager` folder to `/wp-content/plugins/`, or install the plugin from the Plugins screen in WordPress.
2. Activate it from the Plugins screen. The plugin creates its database tables and roles.
3. Open **Warehouse** in the wp-admin menu, or go to `yoursite.com/wms/`.
4. Go to **Settings** in the app to choose your currency, theme colour and logo.
5. Add your team on **System User** and give each person a role (Manager, Accounting or Sales).

If `yoursite.com/wms/` shows "Page not found", go to **Settings → Permalinks** in wp-admin and click **Save Changes** once.

== Frequently Asked Questions ==

= Where is the app? =

At `yoursite.com/wms/`. Administrators also get a **Warehouse** link in the wp-admin menu and in the toolbar. Signed-out visitors are sent to the app's sign-in page at `yoursite.com/wms/login/`.

= Can I change the /wms/ address? =

Yes, with the `wpwm_app_base` filter, for example `add_filter( 'wpwm_app_base', fn() => 'warehouse' );`. The address updates on the next page load.

= Who can use the app? =

WordPress administrators, and users with the Manager, Accounting or Sales role. Other signed-in users (e.g. subscribers or shop customers) are sent to the website's home page.

= Can I change how a screen looks? =

Yes. Copy a file from the plugin's `templates/` folder to a `wms/` folder in your theme and edit the copy. See "Overriding templates" in `docs/core.html`.

= What happens to my data if I delete the plugin? =

By default your warehouse data, settings and roles are kept, so reinstalling the plugin brings everything back. To remove everything when the plugin is deleted, go to **Settings → General → Data** in the app and choose "Delete all warehouse data, settings and roles" before deleting it. Deactivating the plugin never deletes anything.

= Does the plugin send data to other services? =

No. All data stays in your WordPress database. The app shows each user's profile picture through WordPress's own avatar function (Gravatar by default, as in wp-admin). The **Reports** menu item, marked "Add on", is a link to warehousemanagementsolutions.com and opens only when you click it; the plugin contains no locked features.

== Screenshots ==

1. Dashboard with the year's purchases, sales and invoices by month.
2. Products list with stock levels and the Low Stock filter.
3. Sales order with delivery and invoicing.
4. Invoice with payments.
5. System User page for managing the team.
6. Sign-in page with your logo and theme colour.

== Changelog ==

= 3.6.1 =
* Initial release.

== Upgrade Notice ==

= 3.6.1 =
Initial release.
