Troubleshooting Common Issues

Hit a snag with WP Safelink? Most issues come down to caching, the license connection, or your hosting environment, and each has a quick fix. Find your symptom below and follow the matching solution.

The countdown timer isn’t showing

Symptom: the download button appears instantly with no countdown, or the page looks blank where the timer should be.

Fix: this is almost always caching. Safelink pages must be served fresh, never from cache.

1. In your caching plugin, exclude your safelink parameter (default wpsafelink) and the final redirect parameter (default safelink_redirect) from page cache.
2. If you use Cloudflare, add a Cache Rule to bypass cache for URLs containing your safelink parameter, then purge everything.
3. Confirm Time Delay in the Templates tab is set to a value above 0 (the default is 5 seconds).
4. Test in a private/incognito window to rule out a stale local cache.

Links aren’t converting to safelinks

Symptom: outbound links still point straight at the destination instead of going through a countdown page.

• If you generate links manually, make sure you actually copied the short or encrypted safelink from the Generate Link tab, not the original target URL.
• If you rely on the Auto Convert Link extension, confirm the extension is connected: it authenticates with the Integration Key from the Integration tab, so a wrong or empty key stops conversion.
• Check your Include / Exclude domain lists — in include mode only listed hosts are converted; in exclude mode everything except listed hosts is converted.
• After changing include/exclude lists behind Cloudflare, clear the Cloudflare cache so the regenerated blog JavaScript is served.

“The ionCube Loader is missing” error

Symptom: a notice that ionCube is not installed, or the plugin won’t activate.

Fix: WP Safelink PRO needs ionCube Loader 14.0.0+ on PHP 8.3+.

1. Open the setup wizard (WP Safelink → Setup) — it shows your current PHP version and whether ionCube is detected.
2. If ionCube is missing, contact your host and ask them to enable the ionCube Loader for your PHP version (most hosts enable it from cPanel under “Select PHP Version” → extensions).
3. If you’re on PHP 8.2 or lower, switch to PHP 8.3 first, then enable ionCube 14+.
4. Reload the wizard — the requirement check should now pass and let you continue.

My license won’t activate

Symptom: the license key is rejected, or PRO tabs stay locked after entering the key.

• Double-check the key for stray spaces — copy it directly from your Themeson account email.
• Confirm the domain you’re activating on matches the domain on record. Licenses are domain-locked; use Change License on the License tab to move to a new domain.
• PRO features require a key ending in -pro, -agency, or -lifetime. A Lite or Standard key activates the Full version but not PRO tabs.
• Click Refresh Status on the License tab to force a fresh check against api.themeson.com.
• If your server blocks outbound HTTPS, ask your host to allow connections to api.themeson.com and update.themeson.com.

Caching plugin or Cloudflare conflicts

Symptom: visitors see the same target link every time, the timer freezes at a stale value, or the page won’t advance past verification.

Fix: exclude all safelink routes from every cache layer.

Blank or white page on the safelink

Symptom: the safelink URL loads to a completely blank (white) page.

1. Enable WP_DEBUG and WP_DEBUG_LOG in wp-config.php, reload the safelink, then check wp-content/debug.log for a PHP fatal error.
2. Confirm ionCube and PHP meet the requirements (a missing loader is the most common cause of a blank PRO page).
3. Temporarily switch to a default template (template1) in the Templates tab to rule out a theme integration conflict.
4. Raise your PHP memory_limit if the log shows an out-of-memory error.
5. If it persists, deactivate other plugins one at a time to find a conflict, then re-activate.

Where to check your license