Configuration

The wp-parsely plugin is customizable and extensible in the WordPress Admin dashboard and by using PHP and JavaScript WordPress filters.

Limitations

When enabled, wp-parsely is only able to collect data from publicly available sites and publicly accessible URLs.

• Sites under restricted access are incompatible.
• Password-protected pages, or pages blocked from crawler user agents, are incompatible.

WordPress Admin dashboard

To access the settings page for wp-parsely:

1. Log in to the WordPress Admin dashboard for a VIP Platform WordPress site.
2. Select “Settings –> Parse.ly” from the left hand navigation menu in the WP Admin.

More detailed guidance for configuration options in the WP Admin can be found in Parse.ly’s WordPress documentation.

Decoupled / headless

The wp-parsely WordPress plugin is compatible with decoupled sites that use a WordPress backend. Some configurations in the client application’s code are required in order for the plugin to work as expected. Review Parse.ly’s decoupled documentation and reach out to the Support team if there are remaining questions about configuration.

Metadata

Metadata is automatically included in one of Parse.ly’s recognized formats (either JSON-LD or repeated meta tags) on all of a site’s core posts and pages. For Custom Post Types, this must be selectively enabled in the Parse.ly Settings page in the WordPress Admin dashboard. If valid JSON-LD metadata is implemented outside the Parse.ly plugin, metadata can be excluded by configuring the wp_parsely_metadata() filter. By default on VIP, the non-conflicting meta tags format is enabled. This can be modified in the wp-parsely settings page in the WordPress Admin dashboard.

If Parse.ly page metadata is causing issues on a site, report the issues in a Support ticket so that the Support team can assist. In some cases, improvements can be made to the plugin to reconcile a site’s metadata.

Parse.ly JavaScript tracking code

The Parse.ly tracker is a small JavaScript code that monitors user visits and relays them to the Parse.ly analytics servers.

If there are concerns about the performance impact of the wp-parsely JavaScript SDK, refer to Parse.ly’s documentation “Will the Parse.ly tag break or slow down my site?”. Additional information about the Parse.ly JavaScript tracking code, privacy, and GDPR:

• Parse.ly crawler, tracker and servers 
• Data and privacy
• GDPR and Parse.ly

Conditionally load the tracking code

If needed, it is possible to code-configure the Parse.ly JavaScript tracking code to conditionally load, for example to meet General Data Protection Regulation (GDPR) requirements or to load the code only after a user has consented to being tracked.

In PHP, use the wp_parsely_load_js_tracker filter to conditionally load Parse.ly’s JavaScript tracking code.

For a client-side event, use the wpParselyOnLoad and wpParselyOnReady JavaScript hooks to conditionally load the tracker code.