=== Sample Order & Product Generator ===
Contributors: Douple
Plugin URI: https://douple.net/sample-order-product-generator/
Tags: woocommerce, sample orders, sample products, test data, dummy data
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.2
Stable tag: 1.2.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Generate realistic WooCommerce sample orders and simple products in seconds — ideal for plugin, theme, report, and storefront testing.

== Description ==

**Plugin URL:** [https://douple.net/sample-order-product-generator/](https://douple.net/sample-order-product-generator/)
**Demo:** [https://douple.net/sample-order-product-generator/demo.html](https://douple.net/sample-order-product-generator/demo.html)
**GitHub:** [https://github.com/thiendo/WordPress-Sample-Order-Product-Generator-Plugin](https://github.com/thiendo/WordPress-Sample-Order-Product-Generator-Plugin)
**Support:** support@douple.net

**Sample Order & Product Generator** is a lightweight WooCommerce helper for developers, agencies, and store owners who need dummy order and product data without manually clicking through checkout.

When you are building a report, testing a payment gateway, previewing an email template, or filling a staging store before a client demo, this plugin creates clean, clearly marked sample data in a few clicks — then lets you keep working in the native WooCommerce screens you already know.

= Features =

* **One-click sample orders** — create batches of orders without running a real checkout
* **Choose order status** — completed, processing, pending, or on-hold
* **Products per order** — control how many line items each sample order receives
* **Simple sample products** — generate up to 10 published simple products per run for empty catalogs
* **Clearly marked sample data** — orders and products are tagged with plugin meta so they are easy to identify later
* **Native WooCommerce workflow** — review generated data in the standard Orders and Products screens
* **HPOS compatible** — declares compatibility with WooCommerce High-Performance Order Storage
* **Privacy-friendly** — sample data stays in your own WordPress / WooCommerce database
* **Fully translatable** — ready for WordPress.org language packs

= Perfect for =

* Developers testing WooCommerce plugins, themes, and customizations on staging sites
* Agencies preparing demo stores or client sandboxes before go-live
* Store owners who need a few realistic orders to verify reports, emails, or dashboards
* QA teams filling catalogs and order lists without touching live customer data

= What this free package includes =

Everything shipped in this wordpress.org package is fully usable. There is no paywall, license activation, or locked screen inside the free plugin.

Free tools focus on fast, safe sample generation:

1. Open **Sample Orders → Generate Orders**
2. Choose how many orders to create, the status, and products per order
3. Optionally open **Generate Products** to seed a few simple products first
4. Review the results in WooCommerce Orders / Products

= Advanced toolkit (separate distribution) =

A separately distributed advanced toolkit adds scheduling, variable products, CSV exports, presets, cleanup tools, and activity logs. It is **not** required to use this free plugin, and it is **not** bundled in this package.

Learn more: [https://douple.net/sample-order-product-generator/](https://douple.net/sample-order-product-generator/)

= Requirements =

* WordPress 5.8 or higher
* PHP 7.2 or higher
* WooCommerce 3.0 or higher (required)

== Installation ==

1. Upload the `douple-sample-order-generator` folder to `/wp-content/plugins/`, or install from **Plugins → Add New**.
2. Activate the plugin through the Plugins screen in WordPress (WooCommerce must be active).
3. Go to **Sample Orders** in the admin sidebar.
4. Use **Generate Orders** and/or **Generate Products**.
5. Product page / docs: [https://douple.net/sample-order-product-generator/](https://douple.net/sample-order-product-generator/)

== Frequently Asked Questions ==

= Will it delete or modify real customer orders? =

No. The plugin only creates new sample orders and products. It does not edit, refund, or delete existing customer data.

= Do I need WooCommerce? =

Yes. This plugin generates WooCommerce orders and products, so WooCommerce must be installed and active.

= Are any features locked behind a licence? =

No. Everything included in this wordpress.org package works without payment or activation.

= How do I tell sample data apart from real data? =

Generated orders and products are marked with plugin meta (`_dsog_sample_order` / `_dsog_sample_product`) so you can identify them later. Product names and order notes also indicate they were created as sample data.

= What if I have no products yet? =

Use **Sample Orders → Generate Products** to create a small set of simple products first, then generate orders against that catalog.

= Does this plugin slow down my storefront? =

No. The free tools only run in `wp-admin` when you explicitly generate sample data. They do not add frontend scripts to your shop.

= Does this plugin send data to third parties? =

No. Sample order and product data stays in your WordPress database. This free package does not contact external services and does not include licensing or updater SDKs.

= What happens if I deactivate or uninstall the plugin? =

Deactivating keeps generated sample orders/products in WooCommerce (they are store content). Uninstall removes plugin settings and operational options; generated orders/products are intentionally preserved so you do not lose test data by surprise.

= Where is the source code? =

https://github.com/thiendo/WordPress-Sample-Order-Product-Generator-Plugin

== External services ==

This free package does **not** connect to external services for licensing, analytics, or updates beyond the normal WordPress.org update API.

Generated sample data remains local to your site.

== Development ==

Human-readable source for plugin-owned JavaScript is included in this package under `assets/` (for example `dsog-notice-dismiss.js`).

Public source repository: [https://github.com/thiendo/WordPress-Sample-Order-Product-Generator-Plugin](https://github.com/thiendo/WordPress-Sample-Order-Product-Generator-Plugin)

No build tools are required to review or modify the free package sources.

== Screenshots ==

1. Generate sample orders — choose quantity, status, and products per order from the admin screen.
2. Review generated sample orders in the native WooCommerce orders list.

== Changelog ==

= 1.2.1 =
* Renamed plugin to Sample Order & Product Generator for WordPress.org.
* Slug / text domain / main file aligned to `douple-sample-order-generator`.
* Free package can generate simple sample products (max 10 per run).
* Removed upgrade / trialware UI from the free package (Guideline 5).
* Hardened escaping and unique `dsog_` prefixes for wordpress.org review.

= 1.2.0 =
* Packaging improvements and HPOS compatibility.
* Free package focuses on fully usable sample order and product tools.

= 1.0 =
* Initial release with core features: generate multiple sample orders, choose order status, and items per order.

== Upgrade Notice ==

= 1.2.1 =
Adds free simple sample product generation, wordpress.org-compliant packaging, and removes upgrade UI from the free package. Recommended for all free installs.
