This is the changelog of the Refer a Friend for WooCommerce PREMIUM plugin. Data is updated when the new version is up.
= 4.4.10 =
* Fix: Fatal error (TypeError) on PHP 8+ when WooCommerce showed a generic coupon notice with no coupon object, e.g. submitting an empty coupon field (“Please enter a coupon code!”). The coupon-code hiding filter now bails out safely when no coupon is present.
* Fix: Replaced the deprecated WooCommerce Subscriptions “wcs_renewal_order_meta_query” filter (deprecated since Subscriptions core 2.5.0) with “wc_subscriptions_renewal_order_data” to stop deprecation notices. Referral meta is still kept off renewal orders.
= 4.4.9 =
* Fix: Fatal error on My Account → Refer a Friend when a referral order had a deleted customer account
= 4.4.8 =
* Fix: Registered users who checked out as guest (matching email but `customer_id = 0` on the order) were treated as having no orders by the “Hide referral link until first order” guard. `WPGens_RAF_User::hide_with_no_orders()` now matches orders by user ID *or* billing email, mirroring the guest AJAX path. Symptom: share page link box and outgoing share emails contained the “Place at least one order…” warning text as the referral code, producing broken `?raf=Place%20at%20least%20one%20order…` links
* Fix: WPML email locale switching extracted into static helpers on `WPGens_RAF_WPML` and now covers the WP-Cron reminder context, where WCML’s built-in email-language hooks don’t fire. Per-instance previous-language storage prevents clobbering when triggers nest
* Fix: Email header logo falls back to 250px (previous hardcoded behaviour) when WooCommerce’s “Logo width” setting is unset, instead of Woo’s 120px default — prevents existing sites seeing their email logo suddenly shrink after the 4.4.7 update
= 4.4.7 =
* Fix: RAF email header now respects WooCommerce’s “Logo width” email setting (`woocommerce_email_header_image_width`) instead of a hardcoded 250px
* Fix: “Documentation” link in the RAF admin sidebar (and the licence-page guide link) pointed to the retired Helpscout docs — repointed to wpgens.com/docs
* Dev: Disabled the on-activation guest-referral migration scan (`migrate_existing_guest_referrals`); on stores with many orders/users it could hang the activation request. Method retained for opt-in re-enablement once it’s chunked
* Fix: Block-based checkout fraud guards (email/phone/address against prior orders) didn’t run for guest customers — they only fired when the shopper was logged in. Guests could re-use a referral link repeatedly and keep getting the discount. Now reads billing data from `WC()->customer` so the same checks fire in block checkout for guests as in classic checkout. Status list also widened to include `on-hold` (BACS / bank transfer)
* Fix: Privacy regression where the “Track your invites” table on My Account → Refer a Friend showed every order on the site (other customers’ names and statuses) on stores running classic order storage (HPOS off). Caused by `meta_query` being silently dropped by WC’s CPT data store; reverted to the `meta_key`/`meta_value` form which works under both CPT and HPOS
* Fix: Guest-modal “no orders” message wrongly shown when the email belongs to a registered user but the order was placed as guest
* Feat: WPML support for all RAF email subjects/headings/contents (advocate coupon, friend coupon, reminder, share) — emails now render in the customer’s language
= 4.4.6 =
* Security Fix: Added nonce verification to the share-via-email AJAX endpoint to prevent unauthorized requests
* Security Fix: Added IP-based rate limiting (10 emails/hour by default) to prevent email abuse
* Security Fix: Added recipient limit per request (max 5 by default) to prevent bulk email sending
* Fix: Resolved PHP errors for non-logged-in users when sharing via email
* Dev: New filter `wpgens_raf_max_email_recipients` to customize max recipients per request (default: 5)
* Dev: New filter `wpgens_raf_email_rate_limit` to customize hourly email limit per IP (default: 10)
* Dev: New filter `wpgens_raf_email_rate_window` to customize rate limit window (default: HOUR_IN_SECONDS)
= 4.4.5 =
* Fix: Email header/footer now properly supports theme overrides (copy to yourtheme/wpgens-raf/emails/)
* Fix: Duplicate image rendering in reminder email template
= 4.4.4 =
* Add: Admin option to select order status that triggers referral reward generation (General Settings > Generate Referral Reward On)
* Fix: `wpgens_raf_order_status` filter now works properly when added in theme’s functions.php
= 4.4.3 =
* Add: Filter hook `wpgens_raf_advocates_order_status` to filter order statuses in advocates list and totals
= 4.4.2 =
* Fix: Load products and categories by search
= 4.4.1 =
* Fix: My Account list of referrals hotfix
= 4.4.0 =
* Feat: Support for native WooCommerce Emails editor
*Feat: Support for Klaviyo, MailChimp, OmniSend Marketing platforms to easily send generated referral codes
* Fix: Several security and bug fixes
= 4.3.3 =
* Feat: Better checkout logging system
= 4.3.2 =
* Fix: Guest Referrals bug fixed.
= 4.3.1 =
* Feat: Facebook Messenger Icon added to old UI.
* Feat: Generate referral links through ?email query in URL.
= 4.3.0 =
* Feat: Guest referrals now have referral codes instead of emails
* Change email image from admin UI
* Use Phone Number for Fraud detection
= 4.2.1 =
* Fix: Improved security for checkout blocks.
* Fix: Shipping tax for coupon amount reward
* Fix: Facebook and Twitter share button not working
* Feat: Added {{name}} for share emails
* Feat: Added variations in product listings in coupon rewards
* Feat: {{order_amount}} tag for email templates
* Feat: Preparation for email editor in admin panel – will be released soon
* Feat: new filters/action hooks for checkout
* Improvement: Ajax call to run referrals for previous customers
= 4.2.0 =
* Feature: Test your emails from admin screen.
* Security Fix: Added missing nonces.
* Feature: Improve filter for order status change.
* Support: Send referral code to Klaviyo.
* Fix: Nth coupon admin screen issue resolved.
* Fix: Reminder email cron adding only valid orders.
* Improvement: Exclude failed orders from fraud check.
= 4.1.4 =
* Fix: Email notifications missing referral links.
* Fix: Friend coupon after first order email text fixed.
= 4.1.3 =
* Fix: IP address fraud detection bug
= 4.1.2 =
* Email panel saving bug
* Preparation for email templates editing experience
= 4.1.1 =
* Admin panel saving bug
= 4.1.0 =
* Automatically email users with their referral code after their first purchase.
* Delay Modal Popup on Thank you page.
= 4.0.5 =
* Added new analytics section for admins.
* New Referral Popup on the Order Thank You page
* Translation fixed and added Italian language.
= 4.0.4 =
* Apply coupons as soon as product is added to the cart. -> This will fix all of the ajax cart plugins.
* Support for latest WooCommerce Blocks
* Code cleanup
= 4.0.3 =
* New feature: Ban referral link
* New feature: User Special Discount – Specify users to assign unique discount rates to them and their referees.
* Several UI fixes.
* PHP Error notice fixes.
* Security patch for email referrals.
= 4.0.2 =
* UI Fix for new template
* Facebook Messenger Fix
* Updated French translation
* New modern guest template update.
= 4.0.1 =
* Optional two columns layout for my account page.
= 4.0.0 =
* Completly new frontend look for better conversion rate. You can still opt in to use legacy templates.
* Several new UI elements.
* Messenger Share.
* Preparation for Email template editor.
* Updated translations.
= 3.1.0 =
* Important Security fix: Some users were able to get an advocate coupon even if they did not pass the fraud check.
* New feature: WooCommerce Subscription (Enable partial coupon usage). Allows coupons to be partially used, reducing the coupon value if it exceeds the order amount.
* Improvement: Reward tracking – display friend’s first/last name instead of a display name.
* Improvement: WooCommerce 8.3 support.
* Developer: Added new WordPress filter for coupon type.
* Bug Fix: Fatal error fix when manually adding a coupon code.
* Bug Fix: The plugin would not apply discounts to users who were eligible for it.
* Preparation for a new feature to generate coupons X days after the order was marked as completed.
= 3.0.0 =
* Completely redesigned, modern, and user-friendly administration panel.
* New feature: Detailed Referral Orders Screen.
* New feature: Check referral earnings per advocate for defined period. (Track your monthly earnings from referrals for each advocate.)
* New feature: Reward users upon signup.
* Improved: Events screen.
* Speed optimization. Removed jquery cookie script from loading on frontend, now its a single JS file.
* Added several new filters. Documentation in progress.
= 2.4.3 =
* Fix: Wrong history orders showing on account page for latest version of WooCommerce
= 2.4.2 =
* Twitter rebrand
= 2.4.1 =
* Phone number fraud check
* Refer a friend data screen – showing all orders fix
* Preparations for the next big UI update.
= 2.4.0 =
* Big Change: HPOS Support
* Order screen – optimized for speed/less queries
= 2.3.18 =
* Optimized checkout flow.
= 2.3.17 =
* Viber share
* Fix for percentage discount on automatic subscription.
= 2.3.16 =
* Fraud prevention settings panel
= 2.3.14 =
* Subscription bug fix #2
= 2.3.13 =
* Subscription bug fix.
* Disable guest coupons via coupon field fix.
* raf list table fixed to show all referral orders, not just the ones that created coupons.
* Better notice at the checkout on why coupon was removed.
* IP address check
* Share email disable button when ajax is working
* Prevent removing of the last email share input
= 2.3.12 =
* Free shipping for guest auto coupons
* Fix my account page – coupon listing
* Notify admin of fraud detection
* Fix my account coupon listing on mobiles
* Add coupon option to exclude sale items
= 2.3.11 =
* Better WPML support
* WhatsApp guest share fix
* Buyer email subject fix
* Minor coupon issue fixed
* Fix empty referrals applied on subscription renewals.
* Added button to remove email field
* Fix for number of referrals per screen
* Fix events timezone.
= 2.3.10 =
* Support for Aelia currency switcher for minimum order amount.
* Missing raf link bug fix.
= 2.3.9 =
* Security update
* Change in woo subscription, ability to disable shipping costs when applying on automatic subscription.
= 2.3.8 =
* Guests can no longer keep using same referral code to get a discount on the same email address.
= 2.3.7 =
* Exclude sales item for coupon codes
* Japanese translation
= 2.3.6 =
* Fixed issue with referrals not showing even if checkbox to hide the ones with zero order is not checked.
* Notice error removed.
= 2.3.5 =
* Added option to disable referral codes for users without orders.
* Prevent the use of false emails to get guest discounts.
= 2.3.4 =
* Fixed minimum amount required when applying coupon manually.
= 2.3.3 =
* WhatsApp share link fix.
= 2.3.2 =
* Disable sending of emails via option under emails tab.
* Urgent fix for manually added referral codes.
= 2.3.1 =
* Manually add referral code for past orders
* Updated pot file with new translatable strings
* Few bugs fixed regarding the new event system
= 2.3.0 =
* New Raf Events system.
* Added more social share options
= 2.2.5 =
* New filter for points rewards plugin and a filter to disable showing of referral code per user role.
= 2.2.4 =
* Fix send email button for guest users
= 2.2.3 =
* Fix notice for Contact Form 7 shortcode
= 2.2.1 – 2.2.2 =
* Couple of small errors fixed after 2.2 update.
= 2.2.0 =
* FEATURE: Guests referral. A user does not need to be registered user to refer anymore, guests can refer now as well.
* FEATURE: Make sure email is valid when inviting via email.
* FEATURE: Export all referrals as CSV under Woocommerce -> Refer a friend data screen.
* FEATURE: WooCommerce Points & Rewards plugin is now fully supported, you can choose how many points user will earn when he is referring a friend.
* Critical fix: User could use both referral link and referral code in some cases.
* Support for latest Contact form 7 version.
* Optimization for checkout email field
* Templates have been updated to 2.2.0., please update them.
= 2.1.1 =
* Fix for referral codes, exclude bug fix
* Added tab title filter.
* Added new classes for custom styling for referral codes vs referral links.
* Fix for referral codes applied on cart/checkout.
* Fix header notice on checkout,
* Fix issue of guest coupons when using referral codes instead of links, he was able to use code multiple times even tho he was registered user.
= 2.1.0 =
* Option to hide share via email.
* Better UX on share via email, inputs are reappearing after sending emails.
* Added a free shipping option for a coupon
* Added a new filter to enable coupon types created by other plugins
* Translation updates.
* Fall back to “Your Friend”, when user does not have first and last name and invites friends.
* Filter to easly change coupon generation to other order status than completed.
* Added action that runs after sending referral email.
* Subscription – option to spend all coupons at once.
* Added support for popup maker
* Contact Form 7 – bug fix.
* Small bug fixes
* Update to templates.
= 2.0.9 =
* Subscription renewal, fix a renewal bug.
* Click to copy is now available. Update your templates. Clear site cache.
= 2.0.8 =
* Minimum order bug fixed
* Added filter for order status
* Fixed the issue with woocommerce email look taking over headings from custom email template.
= 2.0.7 =
* Generate missing referral links tool – bug fixed.
= 2.0.6 =
* Plugin updater bug fixed.
= 2.0.5 =
* Email template fix for older outlook email clients.
* Fixed translation bug where sometimes it did not work.
= 2.0.4 =
* Couple of bug fixes, return of the depricated {{code}} tag in emails. Couple of new actions and ability to remove filters if needed.
= 2.0.0 =
* Completely rewritten from scratch for better code organizing.
* New Email Templates
* New Templates System for the whole plugin. Copy everything from templates folder to theme/wpgens-raf folder and change HTML and styling.
* New Settings Page
* Support for WooCommerce Subscription
* Ability to generate coupon codes on every nth referral.
* New referral codes as coupon codes.
* Plenty of new filters & actions added
* Added names for email invites
* Plenty of other small changes.
= 1.2.7 =
* Fixed plugin folder name, back to old one – this was mistake.
* Updated Refer a friend Data page to speed up loading time.
* Added brand new statistics under Reports.
* Added currency on my account page and better date format which is using WordPress options date format.
= 1.2.6 =
* Add {{name}} tag in share emails body and subject.
* Add order ID to coupon description.
* Coupon value as percentage of order
* Exclude products by ID
* NEW Order Box that shows all referral info.
* Added multiple security checks to prevent abuse.
* Change in a way referral is generated. Now all referals are generated but coupons are automatically generated only if it passes security features.
* Translation updated.
= 1.2.5 =
* Add ability to offer “From” email to be sender’s email. Couple of other fixes.
= 1.2.4 =
* Whatsup button fix, issue with plugin updater not working.
= 1.2.3 =
* Fatal error fix on auto applied coupon on cart, for older woo versions.
= 1.2.2 =
* Whatsup button fix.
= 1.2.1 =
* Small bug fixes after big 1.2 update.
= 1.2.0 =
* Complete change of the front end look. Added email share and rewrote part of the code.
= 1.1.2 =
* Support for older version of Woocommerce. In woocommerce -> system added new button to reset data, to be used in dev environment.
= 1.1.1 =
* Woocommerce 3.0 support. Removed coupon % product discount that woocommerce removed.
= 1.1.0 =
* Upgrade notices describe the reason a user should upgrade. No more than 300 characters.
= 1.0.0 =
* Initial version
== Upgrade Notice ==
= 2.0.0 =
2.0 is a BIG update! Check your email settings and also check new filters if you have been using them to alter RAF.