django-tinymce4-lite 1.8.0
A Django application that provides a fully functional TinyMCE 4 editor widget for models and forms.
License: MIT License
Keywords: django wysiwyg editor widget tinymce

django-tinymce4-lite
====================

.. image:: https://travis-ci.org/romanvm/django-tinymce4-lite.svg?branch=master
  :target: https://travis-ci.org/romanvm/django-tinymce4-lite
.. image:: https://codecov.io/github/romanvm/django-tinymce4-lite/coverage.svg?branch=master
  :target: https://codecov.io/github/romanvm/django-tinymce4-lite?branch=master
.. image:: https://badge.fury.io/py/django-tinymce4-lite.svg
  :target: https://badge.fury.io/py/django.tinymce4-lite

**django-tinymce4-lite** is a reworked fork of `django-tinymce4`_.
It provides a fully functional `TinyMCE 4`_ editor widget that can be used
in Django forms and models.

.. image:: http://romanvm.github.io/django-tinymce4-lite/_images/screenshot.png

The application can use `django-filebrowser-no-grappelli`_ as a file manager
for TinyMCE 4 to insert images and file links into edited text.

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

**Note**: This package includes the latest available version of TinyMCE 4 -
4.9.2. Currently there are no concrete plans to support TinyMCE 5, and **if**
it happens, it will be in a separate package with a different name.

Compatibility
-------------

- **Python**: 3.5+
- **Django**: 1.11+

Quick Start
===========

Install **django-tinymce4-lite**::

  $ pip install django-tinymce4-lite

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

.. code-block:: python

  INSTALLED_APPS = (
      ...
      'tinymce',
  )

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

.. code-block:: python

  urlpatterns = [
      ...
      path('tinymce/', include('tinymce.urls')),
      ...
  ]

Or with old-style regex ``url``:

.. code-block:: python

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

In your code:

.. code-block:: python

    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:

.. code-block:: django

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



Documentation
=============

http://romanvm.github.io/django-tinymce4-lite

License
=======

MIT license. See LICENSE.txt

.. _django-tinymce4: https://github.com/dani0805/django-tinymce4
.. _TinyMCE 4: https://www.tinymce.com/
.. _django-filebrowser: https://github.com/sehmaschine/django-filebrowser
.. _django-filebrowser-no-grappelli: https://github.com/smacker/django-filebrowser-no-grappelli
.. _TinyMCE docs: https://www.tinymce.com/docs/


Changelog
=========

1.8.0
-----
- Removed Python 2.7 support.
- Added support for Python 3.8, Django 2.2 and 3.0

1.7.5
-----
- Support translated strings in settings (merwok).
- Set TinyMCE localization language when rendering the widget instead of the
  widget class initialization (allows to set TinyMCE language depending on
  the web page locale).

1.7.4
-----
- Upgraded TinyMCE to v.4.9.2

1.7.3
-----
- Upgraded TinyMCE to v.4.8.3

1.7.2
-----
- Upgraded TinyMCE to v.4.8.0.
- Various fixes (maqmigh, ojiii, rvanlaar).

1.7.1
-----
- Upgraded TinyMCE to v.4.7.11

1.7.0
-----
- Upgraded TinyMCE to v.4.7.4
- Fixed using TinyMCE in non-admin forms.
- Fixed compatibility with ``django-filebrowser-no-grapelli``.
  This broke compatibility with ``django-filebrowser``
  (based on grapelli) until the latter adds support for TinyMCE 4.

1.6.0
-----
- Upgraded TinyMCE to v.4.7.2.
- Added compatibility with Django 2.0 (thomwiggers).
- Fixed dropped widget attributes in Django => 1.11 (bentrm).
- Fixed missing Changelog in ``sdist`` .gz distribution.

1.5.2
-----
- Fixed rendering TinyMCE widgets with multiple inline formsets in Django admin
  (se-bastiaan).
- Fixed running Django management commands with ``ManifestStaticFilesStorage`` and
  ``DEBUG = False`` (hopefully).
- Upgraded TinyMCE to v.4.6.7.

1.5.1
-----
- Fixed running collectstatic command with ``ManifestStaticFilesStorage`` and
  ``DEBUG = False``.

1.5.0
-----
- **Security**: protected spellchecker REST endpoint from CRSF.
- Implemented correct handling of TinyMCE widgets inside inline formsets
  in Django admin interface.
- Upgraded TinyMCE to v.4.6.6.

1.4.2
-----
- Upgraded TinyMCE to v.4.6.4.
- Fixed the default editor config.

1.4.1
-----
- Upgraded TinyMCE to v.4.6.2.
- Added text format selector to the default editor configuration.

1.4.0
-----
- Upgraded TinyMCE to v.4.6.0.

1.3.2
-----
- Fixed compatibility with Django v.1.11.

1.3.1
-----
- Upgraded TinyMCE to v.4.5.5.
- Fixed language file configuration for languages with country codes (Gagaro).
- Rendering of the TinyMCE 4 is now tested with Selenium/PhantomJS.

1.3.0
-----
- Upgraded TinyMCE to v.4.5.1.

1.2.0
-----
- Upgraded TinyMCE to v.4.4.3
- Added ``TINYMCE_ADDITIONAL_JS_URLS`` configuration option.

1.1.0
-----
- Upgraded TinyMCE to v.4.4.1.
- Added Django 1.10 to compatibility matrix.

1.0.0
-----
- Initial PyPI release.