forked from varia/varia.website
.. | ||
__init__.py | ||
Readme.rst | ||
related_posts.py |
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.