Overview
The Tutor LMS Tracking add-on connects Ultimate Affiliate Pro with Tutor LMS — a popular feature-rich LMS plugin for WordPress. Once enabled, the integration automatically assigns referral commissions every time a visitor referred by an affiliate completes a course purchase through Tutor LMS.
In addition, you gain precise control over your referral programs directly within each Tutor LMS course. You can define how referrals are awarded and set custom referral values per course, allowing you to tailor incentives based on each course and enrollment flow.
Requirements
Before installing, make sure the following are in place:
| Requirement | Details | Status |
|---|---|---|
| WordPress | 5.6 or higher | Required |
| Ultimate Affiliate Pro | Installed, activated, and with a valid license registered | Required |
| Tutor LMS Plugin | Installed & active on your WordPress site | Required |
| Tutor LMS Tracking Add-on ZIP | The dedicated add-on plugin file, downloaded from your Ultimate Affiliate Pro account | Required |
| WordPress Cron | Enabled (for scheduled commission processing) | Optional |
Installation
The Tutor LMS Tracking integration is delivered as a separate add-on plugin (ZIP file) that you install on top of Ultimate Affiliate Pro. Follow the steps below to get it running.
Step-by-step: Installing the Tutor LMS Tracking Add-on
- 1
Download the Add-on ZIP — Log in to your account on
ultimateaffiliate.pro, go to My Account → Downloads, and download the Tutor LMS Tracking add-on ZIP file. - 2
Upload via WordPress Admin — In your WordPress admin go to Plugins › Add New › Upload Plugin. Click Choose File, select the downloaded add-on ZIP, then click Install Now.
- 3
Activate the Add-on — Once installed, click Activate Plugin. No separate license activation is needed for the add-on — it inherits the license from your main Ultimate Affiliate Pro installation.
- 4
Confirm Tutor LMS is Active — Make sure the Tutor LMS plugin is already installed and activated. The add-on requires Tutor LMS to be present to function correctly.
Enable the Tutor LMS Integration
Once the add-on and Tutor LMS are both active, enabling tracking takes just a few clicks:
- 1
From your WordPress admin sidebar, go to Ultimate Affiliate Pro › Integrations.
- 2
Locate the Tutor LMS Integration card in the Integrations list. Click on it to open its settings panel.
- 3
The Tutor LMS Tracking settings page will load, showing all available options — Source Custom Name, Custom Referral Rates per Course, and the Tutor LMS Account Page section. Configure the options as needed (see Configuration below).
- 4
Click Save Changes. The integration is now active — Ultimate Affiliate Pro will begin tracking all Tutor LMS course purchases made through affiliate referral links.
Configuration
The Tutor LMS integration settings are organised into two main areas: Tracking Settings (source name and per-course rates) and Tutor LMS Account Page (affiliate tab inside the student area).
Access all settings at: Ultimate Affiliate Pro › Integrations › Tutor LMS Integration
General Settings
| Setting | Description |
|---|---|
| Source Custom Name | A custom label displayed on the Affiliate Dashboard to identify this referral source. Defaults to Tutor LMS. You can rename it to match your branding (e.g. “Online Academy” or “Courses”). |
Custom Referral Rates per Course
The Tutor LMS integration allows you to set custom referral rates for each individual course, overriding the global commission rule for that specific course.
You can configure per-course rates in two ways:
Referral Rate Fields — Course Builder (Basics Tab)
When editing a Tutor LMS course, the following referral fields are available directly in the Basics tab of the Course Builder:
| Setting | Description |
|---|---|
| Referral Rate Type | Choose between Percentage (%) — a percentage of the course sale price — or Flat (USD) — a fixed amount paid per enrollment, regardless of price. |
| Referral Amount | The numeric value for the commission. For example, enter 25 for a 25% commission or 10 for a $10 flat commission. |
| Disable Referrals | Toggle this on to completely prevent referrals from being generated for this specific course. This takes precedence over all other referral rate configurations — useful for free courses or internal-only content. |
Tutor LMS Account Page
This section lets you embed an Affiliate Dashboard tab directly inside the Tutor LMS Student Profile, so affiliated students can access their affiliate tools without leaving the Tutor LMS area.
Activate / Hold Affiliate Section
Toggle this option to show or hide the Affiliate Account tab inside the Tutor LMS Student Profile.
| Setting | Description |
|---|---|
| Menu Label | The text label used for the new tab inside the Student Profile navigation. Defaults to Affiliate Account Page. Change it to suit your site’s language and tone. |
| Menu Position | Controls the order of the tab within the Student Profile navigation. Enter a numeric value — lower numbers appear first. Default is 10. |
Affiliated Students Behavior
This setting controls what students who are also affiliates see when they click the Affiliate Account tab inside the Student Profile.
| Display Mode | Behavior |
|---|---|
| Show Affiliate Portal | Renders the full Ultimate Affiliate Pro Affiliate Portal content inline inside the Student Profile tab. The student does not leave the Tutor LMS area. |
| Redirect to Affiliate Portal Page | Redirects the student to the dedicated Ultimate Affiliate Pro Affiliate Portal page set in your plugin settings. Best when you want a full-screen affiliate experience. |
Non-Affiliate Students
When the Affiliate Account tab is enabled, non-affiliate students will also see the tab in their Student Profile. Instead of displaying affiliate tools, you can show them custom content — for example, an invitation to join your affiliate program.
| Setting | Description |
|---|---|
| Custom Content for Non-Affiliate Students | A rich-text editor where you can write any message or call-to-action shown to students who are not yet affiliates. Supports HTML and shortcodes. Use the shortcode |
How Tracking Works
Understanding the end-to-end tracking flow helps you confirm that everything is set up correctly and troubleshoot any edge cases.
- 1
Affiliate shares their referral link — Each affiliate has a unique referral URL (e.g.
yoursite.com/?uap_ref=john). They share this link in blog posts, emails, social media, or course reviews. - 2
Visitor clicks the link — Ultimate Affiliate Pro sets a tracking cookie in the visitor’s browser. The cookie duration is controlled by the Ultimate Affiliate Pro › Settings › Cookie Duration setting.
- 3
Visitor purchases a Tutor LMS course — When the purchase is confirmed by Tutor LMS (order status: Completed), Ultimate Affiliate Pro intercepts the event via the Tutor LMS Tracking add-on.
- 4
Commission is automatically recorded — Ultimate Affiliate Pro matches the purchase to the referring affiliate and applies the correct commission: the course-level Referral Amount (if set), a Product Rate, a Rank commission, or the global rate — whichever takes priority per your settings.
- 5
Affiliate sees the referral — The referral appears in real time on the affiliate’s dashboard under Referrals. The source column will show the Source Custom Name you configured (default: Tutor LMS).
- 6
Admin reviews & pays out — Review all Tutor LMS-sourced referrals under Ultimate Affiliate Pro › Referrals and pay affiliates via PayPal, Stripe, or Bank Transfer using the Payouts section.
Viewing Tutor LMS Referrals
All referrals generated through Tutor LMS are recorded in the main Ultimate Affiliate Pro Referrals log alongside referrals from other integrations. You can filter them by source to see only Tutor LMS activity.
- 1
Go to Ultimate Affiliate Pro › Referrals in your WordPress admin.
- 2
Use the Source filter column to search for the label you set in Source Custom Name (default:
Tutor LMS). - 3
You can also go to Ultimate Affiliate Pro › Reports to see revenue totals broken down by integration source over any date range.
