Posts

Posts is a simple Django app for adding blog functionality to your Django CMS based website (placeholder that accepts installed CMS plugins: text, image, file, video, etc.). It supports multiple sections hooked to a page as an AppHook with front end editing as a normal Django CMS page. Multilanguage is also supported.

Quick start

1. Add "posts" to your INSTALLED_APPS setting like this:

   INSTALLED_APPS = [
       'modeltranslation', # included before all other apps
       ...
       'autoslug', # AutoSlug model field to auto-generate slug
       'model_utils', # model utilities (TimestampedModel mixin for created and modified fields)
       'cms',
       'posts',
   ]
   

2. App has dependencies so they should be included before the posts app

3. Run python manage.py migrate to apply the posts models.

NOTE: If you have more languages or a main language different than English execute python manage.py makemigrations before python manage.py migrate.

4. Add CMS_PLACEHOLDER_CONF to your settings.py file:

   CMS_PLACEHOLDER_CONF = {
       'post_detail': {
           'name': _("Post content"), # Change the placeholder name to whatever you prefer
           'excluded_plugins': ['LatestPostsPlugin'], # Exclude the Latest Posts Plugin to avoid Recursion Error
       },
   }
   

5. Start the development server and visit http://127.0.0.1:8000/admin/ to create sections and posts.

6. Create a new section and add its Namespace

7. Add a new page or hook the app to the existing page (Advanced settings -> Application: Select Posts from the dropdown -> Application Configuration: Select Section name from the dropdown -> Click Save)

8. Add new post from the Admin (POSTS: Posts -> Add new -> Add Title -> Select Section -> Click Save and continue editing -> Edit link appears to edit the page live)

9. View the page in your browser, your post list will be displayed with the link to the post detail

Notes

• Posts have a Published field to control whether they are visible in list view, however they can be edited while not visible from the admin using the Edit link
• When using multiple languages and editing in frontend, Post Edit link is generated for Administration language, set your language preference in User settings to match the default language, otherwise you will not see the generated Edit link

Using the Latest Posts Plugin

1. Add Latest Posts Plugin to an existing page placeholder (e.g. Main placeholder)
2. Choose Section from which to load posts
3. Select number of posts to load (1-100)

Supported versions

• Python 3.x
• Django 2.x
• Django CMS 3.3.x