CakeDC TinyMCE 插件技术文档

1. 安装指南

系统要求

• CakePHP 4.0 及以上版本
• PHP 5.5.9 及以上版本

安装步骤

1. 使用 Composer 安装插件：

   composer require cakedc/tinymce
   

2. 在 src/Application.php 中加载插件：

   $this->addPlugin('CakeDC/TinyMCE');
   

3. 运行数据库迁移（如果需要）：

   bin/cake migrations migrate -p CakeDC/TinyMCE
   

2. 项目使用说明

基本使用

1. 在需要使用 TinyMCE 的视图中，加载插件的 JavaScript 和 CSS 文件：

   echo $this->Html->script('CakeDC/TinyMCE.tinymce/tinymce.min.js');
   echo $this->Html->css('CakeDC/TinyMCE.tinymce/skins/ui/oxide/skin.min.css');
   

2. 初始化 TinyMCE：

   tinymce.init({
       selector: 'textarea',
       plugins: 'advlist autolink lists link image charmap print preview anchor',
       toolbar: 'undo redo | formatselect | bold italic | alignleft aligncenter alignright alignjustify | bullist numlist outdent indent | link image'
   });
   

自定义配置

你可以根据需要自定义 TinyMCE 的配置选项，例如：

tinymce.init({
    selector: 'textarea',
    height: 500,
    plugins: 'advlist autolink lists link image charmap print preview anchor',
    toolbar: 'undo redo | formatselect | bold italic | alignleft aligncenter alignright alignjustify | bullist numlist outdent indent | link image',
    content_css: 'path/to/custom.css'
});

3. 项目 API 使用文档

TinyMCE 初始化 API

• tinymce.init(options): 初始化 TinyMCE 编辑器。options 是一个包含配置选项的对象。

常用配置选项

• selector: 指定要转换为 TinyMCE 编辑器的元素选择器。
• plugins: 指定要加载的插件列表。
• toolbar: 定义工具栏按钮。
• height: 设置编辑器的高度。
• content_css: 指定自定义的 CSS 文件路径。

示例

tinymce.init({
    selector: 'textarea',
    plugins: 'advlist autolink lists link image charmap print preview anchor',
    toolbar: 'undo redo | formatselect | bold italic | alignleft aligncenter alignright alignjustify | bullist numlist outdent indent | link image'
});

4. 项目安装方式

使用 Composer 安装

composer require cakedc/tinymce

手动安装

1. 下载插件压缩包并解压到 plugins/CakeDC/TinyMCE 目录。
2. 在 src/Application.php 中加载插件：

   $this->addPlugin('CakeDC/TinyMCE');
   

通过以上步骤，你可以成功安装并使用 CakeDC TinyMCE 插件，享受 TinyMCE 富文本编辑器的强大功能。