How to troubleshoot the HubSpot for WordPress plugin

Last Modified Date: 10/27/2014 7:16 PM

How the HubSpot WordPress Plugin Works

 
The HubSpot plugin for WordPress helps you integrate your WordPress site or blog with your HubSpot account. The plugin:
 
  • Adds the HubSpot tracking code to your WordPress website or blog
  • Tags your blog posts so that you can sort by them in Page Performance in HubSpot
  • Tracks subscribers to your native WordPress RSS feed
  • Allows you to track publish date, author, and comment count for your WordPress posts in HubSpot Page Performance
In order for the plugin to work, you will need to be a HubSpot customer, running WordPress 3.0 or higher. You will also need to ensure that your website is not hosted on wordpress.com, as this WordPress environment does not allow users to add any JavaScript code to wordpress.com sites because it is a shared environment.
 
Common Issue #1: Your WordPress blog posts are not showing up in Page Performance or the Dashboard
 
Troubleshooting Steps: 
 
  • Check that you have installed the latest version of the HubSpot for WordPress plugin
  • Check that you have added your Hub ID and authenticated the HubSpot plugin in the HubSpot plugin settings page in WordPress
  • Check that your are including <?php wp_footer(); ?> in the footer.php file in your WordPress theme. If you're not sure how to do this, you should check with the person who installed or maintains your WordPress site.

Turning on WordPress Error Logging
 
If you do not see the error message above in WordPress, and Page Performance is not showing authors, dates, or comment counts for your WordPress blog posts in HubSpot, please ensure that WP_DEBUG is set to “true” in your wp-config file.
 
Adding wp_footer to your theme
 
In order for the HubSpot plugin to add HubSpot tracking code to your site, you must include the wp_footer function in your WordPress theme’s footer. Most WordPress themes include this by default, but if you’re theme does not, you will need to include the following to your theme’s footer file (usually named footer.php):
 
 
<?php wp_footer(); ?>
 
 
For more information on the footer.php function, please visit http://codex.wordpress.org/Function_Reference/wp_footer.
 
Common Issue #2: You are seeing WordPress blog posts in Page Performance or the Dashboard, but not Post Date, Author or Comments
 
Troubleshooting Steps: 
 
  • Check that you have installed the latest version of the HubSpot for WordPress plugin
  • Check that you have added your Hub ID and authenticated the HubSpot plugin in the HubSpot plugin settings page in WordPress
  • Check that the list of trusted certificate authorities on your server is up to date. Internally, we updated our list of trusted certificate authorities using the list provided at http://curl.haxx.se/ca/cacert.pem. Also make sure that your PHP SSL libraries are properly configured. If you're not sure how to do this, you should check with the person who installed or maintains your WordPress site.

Common Issue #3: You have tried to authenticate your plugin but you are seeing the message "HubSpot authorization failed. Please go to the HubSpot settings page and authorize with HubSpot"
 
Troubleshooting Steps: 
 
  • Check that you have installed the latest version of the HubSpot for WordPress plugin
  • Check that you have added your Hub ID and authenticated the HubSpot plugin in the HubSpot plugin settings page in WordPress
  • Check that you have an active, SSL certificate installed on your website. Internally, we updated our list of trusted certificate authorities using the list provided at http://curl.haxx.se/ca/cacert.pem. Also make sure that your PHP SSL libraries are properly configured and that your version of PHP supports SSL. If you're not sure how to do this, you should check with the person who installed or maintains yourWordPress site.
 
Setting Up SSL on your server
 
For security, sending meta data (author, date and comments) from your WordPress posts to HubSpot, requires a secure connection (SSL). As a result, you will need to ensure that your server and the instance of php running on your server both support SSL. You will also need to ensure that the directory of certificate authorities on your server is up to date.
 
If SSL is not enabled, or if your list of trusted certificate authorities is not up to date, you will see an error message like the one below in the WordPress Plugin. You will not be able to see post dates, authors and comment counts for your blog posts in HubSpot’s Page Performance app until this issue is resolved. The rest of the plugin, and HubSpot will work normally.
 
"HubSpot Plugin: Error connecting to API - SSL certificate problem, verify that the CA cert is OK. Details: error:14090086:SSL routines:SSL3_GET_SERVER_CERTIFICATE:certificate verify failed"
 
"HubSpot Plugin: Error connecting to API - Response code was blank"
 
"HubSpot Plugin: Error connecting to API -"
 
Below are directions for updating your list of trusted certificate authorities. If you’re feeling a bit confused, please pass this document along to your website or server administrator.
 
Directions for updating the directory of trusted certificate authorities on a Windows server:
 

Directions for updating the directory of trusted certificate authorities on a Linux server:
 
 
HubSpot’s SSL Certificate:
 
 
Other recommendations for updating your list of trusted certificate authorities
 
  • Make sure that you restart your server after following the directions above
  • Make sure that you have correctly set permissions on your .crt file