Django Medium Editor

Supported Environments

Django 1.10+
Python 3.6

Installation

Install django-mediumeditor

via PyPi:

pip install django-mediumeditor

via GIT:

pip install git+https://github.com/g3rd/django-mediumeditor.git

Install app

INSTALLED_APPS = [
    ...
    'mediumeditor',
]

Usage

Django Admin

Add to Admin class

from mediumeditor.admin import MediumEditorAdmin

@admin.register(MyModel)
class MyModelAdmin(MediumEditorAdmin, admin.ModelAdmin):
    ...
    mediumeditor_fields = ('my_text_field', )
    ...

Forms

Override the Widget for the field

from mediumeditor.widgets import MediumEditorTextarea

class MyForm(forms.ModelForm):
    ...
    class Meta:
        model = MyModel
        widgets = {
            'my_text_field': MediumEditorTextarea(),
        }

In the <head> of the template
```
{{ form.media }}
```

Settings

Optionaly change theme or change medium editor options in your settings.py

# Theme options `default`, `roman`, `mani`, `flat`, `bootstrap`, `tim`, `beagle`
MEDIUM_EDITOR_THEME = 'beagle' # `default` is default theme
MEDIUM_EDITOR_OPTIONS = {..}

Available Options

Example:

MEDIUM_EDITOR_THEME = 'bootstrap'
MEDIUM_EDITOR_OPTIONS = {
    'toolbar': {
        'static': True,
        'buttons': [
            'bold',
            'italic',
            'underline',
            'strikethrough',
            'subscript',
            'superscript',
            'h1',
            'h2',
            'h3',
            'h4',
            'h5',
            'h6',
        ]
    },
    'paste': {
        'forcePlainText': True,
        'cleanPastedHTML': False,
        'cleanReplacements': [],
        'cleanAttrs': ['class', 'style', 'dir'],
        'cleanTags': ['meta']
    }
}