=== Affireo - Affiliates for WooCommerce ===
Contributors: propluginslab
Tags: affiliate, referral, commission, affiliate marketing, woocommerce
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Run an affiliate program on WooCommerce: referral link tracking, commissions, a front end affiliate dashboard, and payouts.

== Description ==

Affireo turns your store into a working affiliate program. Affiliates get a referral link, you get a commission record on every sale they bring in, and both sides see the numbers in a clean dashboard.

Every feature listed here is fully functional with no time limit, quota, or license key.

**Referral tracking**

* Referral links using `?ref=yourslug`, tidy `/go/yourslug/` links, and custom vanity slugs
* Signed, tamper resistant tracking cookies with a configurable duration (30 days by default)
* Last click attribution, so the most recent affiliate gets credit
* Bot filtering, so crawlers never create fake clicks
* WP Consent API support and hashed IP storage, so you stay privacy friendly

**Commissions**

* Percentage or fixed amount commission on every referred order
* Choose what commission is calculated on: item subtotal, taxes, shipping, discounts
* Minimum order amount, plus product, category, and user role exclusions
* A grace period that holds commissions until the refund window closes, so you never pay out on an order that gets returned
* Automatic reversal on full refunds and proportional reduction on partial refunds
* Block self referrals so affiliates cannot buy through their own link
* Per affiliate rate overrides

**Affiliate management**

* Unlimited affiliates, with no cap on how many you approve
* Registration form with an application queue: approve, reject, or suspend
* A drag and drop registration form field builder
* Approve applications automatically if you prefer
* Activity log recording every status change, rate change, and payout
* A dedicated Affiliate Manager role so you can delegate without handing over admin access

**Payouts**

* Record manual and store credit payouts with sequential invoice numbers
* Minimum payout thresholds
* CSV export of everything you owe
* Affiliate payout details encrypted at rest and masked in the admin

**Affiliate dashboard**

* A front end dashboard via the `[ppl_afw_portal]` shortcode: earnings, referral links, commission history, payout history
* A registration form via the `[ppl_afw_registration]` shortcode
* Light and dark mode, responsive to 320px, keyboard accessible, and it still works with JavaScript disabled
* Fully overridable templates so your theme can restyle any part of it

**Built properly**

* WooCommerce High Performance Order Storage (HPOS) and Blocks checkout compatible
* GDPR personal data exporter and eraser
* REST API under `ppl-afw/v1`
* Translation ready

== Installation ==

1. Install and activate WooCommerce.
2. Upload the plugin to `/wp-content/plugins/`, or install it from Plugins > Add New.
3. Activate the plugin through the Plugins screen.
4. Go to Affiliates > Settings to set your commission rate and cookie duration.
5. Create a page containing `[ppl_afw_portal]` for the affiliate dashboard, and another containing `[ppl_afw_registration]` for applications.

== Frequently Asked Questions ==

= Does it work with High Performance Order Storage? =

Yes. The plugin declares HPOS compatibility and uses the WooCommerce CRUD APIs, so it works with both legacy post storage and HPOS.

= How do affiliates sign up? =

Create a page containing the `[ppl_afw_registration]` shortcode. Applications appear under Affiliates in wp-admin, where you approve or reject them. You can also enable automatic approval in the settings.

= How do affiliates get paid? =

The plugin records the payouts you make, generates a sequential invoice for each one, and exports what you owe as CSV. You send the money using your normal method.

= What happens if a referred order is refunded? =

Commissions stay locked for a grace period you control (14 days by default), so a refunded order never reaches a payout. If a refund happens after approval, a full refund reverses the commission and a partial refund reduces it proportionally.

= Is affiliate payout data safe? =

Payout details are encrypted at rest with libsodium and are only ever shown masked in the admin.

= Will uninstalling delete my data? =

No. Your affiliate data is kept unless you first enable "delete data on uninstall" in the settings.

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release.