=== Siren Affiliates - Affiliate & Partner Program Manager for WooCommerce ===
Contributors: alexstandiford
Tags: affiliate, referral, affiliate marketing, commission, partner program
Requires at least: 6.4
Tested up to: 7.0
Stable tag: 3.4.0
Requires PHP: 8.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Design and run custom affiliate programs, referral systems, and partner incentives for WooCommerce. No coding required.

== Description ==

https://youtu.be/-o61dgt6DSk

**Siren lets you design multiple, specialized incentive programs from one WordPress site** — affiliate programs, revenue shares, royalties, performance bonuses, and more, all from your WordPress dashboard.

= Why Siren? =

* **Reward what matters.** Build programs around the metrics that drive your business, not just sales.
* **Automate performance and payouts.** Siren handles commission calculations and payments.
* **Reach new partner types.** Specialized programs fit creators, agencies, influencers, and educators.

= Flexible Program Types =

Siren gives you direct control over how programs are structured, so the software fits the partnership arrangement rather than the other way around.

* **Affiliate Programs.** Track referrals through custom links, coupon codes, or landing pages. Know exactly how each partner influences purchasing decisions.
* **Revenue Shares.** Split profits with partners, co-founders, or marketplace sellers automatically.
* **Performance Bonuses.** Reward consistent success by paying bonuses based on last period's results.
* **Royalty Programs.** Pay creators based on content performance, course completions, or engagement metrics.
* **Sales Commissions.** Track and pay sales team performance with flexible commission structures.

= Partnerships That Collaborate, Not Compete =

Traditional affiliate tools credit a single partner per sale. Siren can split credit across every partner who contributed, using the attribution model you choose per program.

* **Shared Engagement Pool.** Rewards are divided evenly among all contributing partners.
* **Performance Weighted Pool.** Rewards are distributed based on relative engagement scores.
* **Top Score Wins.** The partner with the highest engagement score receives the entire reward.

= 10 Core Capabilities =

1. **Custom Program Builder.** Design incentive programs without writing code.
2. **Recipe Import.** Apply a complete program setup from a template in one click.
3. **Partner Dashboard.** Partners get their own login to track earnings and payments.
4. **Automatic Calculations.** Rewards are calculated from your program rules.
5. **Multi-Level Programs.** Tiered reward structures for long-term partner growth.
6. **Payout Manager.** Send rewards through PayPal or bank transfer.
7. **Reward Stacking.** Combine programs for layered reward arrangements.
8. **Performance Bonuses.** Pay bonuses based on last period's results.
9. **Product-Specific Programs.** Different reward rates per product or category.
10. **Coupon Attribution.** Credit partners through coupon codes, without link clicks.

= Deep Integrations =

Siren works seamlessly with the WordPress plugins you already use.

* **WooCommerce.** Automatic order tracking, product-based commissions, coupon attribution, and subscription support.
* **Easy Digital Downloads.** Affiliate and partner programs built for digital products, licenses, and recurring revenue.
* **LifterLMS.** Share course revenue with instructors, experts, and partners from inside your LMS.
* **LearnDash.** Reward instructors and partners for course sales and enrollments.
* **Gravity Forms.** Turn any form into a collaborator signup, lead capture, or lightweight checkout flow.
* **NorthCommerce.** Support modern, high-AOV offers and creator-driven launches.

== Third-Party Services ==

This plugin connects to external services operated by Novatorius, LLC in the following situations:

= Contextual Help Documentation =

When you open the help panel inside the Siren admin screens, the plugin fetches documentation articles from [sirenaffiliates.com](https://www.sirenaffiliates.com/documentation). Only the requested article slug is sent. No personal data, site data, or tracking information is transmitted. Responses are cached locally for 24 hours.

= Recipe Import (Program Templates) =

When you import a program recipe from the Siren website, the plugin fetches the recipe configuration from the Siren Beacon service at `beacon.sirenaffiliates.com`. This sends only the recipe ID. After the recipe is applied, the plugin notifies Beacon that the recipe was consumed so it cannot be reused. No personal data or site data is transmitted.

These services are governed by the [Novatorius Terms of Service](https://www.sirenaffiliates.com/terms-and-conditions) and [Privacy Policy](https://www.sirenaffiliates.com/privacy-policy).

== Bundled Libraries ==

This plugin bundles the following third-party libraries, each shipped with its license text:

* [Opis JSON Schema](https://github.com/opis/json-schema), [Opis String](https://github.com/opis/string), and [Opis URI](https://github.com/opis/uri) — Apache-2.0
* [Select2](https://github.com/select2/select2) — MIT
* [Action Scheduler](https://github.com/woocommerce/action-scheduler) — GPLv3
* PHPNomad framework packages and Novatorius libraries — first-party code by the plugin author, distributed under this plugin's GPL license

== Build and Source Code ==

The compiled React admin bundles shipped with this plugin (everything under `frontend/`) are built from the human-readable TypeScript/React source code included in this plugin package under `frontend-source/`. Every shipped bundle's source is present — entry points live in `frontend-source/src/platform/wordpress/entries/`, one per compiled bundle.

To rebuild the compiled assets from the included source:

1. `cd frontend-source`
2. `npm install`
3. `npm run build:wordpress:lite`

The compiled output is written to `frontend-source/dist/wordpress-lite/`, mirroring the bundles shipped under `frontend/`. Build configuration is included in `frontend-source/vite.config.ts`, `frontend-source/package.json`, `frontend-source/tailwind.config.ts`, and `frontend-source/postcss.config.js`.

This plugin also bundles Select2 for specific extension admin screens. The upstream Select2 source is publicly available at https://github.com/select2/select2

== Installation ==

1. Go to Plugins > Add New in your WordPress admin and search for "Siren Affiliates", or download the plugin and upload the zip file.
2. Activate the plugin through the Plugins screen.
3. Navigate to **Siren** in the admin menu to create your first program.

= Minimum Requirements =

* PHP 8.2 or higher
* WordPress 6.4 or higher

== Frequently Asked Questions ==

= How do I create an affiliate program with Siren? =

Navigate to Siren in your WordPress admin menu and click "Add Program." Choose your commission structure, set the rules for how partners earn rewards, and publish. Partners can sign up through a registration form or be added manually.

= Can I run multiple affiliate programs at the same time? =

Yes. Create as many programs as you need, each with its own commission rates, attribution rules, and eligible partners.

= Does Siren work with WooCommerce? =

Yes. Siren integrates deeply with WooCommerce, including automatic order tracking, product-based commissions, coupon attribution, and full WooCommerce Subscriptions support for recurring commissions.

= Does Siren support recurring commissions for subscriptions? =

Yes. When a WooCommerce subscription renews, Siren can trigger a new conversion and award commissions to the attributed partner. Initial payments, renewals, plan changes, and refund adjustments are all tracked.

= What is a "collaborator" in Siren? =

Siren's term for any partner who earns rewards through your programs: affiliates, content creators, agency partners, resellers, and more.

= What attribution models does Siren support? =

Siren supports shared engagement pools that split rewards evenly, performance-weighted pools that distribute proportionally to contribution, and top-score-wins where a single partner takes the full reward.

= How does Siren handle tracking performance? =

Visitor tracking records a lightweight engagement event; commission calculation and attribution run in background jobs via Action Scheduler rather than during page loads.

= Can partners track their own earnings? =

Yes. Siren includes a partner dashboard where collaborators can log in to view their earnings, track referrals, and see payment status. They do not need WordPress admin access.

= How are payouts handled? =

Siren's Payout Manager lets you send rewards directly to partners. Approved commissions are compiled into payout records that you can fulfill through PayPal, bank transfer, or other methods.

== Screenshots ==

1. Programs list
2. Program editor: rates, attribution rules, engagement types
3. Collaborators list
4. Collaborator detail with earnings breakdown
5. Conversions with engagement history
6. Transactions across all programs
7. Obligations review queue
8. Fulfillments (payout batches)
9. Fulfillment detail
10. Recipe import
11. Partner dashboard
12. Partner rewards
13. Partner performance charts
14. Partner coupons
15. Partner profile

== Changelog ==

= 3.4.0 =

**Added**

* Starter recipes: a new recipe browser lets you launch a fully-configured program in a few clicks. Pick from ready-made setups — affiliate, referral, partner, creator, and more — filtered to what works with your store, then review the details and apply.

**Fixed**

* Easy Digital Downloads 3.x: assigning a collaborator to a coupon works again.
* Ninja Forms integration labels now load from the plugin's own translations.

== Upgrade Notice ==

= 3.4.0 =
Adds a starter-recipe browser for launching pre-configured programs in a few clicks, and fixes collaborator-on-coupon assignment for Easy Digital Downloads 3.x.
