django-redactorjs's Introduction

django-redactorjs

http://github.com/TigorC/django-redactorjs

What's that

django-redactorjs is a reusable application for Django, using WYSIWYG editor http://redactorjs.com/

Package not compatible with previous version 0.2.x. Package not include redactor.js Dependence

Django >= 1.3 # for static files
Pillow or PIL # for image upload

Getting started

Install django-redactorjs:

pip install django-redactorjs

Add 'redactor' to INSTALLED_APPS.
Add url(r'^redactor/', include('redactor.urls')), to urls.py
Add default config in settings.py (more settings see: http://imperavi.com/redactor/docs/settings/):

REDACTOR_OPTIONS = {'lang': 'ru'}
REDACTOR_UPLOAD = 'uploads/'

Config for redactor static

REDACTOR_CSS = {
    'all': (
        'imperavi/css/redactor.css',)
}
REDACTOR_JS = [
    'http://ajax.googleapis.com/ajax/libs/jquery/1.11.0/jquery.min.js',
    'imperavi/js/redactor.js',
    'imperavi/js/ru.js',
]

You can also specify a function to modify the filename of uploaded files (for example to ensure the filename is unique).

import uuid
def make_unique_filename(filename):
    ext = filename.split('.')[-1]
    return "%s.%s" % (uuid.uuid4(), ext)

REDACTOR_GENERATE_FILENAME = make_unique_filename

Using in model

from django.db import models
from redactor.fields import RedactorField

class Entry(models.Model):
    title = models.CharField(max_length=250, verbose_name=u'Заголовок')
    short_text = RedactorField(verbose_name=u'Краткий текст')

or use custom parametrs:

short_text = RedactorField(verbose_name=u'Краткий текст',
                redactor_options={'lang': 'ru', 'focus': 'true'},
                upload_to='tmp/')

Using for only admin interface

from django import forms
from redactor.widgets import RedactorEditor
from blog.models import Entry

class EntryAdminForm(forms.ModelForm):
    class Meta:
        model = Entry
        widgets = {
           'short_text': RedactorEditor(),
        }

class EntryAdmin(admin.ModelAdmin):
    form = EntryAdminForm

RedactorEditor takes the same parameters as RedactorField

Recommend Projects