Skip to main content

WYMeditor RichText widget for Mezzanine

Project description

This is WYMeditor adapted as richtext widget for Mezzanine CMS. It includes basic WYMeditor distribution along with custom image button for use with filebrowser-safe.


WYMeditor widget in Mezzanine admin:

With a media library popup:

With inline editing:


To install mezzanine-wymeditor first make sure you meet the requirements.


It requires at least Mezzanine 1.4.9 and filebrowser-safe 0.2.28 to work correctly.

Now get it from pypi:

pip install mezzanine-wymeditor

Or directly from source if you prefer:

git clone
cd mezzanine-wymeditor
python install

Once installed, set up RICHTEXT_WIDGET_CLASS in your like this:

RICHTEXT_WIDGET_CLASS = 'mezzanine_wymeditor.widgets.WymeditorWidget'

and add the application to INSTALLED_APPS:


Additionally you may override WYMeditor initialisation code (to set your own configs for instance):

WYMEDITOR_SETUP_JS = 'path/to/your/setup.js'

If everything goes well default editor will be replaced with WYMeditor everywhere.


  1. Packaged WYMeditor is version 1.0.0b7, which means it’s a beta. While I consider it to be good enough for everyday use, bugs are possible - please submit them to WYMeditor developers. WYMeditor distribution will be updated upon new releases.
  2. There’s a tiny modification to WYMeditor sources to make it detect static URL properly in Mezzanine admin so it’s not completely vanilla. There are no other changes to the original source.
  3. There are currently two image buttons on the toolbar. The default one lets you insert an image from arbitrary URL and modify some attributes of existing images. The custom one (with filebrowser icon, always at the end) opens up the media library and lets you choose an image from there, which is immediately inserted at the cursor position.
  4. You may want to disable (or relax) Mezzanine’s HTML filtering (RICHTEXT_FILTER_LEVEL) as WYMeditor has its own but it’s entirely up to you.
  5. There’s currently no convenient “insert video” functionality but one can still embed iframes in raw HTML provided RICHTEXT_FILTER_LEVEL = 2.

Project details

Download files

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

Files for mezzanine-wymeditor, version 0.3
Filename, size File type Python version Upload date Hashes
Filename, size mezzanine-wymeditor-0.3.tar.gz (303.0 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page