.. image:: https://img.shields.io/pypi/v/mezzanine.svg :target: https://pypi.org/project/mezzanine/ .. image:: https://img.shields.io/pypi/pyversions/mezzanine.svg :target: https://pypi.org/project/mezzanine/ .. image:: https://img.shields.io/pypi/djversions/mezzanine.svg :target: https://pypi.org/project/mezzanine/ .. image:: https://github.com/stephenmcd/mezzanine/workflows/Test%20and%20release/badge.svg :target: https://github.com/stephenmcd/mezzanine/actions?query=workflow%3A%22Test+and+release%22 .. image:: https://img.shields.io/badge/code%20style-black-000000.svg :target: https://github.com/psf/black

Created by Stephen McDonald <http://twitter.com/stephen_mcd>_

======== Overview

Mezzanine is a powerful, consistent, and flexible content management platform. Built using the Django framework, Mezzanine provides a simple yet highly extensible architecture that encourages diving in and hacking on the code. Mezzanine is BSD licensed and supported by a diverse and active community.

In some ways, Mezzanine resembles tools such as Wordpress_, providing an intuitive interface for managing pages, blog posts, form data, store products, and other types of content. But Mezzanine is also different. Unlike many other platforms that make extensive use of modules or reusable applications, Mezzanine provides most of its functionality by default. This approach yields a more integrated and efficient platform.

Visit the Mezzanine project page to see some of the great sites people have built using Mezzanine.

Features

In addition to the usual features provided by Django such as MVC architecture, ORM, templating, caching and an automatic admin interface, Mezzanine provides the following:

• Hierarchical page navigation
• Save as draft and preview on site
• Scheduled publishing
• Drag-and-drop page ordering
• WYSIWYG editing
• In-line page editing_
• Drag-and-drop HTML5 forms builder with CSV export
• SEO friendly URLs and meta data
• Ecommerce / Shopping cart module (Cartridge_)
• Configurable dashboard_ widgets
• Blog engine
• Tagging
• Free Themes_ Marketplace
• User accounts and profiles with email verification
• Translated to over 35 languages
• Sharing via Facebook or Twitter
• Multi-lingual sites_
• Custom templates_ per page or blog post
• Twitter Bootstrap_ integration
• API for custom content types_
• Search engine and API_
• Seamless integration with third-party Django apps
• One step migration from other blogging engines
• Disqus_ integration, or built-in threaded comments
• Gravatar_ integration
• Google Analytics_ integration
• bit.ly_ integration
• Akismet_ spam filtering
• JVM compatible (via Jython)

The Mezzanine admin dashboard:

.. image:: http://mezzanine.jupo.org/docs/_images/dashboard.png

Support

To report a security issue, please send an email privately to core-team@mezzaninecms.com_. This gives us a chance to fix the issue and create an official release prior to the issue being made public.

For all other Mezzanine support, the primary channel is the mezzanine-users_ mailing list. Questions, comments, issues, feature requests, and all other related discussions should take place here.

If you're certain you've come across a bug, then please use the GitHub issue tracker_, however it's crucial that enough information is provided to reproduce the bug, ideally with a small code sample repo we can simply fork, run, and see the issue with. Other useful information includes things such as the Python stack trace generated by error pages, as well as other aspects of the development environment used, such as operating system, database, and Python version. If you're not sure you've found a reproducible bug, then please try the mailing list first.

Finally, feel free to drop by the #mezzanine IRC channel on Freenode, for a chat! Lastly, communications in all Mezzanine spaces are expected to conform to the Django Code of Conduct_.

Contributing

Mezzanine is an open source project managed using both the 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.

Donating

If you would like to make a donation to continue development of Mezzanine, you can do so via the Mezzanine Project_ website.

Quotes

• "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
• "Like Linux and Python, Mezzanine just feels right" - Phil Hughes, Linux For Dummies author, The Linux Journal columnist
• "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

.. Django: http://djangoproject.com/ .. Django Code of Conduct: https://www.djangoproject.com/conduct/ .. Wordpress: http://wordpress.org/ .. BSD licensed: http://www.linfo.org/bsdlicense.html .. great sites people have built using Mezzanine: http://mezzanine.jupo.org/sites/ .. Mezzanine project page: http://mezzanine.jupo.org .. In-line page editing: http://mezzanine.jupo.org/docs/inline-editing.html .. custom content types: http://mezzanine.jupo.org/docs/content-architecture.html#creating-custom-content-types .. Cartridge: http://cartridge.jupo.org/ .. Search engine and API: http://mezzanine.jupo.org/docs/search-engine.html .. dashboard: http://mezzanine.jupo.org/docs/admin-customization.html#dashboard .. Free Themes: https://github.com/thecodinghouse/mezzanine-themes .. Custom templates: http://mezzanine.jupo.org/docs/content-architecture.html#page-templates .. Multi-lingual sites: http://mezzanine.jupo.org/docs/multi-lingual-sites.html .. _JVM: http://en.wikipedia.org/wiki/Java_virtual_machine .. Jython: http://www.jython.org/ .. Twitter Bootstrap: http://getbootstrap.com/ .. Disqus: http://disqus.com/ .. Gravatar: http://gravatar.com/ .. Google Analytics: http://www.google.com/analytics/ .. bit.ly: http://bit.ly/ .. Akismet: http://akismet.com/ .. GitHub: http://github.com/stephenmcd/mezzanine/ .. Bitbucket: http://bitbucket.org/stephenmcd/mezzanine/ .. mezzanine-users: http://groups.google.com/group/mezzanine-users/topics .. core-team@mezzaninecms.com: mailto:core-team@mezzaninecms.com?subject=Mezzanine+Security+Issue .. GitHub issue tracker: http://github.com/stephenmcd/mezzanine/issues .. #mezzanine IRC channel: irc://irc.freenode.net/mezzanine .. Freenode: http://freenode.net .. _Mezzanine Project: http://mezzanine.jupo.org

.. Python Software Foundation: http://www.python.org/psf/ .. Urban Airship: http://urbanairship.com/ .. Django Packages: http://djangopackages.com/ .. Hewlett Packard: http://www.hp.com/ .. Tabblo: http://www.tabblo.com/ .. The Linux Journal: http://www.linuxjournal.com .. Work For Pie: http://workforpie.com/ .. Van Lindberg: http://www.lindbergd.info/ .. Antonio Rodriguez: http://an.ton.io/ .. Jesse Noller: http://jessenoller.com/ .. Emile Petrone: https://twitter.com/emilepetrone .. Audrey Roy: http://cartwheelweb.com/ .. Michael Delaney: http://github.com/fusepilot/ .. John Campbell: http://head3.com/ .. Phil Hughes: http://www.linuxjournal.com/blogs/phil-hughes .. Nick Hagianis: http://hagianis.com .. Brad Montgomery: http://blog.bradmontgomery.net .. Head3 Interactive: http://head3.com .. _PyLadies: http://www.pyladies.com