Overview
The LearnPress Tracking add-on connects Ultimate Affiliate Pro with LearnPress — the popular free 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 LearnPress.
Because the module fully inherits your existing Ultimate Affiliate Pro settings — commission rules, ranks, cookie duration, and payout methods — there is no duplicate configuration. Enable it once and referral tracking starts working immediately.
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 |
| LearnPress Plugin | Installed & active on your WordPress site | Required |
| LearnPress 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) | Recommended |
Installation
The LearnPress 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 LearnPress 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 LearnPress 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 LearnPress is Active — Make sure the LearnPress plugin is already installed and activated. The add-on requires LearnPress to be present to function correctly.
Enable the LearnPress Integration
Once the add-on and LearnPress 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 LearnPress card in the Integrations list. Click on it to open its settings panel.
- 3
The LearnPress Tracking settings page will load, showing the Source Custom Name field and the LearnPress 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 LearnPress course purchases made through affiliate referral links.
Configuration
The LearnPress integration settings are split into two main areas: Tracking Settings and LearnPress Account Page.
Access all settings at: Ultimate Affiliate Pro › Integrations › LearnPress or Ultimate Affiliate Pro › Modules › LearnPress Tracking
General Settings
| Setting | Description |
|---|---|
| Source Custom Name | A custom label displayed on the Affiliate Dashboard to identify this referral source. Defaults to LearnPress. You can rename it to match your branding (e.g. “Online Courses” or “Academy”). |
LearnPress Account Page
This section lets you embed an Affiliate Account tab directly inside the LearnPress Student Dashboard, so affiliated students don’t need to visit a separate page to access their affiliate tools.
Activate / Hold Affiliate Section
Toggle this option to show or hide the Affiliate Account tab inside the LearnPress Student Dashboard.
| Setting | Description |
|---|---|
| Menu Label | The text label used for the new tab inside the Student Dashboard. 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 Dashboard navigation. Enter a numeric value — lower numbers appear first. Default is 3. |
Affiliated Students Behavior
This setting controls what students who are also affiliates see when they click the Affiliate tab inside the Student Dashboard.
| Display Mode | Behavior |
|---|---|
| Show Affiliate Portal | Renders the full Ultimate Affiliate Pro Affiliate Portal content inline inside the Student Dashboard tab. The student does not leave the LearnPress 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 Users
When the Affiliate Account tab is enabled, non-affiliate students will also see the tab in their Student Dashboard. 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 Users | 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. You can use the Ultimate Affiliate Pro 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 LearnPress course — When the purchase is confirmed by LearnPress (order status: Completed), Ultimate Affiliate Pro intercepts the event via the LearnPress Tracking add-on.
- 4
Commission is automatically recorded — Ultimate Affiliate Pro matches the purchase to the referring affiliate, applies the correct commission rule from the affiliate’s rank or product rate, and logs the referral as Pending or Approved based on 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 set (default: LearnPress).
- 6
Admin reviews & pays out — You can review all LearnPress-sourced referrals under Ultimate Affiliate Pro › Referrals and pay affiliates via PayPal, Stripe, or Bank Transfer using the Payouts section.
Viewing LearnPress Referrals
All referrals generated through LearnPress are recorded in the main Ultimate Affiliate Pro Referrals log alongside referrals from other integrations. You can filter them by source to see only LearnPress 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:
LearnPress). - 3
You can also go to Ultimate Affiliate Pro › Reports to see revenue totals broken down by integration source over any date range.
