Installation¶
This section describes how to install the django-tinymce application and related dependencies in your Django project.
Prerequisites¶
The django-tinymce application requires Django version 1.4 or higher.
If you want to use the spellchecker plugin using the supplied view you must install the PyEnchant package and dictionaries for your project languages. Note that the Enchant needs a dictionary that exactly matches your language codes. For example, a dictionary for code 'en-us'
will not automatically be used for 'en'
. You can check the availability of
the Enchant dictionary for the 'en'
language code using the following Python code:
import enchant
enchant.dict_exists('en')
Note that the documentation will use ‘TinyMCE’ (capitalized) to refer the editor itself and ‘django-tinymce’ (lower case) to refer to the Django application.
Installation¶
Install django-tinymce using pip (or any other way to install python package) from PyPI. If you need to use a different way to install django-tinymce you can place the
tinymce
module on your Python path. You can put it into your Django project directory or runpython setup.py install
from a shell.$ pip install django-tinymce
Add
tinymce
to INSTALLED_APPS insettings.py
for your project:INSTALLED_APPS = ( ... 'tinymce', ... )
Add
tinymce.urls
tourls.py
for your project:urlpatterns = patterns('', ... (r'^tinymce/', include('tinymce.urls')), ... )
Configuration¶
The application can be configured by editing the project’s settings.py
file.
TINYMCE_JS_URL
(default:settings.MEDIA_URL + 'js/tiny_mce/tiny_mce.js'
)The URL of the TinyMCE javascript file:
TINYMCE_JS_URL = os.path.join(MEDIA_ROOT, "path/to/tiny_mce/tiny_mce.js")
TINYMCE_JS_ROOT
(default:settings.MEDIA_ROOT + 'js/tiny_mce'
)The filesystem location of the TinyMCE files. It is used by the compressor (see below):
TINYMCE_JS_ROOT = os.path.join(MEDIA_ROOT, "path/to/tiny_mce")
TINYMCE_DEFAULT_CONFIG
(default:{'theme': "simple", 'relative_urls': False}
)- The default TinyMCE configuration to use. See the TinyMCE manual for all
options. To set the configuration for a specific TinyMCE editor, see the
mce_attrs
parameter for the widget. TINYMCE_SPELLCHECKER
(default:False
)- Whether to use the spell checker through the supplied view. You must add
spellchecker
to the TinyMCE plugin list yourself, it is not added automatically. TINYMCE_COMPRESSOR
(default:False
)- Whether to use the TinyMCE compressor, which gzips all Javascript files into a single stream. This makes the overall download size 75% smaller and also reduces the number of requests. The overall initialization time for TinyMCE will be reduced dramatically if you use this option.
TINYMCE_FILEBROWSER
(default:True
if'filebrowser'
is inINSTALLED_APPS
, elseFalse
)- Whether to use the django-filebrowser_ as a custom filebrowser for media inclusion. See the official TinyMCE documentation on custom filebrowsers.
Example:
TINYMCE_JS_URL = 'http://debug.example.org/tiny_mce/tiny_mce_src.js'
TINYMCE_DEFAULT_CONFIG = {
'plugins': "table,spellchecker,paste,searchreplace",
'theme': "advanced",
'cleanup_on_startup': True,
'custom_undo_redo_levels': 10,
}
TINYMCE_SPELLCHECKER = True
TINYMCE_COMPRESSOR = True