CleverNode Docs

CleverNode plugin settings and endpoint

Last revised: July 2022

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.

Connect CleverNode
Connect site to CleverNode

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.

Plugin Settings - Meta Tags
Plugin Settings - Meta Tags
  • 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.

Plugin Settings - Display
Plugin Settings - Display
  • 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

CleverNode Widget
CleverNode Widget

Endpoint for connection request

The call has to be done in POST to 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.