Getting started
Install in 5 minutes. Capture your first attributed lead today.
1. Requirements
- Joomla 4.x or 5.x
- RSForm!Pro 3.x
- PHP 7.4 or newer
Joomla 3.x is not supported (end-of-life August 2023).
2. Install the plugin
- Download the plugin zip file from the link in your purchase email.
- In Joomla admin, go to System → Install → Extensions.
- Drag the zip file into the upload area. You'll see "Installation was successful".
- Go to System → Manage → Plugins and search for "Lead Source Tracker".
- Click the plugin name to open it. Toggle Status to Enabled in the right sidebar.
- Click Save.
That's it. The plugin starts tracking visits and capturing lead sources immediately. Your existing RSForm!Pro forms will automatically get hidden tracking fields added behind the scenes the first time each form is viewed on the front end.
3. Add your license key
- In the plugin settings, click the License tab.
- Paste your license key (sent in your purchase email) into the License key field.
- Click Save. The plugin activates the key against this site automatically.
- Joomla's update system will now offer plugin updates automatically.
A license key is not required for the plugin to work — lead capture continues even without a key. The license only gates automatic updates and support.
Lost your key? Email support@leadsourcetracker.com from the address you used at checkout.
4. Configure the plugin
All settings live under System → Manage → Plugins → System — Lead Source Tracker. The defaults are sensible for most sites; tweak only if you need to.
| Setting | Default | What it does |
|---|---|---|
| Limit to form IDs | empty (track all) | Comma-separated list of RSForm!Pro Form IDs to track. Leave empty to track every form on your site. |
| Cookie lifetime (days) | 90 | How long to remember a visitor's original source. Lower values are stricter on privacy; longer values capture more delayed conversions. |
| Label as Ads/Organic | Yes | When on, sources are auto-suffixed with " Ads" or " Organic" (e.g. "Google Ads" vs. "Google Organic"). |
| Auto-inject tracking fields | Yes | Automatically add hidden lead-tracking fields to your RSForm!Pro forms the first time they are rendered. Turn off only if you want to add fields manually. |
| Debug logging | No | Print detection details to the browser console (visible only to you when developer tools are open). Useful when verifying setup; leave off in production. |
5. View lead source in submissions
- In Joomla admin, go to Components → RSForm!Pro → Manage Submissions.
- Pick the form whose submissions you want to view.
- Click the columns/gear icon to show or hide columns. Enable:
- Source — e.g. "Google Ads", "Facebook Organic", "Direct"
- Medium — e.g. "cpc", "organic", "referral"
- Campaign, Campaign_ID, Term, Content — UTM values
- Click_ID, Click_Type — for paid traffic (gclid, fbclid, etc.)
- Referrer, Landing — the visitor's original referrer URL and landing page
- First_Seen — when this visitor was first attributed
- The columns are now visible in every submission row.
6. Export submissions to CSV
In Components → RSForm!Pro → Manage Submissions, use the standard Export button. All Source / Medium / Campaign / Click_ID columns are included in the export by default.
For reporting in Excel/Sheets, the Source column is the most useful single field — it tells you "Google Ads", "Facebook Organic", "Direct", "Yelp", etc. for every lead.
7. Future updates
As long as your license is active, Joomla's built-in updater will notify you of new plugin versions automatically (once every 24 hours).
- When an update is available, you'll see a notification badge in your Joomla admin.
- Go to System → Update → Extensions and click Update.
- The plugin updates in place. Your settings and data are preserved.
8. Need help?
If you run into a problem — a form not capturing source data, a license question, anything else — email support@leadsourcetracker.com and we'll respond within one business day. Active license holders get priority.
When emailing, include your Joomla version, RSForm!Pro version, and what you were trying to do. A screenshot of your plugin settings page helps us help you faster.