abmat/craft-tinymce

适用于Craft CMS的TinyMCE字段

2.0.5 2024-09-23 09:54 UTC

This package is auto-updated.

Last update: 2024-09-23 09:55:02 UTC


README

适用于Craft CMS的TinyMCE字段

一个Craft CMS插件,用于将TinyMCE编辑器作为字段类型添加。

安装

此插件可以从Craft插件商店或使用Composer安装。

Craft插件商店

打开Craft项目的控制面板,导航到插件商店,搜索TinyMCE字段,然后点击安装。

Composer

打开终端,导航到Craft项目的根目录,并运行以下命令

# go to the project directory
cd /path/to/my-project.test

# tell Composer to load the plugin
composer require abmat/craft-tinymce

# tell Craft to install the plugin
php craft plugin/install abm-tinymce

要求

TinyMCE Field 1.x需要Craft CMS 4.x。TinyMCE Field 2.x需要Craft CMS 5.x。

配置

您可以在config/tinymce/目录中创建自定义TinyMCE配置,这些配置将可用于您的TinyMCE字段。它们应该以JSON文件的形式创建。插件安装时将创建默认配置。您可以添加自定义项目配置文件,如project1.json、project2.json等,以在TinyMCE字段设置中获得这些配置。

有关可用配置选项和按钮的列表,请参阅TinyMCE文档

自定义TinyMCE配置

这里描述了一些自定义TinyMCE配置

  • craftlink_adv_tab [布尔值]: 如果您想能够添加ID和额外的类到您的链接,则将其设置为true
  • craftlink_data_attr [数组]: 您可以在此处定义可以填充到您的链接中的data-属性。只有当craftlink_adv_tab激活时才有效。
  • craftlink_anker [布尔值]: 如果您想为您的链接提供一个锚点字段,则将其设置为true
  • craftimage_title [布尔值]: 如果您想在您的图像中添加标题,则将其设置为true
  • craftimage_class_list [数组]: 您可以定义一个数组,用于分配给您的图像的自定义类。{ "title": "默认", "value": "editor-img-default" }

对于每个TinyMCE配置,您都可以在config/tinymce/resources目录中添加自定义CSS文件。例如,对于Project1.json配置,您可以添加一个Project1.css文件,以便将这些样式应用到后端编辑器中的自定义样式。

插件 "abmChatGpt" 和按钮 "abmChatGptLanguages", "abmChatGptPrompts"

要启用我们的插件"ChatGPT for editors - Plugin",将"abmChatGpt"添加到自定义tinymce配置中的插件列表,然后添加按钮"abmChatGptLanguages"和/或"abmChatGptPrompts"到工具栏。按钮"abmChatGptLanguages"用于翻译。按钮"abmChatGptPrompts"用于提示。

在全新安装中,插件"abmchatGpt"和按钮已包含在Default.json文件中。

TinyMCE样式格式

您可以通过将其添加到您的json配置文件中来向编辑器添加自定义样式格式。有关可用配置选项的列表,请参阅TinyMCE样式格式文档

示例

"style_formats": [
  {
    "title": "Font Color",
    "items": [
      {"title": "orange", "inline": "span", "classes": "fc-orange"},
      {"title": "blau", "inline": "span", "classes": "fc-blue"}
    ]
  },
  {
    "title": "SEO",
    "items": [
      {"title": "H1", "format": "h1"},
      {"title": "H2", "format": "h2"},
      {"title": "H3", "format": "h3"},
      {"title": "H4", "format": "h4"},
      {"title": "H5", "format": "h5"},
      {"title": "H6", "format": "h6"}
    ]
  }
]

tinyMCE链接类

您可以通过将其添加到您的json配置文件中来为您的链接添加自定义链接类。值将在插入/编辑链接时选择为链接类时添加到a标签中。

"link_class_list": [
  {"title": "None", "value": ""},
  {"title": "My custom link class", "value": "custom_link_class"}
]

abm Feregyhazy & Simon GmbH创建和维护