djangocms-blog-expiry-date

Extension for django CMS blog that adds an optional expiry date per post.

Installation

1. Install the package:

   python3 -m pip install djangocms-blog-expiry-date
   

2. Add it to INSTALLED_APPS:

       "djangocms_blog_expiry_date",
   

3. Run migrations:

   python3 manage.py migrate djangocms_blog_expiry_date
   

4. Update your templates to load the templatetag, and use it to test if the post is expired

   {% load djangocms_blog_expiry_date_tags %}
   
   {% post_expiry_expired post as post_expired %}
   {% if post_expired %}
     {# show a notice, or hide booking links, etc. #}
   {% endif %}
   

Behaviour

post_expiry_expired (Python)

djangocms_blog_expiry_date.utils.post_expiry_expired(post) returns:

• True if an extension linked to post has _meta.app_label == 'djangocms_blog_expiry_date' and is_expired() is True for that instance.
• False if post is None, there is no such extension, expiry_date is empty, or the date is still in the future.

Extensions whose model belongs to another app are ignored (so several extension types can coexist on the same post).

Template tag

Load the tag library, assign the result, then branch (simple tags must use the as form to work inside {% if %}):

{% load djangocms_blog_expiry_date_tags %}

{% post_expiry_expired post as post_expired %}
{% if post_expired %}
  {# show a notice or hide booking links, etc. #}
{% endif %}

This uses the same rules as post_expiry_expired() above.

Calling is_expired on a single extension

If you know the extension is this app’s model (e.g. only one extension type), you can still use:

{% with ext=post.extension.first %}
  {% if ext and ext.is_expired %}
    …
  {% endif %}
{% endwith %}

Optional settings

Multisite

With BLOG_MULTISITE = True, the app registers a get_sites function on the user model (see apps.py), using django CMS global page permissions.

Tests

Install test dependencies using the following commands:

python3 -m venv .venv
. .venv/bin/activate
python3 -m pip install -e ".[test]"

Launch tests using these commands:

. .venv/bin/activate
pytest