How to troubleshoot the HubSpot WordPress plugin

Last Modified: 06/10/2013
Last Modified By: Samuel Siskind

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.


Issue: 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 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(); ?>


More information on the footer.php function:

http://codex.wordpress.org/Function_Reference/wp_footer

 


Issue: 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 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.


    Issue: 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 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.

       

       

       

      Was the content and structure of this article helpful? (If you are running into an issue in your account or have a specific question about your setup, please contact our Support team.)  Yes  No