wagtailtinymce 4.2.1.5

安装

将wagtailtinymce添加到您的INSTALLED_APPS Django 设置中。

在您的设置中添加或更改WAGTAILADMIN_RICH_TEXT_EDITORS以使用小部件wagtailtinymce.rich_text.TinyMCERichTextArea。

例如，要对所有RichTextField和RichTextBlock实例使用 TinyMCE：

WAGTAILADMIN_RICH_TEXT_EDITORS = {
    'default': {
        'WIDGET': 'wagtailtinymce.rich_text.TinyMCERichTextArea'
    },
}

或者，在某些情况下使用 TinyMCE……

WAGTAILADMIN_RICH_TEXT_EDITORS = {
    'default': {
        'WIDGET': 'wagtail.wagtailadmin.rich_text.HalloRichTextArea'
    },
    'tinymce': {
        'WIDGET': 'wagtailtinymce.rich_text.TinyMCERichTextArea'
    },
}

…并在editor参数中使用相应的键声明字段：

html_field = RichTextField(editor='tinymce', ...)
stream_field = StreamField([('html', RichTextBlock(editor='tinymce', ...)), ...])

TinyMCE 配置

TinyMCERichTextArea构造函数接受按钮、菜单和选项的关键字参数，这些参数与默认值合并并传递给 TinyMCE 。

但是，Wagtail 目前不允许将参数传递给此构造函数。要更改配置，您必须创建和注册TinyMCERichTextArea的子类，并在子类构造函数中传递这些参数或修改默认值。

TinyMCE 插件和工具

TinyMCE 加载了以下插件：

• 小时

• 代码

• 全屏

• 不可编辑（ Wagtail图像/嵌入处理需要）

• 粘贴

• 表（和可插入工具）

要向 TinyMCE 添加更多插件和工具，请使用 insert_tinymce_js和insert_tinymce_css挂钩。设置好钩子后，使用以下 JavaScript 向 TinyMCE 注册插件：

registerMCEPlugin(name, path, language);

例如：

registerMCEPlugin('myplugin', '/static/js/my-tinymce-plugin.js', 'en_GB');

语言参数是可选的，可以省略。

一个完整的wagtail_hooks.py文件示例：

import json

from django.templatetags.static import static
from django.utils import translation
from django.utils.html import format_html
from django.utils.safestring import mark_safe
from wagtail.wagtailcore import hooks

@hooks.register('insert_tinymce_js')
def my_plugin_js():
    return format_html(
        """
        <script>
            registerMCEPlugin("myplugin", {});
        </script>
        """,
        mark_safe(json.dumps(static('js/my-tinymce-plugin.js'))),
        to_js_primitive(translation.to_locale(translation.get_language())),
    )

版本控制

此软件包的版本号是 TinyMCE 版本，后面是该 TinyMCE 版本的此软件包的发行号。

变化

执照

此软件包版权所有 (c) 2016，Isotoma Limited 保留所有权利。

如果满足以下条件，则允许以源代码和二进制形式重新分发和使用，无论是否经过修改：

• 源代码的再分发必须保留上述版权声明、此条件列表和以下免责声明。

• 二进制形式的再分发必须在随分发提供的文档和/或其他材料中复制上述版权声明、此条件列表和以下免责声明。

• 未经事先明确的书面许可，不得使用 Isotoma Limited 的名称或其贡献者的名称来认可或推广源自该软件的产品。

本软件由版权所有者和贡献者“按原样”提供，并且不提供任何明示或暗示的保证，包括但不限于对适销性和特定用途适用性的暗示保证。在任何情况下，ISOTOMA LIMITED 均不对任何直接、间接、偶然、特殊、示例性或后果性损害（包括但不限于采购替代商品或服务；使用、数据或利润损失；或业务中断）承担责任) 无论是由何种责任理论引起的，无论是在合同、严格责任或侵权行为（包括疏忽或其他方式）中，以任何方式因使用本软件而引起，即使已被告知存在此类损害的可能性。