coop-cms 0.5.1

Small CMS built around a tree navigation open to any django models

Coop-cms, a really pluggable CMS

• Yet another CMS ?

• Quick start

Yet another CMS ?

1. Coop-cms is built around Articles. It defines a basic abstract model so you can define your own model.

2. It has a website tree in a nice admin widget, to let you order Articles and any other standard django model you’ve defined in your project.

3. Based on the tree, you get templatetags for menu navigation, siblings links, breadcrumb, etc

Coop-cms has some sister apps to make it more usable:

• coop_bar, an extensible toolbar (same concept : any app you create can add links in the toolbar)

• djaloha, a great in-site editor based on Aloha Editor

• colorbox, make easy integration of jquery colorbox library.

Quick start

Python 2.6+, Django 1.3+ required

Install it with pip install coop-cms

urls.py

At the very end of your urls.py file, add:

urlpatterns += patterns('',
    (r'^djaloha/', include('djaloha.urls')),
    (r'^', include('coop_cms.urls')),
    (r'^coop_bar/', include('coop_bar.urls')),
)

Please note that coop-cms will handle any page slug, except the ones you will have defined before.

settings.py

In settings.py:

MIDDLEWARE_CLASSES = (
    'django.middleware.common.CommonMiddleware',
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.middleware.csrf.CsrfViewMiddleware',
    'django.contrib.auth.middleware.AuthenticationMiddleware',
    'django.contrib.messages.middleware.MessageMiddleware',
    'pagination.middleware.PaginationMiddleware',
    ...
)

TEMPLATE_CONTEXT_PROCESSORS = (
    "django.contrib.auth.context_processors.auth",
    "django.core.context_processors.debug",
    "django.core.context_processors.i18n",
    'django.core.context_processors.request',
    "django.core.context_processors.media",
    "django.core.context_processors.static",
    "django.contrib.messages.context_processors.messages",
    ...
)

AUTHENTICATION_BACKENDS = (
    'coop_cms.perms_backends.ArticlePermissionBackend',
    'django.contrib.auth.backends.ModelBackend', # Django's default auth backend
)

INSTALLED_APPS = (
    # Contribs
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.sites',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'django.contrib.admin',
    'django.contrib.admindocs',

    #3rd parties
    'south',
    'django_extensions',
    'sorl.thumbnail',
    'floppyforms',
    'pagination',
    'chosen', #optional but recommended. You must install it separately

    #apps
    'coop_bar',
    'djaloha',
    'colorbox',
    'coop_cms',

    #The coop_cms Article is an abstract model, you must define an Article in one of your app
    #We provide 2 apps that can be used if needed. Choose one or the other
    #'coop_cms.apps.basic_cms', #Nothing else than a concrete Article model.
    'coop_cms.apps.demo_cms', #A ready-to-use example app.

    #The app below make possible to create articles from a RSS feed. Add it if needed
    'coop_cms.apps.rss_sync',
)

#These are settings to customize the CMS behavior. The values are just examples and correspond to the demo_cms app.

#Define the Concrete Article to use. Not required if basic_cms is used
COOP_CMS_ARTICLE_CLASS = 'coop_cms.apps.demo_cms.models.Article'

#Define a custom form for Article editing. Not required if basic_cms is used
COOP_CMS_ARTICLE_FORM = 'coop_cms.apps.demo_cms.forms.ArticleForm'

#Make possible to customize the menus in the admin bar. Optional.
#If not defined, the tuple is build with the coop_bar_cfg modules of all INSTALLED_APPS
COOPBAR_MODULES = (
    'coop_cms.apps.demo_cms.my_coop_bar',
)

#Populate the urls when editing <a> tag in Aloha editor
DJALOHA_LINK_MODELS = (
    'demo_cms.Article',
)

#Default size of the article logo. Can be changed in template
COOP_CMS_ARTICLE_LOGO_SIZE = "128x128"

#Templates that can be used for an article
#It can be a tuple or a function returning a tuple
COOP_CMS_ARTICLE_TEMPLATES = 'coop_cms.apps.demo_cms.get_article_templates'
#COOP_CMS_ARTICLE_TEMPLATES = (
#    ('standard.html', 'Standard'),
#    ('homepage.html', 'Homepage'),
#    ('blog.html', 'Blog'),
#)

#Prefix for making absolute links
COOP_CMS_SITE_PREFIX = 'http://127.0.0.1:8000'

#from email : the domain of this address should allow the IP of your SMTP server : See SPF
COOP_CMS_FROM_EMAIL = '"Your name" <[e-mail]>'

#TODO : REPLY-TO
COOP_CMS_REPLY_TO = '"Your name" <[e-mail]>'

# Email address to send a newsletter test
COOP_CMS_TEST_EMAILS = (
    '"Your name" <[e-mail]>',
)

#tuples of templates that can be used for a newsletter.
COOP_CMS_NEWSLETTER_TEMPLATES = (
    ('basic_newsletter.html', 'Basic'),
    ('special_newsletter.html', 'With sections'),
    ('sortable_newsletter.html', 'Sortable sections'),
)
#optional : A custom form for editing the newsletter
COOP_CMS_NEWSLETTER_FORM = 'coop_cms.apps.demo_cms.forms.SortableNewsletterForm'

Base template

You need to create a base template base.html in one of your template folders. The article.html will inherit from this base template.

You need the following templatetags libs:

{% load coop_navigation coop_bar_tags %}

In the <head> of the document:

{% coop_bar_headers %}
{% block jquery_declaration %}{% endblock %}
{% block extra_head %}{% endblock %}

In the <body> of the document:

{% block document %}...{% endblock %}
{% coop_bar %}

You can also put some navigations in the <body>:

{% navigation_as_nested_ul %}

The navigation_as_nested_ul templatetag accepts several args

• tree=”english” –> The name of the navigation_tree to use. “default” if missing

• li_template=”dropdown_li.html” –> a template for every <li> tags

• ul_template=”dropdown_ul.html” –> a template for every <ul> tags

• li_args=”dropdown_li_class.html” —> args to be used for any <li> tags

There are others templatetags for navigation : navigation_breadcrumb, navigation_children, navigation_siblings with similar behavior

Going further

You can look at the demo_app in apps folder to see how to customize the behavior of coop_cms:

• Editable “pieces of HTML” in your page : A editable block that can be shared by several pages.

• Custom templates for articles and newsletters

• Custom fields in article

• Custom admin bar

• Configuration values

License

coop-cms uses the same license as Django (BSD).

coop-cms development was funded by CREDIS, FSE (European Social Fund) and Conseil Regional d’Auvergne.