Mezzanine is a content management platform built using the Django framework. It is BSD licensed and designed to provide both a consistent interface for managing content, and a simple, extensible architecture that makes diving in and hacking on the code as easy as possible.
Mezzanine resembles tools like Wordpress, with an intuitive interface for managing pages, blog posts, form data, store products, or any other type of content you can imagine. Mezzanine takes a different approach from other Django applications in this space like Pinax or Mingus that glue together a lot of reusable apps, instead opting to provide most of its functionality included with the project by default.
Visit the Mezzanine project page to see some of the great sites people have built using Mezzanine.
On top of all the usual features provided by Django such as MVC architecture, ORM, templating, caching and the automatic admin interface, Mezzanine provides the following features:
- Hierarchical page navigation
- Save as draft and preview on site
- Scheduled publishing
- Drag-n-drop page ordering
- WYSIWYG editing
- In-line page editing
- Drag-n-drop HTML5 forms builder with CSV export
- Custom templates per page or blog post
- Twitter Bootstrap integration
- API for custom content types
- SEO friendly URLs and meta data
- Search engine and API
- Configurable dashboard widgets
- Seamless integration with third-party Django apps
- Multi-device detection and template handling
- Shopping cart module (Cartridge)
- Blogging engine
- One step migration from other blogging engines
- Disqus integration or built-in threaded comments
- Gravatar integration
- Google Analytics integration
- Twitter feed integration
- bit.ly integration
- Akismet spam filtering
- Sharing via Facebook or Twitter
- Built-in test suite
- User accounts and profiles with email verification
The Mezzanine admin dashboard:
Mezzanine makes use of as few libraries as possible, apart from a standard Django environment. The following dependencies are used:
- Python 2.5 ... 2.7
- Django 1.3 ... 1.4
- Python Imaging Library - for image resizing
- grappelli-safe - admin skin (Grappelli fork)
- filebrowser-safe - for manaaging file uploads (FileBrowser fork)
- bleach - for sanitizing markup in content
- pytz - for timezone support
- South - for database migrations (optional)
- django-compressor - for merging JS/CSS assets (optional)
- pyflakes and pep8 - for running the test suite (optional)
Mezzanine's admin interface works with all modern browsers. Internet Explorer 7 and earlier are generally unsupported.
The easiest method is to install directly from pypi using pip by running the respective command below, which will also install the required dependencies mentioned above:
$ pip install -U mezzanine
Otherwise you can download Mezzanine and install it directly from source:
$ python setup.py install
Once installed, the command
mezzanine-project should be available
which can be used for creating a new Mezzanine project in a similar
$ mezzanine-project project_name $ cd project_name $ python manage.py createdb --noinput $ python manage.py runserver
createdb is a shortcut for using Django's
command and setting the initial migration state for South. You
can alternatively use
migrate if preferred.
South is automatically added to INSTALLED_APPS if the
setting is set to
You should then be able to browse to http://127.0.0.1:8000/admin/ and
log in using the default account (
username: admin, password: default).
If you'd like to specify a different username and password during set
up, simply exclude the
--noinput option included above when running
For information on how to add Mezzanine to an existing Django project, see the FAQs section of the documentation.
Mezzanine is an open source project that is managed using both Git and Mercurial version control systems. These repositories are hosted on both GitHub and Bitbucket respectively, so contributing is as easy as forking the project on either of these sites and committing back your enhancements.
Please note the following points around contributing:
- Contributed code must be written in the existing style. This is as simple as following the Django coding style and most importantly PEP 8.
- Contributions must be available on a separately named branch that is based on the latest version of the main branch.
- Run the tests before committing your changes. If your changes causes the tests to break, they won't be accepted.
- If you're adding new functionality, you must include basic tests and documentation.
Mezzanine makes full use of translation strings, which allows it to be translated into multiple languages using Django's internationalization. Translations are managed on the Transiflex website, but can also be submitted via GitHub or Bitbucket. Consult the documentation for Django's internationalization for more information on creating translations and using them.
The following modules have been developed outside of Mezzanine. If you have developed a module to integrate with Mezzanine and would like it listed here, send an email to the mezzanine-users mailing list.
- mezzanine-html5boilerplate - Integrates the html5boilerplate project into Mezzanine.
- mezzanine-mdown - Adds Markdown support to Mezzanine's rich text editor.
- mezzanine-openshift Setup for running Mezzanine on Redhat's OpenShift cloud platform.
- mezzanine-stackato Setup for running Mezzanine on ActiveState's Stackato cloud platform.
- mezzanine-blocks Mezzanine + django-flatblocks.
- mezzanine-widgets Widget system for Mezzanine.
If you would like to make a donation to continue development of the project, you can do so via the Mezzanine Project website.
To report a security issue, please send an email privately to email@example.com. This gives us a chance to fix this issue and create an official release for it, prior to the issue being made public.
For general questions or comments, please join the mezzanine-users mailing list. To report a bug or other type of issue, please use the GitHub issue tracker. There's also a #mezzanine IRC channel on Freenode, so drop by for a chat.
Sites Using Mezzanine
- Citrus Agency
- Mezzanine Project
- Nick Hagianis
- Thomas Johnson
- Central Mosque Wembley
- Ovarian Cancer Research Foundation
- The Source Procurement
- Brad Montgomery
- Jashua Cloutier
- Alpha & Omega Contractors
- Equity Advance
- Head3 Interactive
- Ripe Maternity
- Cotton On
- List G Barristers
- Tri-Cities Flower Farm
- ARA Consultants
- Boîte à Z'images
- The Melbourne Cup
- Diablo News
- Goldman Travel
- IJC Digital
- Joe Julian
- Sheer Ethic
- Salt Lake Magazine
- Boca Raton Magazine
- Elephant Juice Soup
- National Positions
- Like Humans Do
- Connecting Countries
- Environmental World Products
- "I'm enjoying working with Mezzanine, it's good work" - Van Lindberg, Python Software Foundation chairman
- "Mezzanine looks like it may be Django's killer app" - Antonio Rodriguez, ex CTO of Hewlett Packard, founder of Tabblo
- "Mezzanine looks pretty interesting, tempting to get me off Wordpress" - Jesse Noller, Python core contributor, Python Software Foundation board member
- "I think I'm your newest fan. Love these frameworks" - Emile Petrone, integrations engineer at Urban Airship
- "Mezzanine is amazing" - Audrey Roy, founder of PyLadies and Django Packages
- "Mezzanine convinced me to switch from the Ruby world over to Python" - Michael Delaney, developer
- "Impressed with Mezzanine so far" - Brad Montgomery, founder of Work For Pie
- "From the moment I installed Mezzanine, I have been delighted, both with the initial experience and the community involved in its development" - John Campbell, founder of Head3 Interactive
- "You need to check out the open source project Mezzanine. In one word: Elegant" - Nick Hagianis, developer
- "Who came up with the name Mezzanine? I love it, like a platform between the client's ideas and their published website. Very classy!" - Stephen White, developer