How to Add DjangoCMS Blog i.e. News Config - TACC/Core-CMS GitHub Wiki

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. Have 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. Have a CMS admin aware of the client needs³ to set the following values:
      • TITLE (probably: "News")
      • SLUG (probably: "news")
   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. (maybe) Restart server.*
   
   

   ﹡ If the new blog page is not rendering blog menu nor content, first publish page. If still not, then restart server. (When the original author of this doc experienced a need to restart the server, that fix only worked if the page had already been published.)

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.