Skip to content

Latest commit

 

History

History
95 lines (67 loc) · 2.48 KB

README.rst

File metadata and controls

95 lines (67 loc) · 2.48 KB

django-tinymce4-widget

https://travis-ci.org/browniebroke/django-tinymce4-widget.svg?branch=master

django-tinymce4-widget is a reworked fork of django-tinymce4-lite. It provides a minimal TinyMCE 4 editor widget that can be used in Django forms. The application can use django-filebrowser or django-filebrowser-no-grappelli as a file manager for TinyMCE 4 to insert images and file links into edited text.

This version does not include any static files, it's using the TinyMCE from the CDN by default. As compared to the original fork, this package provides Django 1.7 support.

Warning: TinyMCE 4 is incompatible with TinyMCE 3. Read TinyMCE docs for more information about how to configure TimyMCE 4 editor widget.

Compatibility

  • Python: 2.7, 3.4, 3.5
  • Django: 1.7-1.11

Quick Start

Install django-tinymce4-widget:

$ pip install django-tinymce4-widget

Add tinymce to INSTALLED_APPS in settings.py for your Django project:

INSTALLED_APPS = (
    ...
    'tinymce',
)

Add tinymce.urls to urls.py for your project:

urlpatterns = [
    ...
    url(r'^tinymce/', include('tinymce.urls')),
    ...
]

In your code:

from django.db import models
from tinymce import HTMLField

class MyModel(models.Model):
    ...
    content = HTMLField('Content')

In Django Admin the widget is used automatically for all models that have HTMLField fields. If you are using TinyMCE 4 in your website forms, add form.media variable into your templates:

<!DOCTYPE html>
<html>
<head>
  ...
  {{ form.media }}
</head>
<body>
...
</body>
</html>

Documentation

https://browniebroke.github.io/django-tinymce4-widget/

License

MIT license. See LICENSE.txt