Quick Start Guide

Get going with Bibblio's auto-ingestion wizard

My Checklist

Before you proceed with setup, make sure each of these are true:
  • My site is not password protected
  • I’m using canonical tags on my URLs
  • I have more than five content items
  • I have access to my content template, or use a plugin that easily inserts PHP code snippets

Getting Started

Create a Bibblio account. You can pick a free plan for testing or one that suits your catalogue size and traffic.

Once you’ve verified your account via the email we sent you, and logged in, you’ll see our Quick Start code generator.

STEP 1

Check your whitelist

Check the correct domain has been whitelisted. Add more by clicking “Set a domain to whitelist”. This should all be in lowercase, and include subdomains like blog.mydomain, as well as your staging environments.

STEP 2

Choose your module design

Go for the default row of three tiles, or click “Change layout” to alter the configuration, image ratio and any effects you’d like. You can always make further adjustments later.

TIPS

Going for a side widget? We definitely recommend a column, since rows will get squished in a sidebar.

Want the module to match your theme? You can take it to the next level by overriding our css within your own stylesheet.

STEP 3 (optional)

Add tracking parameters

Using Google Analytics? You can add utm parameters to the code snippet to track us on your analytics platform. Click Create new tracking parameter. Add a name for the parameter and its value, then click Add to snippet. A line in your snippet will look similar to this:

data-query-string-params="PARAMETER_NAME=PARAMETER_VALUE"

Repeat this process for each parameter you would like added. 

STEP 4

Copy and paste your snippets into your code

You can then drop the generated code into your website.

The first snippet (4a) imports your content to Bibblio. Copy and paste this into each template that you want to import content from. You need this only once per template, regardless of the number of modules you use.

Do not add it to your master template, else it will import everything. If you add it to your theme via a widget that spans your entire site, we will import content that's unfit for recommendations (contact forms, legal info, category pages, etc.). Instead, make sure it's only added to the relevant content section of your template. (E.g. In a standard WordPress theme it would be added to: partials > single > content.php )

The second snippet (4b) displays a module on your pages. Add the second snippet in the content templates that you'd like your module to appear. If you create different module layouts you can copy and paste this snippet each time. (Feel free to hold off adding this snippet until you’re ready to go live with the module - just keep it safe.)

Once this is done, you can see Bibblio in action on your website. Check out the additional steps below for further features and controls.

ADDITIONAL STEPS

Separate your content

You can use our catalogue function to separate content into folders, or “catalogues”. This is useful if your site's multilingual or you have a products section that you wouldn’t want appearing in your articles’ recommendations.

Copy the snippet in step 4a and paste it in your template. Then copy and paste the property below into the snippet's script tag, replacing YOUR_CATALOGUE_NAME with a unique name of your choosing.

data-auto-ingestion-custom-catalogue-id="YOUR_CATALOGUE_NAME"

If required, you can repeat this process with different catalogue names for other templates.

If you’re using the same template for these different types of content, you can use conditional statements to load different Bibblio snippets depending on the content type.

Hide Bibblio during the installation

If you want to get going but haven't decided on a placement for the module yet, you can start by only adding the first snippet on the Quick Start code generator (4a). It will import your content to Bibblio and generate recommendations which you can check in the "Content" section of your account.

Once you're ready, you can then add the div snippet (4b) where you want the recommendations to be displayed.

You can also add the module to your site but hide it from view by adding the following property to the div:

data-hidden=true

When testing, you can type the following into the developer console to reveal all hidden modules on the page:

Bibblio.showModules();

Don’t forget to remove the "data-hidden" property from the snippet when you're ready to display the recommendations.

Choose a recency setting

If your site has lots of content but only the most recent stuff is likely to be relevant to your audience (such as a news site), you can prioritize recency so that content published within a chosen period is more likely to appear as recommendations. (Older content may still appear, but only if it’s extremely relevant.)

In your dashboard, go to Content in the top bar. Slide the slider in the right column to the period that suits your content type - fewer days for sites with topical articles, more days for those with evergreen content.

Prioritize recency so that content published within a chosen period is more likely to appear as recommendations.

Add a great title

If you want the related content module to stand out, give it a great header that will help your readers know they’re getting more of your own content, and won’t be re-directed elsewhere. “You Might Also Like” or “We Recommend” will do the trick.

 

Support

If you're having difficulties with the Quick Start wizard, please check out our FAQ and troubleshooting page.