varia.website/plugins/related_posts
2018-02-01 14:46:15 +01:00
..
__init__.py adding the 2 submodules again 2018-02-01 14:46:15 +01:00
Readme.rst adding the 2 submodules again 2018-02-01 14:46:15 +01:00
related_posts.py adding the 2 submodules again 2018-02-01 14:46:15 +01:00

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.