=== 23h Brand Ambassador (Affiliate, Referral) – Turn your clients into your best sales team === Contributors: 23hevents Tags: affiliate, referral, affiliate program, refer a friend, woocommerce Requires at least: 6.2 Tested up to: 7.1 Requires PHP: 8.1 Requires Plugins: woocommerce Stable tag: 1.0.3 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Turn your clients into your best sales team: every WooCommerce customer becomes a brand ambassador with a referral link and commissions. == Description == **23h Brand Ambassador is a free WooCommerce affiliate and referral program plugin.** Every customer who creates an account becomes a brand ambassador of your shop, gets a personal referral link and earns a commission when friends buy through it. Word of mouth, tracked and rewarded. Most affiliate plugins wait for bloggers and influencers to sign up. Your best promoters are already in your shop: the people who bought from you and liked it. 23h Brand Ambassador turns them into an affiliate program automatically, from the first order. = Who it is for = * Shops that want a **refer a friend** program without coupons to manage by hand. * Brands that work with **ambassadors, influencers, partners or resellers** and need tracked links and commissions. * Anyone looking for a free alternative to paid WooCommerce affiliate plugins, with **no locked features**. = How it works = 1. A customer orders and ticks "Create an account and become a brand ambassador" at checkout. 2. They get an ambassador account with a referral link, banners, texts and a printable flyer with a QR code. 3. A friend visits the shop through that link and places an order. 4. The ambassador earns a commission, and the buyer can earn one too on their own order. 5. You pay the approved commissions from Brand Ambassador > Payouts. = Features = * **Automatic affiliate accounts.** Customers who tick "Create an account" at checkout get an active brand ambassador account; guests who don't tick it get no account of any kind (GDPR friendly). The checkbox text can be changed and ticked by default. * **Referral links and tracking.** Every ambassador gets a referral link (for example `https://yourshop.com/?ref=12`, or `https://yourshop.com/ref/12/` with friendly URLs). The keyword (`ref`) and the cookie duration (7 days by default) can be changed in the settings; you choose whether the first or the last affiliate gets the credit. * **Commissions for the referrer and the buyer.** The ambassador who recommended the shop earns a commission, and the buyer can earn their own commission on their order. Set any rate, as a percentage or a fixed amount. Commissions follow the order status: pending while processing, approved when completed, rejected when refunded, cancelled or failed. * **Affiliate area.** Dashboard, referral links, creatives, commissions with totals, visits and settings, through the `[bamb_affiliate_account]` shortcode. * **Creatives and flyers.** Banners, texts and personalized flyers with a QR code to each ambassador's link, downloadable as PNG or PDF. * **Payouts.** Group approved commissions into payouts and mark them as paid. * **Extra fields.** Phone, address, "Who are you?" and up to three promotion links, visible to the shop manager. * **CSV import** of affiliates, reCAPTCHA / Turnstile / hCaptcha on the affiliate forms, WooCommerce HPOS and Cart/Checkout blocks support. = Pro version = The free plugin is complete on its own: nothing in it is locked or limited. If you need more, [23h Brand Ambassador Pro](https://23hpress.com/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=free) is a separate plugin that adds readable name.surname referral links, commissions paid as store coupons, the commission shown in WooCommerce emails, and more. == Installation == 1. Make sure WooCommerce is installed and active. 2. Install and activate the plugin from Plugins > Add New, or upload the zip from Plugins > Add New > Upload Plugin. 3. Click **Create the pages** in the notice (or in Brand Ambassador > Settings > Affiliates > Pages). The plugin creates the ambassador account, registration and reset password pages and selects them. 4. Click **Turn it on now** in the notice, so customers can create an account at checkout (this is the WooCommerce setting "Allow customers to create an account during checkout" in WooCommerce > Settings > Accounts & Privacy). 5. In Brand Ambassador > Settings, set the commission rate and the currency. == Frequently Asked Questions == = How do I create an affiliate program in WooCommerce? = Install and activate 23h Brand Ambassador, then click the two buttons in the setup notice: "Turn it on now" (customers can create an account at checkout) and "Create the pages" (the ambassador account page). From then on, every customer with an account is an affiliate with a referral link. = Can customers earn a commission for referring friends? = Yes, that is what the plugin is built for. When a friend orders through the customer's referral link, the customer earns a commission. Set the rate as a percentage or a fixed amount in Brand Ambassador > Settings > Commissions. = Can I use it for influencers or partners who are not customers? = Yes. Turn on "Allow Affiliate Registration" and they can sign up on the "Become a Brand Ambassador" page, or add them yourself in Brand Ambassador > Affiliates. You can review each application before it becomes active. = Is it really free? = Yes. Nothing in this plugin is locked, limited or time-limited. A separate Pro plugin exists for shops that need name.surname referral links, commissions paid as store coupons and commission details in WooCommerce emails, but you never need it to run a complete affiliate program. = Does a guest become an affiliate automatically? = No. Only customers who tick "Create an account" at checkout, or who already have an account, become brand ambassadors. = How are commissions paid? = Approved commissions are grouped in payouts in Brand Ambassador > Payouts; you pay the ambassadors (for example by bank transfer) and mark the payments as paid. = How long does the referral cookie last? = 7 days by default. Change it in Brand Ambassador > Settings > Affiliate Area > Referral Tracking. = Where do ambassadors see their link and their commissions? = On the Brand Ambassador Account page (the `[bamb_affiliate_account]` shortcode). Click "Create the pages" in Brand Ambassador > Settings > Affiliates to create it, then add it to your menu or to the WooCommerce My Account page. = Why was no commission recorded for my test order? = A commission needs a visit through a referral link (for example `https://yourshop.com/?ref=12`) in the same browser before the order, and the referrer cannot be the buyer. The order must be Processing or Completed. == Screenshots == 1. Dashboard with earnings, visits and the latest commissions. 2. Brand ambassadors list. 3. Commissions with their status and the order they came from. 4. Referral visits, with the source and whether they converted. 5. A payout: the total, the payments and the progress. 6. Payments to each ambassador, with an export to CSV for the bank. 7. Creatives: banners, texts and personalized flyers with a QR code. 8. One-click setup: turn on account creation at checkout and create the ambassador pages. 9. Settings: currency and uninstall options. 10. Settings: registration, automatic enrollment of customers, referral tracking and pages. 11. Settings: commission rate and the buyer's own commission. 12. Settings: minimum payout amount, refund grace period and payout methods. 13. Settings: WooCommerce integration and CAPTCHA for the registration form. 14. The ambassador's account: visits, commissions and earnings, with a chart. 15. The ambassador's referral link, link generator, banners, texts and flyer with a QR code. 16. The ambassador's commissions and payments. 17. The ambassador's referral visits. 18. The ambassador's profile and payout email. 19. The public "Become a Brand Ambassador" registration page. 20. The ambassador login page. == External services == The plugin works without any external service. Only if you turn on a CAPTCHA in Brand Ambassador > Settings > Integrations and enter your own keys, the affiliate registration and login forms use that provider: * Google reCAPTCHA - loads https://www.google.com/recaptcha/api.js on the forms and sends the visitor's CAPTCHA token and IP address to https://www.google.com/recaptcha/api/siteverify when a form is submitted. [Terms](https://policies.google.com/terms), [Privacy](https://policies.google.com/privacy). * Cloudflare Turnstile - loads https://challenges.cloudflare.com/turnstile/v0/api.js on the forms and sends the CAPTCHA token to https://challenges.cloudflare.com/turnstile/v0/siteverify when a form is submitted. [Terms](https://www.cloudflare.com/website-terms/), [Privacy](https://www.cloudflare.com/privacypolicy/). * hCaptcha - loads https://js.hcaptcha.com/1/api.js on the forms and sends the CAPTCHA token to https://hcaptcha.com/siteverify when a form is submitted. [Terms](https://www.hcaptcha.com/terms), [Privacy](https://www.hcaptcha.com/privacy). == Changelog == = 1.0.3 = * Fix: the default registration fields (Phone, Address, Who are you?, Where do you promote us?) are now in English and translatable; the "Who are you?" suggestions are generic. * Fix: the notice for customers who already have an account is translatable in every language. * Improved: the login, registration and password forms have clean default styles that follow your theme. * Readme: screenshots of the ambassador's account and of the public pages. = 1.0.2 = * New: Live Preview on WordPress.org, with WooCommerce and demo data. * New: after the first commission, a small notice asks for a review on WordPress.org. It can be dismissed for good. * Readme: description, tags and FAQ. = 1.0.1 = * New: a notice with a "Turn it on now" button when WooCommerce does not let customers create an account at checkout. * New: "Create the pages" button that creates the ambassador account, registration and reset password pages and selects them. * New: "Pro version" link on the Plugins screen and an information card in the settings. * Readme: new title and description, screenshots, FAQ. = 1.0.0 = * First release.