Skip to main content

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

Project description

coop_cms is a Content Management System (CMS) for Django

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).
  • coop_html_editor, integration of in-site html editors._
  • colorbox, make easy integration of jquery colorbox library.

Quick start

Python 3, Django >=2.0, < 3.0 required

Install it with pip install apidev_coop_cms

At the very end of your file, add:

urlpatterns += [
    url(r'^html-editor/', include('coop_html_editor.urls')),
    url(r'^', include('coop_cms.urls')),
    url(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.


    'coop_cms.middleware.PermissionsMiddleware',  # Optional: redirect to login when PermissionDenied is raised


    'coop_cms.apps.email_auth.auth_backends.EmailAuthBackend',  # Optional -> login with email rather than username
    'django.contrib.auth.backends.ModelBackend', # Django's default auth backend

    # Contribs

    # 3rd parties
    'registration', # Optional

    # apps
    'coop_cms.apps.coop_bootstrap', # Optional -> utilities for Bootstrap CSS framework
    'coop_cms.apps.email_auth', # Optional -> login with email rather than username

    # 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

# 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

# Populate the urls when editing <a> tag in HTML editor

# Optional: you can overload the aloha plugins used by coop_cms --> see coop_html_editor docs for details

# Optional: you can change the jquery version used by aloha --> see coop_html_editor docs for details
ALOHA_JQUERY = 'js/jquery.1.7.2.js'

# Optional : you can customize the whole behavior of aloha by proving the url of config file.
# It will overload the config provided by coop_html_editor --> see coop_html_editor for details
ALOHA_INIT_URL = '/static/js/my_aloha_config.js'

# Default size of the article logo. Can be changed in template

# 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'
#     ('standard.html', 'Standard'),
#     ('homepage.html', 'Homepage'),
#     ('blog.html', 'Blog'),
# )

# Prefix for making absolute links

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

COOP_CMS_REPLY_TO = '"Your name" <>'

# Email address to send a newsletter test
    '"Your name" <>',

# tuples of templates that can be used for a newsletter.
    ('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 %}

Just before </body> at the end of the document:

{% coop_bar_footer %}

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


If you want to make an international site, coop_cms works well with django-modeltranslation.

We recommend to remove django-modeltranslation from the apps when making the model migrations

if not (len(sys.argv) > 1 and sys.argv[1] in (‘makemigrations’, )):
INSTALLED_APPS = (‘modeltranslation’, ) + INSTALLED_APPS

The model migrations wil not take the translation fields into account and it will be easier to add or remove languages with the following commands

python sync_translation_fields –noinput python update_translation_fields


apidev-coop-cms is a fork of credis/coop_cms and uses BSD license see license.txt.

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

Project details

Release history Release notifications

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for apidev-coop_cms, version 1.5.3
Filename, size File type Python version Upload date Hashes
Filename, size apidev-coop_cms-1.5.3.tar.gz (1.0 MB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page