CleverNode Related Content Plugin
The CleverNode Related Content plugin allows you to display a collection of related articles, picked among those on your own site.
The correlation is made through a semantic algorithm that analyzes both the title and content of your articles in order to select a collection of related posts.
Articles are displayed as a grid form containing the featured image, title, and link to the featured article. The position of this grid within the page can be freely chosen.
Plugin Connection
To connect to the CleverNode Semantic Content Correlation Service simply click the "Connect to CleverNode" button on the first setup tab of the plugin.
This will make a single call to CleverNode service endpoint and allow you to assign a token, which will then be passed as a parameter to the widget display script.
Once the plugin is connected, a set of meta tags will be added to the head of the individual post. These meta tags will contain the title, URL of the featured image, and the date of posting and are used to create the post element in the widget. They may be disabled if Open Graph data is already present.
The main post content will be tagged by an HTML comment, so that CleverNode will be able to read it, to extract the semantic argument.
Eventually, there will be inserted the script that displays the related posts widget, by default placed at the bottom of the content on individual post pages. It could be displayed in other locations using the [clevernode-related] shortcode.
When the single post page is loaded, this script will make a call to the CleverNode correlation service, passing the post URL and token as parameters, so the service can read the meta tag and content of the post to extract the topic and can send back a JSON with the correlated results for that article.
What data is required by the plugin?
The plugin needs the website URL to generate the website token, parse individual posts, and return results, which are semantically related to the specific site.
The URL of the single posts, the meta tags and the name of the identified topic are recorded in our database, for a 15 days from each call, to allow CleverNode to perform the correlation and display the widget.
The plugin does NOT save or use any cookies and NO browsing events are tracked in any way. None of the saved meta tags will be used for purposes other than providing related results, nor transferred to third parties, and NO textual or visual content (HTML or images) will be stored, excluding meta tags as specified above.
Plugin Settings
After connecting the plugin, the following settings will be available.
Meta Tags
This plugin places some meta tags in each post, which are useful for gathering the relevant information.
If your website uses OG Tags you may enable the setting, but otherwise you can choose the image to show if the post does not feature one, and optionally insert the prefix or suffix of your post in the title tag.
-
Open graph enabled
The plugin adds a set of meta tags in the head of the single article. They can be disabled if Open Graphs is present on the site.
If enabled and the switch is on, the following features will be hidden. -
Filter for widget title
This filter allows you to exclude parts of the post title (e.g., site name) from the widget displaying the results.
Text field to be excluded from the post title (e.g. "Site Name -"). -
Default featured image
If the featured image is not set for the post, you can upload an image to display.
Display option
This plugin auto inserts a script tag after the content of single post to display related articles.
You can choose to insert the shortcode manually instead, if you want to place related posts elsewhere on the page.
-
Enable the filter or shortcode
If the filter is activated, the block of related articles will be inserted automatically at the end of the individual article, otherwise the shortcode
[clevernode-related]must be entered where you intend to display the block of related articles.
Note: The shortcode will have to be manually inserted into individual posts, even through the active theme or active widget areas.
CleverNode Widget Preview
Endpoint for connection request
The call has to be done in POST to https://clevernode.it/api/v1/account/connect passing the following JSON:
{
"site" : "site_url"
}The call sends back a token that will be used for subsequent calls made by the script.
Note: The plugin only needs a reference to the domain name to return the correct results for the specific website.