Changelog

1.10.1 (2026-10-28)

Improvements

For developers: withdrawals and affiliate events can now be deleted through WithdrawRepository and EventRepository with delete() and deleteById(), the same way as banners. Until now these repositories could save records but not remove them. EventRepository::get() is now declared to always return an event, because it throws an error when the event does not exist

Fixed

Fixed affiliate program conditions being skipped for bundle products, and for orders whose shopping cart had already been cleaned up. The "Affiliate Account" conditions (lifetime commission, "Is an affiliate", "Affiliate client") and the "General" conditions always matched such lines, so commission was paid on them even when the program's conditions should have excluded them. These lines are now checked against the program's conditions like any other line. For an order line, the customer is taken from the order; a line without its order is checked as a guest's
Fixed saving an affiliate transaction for an account that does not exist (deleted, or a missing or zero account ID) failing with a PHP fatal error. The save is now refused with a clear "no such entity" error
Fixed a PHP warning in the new-affiliate notification email when an affiliate account was created without a status. The email is now sent with the status left blank

1.10.0 (2026-10-26)

Features

Sale waiting period - A new "Sale waiting period (days)" setting under the commission settings (default 90) sets how long an affiliate sale waits for its order to earn commission. After that the sale is closed with no commission and the reason "not completed within N days"; it is checked again only if the order is saved later. Set it to 0 to wait forever

Improvements

Compatible with Mirasvit Core 2.0 — the module can now be installed alongside both the 1.x and 2.0 versions of the core package
Affiliate sales that can never earn commission are no longer re-checked by cron every minute. A sale whose order is canceled or closed is now closed with no commission and the reason "order canceled" or "order closed", and a sale that has already earned its commission is closed again when its order is re-saved (a later credit memo still reverses the commission as before). This removes constant background work on stores with many old orders
⚠️ Database change in mst_affiliate_event - the type column changes from text to varchar(255) and a new index on is_processed + type is added, so the cron finds unprocessed events faster. Run bin/magento setup:upgrade after updating

Fixed

Fixed affiliate email notifications and AddToAny share-button settings set on a website or store view being ignored in favour of the default value. The new-affiliate and withdrawal admin notifications (whether they are enabled, the email templates, sender and copy-to addresses), the affiliate's own emails and the AddToAny settings now use the value of the affiliate's store
Fixed sales closed without commission (canceled, closed or not completed in time) being counted as orders in affiliate group conditions. They are now left out, and a sale that earns commission later no longer keeps its old "no commission" reason
Fixed deleting a referred customer that no longer exists failing with an error in the admin. It now shows "This relation no longer exists."

1.9.2 (2026-10-22)

Fixed

Fixed the affiliate's statistics charts in the customer account showing a label one day off - for example, "Dec 31" for January 1 - in stores whose timezone is behind UTC (such as Los Angeles) at certain times of day. Each label now shows its own day in the store timezone
Fixed statistics charts grouped by week labelling each week with the following Sunday in some years, such as 2023 and early January 2024. Each weekly bar is now labelled with the Sunday its own week starts on
Fixed setup:upgrade aborting with an error during the payment method settings migration on stores where the old affiliate payment method setting was saved in more than one scope (for example, default and a website). Every scope is now migrated into its own setting, and a scope that was already migrated is left as it is
Fixed the embeddable affiliate widget failing with a server error on the affiliate's website when it had nothing to display (on PHP 8). An empty widget is now returned as empty
Fixed the "Is an affiliate" and "Affiliate client" program conditions set to "No": they never matched, so a shopper who is not an affiliate or not referred by one did not get the program. "No" now matches such shoppers, and when the account check fails because of an error the shopper matches neither "Yes" nor "No" instead of being treated as "No"
Fixed affiliate coupon code patterns that start with a character set or a length, such as A-Z4 or 3, being rejected as invalid
Fixed coupon code patterns with an empty character set, such as ``, 3 or A, causing an error during coupon generation - they are now rejected as invalid. A pattern starting with a length followed by more text, such as 3A-Z, is now rejected too, instead of silently producing a shorter code than expected
Fixed the admin edit page of an affiliate account failing with "Unable to unserialize value" when the account's website, migrated from an earlier version, contained a quote or a backslash. The website is now stored correctly during the upgrade, and ordinary websites are stored exactly as before

1.9.1 (2026-10-20)

Fixed

Fixed the affiliate share buttons (AddToAny) producing a broken link for a page whose URL has a query string, such as product.html?color=red: the referral parameter was glued on with a second ? and the query ended up inside the page path, so the visitor was not credited to the affiliate. The shared link now keeps the page's query string intact and adds the referral parameter to it with &
Fixed the banner image link that affiliates place on their websites when the banner's image file is missing: it failed with a server error, and on remote media storage (such as Amazon S3) it returned an empty, broken image. It now returns a transparent pixel, so the affiliate's page shows no broken image
Fixed statistics charts grouped by month showing each month's data under the following month - for example, January's sales and clicks appeared under February
Fixed the affiliate account form breaking when an additional account field (Additional Account Fields) had been saved without the "Required" setting

1.9.0 (2026-10-16)

Features

Hyvä support now ships with the extension - The companion package mirasvit/module-affiliate-hyva is gone: the affiliate account pages, referral tracking, the programs and sign-in widgets, the product share buttons and the embeddable product widget are now part of Affiliate itself. There is no second package to find and keep in step, and on a Luma store the Hyvä part simply stays dormant. Composer removes the companion package by itself when you upgrade. On Hyvä the account pages keep the look they had with the companion package, and on Luma and Breeze the look they had before.

Improvements

⚠️ Hyva_MirasvitAffiliate is gone, not renamed - You only need to act if you referenced it yourself: in a custom di.xml, a layout file, or a deployment script that enables modules by name.
⚠️ If you overrode a Hyvä template in your theme, repoint it - Hyva_MirasvitAffiliate::path.phtml is now Mirasvit_Affiliate::path.phtml. An override at the old path is simply not read, with no error to say so.
The statistics date range now uses the browser's own date fields on every theme. Links with a date range saved before the update keep working.
After upgrading a Hyvä store, run bin/magento hyva:config:generate and rebuild your theme's Tailwind CSS.
⚠️ Admin actions that change data now accept POST requests only - saving accounts, programs, groups, banners, transactions and withdrawals, deleting accounts, programs, groups, banners and referred customers, inline edits, banner uploads, saving the "Additional Account Fields" page and "Register as Affiliate" on the customer page. The admin screens already send them this way. You only need to act if a custom script or bookmark opened one of these URLs directly.
⚠️ The group refresh command is now bin/magento mirasvit:affiliate:group:refresh - the old name mirasvit:affiliate:refresh-group still works for this release. Update cron jobs and deployment scripts that call it.
⚠️ For developers: the per-form GenericButton, SaveButton and SaveAndContinueButton classes under Ui/*/Form/Control are gone - the forms now share Ui\Form\Control\AbstractButton and SaveSplitButton. Code that extended the old classes has to move to the shared ones.
⚠️ For developers: Service\CouponGenerateService is gone - CouponService generates the affiliate coupon codes itself. Code that called the old class has to use CouponService::ensureCoupon().
For developers: Api\Data\TierInterface and GroupRepository::getDefaultGroup() are deprecated in favour of Model\Tier and GroupRepository::getByIsDefault(). They keep working. The constructors of AnalyticsService and CouponService changed, which matters only to a subclass that passes their arguments by position.
Admin forms have one split "Save" button: the button saves and keeps the form open, its menu holds "Save & Close". It replaces the separate "Save" and "Save and continue edit" buttons.
Clicking a row in the accounts, programs, groups, banners, transactions and withdrawals grids opens the record. The grids can also show the form fields they used to leave out, such as store views and payment method, through the "Columns" menu.
Admin page titles, buttons, menu entries and messages use consistent wording and capitalisation.

Fixed

Hyvä: the programs widget showed only the public programs on cached pages - the affiliate's own programs never loaded there. Luma was unaffected.
Hyvä: the programs widget opened with no program shown unless the first program happened to have ID 1. Luma was unaffected.
Hyvä: a statistics range started at the current time of day instead of the start of the "From" day, so that day's earlier events were left out. Luma was unaffected.
Hyvä: a withdrawal amount with cents (such as 10.50) was rejected by the amount field. Luma was unaffected.
Hyvä: a referred customer's tracking cookies were not re-aligned to the date they were linked to the affiliate, as they are on Luma.
The referral product widget showed no products in "Bestsellers" mode in a store view without orders of its own, such as a second store view for another theme. It now counts the sales of the whole website.
Breeze: the referral product widget failed to load with a server error. It now shows its products as on Luma.
Luma: an empty box showed in the withdrawal amount field in place of an icon that was never loaded.
A referral visit kept only part of a referring URL with a query string - everything after its first & was lost.
An existing transaction opened under the title "Add transaction" in the admin. It now says "View Transaction".
Opening or saving an admin record that had been deleted in the meantime ended in an error page instead of the "This ... no longer exists." message.
The status column of the withdrawals grid was labelled "Type".
The programs widget failed to render when a commission tier or an affiliate pointed at a deleted affiliate group. Such a tier is now skipped and the missing group is written to the log.

1.8.24 (2026-10-14)

Improvements

⚠️ The affiliate event processing job (affiliate_handle_events), which turns sales, clicks and leads into commissions every minute, now runs in its own cron group mst_affiliate as a separate process. On stores with many old unfinished sales a single run can take minutes, and in the "default" group it used to hold up the other default cron jobs until they were missed. If your server starts cron per group (bin/magento cron:run --group=...), add the mst_affiliate group, otherwise commissions will stop being calculated
Affiliate banner images are now stored and read through Magento's standard media storage, so image banners also work when the store keeps its media on remote storage (such as Amazon S3)

Fixed

Fixed the affiliate account edit page in the admin failing with a fatal error on Adobe Commerce (the Commerce price permissions module crashed on the unnamed coupon hint block of the form)
Fixed the affiliate share button not appearing on the product page on Magento 2.3.x - its template failed to render there
Fixed opening an image banner for editing in the admin failing with a "Cannot gather stats!" error, and the banner image link that affiliates place on their websites failing to deliver the image when the media path could not be resolved

1.8.23 (2026-09-29)

Fixed

Fixed the customer grid in the "Add customers" popup on the admin affiliate account form forgetting its settings. Column visibility and other grid changes you made there were lost every time the popup was reopened or the page reloaded; they are now remembered for your admin user, like in other admin grids

1.8.22 (2026-09-25)

Improvements

Paying out a withdrawal to Store Credit now stops with the clear "Store Credit extension not found" message whenever the Store Credit balance cannot be loaded, instead of failing with a generic error - the payment is not completed and the affiliate's withdrawal stays open, so it can be retried once Store Credit is available

1.8.21 (2026-09-23)

Fixed

Fixed the affiliate Programs widget on full-page-cached pages (CMS, category and other pages where you place it). The page cache shares one copy of a page between all visitors of the same store, customer group and currency - not per affiliate - so the widget there always showed only the public program list and never the programs assigned to the logged-in affiliate; rendering the affiliate's own list into that shared copy would have exposed one affiliate's hidden programs to others. The widget now puts the public program list into the cached page (so it still works without JavaScript and is visible to search engines) and then loads the current affiliate's own programs separately for each visitor, never cached. On pages that are not cached anyway, such as the affiliate's account welcome page, the list is still rendered directly as before. If the theme cannot find the widget template, the widget now shows an empty block instead of breaking the page
Fixed inline editing in the admin affiliate accounts grid (which changes affiliate coupon codes) being available to any admin user regardless of their role. It now requires the same "Accounts" permission (under Affiliate in the admin role resources) as the rest of the account pages, so admin roles without it can no longer change coupon codes from the grid

1.8.20 (2026-09-21)

Fixed

Fixed the affiliate account page offering a "Payment method" list with nothing in it when every withdrawal payment method is disabled in the extension settings. The field was marked as required but let the form be saved anyway, which stored an empty payment method and only came to light later, when the affiliate's withdrawal failed. The field is now hidden while no method is available, and an affiliate who already has one saved keeps it - the list still includes their own method, so nothing is wiped
Fixed the commission breakdown of a transaction whose stored calculation data is damaged. Opening it used to fail with a generic admin error, or - when the damaged value happened to be readable as a single number - show a made-up commission line that nobody calculated. You now get a clear message naming the transaction, so the affected record can be found instead of guessing which one broke the page. The transactions grid itself was never affected by such a row and lists them as before

1.8.19 (2026-09-15)

Features

Old affiliate records are converted to the current storage format during the upgrade - stores that have been running the extension since before the switch to JSON storage still carry rows saved in the old PHP-serialized format. setup:upgrade now rewrites them in place, in small batches, so nothing depends on the legacy read path any more. The conversion is safe to re-run and refuses to touch a row it cannot convert exactly: every rewritten value is read back and compared against the original before it is saved, and anything that is skipped (a damaged payload, text with broken characters) is left byte-for-byte as it was and reported in the system log with its row id, instead of being silently dropped or aborting the upgrade halfway

Improvements

Commission messages and their calculation breakdown are now written in the language of the store view the event came from. These texts are stored as-is when the affiliate cron processes an event, and the cron used to translate them in the language of the default store view - so on a multi-store shop an order placed in one language ended up with a commission record in another. Every store view now gets its own language, including when the cron is run from the command line, where the messages used to come out in English whatever the store language was
The "Click", "Lead" and "Impression" commission messages are now translatable - they used to be written from the internal event name, so they always appeared in English no matter the store language
Cleaned up stray spacing in the customer-facing labels ("Copy and paste this code into your website:", "Program commission:", "Total Commission:") and removed an empty label above the "Add customers" button on the affiliate account form in the admin

Fixed

Fixed affiliate amounts showing the currency code twice, as in "US$35.60 USD". The amount is now formatted once, the way the store's locale writes the base currency - with the plain symbol when it is the locale's own currency, and with its country prefix or code when it is not - so the currency is still unambiguous but no longer repeated
Fixed the commission rates on the affiliate Programs page being labelled with the store view's display currency. Program tiers ("per sale", "per lead", "per 1000 views", "per unique click") are stored in your base currency, and an affiliate browsing in a secondary currency saw the base number next to the wrong symbol. All of them now show the base currency, and the small-amount rates used by pay-per-impression programs keep the extra decimal places they need
Fixed the order total quoted in a commission message ("Commission for order 100000123 (...)") being labelled with the display currency of the store view instead of the base currency it is taken from

1.8.18 (2026-09-02)

Improvements

The "Minimum withdrawal amount is ..." notice now shows the amount as a formatted price with its currency instead of a bare number

Fixed

Fixed affiliate amounts being displayed in the wrong currency. Balances, commission transactions, withdrawal figures, the statistics chart, the affiliate grid and form in the admin, and the affiliate notification emails all report amounts that are stored in your base currency - but they used to be labelled with whatever currency the store view was displaying, so an affiliate browsing in a secondary currency saw the base figure next to the wrong symbol. Every affiliate amount is now formatted in the base currency with the currency code shown alongside it, so the number and its currency always match
Fixed withdrawal requests being run through the current exchange rate. The amount an affiliate enters is now taken as an amount in the base currency, the same currency the withdrawal form shows - previously it was treated as an amount in the store view's display currency and converted, so a request placed from a store view with a secondary currency claimed a different sum than the affiliate typed, and the minimum-amount check was made against that converted figure

1.8.17 (2026-08-31)

Improvements

Made the parsing of an affiliate account's program list tolerant of a "0" value, so a program list is never silently emptied by a stray separator

Fixed

Fixed admin-created withdrawals being able to over-commit an affiliate's balance. When you add a withdrawal for an affiliate in the admin, the amount is now checked against the funds actually available - the balance minus everything already claimed by the affiliate's open (Pending or Accepted) requests, including their fees - instead of the raw balance, so the account can no longer be driven negative once finance completes those requests. The "Available funds" figure on the form now reports the same number the save check uses, and when you edit an existing open request its own amount is no longer counted against itself, so you can still raise it up to the balance
Fixed deleting a customer leaving broken references in affiliate data. Referral records, commission transactions and the affiliate-to-customer relation now simply lose the link to the deleted customer instead of pointing at an account that no longer exists - deleted customers stop appearing in the referred-customers listing, while the affiliate's commission history and balance stay intact

1.8.16 (2026-08-25)

Fixed

The affiliate social share buttons now display correctly on stores that use a strict security policy.

1.8.15 (2026-07-29)

Fixed

Fixed the affiliate Sign In / Apply widget being hidden from every logged-in customer, which left a customer without an affiliate account on the welcome page with no way to apply. The button now shows to guests and to logged-in customers who are not affiliates yet, and disappears once the customer has an affiliate account of any status
Fixed the "Affiliate" link in the customer account menu appearing for affiliates whose application is still awaiting approval. When approval is required, the link now shows only after the account has been approved

1.8.14 (2026-07-27)

Fixed

Fixed access to "Dashboard" and "Promotions"

1.8.13 (2026-07-13)

Fixed

Improved messages displayed during fund withdrawal

1.8.12 (2026-07-13)

Fixed

Fixed a misleading message on the affiliate withdrawal form. An affiliate who already had a pending withdrawal request and asked for an amount above their available balance saw "Withdraw cannot exceed current balance." instead of "You already have a pending withdrawal request." - so they now see the real reason their request was blocked regardless of the amount entered

1.8.11 (2026-07-09)

Fixed

Fixed affiliates being able to withdraw more than their real balance by submitting several withdrawal requests at once. The amount available for a new request now subtracts any pending or accepted requests that haven't been paid out yet, so an affiliate can no longer stack open requests that together exceed their balance and push the account negative once finance completes them

1.8.10 (2026-06-23)

Fixed

Fixed a possible error when opening a transaction's commission breakdown in the admin if its stored details were not in the expected format

1.8.9 (2026-06-08)

Fixed

Translate affiliate transaction messages

1.8.8 (2026-06-08)

Fixed

Fixed the store-wide REST API schema endpoint (/rest/all/schema) returning HTTP 500, which disabled Swagger UI and any OpenAPI tooling - an affiliate account API method declared an unmappable array type
Fixed REST API validation for affiliate account creation, coupons, withdrawals, and transactions

1.8.7 (2026-05-18)

Fixed

Fixed a deprecation warning shown on the affiliate withdrawal form in the admin on PHP 8.1+

1.8.6 (2026-05-04)

Improvements

Localized the extension into 15 core locales (Arabic, Czech, German, Spanish, French, Italian, Japanese, Dutch, Polish, Brazilian Portuguese, European Portuguese, Swedish, Turkish, Ukrainian, Simplified Chinese)

1.8.5 (2026-04-29)

Fixed

Affiliate banners and the referral widget can now be embedded on external sites - added the necessary cross-origin headers

1.8.4 (2026-04-14)

Features

Rich text program descriptions - the program description field in the admin now uses a WYSIWYG editor, so you can add formatted text, links, and images. Rich content is rendered on the storefront (affiliate account, coupon page, and programs widget)

1.8.3 (2026-03-31)

Fixed

Very small commission amounts (less than $0.01, common in click-based programs) now display correctly with enough decimal places instead of showing $0.00 - affects the Transactions grid, Events grid, and the affiliate account page

1.8.2 (2026-03-27)

Fixed

Fix banner code generation

1.8.1 (2026-03-27)

Fixed

Program sorting
The number of digits after the decimal point for the click program

1.8.0 (2026-03-11)

Features

REST API - full CRUD endpoints for all major entities (accounts, banners, coupons, groups, programs, transactions, withdrawals, referred customers) via Magento REST API

1.7.23 (2026-03-05)

Improvements

Configurable email notifications - send New Affiliate and New Withdrawal admin notifications to any email address, with separate enable/disable toggles, template selection, sender identity, and CC recipients for each notification type

1.7.22 (2026-02-27)

Fixed

Fixed group condition evaluation when using time-period-based rules

1.7.21 (2026-02-20)

Features

Time-based group conditions - evaluate group rules within a specific period (Current Week, Month, Quarter, or Year), enabling automatic group assignment based on affiliate performance over time

1.7.20 (2026-02-06)

Fixed

Fixed commission being incorrectly applied when an affiliate used their own referral code to make a purchase

1.7.19 (2026-01-27)

Fixed

Fixed affiliate account statistics showing only current store data instead of global data across all stores

1.7.18 (2025-12-05)

Fixed

Fixed referral link not recognizing removed customer relations, causing stale referrals to still track
Fixed affiliate conditions (lifetime commission, affiliate client) not checking whether the customer relation was removed

1.7.17 (2025-12-03)

Fixed

Fixed statistics page showing incorrect click counts (was counting sales instead of clicks)
Fixed statistics counts and commission amounts being wrong when zero-commission events were filtered out
⚠️ Replaced deprecated Zend_Db_Expr with Magento\Framework\DB\Sql\Expression in statistics and analytics services

1.7.16 (2025-11-25)

Fixed

Fixed referral link URL being generated incorrectly (produced true/false instead of the actual referral parameter)

1.7.15 (2025-11-21)

Fixed

Fixed HTML escaping issue in the transactions list on the affiliate account page

1.7.14 (2025-11-20)

Fixed

Fixed over-escaping in the affiliate transactions template introduced in 1.7.13

1.7.13 (2025-11-18)

Improvements

Balance and Hold columns - affiliate account form in admin now displays current balance and on-hold amounts with proper currency formatting
Reorganized affiliate account form fields into the Additional Info category for better clarity

Fixed

Fixed Content Security Policy (CSP) violations on pages with inline affiliate scripts
Fixed unescaped output across multiple frontend templates (transactions, programs, promotions, widget, dashboard)
Fixed border appearing around date fields on the statistics page

1.7.12 (2025-11-07)

Improvements

⚠️ Referred customer removal is now a soft delete (is_removed column added to mst_affiliate_account_customer table) - previously deleted relations are now preserved and marked as removed

Fixed

Fixed account statistics not loading when viewing data for all stores
Consolidated Magento 2.4.5-specific JS files (click245.js, widget245.js) into the main JS files

1.7.11 (2025-11-03)

Fixed

Fixed account statistics not working when "All Stores" view was selected

1.7.10 (2025-10-27)

Fixed

Fixed data loss of additional account fields - checkbox and radio inputs had duplicate IDs causing incorrect form submissions
Fixed crash on account edit page when no payment method was selected

1.7.8 (2025-10-24)

Features

Affiliate rules for program conditions - two new conditions: "Is an affiliate" (checks if the ordering customer is an approved affiliate) and "Affiliate client" (checks if the customer is a referred client of an affiliate)

1.7.7 (2025-09-24)

Fixed

Fixed inability to remove all referred customers from an affiliate account at once

1.7.6 (2025-09-23)

Fixed

Fixed new affiliate registration redirecting unauthenticated users incorrectly instead of sending them to the login page

1.7.5 (2025-09-17)

Features

Export to CSV - export affiliate data (name, total earnings, on hold, clicks) from the admin dashboard

1.7.4 (2025-08-29)

Fixed

Fixed RequireJS mixin conflicts that could cause errors on other pages - replaced mixin with a standalone UI component for the withdrawal form

1.7.3 (2025-08-26)

Improvements

Withdrawal balance verification - the withdrawal form now shows available funds and validates that the requested amount (including fee) does not exceed the affiliate's balance

Fixed

Fixed incorrect default store view assignment for CMS blocks during installation

1.7.2 (2025-07-29)

Improvements

Swissup Breeze theme compatibility - added Breeze-specific layout files, JS components, and CSS styles

1.7.1 (2025-06-20)

Improvements

Remote storage compatibility - media file operations now work with remote storage backends (e.g., S3)
Added links to user manual in the admin menu

1.7.0 (2025-06-04)

Improvements

WCAG 2.2 AA compliance - added aria labels, required attributes, proper fieldset legends, unique IDs, and label associations across all frontend forms and pages

Fixed

Fixed AddToAny share buttons not displaying correctly on the product page

1.6.2 (2025-05-23)

Features

AddToAny share buttons - affiliates can share referral links via social media directly from product pages

Fixed

Fixed incorrect layout on the affiliate dashboard page
Fixed error "Call to a member function setBalance() on null" when saving transactions

1.6.1 (2025-05-15)

Fixed

Fixed "Missed phrase" error on affiliate account pages caused by incorrect translation function usage

1.6.0 (2025-05-06)

Improvements

⚠️ Hyva compatibility is now built-in - the separate hyva-themes/magento2-mirasvit-affiliate compatibility module is no longer needed and should be removed

1.5.10 (2025-04-15)

Fixed

Fixed compatibility with PHP 8.4 (updated return type declarations across interfaces and models)

1.5.9 (2025-04-07)

Improvements

Added pagination to the withdrawal list on the affiliate account page

Fixed

Fixed commission not being created for second and subsequent orders from a referred customer

1.5.8 (2025-03-12)

Improvements

Non-affiliate customers who are logged in are now automatically redirected to the affiliate signup page when they try to access affiliate pages
Reorganized and improved all admin configuration field descriptions and groupings for better clarity

1.5.7 (2025-01-22)

Fixed

Fixed slow page load on the Referral Widget caused by an unoptimized bestseller query

1.5.6 (2024-12-04)

Improvements

Commission limit messages are now configurable per program - when the transaction limit is reached, a custom message explains why no commission was earned

1.5.5 (2024-11-15)

Fixed

Fixed customer-affiliate relation not being established when a customer registers through the affiliate flow
Fixed error when registering a customer in the affiliate program from the admin panel

1.5.4 (2024-08-06)

Fixed

Fixed unexpected logout when navigating between affiliate pages

1.5.3 (2024-07-12)

Fixed

Fixed filter by type not working in the withdrawal grid

1.5.2 (2024-06-17)

Fixed

Fixed admin role permissions not being enforced for Account Additional Fields settings

1.5.1 (2024-06-17)

Fixed

Fixed blank affiliate pages when the AdGuard browser extension is installed

1.5.0 (2024-06-11)

Features

Account additional fields - configure custom fields (text, textarea, select, multiselect, file, image) for affiliate registration and account editing, managed from a new admin configuration page

1.4.37 (2024-05-27)

Fixed

Fixed bestsellers not displaying in the referral widget - improved product collection query and added new widget configuration options

1.4.36 (2024-05-20)

Fixed

Fixed error when saving configuration on Magento 2.4.1 and earlier

1.4.35 (2024-05-09)

Improvements

Added support for Mirasvit GDPR extension v1.4

1.4.34 (2024-04-24)

Features

Custom withdrawal payment methods - define custom payment methods for affiliate withdrawals from admin configuration, with configurable fields per method

1.4.33 (2024-03-05)

Fixed

Fixed error page when requesting a non-existent banner URL

1.4.32 (2024-02-26)

Fixed

Fixed empty transaction description in commission records
Added HTML tag validation to all admin forms to prevent markup in text fields

1.4.31 (2024-02-01)

Fixed

Fixed impression statistics not being recorded correctly

1.4.30 (2024-01-18)

Fixed

Fixed commission calculation producing incorrect results in multistore setups

1.4.29 (2023-12-08)

Fixed

Fixed chart not displaying correctly when viewing statistics for all sites
Fixed calendar date picker not working on the statistics page

1.4.28 (2023-11-09)

Fixed

Fixed filtering transactions by status not working in the admin transaction grid

1.4.27 (2023-11-07)

Features

All-sites statistics - view aggregate affiliate performance data across all store views from the statistics page

1.4.26 (2023-10-09)

Fixed

Fixed error on the program editing page when coupons are used and "Use Auto Generation" is disabled in Cart Price Rules
Fixed compatibility with Magento 2.4.6

1.4.25 (2023-09-28)

Fixed

Fixed commission being charged multiple times when email notification sending fails

1.4.24 (2023-09-18)

Features

Commission explanation - view a detailed breakdown of how each commission was calculated via a new modal on the transaction page

Improvements

Added export button for the Referred Customers list in admin

Fixed

Fixed commission calculation failing when "Subtract commission when order has obtained status" setting is empty
Fixed missing block name error when editing Group or Program on Magento Commerce (EE)
⚠️ Renamed program type classes: SaleProgram → Sale, ClickProgram → Click, LeadProgram → Lead, ImpressionProgram → Impression. Added new explain column to the transaction DB table.

1.4.23 (2023-08-03)

Fixed

Fixed status variable not being available in email templates for new affiliate notifications

1.4.22 (2023-08-02)

Improvements

Added total commission amount per customer in the referred customers list
Made the "Referring Website" field optional during affiliate registration

Fixed

Fixed email templates not working with Magento 2.4.4 and later (changed template variable format)
Fixed incorrect visitor IP address detection

1.4.21 (2023-06-20)

Fixed

Fixed commission not being calculated for guest orders when the program has a Customer Group condition

1.4.20 (2023-06-15)

Fixed

Fixed programs with an activity period not being applied correctly when the period was active

1.4.19 (2023-05-12)

Fixed

Fixed "Is Processed" column always showing the same value in the event grid on the account edit page
Fixed inability to remove an affiliate from a group
Fixed click tracking not registering clicks in certain cases

1.4.18 (2023-03-30)

Improvements

Added loading indicator on the Promotion Materials page while the widget preview loads

1.4.17 (2023-03-27)

Fixed

Removed non-functional "Add New" button from the Referred Customers listing

1.4.16 (2023-03-15)

Fixed

Fixed PHP 8.2 compatibility issue with data patch

1.4.15 (2023-03-13)

Fixed

Fixed date filters not working in admin grids for referred customers, transactions, and withdrawals

1.4.14 (2023-03-02)

Fixed

Fixed widget configurator not loading on the Promotion Materials page

1.4.13 (2023-02-16)

Improvements

Added support for Magento 2.4.6

Fixed

Fixed base currency not displaying correctly in admin grids on Magento 2.4.6
Fixed currency shown in the statistics chart not matching the store's base currency
Fixed withdrawal form showing incorrect currency

1.4.12 (2023-02-13)

Improvements

Added option to hide events with zero commission on the affiliate Statistics page

1.4.11 (2023-01-30)

Improvements

Old orders placed before the affiliate module was installed no longer generate retroactive commission transactions

1.4.10 (2023-01-17)

Improvements

Improved statistics page behavior when using calendar date range buttons (Today, Week, Month, etc.)

1.4.9 (2023-01-06)

Fixed

Fixed TypeError crash on the Promotion Materials page when coupon data is missing

1.4.8 (2022-12-29)

Fixed

Fixed error "Return type of ReverseRegex\Generator\Node::offsetExists($key)" during coupon generation - replaced external library with a built-in coupon code generator

1.4.7 (2022-11-14)

Fixed

Fixed category selection being lost when editing Program Conditions

1.4.6 (2022-10-27)

Features

Commission-based affiliate conditions - new rules to apply conditions based on whether an order already has a commission from another program

1.4.5 (2022-10-14)

Fixed

Fixed error when an order contains items whose products have been deleted from the catalog

1.4.4 (2022-08-15)

Improvements

Compatibility with Magento 2.4.5

Fixed

Fixed referrer tracking being lost intermittently during navigation

1.4.3 (2022-06-29)

Fixed

Fixed commission calculation producing incorrect amounts for the Fixed Amount commission type

1.4.2 (2022-06-22)

Fixed

Fixed error when removing a Referred Customer from the account edit page in admin

1.4.1 (2022-06-20)

Improvements

⚠️ Removed db_schema_whitelist.json - no longer needed after migration to declarative schema

1.4.0 (2022-06-07)

Improvements

⚠️ Migrated database schema to Magento declarative schema (db_schema.xml). Removed all legacy InstallSchema, UpgradeSchema, and UpgradeData scripts; replaced with data patches.

1.3.40 (2022-05-03)

Fixed

Fixed sorting not working in the Accounts admin grid
Fixed commission lifetime cookie not being set correctly

1.3.39 (2022-04-19)

Fixed

Fixed commission lifetime cookie expiration not being applied properly

1.3.38 (2022-04-15)

Fixed

Fixed email template variables not rendering correctly in notification emails

1.3.37 (2022-04-13)

Fixed

Fixed email subscription toggle not saving on the affiliate account form

1.3.36 (2022-04-04)

Fixed

Fixed Affiliate Tab link not appearing in the customer account navigation

1.3.35 (2022-03-24)

1.3.34 (2022-01-26)

Features

Scheduled withdrawal requests - automatically create withdrawal requests on a configurable schedule (daily, weekly, monthly) with rounding options

Fixed

Fixed compatibility with Magento 2.4.4
Fixed error in the admin panel when viewing a transaction for a deleted order

1.3.33 (2022-01-14)

Fixed

Fixed error when processing orders that have no associated quote (e.g., orders created via admin or API)

1.3.32 (2022-01-06)

Fixed

Fixed incorrect commission calculation for the Sale program type

1.3.31 (2021-12-24)

Fixed

Fixed wrong affiliate being credited when a customer uses a coupon code belonging to a different affiliate
Fixed slow loading on the program edit page when there are many Cart Price Rules

1.3.30 (2021-10-25)

Fixed

Fixed orphaned commission entries remaining after an affiliate program is deleted

1.3.29 (2021-10-13)

Fixed

Fixed statistics chart crashing when there are gaps (empty periods) in the data

1.3.28 (2021-09-29)

Fixed

Fixed affiliate blocks not rendering on the frontend for newly created accounts

1.3.27 (2021-09-22)

Improvements

Removed third-party scripts from the referral widget - widget now loads without external dependencies

Fixed

Fixed affiliate welcome block not displaying for new visitors
Fixed affiliate group being reset to default when editing an account

1.3.26 (2021-09-03)

Fixed

Fixed TypeError crash on the Promotion Materials page

1.3.25 (2021-08-27)

Features

Statistics charts - visual charts (powered by Chart.js) on the affiliate account statistics page showing performance over time

Improvements

Added event list to the account statistics page
Added pagination to the transaction list on the affiliate account page

1.3.24 (2021-08-11)

Features

Send To Store Credit - transfer affiliate balance to Magento Store Credit directly from the withdrawal management page

1.3.23 (2021-08-09)

Improvements

Added "Active" status column to the programs listing in admin
Added informational message when the Store Credit extension is not installed

1.3.22 (2021-08-06)

Features

Lifetime commission condition - set conditions in sales programs based on the affiliate's total lifetime commission (e.g., increase commission rate after reaching a threshold)

1.3.21 (2021-07-30)

Fixed

Fixed zero-amount transactions being created when no commission should be earned

1.3.20 (2021-07-29)

Fixed

Fixed empty transactions being created for orders that don't match any active affiliate program

1.3.19 (2021-07-27)

Features

Multi-program support - multiple affiliate programs can now apply to the same order, each calculating its own commission independently. Programs with "Stop Processing" enabled will prevent lower-priority programs from applying.

1.3.18 (2021-07-20)

Fixed

Fixed program conditions not evaluating correctly for bundle products

1.3.17 (2021-06-17)

Fixed

Fixed affiliate account not being found when a customer uses a coupon code for referral tracking

1.3.16 (2021-06-17)

Fixed

Fixed guest customer events not being registered for lead tracking programs

1.3.15 (2021-06-17)

Fixed

Fixed commission calculation not accounting for tax when tax-inclusive pricing is enabled

1.3.14 (2021-06-14)

Features

Referred Customers admin page - manage and view all referred customers with a dedicated admin listing
Added configuration option to hide the referred customers list on the affiliate's frontend account page

Fixed

Fixed commission priority not being applied correctly when multiple programs match
Fixed hold functionality not working for pending transactions

1.3.13 (2021-06-03)

Fixed

Fixed sales not being tracked when the customer session is empty (e.g., during async order processing)

1.3.12 (2021-05-25)

Fixed

Fixed impression events not being registered for banner views

1.3.11 (2021-05-21)

Fixed

Fixed affiliate tracking cookie not being set properly in certain browser configurations

1.3.10 (2021-05-20)

Improvements

Added translation files for 40+ locales as starting templates for customization

1.3.9 (2021-05-19)

Fixed

Fixed error occurring after a customer removes a coupon code from their cart

1.3.8 (2021-05-12)

Fixed

Fixed commission being calculated on the full order when only some products match the program conditions - now only matching items are included
Fixed notification emails being sent for zero-commission transactions
Fixed transactions list not displaying on the affiliate account page

1.3.7 (2021-04-02)

Fixed

Fixed admin notification emails not being sent for new affiliate registrations and withdrawal requests

1.3.6 (2021-03-30)

Fixed

Fixed data migration error during upgrade

1.3.5 (2021-03-29)

Fixed

Fixed commission being calculated using order currency instead of base currency when they differ

1.3.4 (2021-03-23)

Fixed

Fixed withdrawal payment methods not displaying on the affiliate account page

1.3.3 (2021-03-23)

Fixed

Fixed error when registering a new lead event
Fixed error on the affiliate account page when transaction data contains null values

1.3.2 (2021-03-22)

Improvements

The account statistics page now shows unique clicks instead of total clicks for more accurate performance tracking

1.3.1 (2021-03-19)

Fixed

Fixed transactions only showing for the current store instead of all stores
Fixed notification email sender name not being set correctly

1.3.0 (2021-03-17)

Features

Affiliate Groups - organize affiliates into groups with automatic assignment rules based on affiliate performance conditions. Includes full admin CRUD, group-based rules engine, and a cron job to automatically reassign affiliates to groups based on their activity.
Tier system - define commission tiers for programs
Transaction export - export transaction data from admin
Programs page - affiliates can view available programs from their account dashboard

Improvements

⚠️ Requires Magento 2.3 or higher (versions below 1.3.0 support Magento 2.1-2.2)
⚠️ Major code refactoring - simplified all data interfaces and models. Added new group DB table and group_id column on the account table.

1.2.3 (2021-02-03)

Fixed

Fixed commission not being calculated for orders where quote_id is 0

1.2.2 (2021-01-12)

Features

Tax inclusion option - configure whether commission is calculated on the order amount including or excluding tax

1.2.1 (2020-12-17)

Fixed

Fixed dashboard crashing when some affiliate accounts had been deleted

1.2.0 (2020-12-10)

Fixed

Fixed commission not being added when order status changes happen rapidly (e.g., via automated fulfillment)

1.1.82 (2020-11-17)

Fixed

Fixed success message not appearing after affiliate sign-in

1.1.81 (2020-10-30)

Fixed

Fixed error when creating or editing programs on Magento 2.4.0

1.1.80 (2020-09-30)

Improvements

Fixed grammar and spelling across all documentation and UI labels

1.1.79 (2020-09-16)

Fixed

Fixed error when saving a coupon with an empty code field

1.1.78 (2020-09-07)

Fixed

Fixed error on the affiliate account edit page after deleting a referred customer
Fixed error on the affiliate account edit page on Magento 2.1

1.1.77 (2020-08-27)

Improvements

Commissions on hold are now displayed separately in the dashboard statistics

Fixed

Fixed not all customers being displayed in the account edit form customer list

1.1.76 (2020-08-07)

Features

Multiple programs with different coupons - use several affiliate programs with different cart price rules and unique coupon codes per program

1.1.75 (2020-07-30)

Improvements

Compatibility with Magento 2.4

Fixed

Fixed transaction list and affiliate balance display issues

1.1.74 (2020-07-23)

Fixed

Fixed affiliate balance not updating correctly after saving a transaction from admin

1.1.72 (2020-07-21)

Fixed

Fixed error when saving a new transaction from the admin panel

1.1.71 (2020-07-16)

Features

Program priority - set the order in which programs are evaluated when multiple programs match
Customer group and store conditions - restrict programs by customer group or store view
Event listing in admin - view all affiliate events with filtering and sorting

Improvements

Added event section to the affiliate account page
Improved referrer tracking reliability across stores

1.1.70 (2020-05-13)

Fixed

Fixed sale program applying commission even when no products match the program rules
Fixed compatibility with Amasty Role Permissions extension

1.1.69 (2020-04-13)

Fixed

Fixed commission not being subtracted when a discounted order is refunded

1.1.68 (2020-03-03)

Fixed

Fixed commission being earned on an affiliate's own sales and clicks
Fixed commission not being subtracted when an order is canceled
Fixed zero-commission activity messages appearing in the dashboard
Fixed repeated sign-in prompts on affiliate pages
Fixed commission not being added after re-enabling a previously disabled program
Fixed SQL error on the affiliate welcome page
Fixed commission not being added for different customers sharing the same IP address
Fixed date incrementing incorrectly on the account statistics page

1.1.67 (2020-01-16)

Fixed

Fixed error when adding or deleting commission tiers
Fixed commission not being subtracted correctly on refund for fixed-amount commissions

1.1.66 (2019-12-12)

Fixed

Fixed sorting by ID in the Add Customers grid
Fixed potential XSS vulnerability in account data and customer input fields

1.1.65 (2019-11-18)

Improvements

Coupon pattern is now validated before use to prevent invalid coupon codes

Fixed

Fixed statistics date ranges not filtering correctly
Fixed modal window conflicts on sites using Bootstrap
Fixed programs being duplicated after saving
Fixed error on the program edit page on Magento 2.1.x

1.1.63 (2019-10-23)

Fixed

Fixed admin listing filters not persisting after page reload

1.1.62 (2019-09-09)

Fixed

Fixed text banner form not loading data when editing

1.1.61 (2019-08-08)

Fixed

Fixed code quality issues flagged by Magento Extension Quality Program

1.1.60 (2019-08-01)

Improvements

Added Store Credit as a withdrawal payment method in the admin backend

1.1.59 (2019-08-01)

Fixed

Fixed cart grand total value used for commission calculation

1.1.58 (2019-07-09)

Fixed

Fixed shipping refunded amount being included in commission calculation for credit memos

1.1.55 (2019-07-01)

Fixed

Fixed credit memo not reducing the affiliate commission correctly

1.1.54 (2019-05-11)

Features

Product-specific commission rules - apply commission only for products matching specific conditions within an order

1.1.53 (2019-05-06)

Fixed

Fixed referral widget iframe links opening inside the iframe instead of the parent window

1.1.50 (2019-05-03)

Fixed

Fixed referral parameter not being appended to product links in the referral widget

1.1.49 (2019-04-01)

Improvements

Account statistics now only include processed orders, giving affiliates a more accurate view of earned commissions

1.1.48 (2019-03-19)

Features

Transaction limit per customer - limit the number of commission transactions per customer-affiliate pair (e.g., commission only for the first order)

1.1.47 (2019-03-14)

Fixed

Fixed customer-affiliate relation timeframe calculation being incorrect

1.1.46 (2019-03-13)

Improvements

Improved products widget layout with flex markup for better responsive display
Added option to hide the affiliate link for customers who are not registered affiliates

Fixed

Fixed unnecessary header and footer appearing in the referral widget
Fixed incorrect title on the affiliate welcome page

1.1.45 (2019-03-07)

Fixed

Fixed validation error when a new customer tries to register as an affiliate during account creation

1.1.44 (2019-03-04)

Improvements

Improved Store Credit extension integration with the withdrawal workflow

1.1.42 (2019-01-23)

Fixed

Fixed "headers already sent" error when displaying banner output
Fixed display issue with the affiliate signup form

1.1.40 (2019-01-16)

Features

Affiliate registration without customer account - allow affiliates to register and operate without requiring a Magento customer account

Fixed

Fixed various stability issues with the registration and authentication flow

1.1.39 (2018-11-29)

Improvements

Compatibility with Magento 2.3

1.1.38 (2018-11-14)

Fixed

Fixed account assignment priorities not being respected when multiple matching methods exist (referral link, coupon, etc.)

1.1.37 (2018-10-16)

Fixed

Fixed notification emails being sent from the wrong store view

1.1.36 (2018-10-10)

Fixed

Fixed sorting by account name not working in the transaction listing

1.1.35 (2018-09-06)

Fixed

Fixed admin session cookie conflict causing issues with affiliate tracking

1.1.34 (2018-08-27)

Fixed

Fixed notification emails not being sent for new affiliate registrations

1.1.33 (2018-08-15)

Fixed

Fixed cron job crashing when a referenced order has been deleted

1.1.32 (2018-07-30)

Fixed

Fixed error when creating a new affiliate program in admin

1.1.31 (2018-07-24)

Features

Register affiliate from admin - create affiliate accounts directly from the customer edit page in the backend

Fixed

Fixed error when saving customer-affiliate relations

1.1.30 (2018-05-23)

Fixed

Fixed compatibility issue with Magento 2.1

1.1.29 (2018-02-26)

Features

Affiliate info on order page - view affiliate details (account, referral source) directly on the order view page in admin

Fixed

Fixed sales not being tracked correctly for certain affiliate-customer combinations

1.1.28 (2018-02-08)

Features

Manual balance adjustment - add custom transactions from admin to manually adjust an affiliate's balance

1.1.27 (2018-02-06)

Features

Delete affiliate accounts - remove affiliate accounts from admin
Enable/disable payment methods - configure which withdrawal payment methods are available to affiliates

1.1.26 (2018-02-06)

Fixed

Fixed commission not being subtracted correctly when an order is refunded

1.1.25 (2018-01-25)

Fixed

Fixed admin user orders being counted as affiliate sales
Fixed fatal error when filtering affiliates by the "Affiliate Since" column

1.1.24 (2018-01-09)

Fixed

Fixed error in the affiliate accounts listing page

1.1.23 (2018-01-04)

Fixed

Fixed sale program not calculating commission correctly

1.1.22 (2018-01-03)

Fixed

Fixed broken review link on the affiliate account page

1.1.21 (2018-01-02)

Fixed

Fixed automatic affiliate signup not working for new customer registrations

1.1.20 (2018-01-02)

Fixed

Fixed Pay Per Click program not tracking clicks correctly

1.1.19 (2017-12-26)

Improvements

Improved programs list display with program type information

1.1.18 (2017-12-26)

Fixed

Fixed interface for assigning programs to affiliates in admin

1.1.17 (2017-12-26)

Features

Account statistics page - affiliates can view their performance statistics (events, commissions) from their account dashboard

1.1.16 (2017-12-20)

Fixed

Fixed error in account service causing affiliate account operations to fail

1.1.15 (2017-12-06)

Improvements

Added English translations for all UI strings

Fixed

Fixed banner images not displaying correctly

1.1.14 (2017-11-20)

Features

Pending account notifications - admin system messages alert when there are pending affiliate accounts or withdrawals waiting for approval
Separate account creation page - dedicated page for new affiliate registration

1.1.13 (2017-11-20)

Fixed

Fixed sale program commission calculation issue

1.1.12 (2017-11-13)

Fixed

Fixed hidden programs still being applied to commission calculations

1.1.11 (2017-11-09)

Fixed

Fixed errors occurring when a customer associated with an affiliate has been deleted
Fixed installation errors on fresh setup

1.1.10 (2017-10-13)

Features

Add referred customers from admin - manually assign customers to an affiliate's referred customers list from the account edit page

1.1.9 (2017-09-27)

Improvements

Compatibility with Magento 2.2

1.1.8 (2017-09-18)

Features

Editable coupon codes - edit affiliate coupon codes directly from the admin account form

1.1.7 (2017-09-11)

Fixed

Fixed payment notification email not being sent after withdrawal approval

1.1.6 (2017-09-01)

Improvements

Improved admin account interface with inline statistics and better transaction display

Fixed

Fixed program amounts not saving correctly

1.1.5 (2017-08-21)

Features

Withdrawal request email - admin receives email notification when an affiliate submits a withdrawal request

1.1.4 (2017-08-21)

Fixed

Fixed notification emails failing to send in certain configurations

1.1.3 (2017-08-10)

Improvements

Removed legacy admin grid and form files after UI component migration in 1.1.0

1.1.2 (2017-07-28)

Fixed

Fixed event processing logic not handling certain event types correctly

1.1.1 (2017-07-27)

Fixed

Fixed error when saving an affiliate account in admin

1.1.0 (2017-07-21)

Features

Commission tiers - define tiered commission rates that increase as affiliates reach higher performance levels
Commission priority - configure which program takes precedence when multiple programs match an order
Referred customers tracking - automatic tracking and display of customer-affiliate relationships

Improvements

⚠️ Complete admin interface rewrite - migrated all grids and forms to Magento UI Components

1.0.10 (2017-06-02)

Fixed

Fixed program ID handling in the referral widget

1.0.8 (2017-05-31)

Features

Custom referral codes - configure unique affiliate identifiers and referral parameter names instead of using system-generated IDs

Fixed

Fixed click events not being registered for certain referral link formats

1.0.7 (2017-05-03)

Fixed

Fixed commission calculation for the "by cart percent" commission type producing incorrect amounts
Fixed possible rendering error on admin pages

1.0.6 (2017-04-19)

Fixed

Fixed error when displaying the programs widget on the frontend

1.0.5 (2017-04-18)

Fixed

Fixed email notifications not being sent for new affiliates and withdrawals

1.0.4 (2017-04-18)

Features

Cart subtotal commission - calculate commission based on the order subtotal (cart total) instead of individual product prices

1.0.3 (2017-04-12)

Features

Coupon-based referrals - use coupon codes as an alternative referral method, automatically linking customers to affiliates when they apply a coupon

Improvements

Added configurable cookie lifetime for referral tracking duration

1.0.2 (2017-02-27)

Fixed

Fixed incorrect file permissions on the media folder preventing banner uploads

1.0.1 (2016-10-18)

Improvements

Removed Font Awesome dependency from frontend styles for faster page loads
Added unique affiliate link display in the admin interface

Fixed

Fixed error when saving affiliate accounts
Fixed issues with the withdrawal process and session handling

1.0.0 (2016-08-01)

Initial release