djangocms-text 0.3.1

富文本编辑器选择

要选择富文本编辑器，将编辑器的包添加到您的INSTALLED_APPS中，并将设置DJANGOCMS_TEXT_EDITOR添加到指向编辑器RTEConfig路径。

示例

INSTALLED_APPS = [
    ...,
    "djangocms_text.contrib.text_ckeditor4",
    ...
]

DJANGOCMS_TEXT_EDITOR = "djangocms_text.contrib.text_ckeditor5.ckeditor4"

可能还有其他富文本编辑器可用，例如在extension_text_ckeditor5中的CKEditor 5。

内联编辑功能

内联编辑允许编辑器直接点击文本插件并在django CMS的编辑模式下更改内容。CKEditor将直接出现在文本字段周围，并可正常使用。一旦文本字段失去焦点，更改就会保存。

内联编辑需要在编辑模式中将HTML文本封装在一个<div>中。这可能会与网站的CSS产生一些副作用，例如直接子规则。

要激活内联编辑，请在项目的settings.py中添加以下行

TEXT_INLINE_EDITING = True

这将添加一个切换按钮到工具栏，允许在当前会话中开启和关闭内联编辑。

当内联编辑激活时，编辑器每次失去焦点都会保存插件的内容。如果只有文本已更改，用户可以立即继续编辑。如果更改了文本启用的插件，添加了或删除了它，页面将刷新以更新页面树并获得更改插件的正确渲染版本。

文本启用的插件

djangocms-text支持文本启用的插件，但并非所有富文本编辑器前端都支持。

如果您已创建一个希望在文本插件中使用的插件，您可以通过将其设置为text_enabled来使它们出现在下拉菜单中。这意味着您将插件的属性text_enabled设置为True，默认值为False。以下是一个非常简单的实现

class MyTextPlugin(TextPlugin):
    name = "My text plugin"
    model = MyTextModel
    text_enabled = True

当插件被选中时，它将在CMS插件下拉菜单（拼图图标）中可用，您可以在编辑器中找到它。这使得用户可以非常容易地在一个用户友好的文本块中插入特殊内容，这是他们熟悉的。

该插件甚至会在文本编辑器中预览。小贴士：请确保您的插件提供了自己的icon_alt方法。这样，如果您有许多text_enabled插件，它可以显示有关它的提示。例如，如果您创建了一个显示可配置产品价格的插件，它可以显示带有该产品名称的工具提示。

有关如何扩展CMS以添加插件的信息，请参阅django-cms文档。

文本启用的插件可以使用djangocms-text具有自己的图标。如果插件类具有text_icon属性，则应包含一个图标的SVG源代码。图标将在CMS插件下拉菜单或工具栏中显示。

class MyTextPlugin(TextPlugin):
    name = "My text plugin"
    model = MyTextModel
    text_enabled = True
    text_icon = '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm0 18c-4.41 0-8-3.59-8-8s3.59-8 8-8 8 3.59 8 8-3.59 8-8 8zm-1-13h2v6h-2zm0 8h2v2h-2z"/></svg>'

您还可以通过将插件名称添加到工具栏配置中，例如"LinkPlugin"，来配置文本启用的插件，使其可以从富文本编辑器工具栏直接访问。

占位符中的默认内容

您可以在“default_plugins”中使用 TextPlugin（请参阅有关 CMS_PLACEHOLDER_CONF 设置的文档）。TextPlugin 只需要一个值：body，在其中写入您的默认 HTML 内容。如果您想为自动添加的插件（例如 LinkPlugin）添加一些“默认子项”，您必须在正文中放置子项引用。引用格式为 "%(_tag_child_<order>)s"，其中包含子项的插入顺序。例如

CMS_PLACEHOLDER_CONF = {
    'content': {
        'name' : _('Content'),
        'plugins': ['TextPlugin', 'LinkPlugin'],
        'default_plugins':[
            {
                'plugin_type':'TextPlugin',
                'values':{
                    'body':'<p>Great websites : %(_tag_child_1)s and %(_tag_child_2)s</p>'
                },
                'children':[
                    {
                        'plugin_type':'LinkPlugin',
                        'values':{
                            'name':'django',
                            'url':'https://django.ac.cn/'
                        },
                    },
                    {
                        'plugin_type':'LinkPlugin',
                        'values':{
                            'name':'django-cms',
                            'url':'https://www.django-cms.org'
                        },
                    },
                ]
            },
        ]
    }
}