lowtechmag-solar-plugins/related_posts

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.