How to Add DjangoCMS Blog i.e. News Config

Steps

This document assumes djangocms-blog is already installed with one config.

1. Add Blog config i.e. "apphook" config.

   1. Open CMS Administation UI.
   2. In section "DJANGO CMS BLOG", add a Blog config.
   3. Talk a CMS admin aware of the client needs³ to set the following values:
      • INSTANCE NAME: Uncertain. Set to the same value as "APPLICATION TITLE". (default: "Blog")
      • APPLICATION TITLE: Title of the BlogConfig instance created by Auto setup. (default: "Blog")
      • OBJECT NAME: The CMS name for a Blog item. (default: "Article")
   4. (Optional) Ask a CMS admin aware of the client needs³ for remaining values.

2. Add Blog instance i.e. "apphook" to a Page.

   1. Open CMS Administation UI.
   2. In section "DJANGO CMS", add a Page.
   3. Talk a CMS admin aware of the client needs³ to set the following values:
      • TITLE
      • SLUG
   4. Save the page.
   5. Edit the Page's Advanced Settings.
   6. Set the following values:
      • ATTACHED MENU: "Blog menu"
      • APPLICATION: "Blog"
      • APPLICATION CONFIGURATIONS: (appears only after choosing APPLICATION) (Check whether auto-set value is accurate.)
   7. Publish page.*
   8. Restart server.*
   
   

   ﹡ Page must be published before server restart. Otherwise, new page will not render blog content.

3. Confirm djangocms_blog app is installed and active.

   1. Open CMS Pages admin UI. New page has 🧩. icon?﹡
   2. Open Blog/News page while logged in. Admin toolbar has "Blog" link?
   3. Open CMS Administation UI. Section "DJANGO CMS BLOG" exists?
   
   

   ﹡ In same column where Home page has 🏠. icon.

4. Confirm new Blog instance is working.

   1. Add and publish an article. Article shows up on new page?
   2. Open new page while logged in. Page shows "No articles found"?
   
   

   ☑ If article is not published, it will not show.