forked from varia/varia.website
many many many Varia's websites, work in progress: https://many.vvvvvvaria.org
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
mb@mb
04c2824180
|
7 years ago | |
---|---|---|
.. | ||
Readme.rst | 7 years ago | |
__init__.py | 7 years ago | |
related_posts.py | 7 years ago |
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.