django-wysiwyg-redactor 0.4.9

django-wysiwyg-redactor is a lightweight responsive wysiwyg editor for Django
A lightweight wysiwyg editor for Django
=======================================

.. image:: https://img.shields.io/pypi/dm/django-wysiwyg-redactor.svg
    :target: https://pypi.python.org/pypi/django-wysiwyg-redactor/
    :alt: Downloads

Screenshot
----------

.. image:: https://raw.githubusercontent.com/douglasmiranda/django-wysiwyg-redactor/master/screenshots/redactor.jpg

What's that
-----------------

*django-wysiwyg-redactor* is a text editor application for Django, using `Redactor WYSIWYG editor <http://redactorjs.com/>`_

Sponsored by `Mess Marketing <http://www.thisismess.com>`_, we use the latest version of redactorjs, always up-to-date.

Dependency
----------

- `Pillow or PIL` # for image upload

Getting started
---------------

- Install *django-wysiwyg-redactor*:

``pip install django-wysiwyg-redactor``

- Add `'redactor'` to INSTALLED_APPS.

.. code-block:: python

    INSTALLED_APPS = (  
        # ...  
        'redactor',  
        # ...  
    ) 

- Add `url(r'^redactor/', include('redactor.urls'))`, to urls.py

.. code-block:: python

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


- Add default config in settings.py

.. code-block:: python

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

More `redactor settings <http://imperavi.com/redactor/docs/settings/>`_.

Using in model
--------------

.. code-block:: python

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

    class Entry(models.Model):
        title = models.CharField(max_length=250, verbose_name=u'Title')
        short_text = RedactorField(verbose_name=u'Text')

or use custom parametrs:

.. code-block:: python

    short_text = RedactorField(
        verbose_name=u'Text',
        redactor_options={'lang': 'en', 'focus': 'true'},
        upload_to='tmp/',
        allow_file_upload=True,
        allow_image_upload=True
    )

Using only in Django Admin
--------------------------

.. code-block:: python

    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`.

Using Plugins
-------------
`Download <http://imperavi.com/redactor/plugins/>`_ the plugin you want or `create a custom plugin <http://imperavi.com/redactor/docs/how-to-create-plugin/>`_.

Then:

.. code-block:: python

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

    class Entry(models.Model):
        title = models.CharField(max_length=250, verbose_name=u'Title')
        short_text = RedactorField(
            verbose_name=u'Text',
            # for example, if you downloaded the 'table' plugin:
            redactor_options={'plugins': ['table']}
        )

OR (on settings.py):

.. code-block:: python

    REDACTOR_OPTIONS = {'lang': 'en', 'plugins': ['table']}

Important: if you set a plugin called "table", you must create/paste the "table.js" on **YOUR_STATIC_FILES_FOLDER/redactor/plugins/table.js**

Upload Handlers
---------------
SimpleUploader - The Standard Uploader. Will upload your file to REDACTOR_UPLOAD.

UUIDUploader - This handler will replace the original file name for an UUID.

DateDirectoryUploader - This handler saves the file in a directory based on the current server date.

Usage:

For example, if I want to use the DateDirectoryUploader handler, I will put this on settings.py:

.. code-block:: python

    REDACTOR_UPLOAD_HANDLER = 'redactor.handlers.DateDirectoryUploader'

Upload permissions
------------------
By default django-wysiwyg-redactor uses `staff_member_required` decorator from
`django.contrib.admin.views.decorators` package to control access to dispatch
method.

To use custom authentication decorator, set `REDACTOR_AUTH_DECORATOR` to
anything else, eg. if every authenticated user should have permissions to
upload files/images/etc.:

.. code-block:: python

    REDACTOR_AUTH_DECORATOR = 'django.contrib.auth.decorators.login_required'

File Storages
-------------
*django-wysiwyg-redactor* defaults to using the default media storage for your Django application.

This can be overriden to use a different storage backend with this settings.py variable:

.. code-block::

    REDACTOR_FILE_STORAGE = 'my_site.file_storages.StorageClass'

Information on writing a custom storage backend is `here in the Django documentation <https://docs.djangoproject.com/en/1.7/howto/custom-file-storage/>`_.

Other third-party libraries exist to provide storage backends for cloud object storages (e.g. `django-cumulus <https://github.com/django-cumulus/django-cumulus/>`_ for Rackspace/OpenStack or `django-storages <http://django-storages.readthedocs.org/en/latest/backends/amazon-S3.html>`_ for Amazon S3). For example, following should be enough to store all your files and images to Amazon S3, even if the rest of the application uses different storage.

.. code-block:: python

    REDACTOR_FILE_STORAGE = 'storages.backends.s3boto.S3BotoStorage'
    AWS_ACCESS_KEY_ID = '...'
    AWS_SECRET_ACCESS_KEY = '...'
    AWS_STORAGE_BUCKET_NAME = '...'


NOTE: Soon we will have a better documentation.

Contributing
------------

1. Fork it!
2. Create your feature branch: `git checkout -b my-new-feature`
3. Commit your changes: `git commit -am 'Add some feature'`
4. Push to the branch: `git push origin my-new-feature`
5. Submit a pull request =]

Made by robots, or what?
------------------------
Awesome people, you should see the `AUTHORS <https://github.com/douglasmiranda/django-wysiwyg-redactor/blob/master/AUTHORS>`_ file.

And our awesome sponsor:

Mess Marketing from Chicago, IL
jshedd@thisismess.com
thisismess.com
@etchalon
MIT

Author

Douglas Miranda

Pip

django-wysiwyg-redactor==0.4.9

Classifiers

  • Development Status :: 5 - Production/Stable
  • Environment :: Web Environment
  • Framework :: Django
  • Intended Audience :: Developers
  • Operating System :: OS Independent
  • Programming Language :: Python
  • License :: OSI Approved :: BSD License
File Type Python Version Uploaded On Downloads
django-wysiwyg-redactor-0.4.9.tar.gz Source Aug. 2, 2015 786
Version Release Date
0.4.9 Aug. 2, 2015
0.4.8.1 June 18, 2015
0.4.8 June 18, 2015
0.4.7 May 1, 2015
0.4.6 April 30, 2015
0.4.5.1 March 18, 2015
0.4.5 Feb. 18, 2015
0.4.4.1 Jan. 6, 2015
0.4.4 Jan. 4, 2015
0.4.3.2 Dec. 19, 2014
0.4.3.1 Dec. 15, 2014
0.4.3 Dec. 10, 2014
0.4.2.1 Nov. 6, 2014
0.4.2 Nov. 6, 2014
0.4.1 Oct. 21, 2014
0.4.0 Sept. 11, 2014
0.3.9.1 June 6, 2014
0.3.9 March 29, 2014
0.3.8.2 Feb. 14, 2014
0.3.8.1 Feb. 13, 2014
0.3.8 Nov. 16, 2013
0.3.7 Oct. 27, 2013
0.3.6 Aug. 12, 2013
0.3.5 June 26, 2013
0.3.4 June 14, 2013
0.3.3 May 3, 2013
0.3.2 April 14, 2013
0.3.1 March 7, 2013
0.3.0 Dec. 11, 2012
Date Package Version Action
Aug. 24, 2015, 11:05 p.m. django-wysiwyg-redactor 0.3.8.2 Release Created
Aug. 24, 2015, 11:05 p.m. django-wysiwyg-redactor 0.4.5.1 Release Created
Aug. 24, 2015, 11:05 p.m. django-wysiwyg-redactor 0.3.8 Release Created
Aug. 24, 2015, 11:05 p.m. django-wysiwyg-redactor 0.4.6 Release Created
Aug. 24, 2015, 11:05 p.m. django-wysiwyg-redactor 0.4.7 Release Created
Aug. 24, 2015, 11:05 p.m. django-wysiwyg-redactor 0.4.4 Release Created
Aug. 24, 2015, 11:05 p.m. django-wysiwyg-redactor 0.4.5 Release Created
Aug. 24, 2015, 11:05 p.m. django-wysiwyg-redactor 0.4.2 Release Created
Aug. 24, 2015, 11:05 p.m. django-wysiwyg-redactor 0.4.3 Release Created
Aug. 24, 2015, 11:05 p.m. django-wysiwyg-redactor 0.4.0 Release Created
Aug. 24, 2015, 11:05 p.m. django-wysiwyg-redactor 0.4.1 Release Created
Aug. 24, 2015, 11:05 p.m. django-wysiwyg-redactor 0.4.8 Release Created
Aug. 24, 2015, 11:05 p.m. django-wysiwyg-redactor 0.4.9 Release Created
Aug. 24, 2015, 11:05 p.m. django-wysiwyg-redactor 0.3.5 Release Created
Aug. 24, 2015, 11:05 p.m. django-wysiwyg-redactor 0.3.4 Release Created
Aug. 24, 2015, 11:05 p.m. django-wysiwyg-redactor 0.3.7 Release Created
Aug. 24, 2015, 11:05 p.m. django-wysiwyg-redactor 0.3.6 Release Created
Aug. 24, 2015, 11:05 p.m. django-wysiwyg-redactor 0.3.1 Release Created
Aug. 24, 2015, 11:05 p.m. django-wysiwyg-redactor 0.3.0 Release Created
Aug. 24, 2015, 11:05 p.m. django-wysiwyg-redactor 0.3.3 Release Created
Aug. 24, 2015, 11:05 p.m. django-wysiwyg-redactor 0.3.2 Release Created
Aug. 24, 2015, 11:05 p.m. django-wysiwyg-redactor 0.3.8.1 Release Created
Aug. 24, 2015, 11:05 p.m. django-wysiwyg-redactor 0.4.4.1 Release Created
Aug. 24, 2015, 11:05 p.m. django-wysiwyg-redactor 0.3.9 Release Created
Aug. 24, 2015, 11:05 p.m. django-wysiwyg-redactor 0.3.9.1 Release Created
Aug. 24, 2015, 11:05 p.m. django-wysiwyg-redactor 0.4.8.1 Release Created
Aug. 24, 2015, 11:05 p.m. django-wysiwyg-redactor 0.4.3.1 Release Created
Aug. 24, 2015, 11:05 p.m. django-wysiwyg-redactor 0.4.3.2 Release Created
Aug. 24, 2015, 11:05 p.m. django-wysiwyg-redactor 0.4.2.1 Release Created
Aug. 24, 2015, 11:05 p.m. django-wysiwyg-redactor Package Created