README

Stable tag: 3.17.0
Requires at least: 5.2
Tested up to: 6.7
Requires PHP: 7.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Tags: analytics, statistics, stats, content marketing, parsely, parsley, parse.ly
Contributors: parsely, hbbtstar, jblz, mikeyarce, GaryJ, parsely_mike, acicovic, mehmoodak, vaurdan

The Parse.ly plugin facilitates real-time and historical analytics to your content through a platform designed and built for digital publishing.

Description

Designed and built for digital publishers, Parse.ly helps you understand how your audience is connecting to your content.

Thousands of writers, editors, site managers, and technologists already use Parse.ly to understand what content draws in website visitors, and why. Using our powerful dashboards and APIs, customers build successful digital strategies that allow them to grow and engage a loyal audience.

Join industry leaders -- like NBA, Slate, News Corp, and Condé Nast -- who already use Parse.ly to bring clarity to content, audience, and analytics.

Feedback, suggestions, questions or concerns? Open a new GitHub issue or email us at support@parsely.com. We always want to hear from you!

NOTE: The plugin requires an active Parse.ly account. Sign up for a free Parse.ly demo.

Features

The wp-parsely plugin is packed with features that allow for a seamless integration process, and brings the power of the Parse.ly dashboard into WordPress.

Automated integration

The plugin automatically inserts the Parse.ly metadata and JavaScript in all published pages and posts (Custom Post Types are supported). It also provides a settings page to customize your integration, with options including:

• Output Parse.ly metadata as JSON-LD or repeated meta tags.
• Choose whether logged-in users should be tracked.
• Define how to track every Post Type (as Post, Non-Post or no tracking).

The Parse.ly Content Helper

The Content Helper is a set of content insight tools including:

• The Parse.ly Dashboard Widget - Displays the site's top posts in the WordPress Dashboard.
• The Parse.ly Stats Column - Displays published post performance for the last 7 days in Post Lists.
• The Parse.ly Editor Sidebar - This sidebar is integrated into the WordPress Editor and offers insights about the content currently being edited such as:
  • Title Suggestions - Generates title suggestions for the post/page currently being edited.
  • Excerpt Suggestions - Generates an excerpt suggestion for the post/page currently being edited.
  • Smart Linking - Automatically adds links to the current content that point to the most relevant and top-performing posts.
  • Related Posts - Displays a list of the website’s most successful posts, similar to the post/page currently being edited.
  • Performance Stats - Displays performance metrics about the content currently being edited.

The Parse.ly Recommendations Block

The plugin includes a Recommendations Block that displays a list of posts related to the currently viewed post/page. The Block is useful for showcasing related content to visitors, and it can also be used in Site Editing mode or as a Block-based Widget.

Advanced integrations support

While the plugin works out of the box for basic integrations, it offers a host of features that easily allow for advanced integration scenarios:

• Support for Google Tag Manager, AMP, Google Web Stories and Cloudflare is included.
• The plugin exposes the wpParselyOnLoad and wpParselyOnReady JavaScript hooks that allow for advanced integrations requiring JavaScript, such as Dynamic Tracking.
• Support for WordPress network/multisite and decoupled/headless (GraphQL and WP Rest API) setups is included.
• Last but not least, a wide range of hooks is available in order to customize the plugin's functionality even further.

Documentation and resources

• Plugin Documentation.
• Commonly Asked Questions.
• Changelog.

IMPORTANT: If you are a WordPress VIP customer, please consult the WordPress VIP documentation for more details.

Sample Parse.ly metadata

The standard Parse.ly JavaScript tracker inserted before the closing body tag:

<script id="parsely-cfg" data-parsely-site="example.com" src="https://cdn.parsely.com/keys/example.com/p.js"></script>

A sample JSON-LD structured data for a home page or section page:

<script type="application/ld+json">
{"@context":"http:\/\/schema.org","@type":"WebPage","headline":"WordPress VIP","url":"http:\/\/wpvip.com\/"}
</script>

A sample JSON-LD meta tag and structured data for an article or post:

<script type="application/ld+json">
{"@context":"http:\/\/schema.org","@type":"NewsArticle","mainEntityOfPage":{"@type":"WebPage","@id":"http:\/\/wpvip.com\/2021\/04\/09\/how-the-wordpress-gutenberg-block-editor-empowers-enterprise-content-creators\/"},"headline":"How the WordPress Gutenberg Block Editor Empowers Enterprise Content Creators","url":"http:\/\/wpvip.com\/2021\/04\/09\/how-the-wordpress-gutenberg-block-editor-empowers-enterprise-content-creators\/","thumbnailUrl":"https:\/\/wpvip.com\/wp-content\/uploads\/2021\/04\/ladyatdesk.png?w=120","image":{"@type":"ImageObject","url":"https:\/\/wpvip.com\/wp-content\/uploads\/2021\/04\/ladyatdesk.png?w=120"},"dateCreated":"2021-04-09T15:13:13Z","datePublished":"2021-04-09T15:13:13Z","dateModified":"2021-04-09T15:13:13Z","articleSection":"Gutenberg","author":[{"@type":"Person","name":"Sam Wendland"}],"creator":["Sam Wendland"],"publisher":{"@type":"Organization","name":"The Enterprise Content Management Platform | WordPress VIP","logo":"https:\/\/wpvip.com\/wp-content\/uploads\/2020\/11\/cropped-favicon-dark.png"},"keywords":[]}
</script>

Contributing

Development, code hosting and issue tracking of this plugin happens on the wp-parsely GitHub repository. Active development happens on the develop branch and releases are made off the trunk branch.

To run the plugin locally or to contribute to it, please check the instructions in the CONTRIBUTING file.

Installation

The plugin requires an active Parse.ly account. Sign up for a free demo of Parse.ly.

For more information, please visit the installation instructions in the official documentation.

Frequently Asked Questions

Please visit the Commonly Asked Questions page in the official documentation.

Changelog

Please visit the changelog.

Screenshots

1. The Parse.ly Dashboard Widget, showing the website's top posts.
   
2. The Parse.ly Stats Column (on the right), showing information about content that is being tracked as Posts.
   
3. The Parse.ly Editor Sidebar, featuring the Title Suggestions panel.
   
4. The Parse.ly Editor Sidebar, featuring the Smart Linking panel.
   
5. The Parse.ly Editor Sidebar, featuring the Related Posts panel.
   
6. The Parse.ly Editor Sidebar, featuring the Performance Stats panel.
   
7. The Parse.ly Excerpt Suggestions in the Post Editor's settings. Also available in the Parse.ly Editor Sidebar.
   
8. The Recommendations Block, showcasing links to related content on your site.
   
9. A view of the Parse.ly Dashboard Overview. Parse.ly offers analytics that empower you to better understand how your content is performing.