Metadata-Version: 1.1
Name: wagtailfroala
Version: 0.2.8
Summary: Extends Wagtail to use the Froala WYSIWYG editor in RichTextFields/RichTextBlocks.
Home-page: https://github.com/jaydensmith/wagtailfroala
Author: Jayden Smith
Author-email: jayden@intelliscale.com.au
License: MIT License
Description: ===============
        Wagtail Froala
        ===============
        
        Extends Wagtail to use the amazing Froala editor.
        This Wagtail extension requires Wagtail 1.5.x, as it uses ``WAGTAILADMIN_RICH_TEXT_EDITORS``.
        
        Installation
        ============
        
        Run the command ``pip install wagtailfroala``
        
        Add ``wagtailfroala`` to your ``INSTALLED_APPS``.
        
        Add ``wagtailfroala.rich_text.FroalaRichTextArea`` to ``WAGTAILADMIN_RICH_TEXT_EDITORS`` in your settings.
        
        For example, to use Froala for all ``RichTextField`` and ``RichTextBlock`` instances:
        
        .. code-block:: python
        
            WAGTAILADMIN_RICH_TEXT_EDITORS = {
                'default': {
                    'WIDGET': 'wagtailfroala.rich_text.FroalaRichTextArea'
                },
            }
        
        Or, to use Froala only for defined instances...
        
        .. code-block:: python
            
            WAGTAILADMIN_RICH_TEXT_EDITORS = {
                'default': {
                    'WIDGET': 'wagtail.wagtailadmin.rich_text.HalloRichTextArea'
                },
                'froala': {
                    'WIDGET': 'wagtailfroala.rich_text.FroalaRichTextArea'
                },
            }
        
        .. code-block:: python
        
            html_field = RichTextField(editor='froala')
            stream_field = StreamField([
                ('html', RichTextBlock(editor='froala'))
            ])
        
        Options
        -------
        
        You will need to add ``FROALA_LICENSE_KEY`` to your settings:
        
        .. code-block:: python
        
            FROALA_LICENSE_KEY = 'xxxxxxxxxxxxxx'
        
        You can also specify ``FROALA_OPTIONS``, which should be a dict populated with official Froala options (https://www.froala.com/wysiwyg-editor/docs/options):
        
        .. code-block:: python
        
            FROALA_OPTIONS = {
                'toolbarButtonsMD': ['bold', 'italic', 'underline', 'fontFamily', 'fontSize', 'color'],
                'toolbarButtonsXS': ['bold', 'italic', 'underline']
            }
        
        By default, Codemirror HTML syntax highlighting is enabled, you can disable it if you wish.
        
        .. code-block:: python
            
            FROALA_CODEMIRROR = False
        
        Font Awesome is required by Froala for toolbar icons, so it is included by default. If you don't want to include it or already have a version included, you can disable it.
        
        .. code-block:: python
            
            FROALA_FONT_AWESOME = False
        
        To Do
        -------
        - [ ] Implement image replace button.
        - [ ] Incoorperate Froala events https://www.froala.com/wysiwyg-editor/docs/events.
        
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.8
Classifier: Framework :: Django :: 1.9
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: MIT License
Classifier: Intended Audience :: Developers
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
