WordPress Plugin: Troubleshooting

The plugin doesn’t inject the Parse.ly tracker and/or metadata

There are a few reasons why this could be happening:

• Make sure you have specified the Site ID in the plugin’s options.
• You may have disabled tracking for logged-in users via the “Track Logged-in Users” option.
• By default, the plugin only tracks posts with the publish status. This behavior can be changed by using the filter_trackable_statuses filter:

add_filter( 'wp_parsely_trackable_statuses', 'filter_trackable_statuses', 10, 2 ); 
function filter_trackable_statuses( $statuses, $post ) {
	$statuses[] = 'future';
	$statuses[] = ...;
	return $statuses;
} 

• To avoid data leakage, the tracking code is not inserted in password-protected pages when the user hasn’t provided the password. This behavior can be changed by using the wp_parsely_skip_post_password_check filter:

add_filter( 'wp_parsely_skip_post_password_check', '__return_true' ); 

The plugin relies on the wp_head() and wp_footer() WordPress functions to work. If your site uses a non-standard WordPress template, these functions might not get called. In that case, get in touch with us.

Why do I see duplicate content in the Parse.ly Dash?

When Parse.ly crawls a website, it will read every page’s metadata. If you see duplicate content (posts or pages that are identical but separated into two items) in the Parse.ly dashboard, this is usually caused by a post being accessible from different URLs (for instance, http://example.com/post-1 and http://wwww.example.com/post-1).

As the plugin gets the canonical URL from WordPress for every page and puts it into the metadata, a possible fix to this would be to modify the plugin’s metadata output by using the wp_parsely_metadata filter.

However, we do not recommend this approach as it doesn’t solve the root of the problem. Having duplicate content can have severe implications, including SEO. We recommend fixing the issue at the WordPress level and moving your site to having just one canonical URL for every page.