This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

djangocms-oscar eases integration between the content management system django CMS and the e-commerce framework Oscar.

It is in an early stage, so use at your own risk.


  • base.html template which means that the django CMS toolbar works both on CMS pages and Oscar views
  • Ships with default CMS templates that share the look with Oscar’s sandbox pages
  • Oscar’s “Browse store” dropdown includes CMS pages
  • A “Featured product” CMS plugin to be able to add individual products on CMS pages

Tested with

  • django-cms 3.0.2
  • django-oscar >=0.7.1, <0.8
  • Django 1.5.8
  • Python 2.7

NOTE: Currently, django CMS does not play well with the new @atomic decorator introduced in Django 1.6. Use django CMS from the master branch, or wait for the next release.


Grabbing the integration

The latest release will be on PyPi, so you can just pip install djangocms-oscar. Or grab it from the master branch if you prefer the bleeding edge.

Adding django CMS to an Oscar project

If you have a working Oscar project and want to add django CMS, follow the instructions on integrating django CMS.

You should also add at least one plugin to be able to set content. This probably want to add djangocms-text-ckeditor to be able to include text.

Adding Oscar to a django CMS project

If you have a working django CMS project and want to integrate Oscar, follow the instructions on getting started with Oscar.


There’s two options to include Oscar’s URLs.

This integration comes with an app hook for django CMS. So you can just let django CMS take care of URL handling by adding Oscar to a CMS page.

If you prefer to hard-wire Oscar’s URLs into your project’s, make sure that django CMS’s URLs come after Oscar’s.urls:

urlplatterns = [
   (r'^shop/', include(shop.urls)),
   (r'^', include('cms.urls')),

Setting up the integration

To get started using djangocms-oscar:

  • install it with pip:

    $ pip install djangocms-oscar
  • add the plugins to INSTALLED_APPS:

  • To use the supplied templates, they need to be loaded before Oscar’s:

    from oscar import OSCAR_MAIN_TEMPLATE_DIR
    from djangocms_oscar import OSCAR_CMS_TEMPLATE_DIR
  • Run syncdb or migrate if you’re using South.

Optional settings

Besides customised Oscar templates, djangocms-oscar comes with a set of CMS templates that are based on Oscar’s default templates. They’re a good starting point and can be used like this:


    ('djangocms_oscar/full_width.html', 'Full width (no sidebars)'),
    ('djangocms_oscar/with_sidebar.html', 'Two column (left-hand sidebar)'),

If you want Oscar’s homepage to be controlled by django CMS, set it like this:


from django.core.urlresolvers import reverse_lazy
OSCAR_HOMEPAGE = reverse_lazy('pages-root')
Release History

Release History


This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
djangocms-oscar-0.1.tar.gz (6.4 kB) Copy SHA256 Checksum SHA256 Source Jul 7, 2014

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting