WordPress Troubleshooting

Common questions to issues with the Related Posts by Bibblio plugin

A WPEngine Recommended Plugin

⚠️ Caching issue for our latest release

Do you see this error in your WP admin?

Failed to initialize plugin: bibblio_button_script

If so, this is because your browser has cached an old version of one of our files.

Fear not - there's an easy fix!

On the page where that message appears, open your Developer Console and go to the Sources tab. In the left panel, navigate to your plugins directory, then to:

bibblio_related_posts / admin / js / tinymce_buttons.js

Perform a hard refresh (Windows: Ctrl + F5, Mac: Cmd + Shift + R) and the problem disappears. If not, contact us!

Module display

 

My posts have been imported. What do I do next?

After importing, the final step is to just drop the module on your pages. Set the module to automatically appear beneath the content of all of your posts by either switching the setting to on and clicking Save when on the 'Add Module' step of the setup wizard, or by choosing a module from the dropdown and clicking Save from within the 'Modules' tab of the Bibblio plugin admin.

You can also add modules to other areas of your posts, such as the sidebar or footer, by navigating to Appearance > Widgets in the left-hand menu of your WordPress admin. Then in the Available Widgets column, drag and drop the Bibblio Related Posts widget into your page area of choice.

If you only want your module on specific posts, add it using a shortcode within the post editor. Read more...

Please note that, depending on the size of your catalog, you might need to wait 20-30 minutes the first time around to generate recommendations.

 

My module appears very squashed on my side bar

This is probably because a horizontally-shaped layout of tiles has been chosen and placed as a widget in your side bar. If you would like it to be a column of tiles, go to the "Modules" tab in your Bibblio plugin admin, select the module from the "My Modules" section, and alter the "Module Layout" to be a column of between one to five tiles. Click Update and your module should correct itself on your site. (Remember, you can make different modules for different parts of your pages, not just one.)

If you want your module to appear below your posts rather than as a column on the sidebar, see the question below...

 

How do I display recommendations on the bottom of the page, rather than in a sidebar?

You can set the module to automatically appear beneath the content of all of your posts. When you initially run the setup wizard, in the 'Add Module" step, go to the green "Now add the module to your posts" section, slide the setting to on (if necessary, alter the subtitle that will appear above the module) and click Save.

If you've already completed the setup, go to the "Modules" tab in your Bibblio plugin admin. There you'll see the "Automatically feature one module at the end of my posts" dropdown, which lists each of your modules. Choose one of these, (if necessary, alter the subtitle that will appear above the module) and click Save.

The widget can also be dragged into the footer of the page by going to Appearance > Widgets in your WordPress admin. There you’ll see a series of widgetized areas on the right. Expand the footer area you want to add the widget to (hover over it and click on the down arrow on the right), then drag the Bibblio widget to the expanded area.

 

Can I use shortcodes to display the recommendations?

Yes, you can use shortcodes to 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. A popup window will ask you to select which of your modules you'd like to insert. Choose one and click OK.

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

 

How do I insert shortcodes on every page?

If you'd like to use shortcodes across posts, you can drop the shortcode directly into the theme's template. Go to Appearance > Editor and navigate to the relevant post template. In the template's source code, in the section bracketed by <?php ... ?>, you can insert

echo do_shortcode('[YOUR BIBBLIO SHORT CODE]');

replacing "YOUR BIBBLIO SHORT CODE" with the shortcode (see previous question regarding getting your shortcode), and it will show up across all pages.

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

 

I've dropped the widget on the page, but it's not showing up.

If you've just installed the plugin, it can take up to 20-30 mintues for your content to be indexed. You can check that the module has been dropped on the page by navigating to your Developer Tools (Win: Ctrl + Shft + I. Mac: Cmd + Alt + I) and looking in the Elements tab (or Inspector tab in Firefox).

Click anywhere in the HTML panel and open the Find Text field (Win: Ctrl + F. Mac: Cmd + F). Then search for the text "bib_" to verify that the module has been dropped on the page.

If you can see the code but the module is still not visible, it's most likely being hidden by your theme. You’ll need to make the appropriate adjustments in your stylesheet to override any overzealous classes.

If you cannot see the code, double-check the Widgets tab in your WordPress admin to ensure that you’ve dropped the widget on the page.

If you added the code using Ad Inserter, our module might be getting blocked by your ad blocker. Disable it and refresh the page to see whether that is the case.

In either event, if the module still does not display, check to make sure that your JavaScript files are loading before the Bibblio module renders. If they’re not, you’ll most likely see an error in your Console tab such as: Uncaught ReferenceError: Bibblio is not defined or jQuery is not defined.

 

The recommendations aren't displaying the images from my posts.

Currently, the plugin will only pull images that have been set as featured images. If you’d like to convert your existing images into featured images, here’s a helpful plugin you can use.

For more information on using images, see our blog post Making the most of images on your Related Posts for WordPress plugin.

 

My images are blurry/low quality on the recommendations.

The plugin pulls in your featured images as "Medium" sized. By default, WordPress creates a medium-sized image by limiting the width or height (whichever is largest) to a maximum 300 pixels, scaling the image proportionally. When using some of our plugin layouts the image may have to stretch to fit a tile wider than 300 pixels. This causes the images to look blurry or of a low quality. We're looking into improvements to automatically resize your existing images to better display on your recommendations.

In the meantime, to ensure a better image quality for all of your future posts, go to Settings > Media, change the Medium size Max Width to 400 and Max Height to 600. Then click Save Changes. This will make all newly-created medium-sized images slightly larger, even in portrait orientation.

If you wish to change the "Medium" size of your existing featured images, there are a variety of plugins available to automatically resize them to your desired dimensions. Once complete, you will need to reimport your posts so that Bibblio knows the new image URLs for each. Please get in touch if you would like to clear your account to perform this.

 

Can I customize the title font and other elements?

If you want to change the font or text size of the headline, you can set these in your module editor. Go to Modules, select the module you wish to edit, and under "Headline Style" you can choose a recommended system font (to ensure it looks the same on Windows and Apple devices) and the text size.

If you wish to use a non-standard font for your headline, you can do this within your own stylesheet, altering the '.bib__title' class. (Be sure your stylesheet loads after ours, and include !important in the parameter to guarantee you'll override our settings.)

E.g.

.bib__title {
    font-family: “Roboto”, sans-serif !important;
}

You can use this class to override the headline color and similar parameters.

Alternatively, if you wish to change the font for the entire module (including the author, date and description in all tiles) you can use your stylesheet again, but this time targeting the '.bib__info' class. (We recommend a simple, sans-serif font is used for this small text to ensure legibility.)

E.g.

.bib__info {
    font-family: “Roboto”, sans-serif !important;
}

 

 

Post management

 

The module is recommending posts from my staging environment.

If you've used the same Bibblio credentials to import content from your testing and production site, these will all be stored in the same catalogue. Ask us to clear your catalogue and start fresh. You will need to go through the installation wizard again, so don't forget to make a note of your modules' settings.

We recommend using two accounts for live and staging. If you want to use the same email address for both accounts, use the "+" function. For example, jane.smith@mail.com and jane.smith+staging@mail.com.

If you want to keep one account only, just make sure you contact us once you're ready to move Bibblio to your live site: we'll clear your catalogue so that the staging urls don't appear in the recommendations.

 

I’ve installed the plugin, but my posts aren't importing.

Check to make sure that cron jobs are enabled. Open the wp-config.php file in the root of your WordPress installation and ensure the code DISABLE_WP_CRON is set to false.

A few other factors may be blocking the importer from running:

  • Your posts don't have a title and/or text
  • You are using a page builder that creates text "blocks", or "modules". these tend to output content as shortcodes, which we cannot import. Gutenberg Editor is fine!

If this applies to you, consider installing Bibblio with our Quickstart code instead.

 

How do I exclude individual posts from being recommended?

To exclude individual posts from your recommendations, just untick the box called Import post to Bibblio in the lower right-hand corner of the Edit Post page.

If you have a few posts you want to exclude from being recommended, you can use our "Bulk Edit" option. In your WordPress admin, go to Posts > Bulk Actions > Edit, select the posts you want to exclude and click Apply. In the panel that appears, select No from the "Import to Bibblio" dropdown.

 

How do I exclude certain post types or categories from being recommended?

When installing the plugin, you can indicate which post types to ingest. Simply unselect any types that you do not want to include in your recommendations.

You can't currently choose to display posts by category using our plugin. It's worth noting that since our recommender engine finds the most relevant posts for a piece of content, it is likely the recommendations will come from the same category anyway. 

If there is a specific reason why you would want to exclude a category from displaying in the recommendations (for example, not wanting product reviews to appear in a Bibblio widget you named "More Delicious Recipes"), talk to us about using the Quick Start code instead of the plugin.

 

Can I disconnect the plugin from one of my environments only?

No. Widget disconnection will apply to all of your environments at once. E.g. If you disconnect the widget from your development environment it will instantly disconnect from your live environment too.

Disconnection will 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.

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.

Support

If you haven't found the answer, perhaps our WordPress Guide can help.

If you're still having difficulties please get in touch and a member of Bibblio Support will be happy to assist.