Troubleshooting LeadPages

After moving a client website recently we ran into an issue with a popular funnel page builder plugin not working with WordPress called LeadPages.

We started with all of the basic stuff:

  • Made sure most current version LeadPages plugin was installed
  • Turned off all plugins to make sure no plugin conflicts existed
  • Uninstalled LeadPages plugin / reinstalled – per LeadPages support
  • Made sure WP was up to date

After none of these basic tests seemed to get LeadPages working we started to look at other things:

  • Sent LeadPages support copy of error log file (they could not figure anything out)
  • Got escalated to LeadPages advanced support with no success in any of our testing / troubleshooting
  • Confirmed that TLS 1.2 was supported / running on server
  • Checked PHP versions
  • Ran PHP test utility to make sure no issues were detected
  • Tested on a different server with a clean domain – (LeadPages worked instantly)
  • Set up and tested a clean domain on client’s dedicated server (LeadPages Did Not Work)

Still could not get LeadPages working

This is where experience and troubleshooting tenacity came in handy. After all of the above tests I knew it had to be one last area we did not check or test (LeadPages support never mentioned this once even when talking to advanced support) – I figured it had to be the .htaccess file. After looking at .htaccess file on client WP installation, it was not the normal entry you see after installing WP and setting permalinks.

The LeadPages Fix!

  • Reset WordPress Permalinks
  • Manually entered WP .htaccess entry after setting permalins (See below)

Standard .htaccess entry for WordPress installation

# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ – [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>

After this tweak, I tested all LeadPages links we created and they all worked fine.

What to remember:

  • Troubleshooting any WordPress plugin takes a systematic approach and some patience.
  • Don’t expect WordPress plugin support for any third party plugins to be able to solve all of your support issues
  • Most of the time it’s something simple as in this case

Below is a snippet from our error log file

[27-Nov-2018 19:15:21 UTC] PHP Fatal error:  Uncaught Error: Call to undefined function LeadpagesWP\Helpers\mb_convert_encoding() in /home/***/public_html/wp-content/plugins/leadpages/App/Helpers/LeadpageType.php:73
Stack trace:
#0 /home/***/public_html/wp-content/plugins/leadpages/App/Front/Controllers/LeadpageController.php(192): LeadpagesWP\Helpers\LeadpageType::modifyMetaServedBy('<!DOCTYPE html>...', 'wordpress')
#1 /home/***/public_html/wp-content/plugins/leadpages/App/Bootstrap/FrontBootstrap.php(96): LeadpagesWP\Front\Controllers\LeadpageController->normalPage()
#2 /home/***/public_html/wp-includes/class-wp-hook.php(288): LeadpagesWP\Bootstrap\FrontBootstrap->displayLeadpage(Array)
#3 /home/***/public_html/wp-includes/plugin.php(244): WP_Hook->apply_filters(Array, Array)
#4 /home/***/public_html/wp-includes/class-wp-query.php(2982): apply_filters_ref_array('the_posts', Array)
#5 /home/***/public_html/wp-includes/class-wp-query.php(3230): WP_Query->get_post in /home/***/public_html/wp-content/plugins/leadpages/App/Helpers/LeadpageType.php on line 73
[27-Nov-2018 19:16:26 UTC] PHP Fatal error:  Uncaught Error: Call to undefined function LeadpagesWP\Helpers\mb_convert_encoding() in /home/***/public_html/wp-content/plugins/leadpages/App/Helpers/LeadpageType.php:73
Issues with LeadPages - LeadPages Not Working

Troubleshooting Lead Pages