Switch branches/tags
Nothing to show
Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.

Readme.rst

Related posts

This plugin adds the related_posts variable to the article's context. By default, up to 5 articles are listed. You can customize this value by defining RELATED_POSTS_MAX in your settings file:

RELATED_POSTS_MAX = 10

You can then use the article.related_posts variable in your templates. For example:

{% if article.related_posts %}
    <ul>
    {% for related_post in article.related_posts %}
        <li><a href="{{ SITEURL }}/{{ related_post.url }}">{{ related_post.title }}</a></li>
    {% endfor %}
    </ul>
{% endif %}

Your related posts should share a common tag. You can also use related_posts: in your post's meta data. The 'related_posts:' meta data works together with your existing slugs:

related_posts: slug1, slug2, slug3, ... slugN

N represents the RELATED_POSTS_MAX.

Additionally, you can specify:

RELATED_POSTS_SKIP_SAME_CATEGORY = True

in your settings file. With this setting, article.related_posts will contain only related posts from categories other than the original article's.