SmartLink WP v1.0 - Advanced URL Rotator

Created: January 2026
By: onwebco
Support: Contact us via our Website

Thank you for purchasing SmartLink WP. This documentation and video will guide you through installing and using your new WordPress URL Rotator.

1. Server Requirements

SmartLink WP runs on any standard WordPress environment:

• WordPress 5.0 or higher.
• PHP 7.4 or higher.
• MySQL 5.6 or MariaDB 10.1 or higher.

2. Installation

Note: Please unzip the main package you downloaded from CodeCanyon first. Inside, you will find the file smartlink-wp.zip. This is the file you need to upload.

Method A: WordPress Admin (Recommended)

1. Log in to your WordPress Dashboard.
2. Navigate to Plugins > Add New.
3. Click the Upload Plugin button at the top.
4. Choose the smartlink-wp.zip file.
5. Click Install Now.
6. After installation, click Activate Plugin.

Method B: FTP Upload

1. Unzip the smartlink-wp.zip file on your computer.
2. Connect to your server via FTP.
3. Upload the smartlink-wp folder to: /wp-content/plugins/.
4. Log in to WordPress, go to Plugins, and activate SmartLink WP.

3. Managing Links

Once activated, click on SmartLink Manager in your WordPress sidebar.

The Dashboard List

This page shows all your active rotators. From here you can:

• Copy URL: Click the small "Copy" icon next to any URL to instantly copy it to your clipboard.
• View Clicks: See the total click count at a glance.
• Edit/Delete: Manage your campaigns.

Creating a New Link

1. Click Add New Link.
2. Title: Name your campaign (e.g., "Holiday Sale").
3. Default URL: The fallback URL. Users go here if no specific targeting rules match.
4. Expiry Date (Optional): The link will stop working after this date.
5. Fallback URL (Optional): Where users are redirected if the link has expired.

4. Geo & Device Targeting

SmartLink WP allows you to split traffic based on rules. You can add multiple "Targets" for a single link.

How Weights Work (Split Testing)

The rotator uses a weighted random algorithm (1-10).

• 50/50 Split: Set both URLs to Weight 5.
• 90/10 Split: Set URL A to Weight 9, and URL B to Weight 1.

Geo-Targeting

Enter the 2-letter ISO Country Code (e.g., US, GB, CA, DE). Leave blank to target all countries.

Device Targeting

Select Mobile or Desktop to restrict a URL to specific devices.

5. Analytics & Stats

Click the Stats link next to any campaign to view detailed reports.

• Top Countries: A pie chart showing where your traffic is coming from.
• Device Breakdown: A bar chart comparing Mobile vs. Desktop clicks.

Note: Data is stored in a custom high-performance database table to ensure your site remains fast.

6. FAQ & Troubleshooting

Does this work with Caching plugins?

Yes. However, because the redirection happens via PHP, very aggressive page caching might cache the redirect itself. If you notice issues, exclude the query parameter ls_id from your caching plugin.

How is location detected?

We use a smart hybrid system:

1. Cloudflare: If your site uses Cloudflare, we use their headers for 100% accuracy.
2. IP-API: If not on Cloudflare, we use a fallback API to detect the user's country.