WordPress Guide

Installing and using the Bibblio Related Posts plugin

A WPEngine Recommended Plugin

Installation

Welcome!

Before you begin, ensure you have at least five posts on your site. After all, it only works if there's something to recommend from! ;)

If so, you can install the plugin via the WordPress Plugins page.

Click Add New (top left next to the page heading), then click Upload Plugin and Choose File to browse to the latest .zip file of the Related Posts by Bibblio plugin.

Add a new plugin

 

Upload plugin

Getting Started

After uploading and activating the plugin you should see a Bibblio link in the WordPress admin’s left menu. Clicking this will start the setup wizard.

Step 1 is to create a Bibblio account. You can pick a free plan or one that suits your catalogue size.

Get started

 

If you already have a Bibblio account you can go to Step 2. Retrieve your Client ID and Client Secret from here.

Once you have your Client ID and Client Secret from the link above you can paste each into Step 2 back on the plugin's Get Started page then click Let’s Go!

Getting your credentials

 

You can include existing posts into Bibblio’s recommendations brain as well as automatically including all future ones.

Nb. If you have many posts to include, your site may encounter a brief impact on performance, as these must be fetched and submitted to our HTTP API. Also, depending on your catalog size, there may be a delay before related posts appear while the indexing is completing.

If you use custom post types you can choose which types you wish to be included in your recommendations.

Set which posts to compare

 

Clicking Next takes you to the module designer. A module is a widget containing related posts that can sit on any part of your post pages.

1: Choose a layout, a tile ratio that suits your typical shape of feature image and any effects you’d like. You can always make further adjustments later.

Nb. A 'Showcase', 'Grid' or 'Row' style would look great in the footer, while a 'Column' would work in the side bar.

2: Create a memorable name for your module that reflects its layout (e.g. "Footer row of 3").

3: Add any tracking parameters you wish to monitor (e.g. for Google Analytics).

4: When happy, click Next.

Create a module

 

At this point, we will begin indexing all of your content to determine how they are related. This will take 5-10 minutes, depending on your article quantity. Please be patient during this initial indexing.

In the meantime, you can automatically add the module to the bottom of all of your posts, add it as a widget (see the Adding Widgets section) or use a shortcode to selectively insert a module (see the Inserting Shortcodes section).

Be sure to perform this step otherwise your module will not appear anywhere!

If you automatically add the module to the bottom of your posts you can customize the title that appears above it or keep the default ("Related").

If you need further help, try the Troubleshooting Guide or contact the Bibblio team.

Success!

Adding Widgets

To display a Related Posts module on your post pages, go to Appearance > Widgets from the left-hand menu.

In the Available Widgets column, drag and drop the Bibblio Related Posts widget into your page area of choice.

Alternatively, click on the Bibblio Related Posts widget and choose a page area from the list that appears below it, then click Add Widget. The widget will expand to reveal options to configure it.

Add a widget

 

Type a headline into the title field that will sit above the module on your post page, such as "Related Posts". From the dropdown choose which of your modules to display, then click Save.

The module is now inside a widget on your post pages! Go to a post and look to see how it is displaying. If it doesn't look quite right, change the layout or tile ratio in the Module section of the Bibblio plugin admin until you're happy with it.

Repeat the process until each of your modules appear on your posts as you would like them.

Widget settings

The WordPress Plugin Admin Explained

Overview

The Overview tab shows you how many posts are stored in Bibblio's recommendations brain as well as the amount of times per month that the widget has been rendered on your post pages.

To see your full analytics, including module clicks and click-through rate, go to your dedicated dashboard on Bibblio.

 

Settings

Handling Existing Posts

You can import any posts you have published before you installed this plugin by pressing the Import published posts button.

The import will start with your most recent published posts and work backwards until it has either ingested all of your published posts or has reached your storage limit. This limit depends on the plan you have with Bibblio. If you need more space you can easily upgrade your plan.

You can pause and resume this import at any time to cater for storage limits or to avoid peak traffic times on your website.

You can prioritize recency so that posts published within your chosen time span are more likely to appear as recommendations (and conversely, those older are less likely).

Drag the slider to the period that suits the nature of your site. (e.g. an online publication that thrives on the latest news might prefer 2 days, so that recommendations are very recent, whereas a magazine site or journal might prefer 2 years, to allow users to discover older yet relevant content deep within their platform.)

Drag the slider to OFF to be sure recency does not influence the recommendations.

 

Handling Future Posts

Stop any new published posts from being recommended via the widget by switching it OFF.

If you switch this setting ON, any new posts published whilst it was set to OFF can be imported to Bibblio via the Import published posts button (see above). Nb. If you edit and update an as-yet unimported published post, it will be automatically imported at that moment.

 

Standard posts and custom post types

If you use custom post types you can choose which types you wish to be included in your recommendations. Adding post types is a one way street - if you want to remove posts of a specific type you must deactivate the plugin, reactivate it and start again.

 

Disconnecting this widget

Should you wish to remove the widget from your site you can press the Disconnect button. This will log you out of the Bibblio plugin and detach all of your posts from Bibblio. Your actual posts within WordPress will not be affected but all Bibblio widgets within them will not appear.

Beware that disconnection will apply to all of your environments. E.g. If you disconnect the widget from your development environment it will instantly disconnect from your live environment too.

You can reactivate the widget at any time using your Bibblio client ID and client secret. You will need to reimport your posts and create your modules again. Any analytics data from previous activations will be preserved.

 

Modules

A module is a widget containing related posts that can sit on any part of your post pages.

Automatically add a module to the bottom of all of your posts by selecting the module from the dropdown. Customize the title that appears above the module or keep it as the default ("Related"). Click Save to be sure these changes happen.

 

Module Layout

There are a variety of layouts that can be chosen to suit your website theme and positioning. Have a play and see which works best on your pages.

Tip: A 'Showcase', 'Grid' or 'Row' style would look great in the footer, while a 'Column' would work in the side bar.

 

Arrangement

Text upon image - The related post title sits on top of its featured image in each tile.

Text beneath image - The related post title sits underneath its featured image.

Explanatory link beneath module - An information icon sits to the bottom-right of the entire module, linking to a page (that opens in a new tab) explaining why your related posts are trustworthy. Bibblio is a hallmark of clarity in a climate of increasing distrust. Adding this information link to your module assures your audience that these recommendations are credible and genuine, rather than advertising or clickbait.

 

Tile Ratio

The ratio of each tile can be set so that your post's featured image can appear nicely as a background.

Wide - 16:9 ratio.

4:3 - 4:3 ratio.

Square - 1:1 ratio.

Tall - 2:3 ratio.

If you do not use featured images in your posts, you can use the Text-only layout instead.

If you were to use a tiled layout without featured images, each tile would display a watermarked pattern. You can change this and any other design elements by overriding specific module classes in your own style sheet, provided it loads after Bibblio's CSS file in the page head. This action requires an understanding of Cascading Style Sheets (CSS) and should only be attempted if you are confident with them.

Tip: If you usually have very long titles, consider using a ratio that would fit a lot of text, such as 'Square' or 'Tall'.

 

Text

You can set the font style and size of the headline in each tile. For legibility, the description below the title remains as the Arial font.

If you use a non system font for headlines and want to use that instead, do this by overriding our stylesheet with your own.

You can change anything you like by overriding our stylesheet! If you find a change isn't appearing on your page, add !important after the parameter, to force it to override.

Invert to white - Changes the text color to white for legibility on dark themed websites, where applicable.

 

Image

Vertical alignment - Anchor the top, middle or bottom of all of your featured images to its tile edge. This is useful if you've been creating featured images that always have their focal point in a certain area of the picture.

Hover for shine effect - A white glint appears across the right side of a tile when the cursor passes over it.

Hover for spectrum effect - A spectrum of color appears across the right side of a tile when the cursor passes over it. 

 

Properties

Author - Displays the name of the post author.

Date published - Displays the date the post was first published.

Site domain - Displays the top-level domain of the page being linked to. This only appears if you are running Syndication on your modules. Find out more here.

 

Display

Hover for title - Hides all titles, revealing them only when the cursor hovers over each tile (Text upon image arrangement only).

Hover for properties - Hides all properties, revealing them only when the cursor hovers over each tile (Text upon image arrangement only).

Hover for preview - Reveals a preview of the page's content when the cursor hovers over each tile.

 

Recommendation Type

You can influence how the plugin decides which related posts it should display.

For example, you could set the plugin to consider relevant posts that are more popular than others.

Click on the Module Settings button. Under Recommendation Type, choose one of the following from the dropdown:

Improved page views - Optimize the module for relevant suggestions that are also influenced by their popularity.

Relevance only - Optimize the module for relevant suggestions based purely on their content.

When done, be sure to click Update.

 

Tracking

You can append additional query string parameters to the target url of recommended items in the module designer. This is especially useful for specifying analytics parameters, such as utm_source.

For example, you could add something like the following query string parameter:

Name:utm_source
Value: Bibblio_Module

and utm_source=Bibblio_Module would then be appended to the target url of each recommendation, allowing you to monitor recommendation performance closely.

Click on the Module Settings button. Under Manage Tracking, click Add new tracking parameter to assign a name and value.

When done, be sure to click Update.

 

Management

When you are happy with how your module looks, you can create a name for it and save it. Saved modules can be viewed and edited via the large buttons across the top of the Modules panel.

You can also delete modules at any point. Be sure to check your side bars and footers before deleting a module that may be in use.

Inserting Shortcodes

WordPress version 4: You can display a Related Posts module within the body of your post. When editing a post in 'Visual' mode, click on the line you would like the module to appear on, then click on Bibblio's "Insert Shortcode" icon in the toolbar.

Insert shortcode button

WordPress version 5 (Gutenberg editor): You can add a Related Posts module within the body of your post by adding a classic block, click on the line you would like the module to appear on, then click on Bibblio's "Insert Shortcode" icon in the toolbar. 

Nb. If you're using the Classic Editor plugin, we are not yet integrated into this, so you can instead grab a Bibblio shortcode from this How-to guide and paste it directly into the editor.

Insert shortcode button on Gutenberg

A popup window will ask you to select which of your modules you'd like to insert. Choose one and click OK.

Choose your module

 

The shortcode is dropped into your post and contains each of the classes needed to render your module as you want it. After which you can publish or update as necessary.

Shortcode tag example

 

Repeat this with any other posts on an ad hoc basis or instead add it to your template using PHP code in the source, replacing “SHORTCODE” with your Bibblio shortcode:

One shortcode displays per post.

<?php echo do_shortcode('[SHORTCODE]'); ?>

Support

If you're having difficulties with the plugin please check out our WordPress Troubleshooting page.

We'd love to hear any questions, comments and suggestions you have! Please do get in touch.