djangocms-blog-agenda

Add an Agenda to your blog that displays upcoming events!

Easy! CheapFree! Not seen on TV!

---

Install

• Install the package

  python3 -m pip install djangocms-blog-agenda
  

• Add it in your INSTALLED_APPS:

  
      "djangocms_blog_agenda",
  

• Run the migration:

  python3 manage.py migrate djangocms_blog_agenda
  

• Update the djangocms-blog urls by the ones in this module, by using this lovely setting:

  BLOG_URLCONF = "djangocms_blog_agenda.patched_urls"
  

• Create a new blog configuration.

  • Instance namespace: put what you want.
  • Application title: put what you want.
  • Object name: put what you want.
  • [...]
  • Click on Layout (Show):
    • [...]
    • Template prefix: djangocms_blog_agenda.

    That's very important since this application will check this value multiple times (to update the queryset, to check the templates, to add the post extension "event date" only to the Agenda app...).

  • Save this config.

• 

---

Explanations/Views/Misc

• A new Event date DateTime field has been added to blog posts that have the template prefix set to djangocms_blog_agenda.
• A new post list view was created for the Agenda view, it includes all the posts where the event_date is set to a date in the future.
• Another view is available at _("/past/"), that will display each post where the event_date is in the past.
• The templates are not in djangocms_blog/templates anymore, but in djangocms_blog_agenda/templates. Something's not appearing on your templates? Try to edit the file in djangocms_blog_agenda/templates/!
• We removed the mention of comments & liveblog in the admin form, because we're not using this.
• We use some very special bits of code that are using some internal features of djangocms-blog (see misc.py, and apps.py). Try the module before pushing an update.

---

Config

Multisite

This modules handles multisite just fine; just add BLOG_MULTISITE = True in your settings, and our module will inject the get_site function directly inside the class returned by get_user_model()!

You will then need to create a new "Global Page Permission" entry with your user/group, and to select the site where the user/group will have the right to post new articles/agenda posts.

If you're curious about this function, here it is.