============================ Django CMS 2.0 Content App

.. contents::

1. Introduction

Django CMS is a django app to build your content management site. It uses mptt to manage different pages to control the level relationships of your contents.

1.1 Why this?

• It's complicated if you have too many pages. Sometime you don't remember what page is and what relationships of these pages. Although Using static level to display content will be hard to render pages by different templates to some extend, I think the content itself is the hardcore not the templates.

• Without pagination as default settings like django-page-cms, the admin interface of django-cms use jquery to render tree. So the speed will be kind of slow by js render perfermence if you have a bunch of pages.

• The current version of django-cms(2.1.0 beta) menu tags will make a lot of queries(for caching menu) when the web server restart or pages are added. Although the cache will be recached in every 3600 seconds default, I think it's not a good choice to build the menu if your site is based on a lot of pages. The more pages your site have, the more queries made when caching menu. cms_content could be used to avoid these queries because you don't need to add pages every time to add new content.

django-cms has the ability to extend or integrate other app into it. So this app was being built as a simple three levels relationship content management which idea comes from joomla_ , a PHP CMS program.

.. _Django CMS: http://www.django-cms.org .. _mptt: http://code.google.com/p/django-mptt/ .. _joomla: http://www.joomla.org

2. Install

2.1 Dependencies

Because default WYSIWYG editor 'WYMEditor' support pygments code highlight, so django-cms-2.0-content has dependencies:

• BeautifulSoup_
• Pygments_

.. _BeautifulSoup: http://www.crummy.com/software/BeautifulSoup/ .. _Pygments: http://pygments.org/

2.2 Install

django-cms-content is now still in beta version. please use git to clone repositity:

::

git clone git://github.com/indexofire/django-cms-content.git

Install the app is simple like any other django app, you just need to insert cms_content into your INSTALLED_APP of your project settings file like this:

::

INSTALLED_APPS = ( ... 'cms_content', ... )

copy or link media/cms_content/ folder to your media folder.

Adding a page in admin and giving a name of it, for example 'content'. set attached menu to CMS Content Menu and application to CMS Section in the page's advanced settings. And if the content page has a root page whose name is 'cms', then the url for the cms will be /cms/content/ as default. Set the value of CMS_CONTENT_ROOT_URL to the url in your project's settings.py

::

CMS_CONTENT_ROOT_URL = '/cms/content/'

in admin, create your sections and categories, then add articles. After that open your browser, visit /cms/content/ URL, you will see the all your articles.

2.3 Setting

You can add these in settings.py

2.3.1 WYSIWYG Editor:

The default WYSIWYG editor is WYMEditor. You can use TinyMCE or MarkItUp by adding CMS_CONTENT_EDITOR in your project settings.py

::

CMS_CONTENT_EDITOR = 'TinyMCE'

2.3.2 Code highlight

There are some valuable could be define to custom code highlight. Put them in your settings.py

::

CMS_CONTENT_CODE_HIGHLIGHT = True CMS_CONTENT_CODE_HIGHLIGHT_CSS = 'code_highlight' CMS_CONTENT_CODE_HIGHLIGHT_LINENOS = True

2.4 Plugins

Latest Articles Plugin works now. Top Hit Articles Plugin is being working. There is a plan to add a Top Rate Articles Plugin into cms_content.