Recirculation Module Overview
Table of Contents
Introduction
The Recirculation Module allows you to add a sets of article links to the bottom of your articles. This allows users follow links to related articles, encouraging more clicks and longer sessions.
The set of articles shown to the user is dynamic. The app will talk to our server to get the latest and greatest list of articles at the time of viewing. So older articles may link to newer related content.
Placement
Standard Recirculation modules appears at the bottom of an article, below any boxouts or tags and above comments if you have them. They can be ordered in a fashion using a drop and drag interface in Express.
The module can also be placed inline using shortcodes. This can either be done manually, included in the article body from content feeds or using a template.
e.g
[pugpig_recirc type="section" term="Sport" text="Read Sport"]
Appearance
The title that appears above each recirculation module can be set in settings. You can set it to appear as Cards or in a List format, which is a bullet-pointed list without images.
Articles use the same article card that appears on the timeline, taking the same styling. These can be modified with some custom styling. Styling can be different per recirculation module type.
If there is no content returned for the module type, the entire module will be hidden.
Types
There are seven unique types of recirculation modules. For Enterprise customers they are available to be set directly via API.
More from the section
Pugpig will show more articles from the same Section as the main article.
More from the contributor
Pugpig will show more articles from the first Contributor of the main article.
Related Articles
Related articles is a specific set of articles related to the main article. It does not vary by user. You can send Pugpig an explicit list of articles IDs via API, or we will fall back to getting articles based on recommendation from Pugpig's new Suggestor.
Latest Articles
Pugpig will show the latest published articles in the app.
Most Popular
This is a list of the most read articles in the app. API only.
Editor's Pick
This is a curated list of article. It does not vary by user. API only.
Recommended for You
This is a custom list of article specifically recommend for the user. API only.
| API Required | User Token | |
|---|---|---|
| Related Articles | No | No | 
| More from the section | No | No | 
| More from the contributor | No | No | 
| Latest Articles | No | No | 
| Most Popular | Yes | No | 
| Editor's Pick | Yes | No | 
| Recommended for you | Yes | Yes | 
API
Enterprise customers can use an API to set any recirculation module. Pugpig will write a custom interface between your API and the app. Read more about the API here.


