{ "info": { "author": "Richard Mitchell", "author_email": "richard.mitchell@isotoma.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Environment :: Web Environment", "Framework :: Django", "Framework :: Django :: 1.8", "Framework :: Django :: 1.9", "Intended Audience :: Developers", "License :: OSI Approved :: BSD License", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Topic :: Internet :: WWW/HTTP :: Site Management" ], "description": "===============\nWagtail TinyMCE\n===============\n\nWagtail TinyMCE offers integration of the\n`TinyMCE rich text editor `_ into the\n`Wagtail CMS `_.\n\nAs of Wagtail 1.5 this integrates using Wagtail's alternative rich text editor feature and requires no extra customisation or patching.\n\nInstallation\n============\n\nAdd ``wagtailtinymce`` to your |INSTALLED_APPS Django setting|_.\n\n.. |INSTALLED_APPS Django setting| replace:: ``INSTALLED_APPS`` Django setting\n.. _`INSTALLED_APPS Django setting`: https://docs.djangoproject.com/en/1.9/ref/settings/#installed-apps\n\nAdd or change ``WAGTAILADMIN_RICH_TEXT_EDITORS`` in your settings, to use the widget ``wagtailtinymce.rich_text.TinyMCERichTextArea``.\n\nFor example, to use TinyMCE for all ``RichTextField`` and ``RichTextBlock`` instances:\n\n.. code-block:: python\n\n WAGTAILADMIN_RICH_TEXT_EDITORS = {\n 'default': {\n 'WIDGET': 'wagtailtinymce.rich_text.TinyMCERichTextArea'\n },\n }\n\nOr, to use TinyMCE for certain instances...\n\n.. code-block:: python\n \n WAGTAILADMIN_RICH_TEXT_EDITORS = {\n 'default': {\n 'WIDGET': 'wagtail.wagtailadmin.rich_text.HalloRichTextArea'\n },\n 'tinymce': {\n 'WIDGET': 'wagtailtinymce.rich_text.TinyMCERichTextArea'\n },\n }\n \n...and declare fields with the corresponding key in the ``editor`` parameter:\n\n.. code-block:: python\n\n html_field = RichTextField(editor='tinymce', ...)\n stream_field = StreamField([('html', RichTextBlock(editor='tinymce', ...)), ...])\n \nTinyMCE configuration\n===================== \n\nThe ``TinyMCERichTextArea`` constructor accepts keyword arguments for buttons, menus and options which are merged with defaults and passed to TinyMCE. \n\nHowever, Wagtail does not currently allow for passing parameters to this constructor. To change the configuration you must create and register a subclass of ``TinyMCERichTextArea`` and pass these parameters or amend defaults in the subclass constructor.\n\nButtons\n-------\n\nThese are configured as a list of menu bars, each containing a list of groups, each containing a list of button names.\n\nBy default, TinyMCE is loaded with buttons for undo/redo, a styles dropdown, bold/italic, lists and tables, link/unlink, Wagtail documents/images/embeds, paste filter toggle and edit fullscreen.\n\nMenu\n----\n\nThese are configured as a list of menu names.\n\nBy default, TinyMCE is loaded with no menubar.\n\nOptions\n-------\n\nThis is a dict. By default, TinyMCE is loaded with the following options set:\n\n- ``browser_spellcheck``\n- ``noneditable_leave_contenteditable`` (required for Wagtail image/embed handling)\n- ``language`` (taken from Django settings)\n- ``language_load``\n\nTinyMCE plugins and tools\n========================= \n\nTinyMCE is loaded with the following plugins:\n\n- ``hr``\n- ``code``\n- ``fullscreen``\n- ``noneditable`` (required for Wagtail image/embed handling)\n- ``paste``\n- ``table`` (and ``inserttable`` tool)\n\nTo add further plugins and tools to TinyMCE, use the\n``insert_tinymce_js`` and ``insert_tinymce_css`` hooks. Once you have the hook in place use the\nfollowing JavaScript to register the plugin with TinyMCE:\n\n.. code-block:: javascript\n\n registerMCEPlugin(name, path, language);\n\nFor example:\n\n.. code-block:: javascript\n\n registerMCEPlugin('myplugin', '/static/js/my-tinymce-plugin.js', 'en_GB');\n\nThe ``language`` parameter is optional and can be omitted.\n\nA complete ``wagtail_hooks.py`` file example:\n\n.. code-block:: python\n\n import json\n\n from django.templatetags.static import static\n from django.utils import translation\n from django.utils.html import format_html\n from django.utils.safestring import mark_safe\n from wagtail.wagtailcore import hooks\n\n @hooks.register('insert_tinymce_js')\n def my_plugin_js():\n return format_html(\n \"\"\"\n \n \"\"\",\n mark_safe(json.dumps(static('js/my-tinymce-plugin.js'))),\n to_js_primitive(translation.to_locale(translation.get_language())),\n )\n\nVersioning\n==========\nThe version number of this package is the TinyMCE version, followed by\nthe release number of this package for that TinyMCE version.\n\n\nChanges\n=======\n\n4.2.1.5 (2016-06-08)\n--------------------\n\n- Alter doclink editing fixes in line with Wagtail 1.5.1 Hallo editor.\n- Change page chooser to use parent page ID in line with Wagtail 1.5.1 Hallo editor.\n\n4.2.1.4 (2016-06-01)\n--------------------\n- Update to use Wagtail 1.5 pluggable rich text editor mechanism.\n- Refactor link and doclink plugins to remove race condition.\n- Add link editing and unlinking in line with Wagtail 1.5 Hallo editor.\n- Fixes around editing of doclinks with link editor.\n- Refactored settings to allow per-field variation.\n- Made default menu/toolbar settings more Wagtail friendly.\n\n4.2.1.3 (unreleased)\n--------------------\n- No changes.\n\n4.2.1.2 (unreleased)\n--------------------\n- Add further button and menubar settings.\n- Persist TinyMCE content to form on change to avoid losing content on preview with validation errors.\n\n4.2.1.1 (unreleased)\n--------------------\n- Bug fixes relating to page/document link handlers.\n- Add image/embed editing (requires custom Wagtail).\n- Add image/embed caption field (requires custom Wagtail).\n\n4.2.1.0 (unreleased)\n--------------------\n- Initial release.\n\n\nLicense\n=======\n\nThis package is copyright (c) 2016, Isotoma Limited\nAll rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are\nmet:\n\n* Redistributions of source code must retain the above copyright\n notice, this list of conditions and the following disclaimer.\n* Redistributions in binary form must reproduce the above copyright\n notice, this list of conditions and the following disclaimer in the\n documentation and/or other materials provided with the distribution.\n* Neither the name of the Isotoma Limited nor the\n names of its contributors may be used to endorse or promote products\n derived from this software without specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS\nIS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED\nTO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A\nPARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL ISOTOMA LIMITED BE\nLIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR\nCONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF\nSUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR\nBUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,\nWHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR\nOTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF\nADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\nAttributions\n------------\n\nThis package includes TinyMCE 4.x which is licensed under the LGPLv2.1.\n\nIcons for TinyMCE are generated and provided by the http://icomoon.io\nservice.\n\nThe Document icon is from Wagtail's own icon font which is generated\nand provided by the http://icomoon.ico service.", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/isotoma/wagtailtinymce.git", "keywords": null, "license": "New BSD", "maintainer": null, "maintainer_email": null, "name": "wagtailtinymce", "package_url": "https://pypi.org/project/wagtailtinymce/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/wagtailtinymce/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://github.com/isotoma/wagtailtinymce.git" }, "release_url": "https://pypi.org/project/wagtailtinymce/4.2.1.5/", "requires_dist": null, "requires_python": null, "summary": "A TinyMCE editor integration for Wagtail", "version": "4.2.1.5" }, "last_serial": 2706883, "releases": { "4.2.1.0": [], "4.2.1.4": [ { "comment_text": "", "digests": { "md5": "0d4a8e764b42c31f6ca5c7b837c98fd1", "sha256": "5ae99621bdaac0557041d611422504261feaeb2e580cefb6125232b3aa937e4d" }, "downloads": -1, "filename": "wagtailtinymce-4.2.1.4.tar.gz", "has_sig": false, "md5_digest": "0d4a8e764b42c31f6ca5c7b837c98fd1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1786496, "upload_time": "2016-06-01T11:25:37", "url": "https://files.pythonhosted.org/packages/72/29/fe0f9023f961346194ae6a24f8d01fc1516ad11984eaf84b98f1d33f35f6/wagtailtinymce-4.2.1.4.tar.gz" } ], "4.2.1.5": [ { "comment_text": "", "digests": { "md5": "f7e9853b639c505bf5e56a4f7175e660", "sha256": "84c92385413f2bcd08563261b5d8dc35fe34a84641691970bcac0f325610a5ef" }, "downloads": -1, "filename": "wagtailtinymce-4.2.1.5.zip", "has_sig": false, "md5_digest": "f7e9853b639c505bf5e56a4f7175e660", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2294515, "upload_time": "2016-06-08T10:38:35", "url": "https://files.pythonhosted.org/packages/c6/17/0d5108e25ed0deb2587a5a8f92a3ecf416d3cc301493f81cc5fa840f243a/wagtailtinymce-4.2.1.5.zip" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "f7e9853b639c505bf5e56a4f7175e660", "sha256": "84c92385413f2bcd08563261b5d8dc35fe34a84641691970bcac0f325610a5ef" }, "downloads": -1, "filename": "wagtailtinymce-4.2.1.5.zip", "has_sig": false, "md5_digest": "f7e9853b639c505bf5e56a4f7175e660", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2294515, "upload_time": "2016-06-08T10:38:35", "url": "https://files.pythonhosted.org/packages/c6/17/0d5108e25ed0deb2587a5a8f92a3ecf416d3cc301493f81cc5fa840f243a/wagtailtinymce-4.2.1.5.zip" } ] }