=== FXOapps Order Returns for WooCommerce ===
Contributors: fxoapps
Tags: woocommerce, returns, refund, rma, exchange
Requires at least: 5.3
Tested up to: 7.0
Requires PHP: 7.2
Stable tag: 1.4.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Requires Plugins: woocommerce

Guided WooCommerce return requests for customers with a full admin workflow.

== Description ==

**FXOapps Order Returns for WooCommerce** helps logged-in customers submit return requests from completed orders within a configurable time window. You manage every request from a dedicated admin area with status workflow, email notifications, translations, and appearance controls.

This WordPress.org release includes a **complete core return workflow** without a license or external account.

= What customers can do =

* Start a guided return wizard from **My Account → Retur** (logged-in customers)
* Choose product condition and return reason (as configured by the shop)
* Select a return option (refund, exchange, bank transfer, etc.)
* Choose courier handover when enabled by the shop (shop calls courier or customer calls courier)
* Receive a confirmation email after submitting a return

= What shop owners get =

* **Dashboard** with return statistics and charts (fixed recent period)
* **Returns list** with search, status filter, and pagination
* **Return settings** — return period, admin email, date format
* **Return flow** — unlimited product condition + reason rows, with per-reason return shipping fee payer (shop or customer)
* **Return options** — built-in customer-facing return option types with translated labels
* **Handover (courier)** — shop-calls-courier or customer-calls-courier modes with editable notices
* **Appearance** — colors, border radius, and theme compatibility
* **Translations** — edit storefront and admin strings; compatible with WPML and Polylang
* **Email notifications** — customer confirmation and admin alert when a new return is submitted
* **IBAN validation** when a return option requires bank details
* **Support** contact form in wp-admin
* **WooCommerce HPOS** (custom order tables) compatibility

= PRO features (separate commercial plugin) =

Advanced features are available in **FXOapps Order Returns PRO** on fxoapps.com, including:

**Return experience**

* Guest returns without account login (public /retur page with order number + email verification)
* Group returns (multiple products from one order)
* Customer product image uploads on returns
* Courier pickup date on the return form
* In-person handover at store locations
* Per-reason “shop calls courier” override on return shipping

**Store operations**

* Automatic stock restore when a return is completed
* WooCommerce store credit coupons for coupon-type returns (created when completed)
* Bulk status actions on the returns list
* Internal admin notes on return records
* Print return / RMA slip
* Date range filter on the returns list
* Filter returns by return option and show the selected option in the list

**Reporting and exports**

* CSV export with current list filters
* Advanced dashboard with custom date range
* Returns by product and return reason statistics
* Scheduled and on-demand weekly return reports by email

**Automation and rules**

* Customizable customer and admin email templates
* Email notifications when return status changes
* Multiple admin notification email addresses
* Exclude selected products or categories from returns
* Per-category return period overrides

**Support**

* Priority support

See **Order Returns → Settings → PRO features** in wp-admin for the full list.

= Merchant setup =

After activation, open **Order Returns → Settings** and configure:

1. **General** — return period (days), admin notification email, date format
2. **Return flow** — add product condition labels and return reasons
3. **Return options** — choose which built-in return options customers can select
4. **Handover** — enable courier return and edit courier notices
5. **Appearance** — match the return form to your store branding

== Installation ==

1. Install and activate **WooCommerce**.
2. Upload the `fxoapps-order-returns-woocommerce` folder to `/wp-content/plugins/`.
3. Activate **FXOapps Order Returns for WooCommerce** through the **Plugins** menu in WordPress.
4. Go to **Order Returns → Settings** and configure your return period, return flow, return options, and handover preferences.

== Frequently Asked Questions ==

= Does this plugin require a license or external account? =

No. This release works without a license key, subscription, or fxoapps.com account.

= Is there a PRO version? =

Yes. FXOapps offers a separate commercial PRO plugin with advanced features listed under **Settings → PRO features**. PRO is not required for core returns.

= Can guests return products without logging in? =

Not in the free WordPress.org edition. Guest returns on the public `/retur` page are available in **FXOapps Order Returns PRO**. The free edition supports returns from **My Account → Retur** for logged-in customers.

= Does it work with WooCommerce HPOS? =

Yes. The plugin declares compatibility with WooCommerce custom order tables (HPOS).

= Does the plugin call external services? =

No. This release does not phone home, send telemetry, or contact a license server.

== Screenshots ==

1. Customer return wizard — product selection from a completed order
2. Return form — product condition, reason, handover, and return option
3. Admin returns list with status filter and search
4. Settings — return flow (condition and reason configuration)
5. Settings — PRO features tab

== Changelog ==

= 1.4.3 =
* Readme: align free vs PRO feature lists with the current plugin split.
* Document guest returns, group returns, store credit coupons, email templates, weekly reports, and other PRO-only features correctly.
* Clarify that the free edition serves logged-in customers via My Account.

= 1.4.2 =
* PRO features tab: benefit cards layout and updated PRO feature list.
* Return options: built-in dropdown types with fixed IDs and legacy ID normalization.

= 1.4.1 =
* Split free vs PRO: text-only PRO features tab; remove PRO-only settings from free UI.
* Disable status-change emails in free; keep new-return notifications.

= 1.4.0 =
* Rebrand and WordPress.org compliance release.

== Upgrade Notice ==

= 1.4.3 =
Readme updated: guest returns and other advanced features are PRO-only; free edition covers logged-in My Account returns.

= 1.4.2 =
PRO features tab redesign and return options dropdown improvements.

= 1.4.1 =
Free edition now focuses on core returns; advanced features are listed under Settings → PRO features.
