akkaweb / cakephp-ckeditor
CakePHP 的 AkkaCKEditor 插件
Requires
- php: >=5.4
Requires (Dev)
This package is auto-updated.
Last update: 2020-01-10 15:30:14 UTC
README
一个 CakePHP 3.x 插件,允许将 CKEditor 集成到应用程序中。
要求
- CakePHP 3.x
- PHP 5.4.6+
- CKEditor - 通过此 Helper 使用 CKEditor 的 CDN 自动加载 http://cdn.ckeditor.com/
包含
- CKEditor Helper
安装
Composer(最佳选择)
- 将以下内容添加到您的应用程序根目录中的
composer.json
文件中,在require
部分中。例如,/var/www/domain.com/composer.json
"require": { "akkaweb/cakephp-ckeditor": "dev-master" }
- 在应用程序根目录中运行以下命令
sudo php composer.phar update
注意:如果找不到 composer.phar
,您需要安装它。请参阅 CakePHP 文档中的以下部分 -> https://book.cakephp.com.cn/3.0/en/installation.html。参考安装 CakePHP 部分
Git 克隆
git clone git@github.com:akkaweb/AKKA-CakePHP-CKEditor-Plugin.git
下载
https://github.com/akkaweb/AKKA-CakePHP-CKEditor-Plugin/archive/master.zip
注意:当使用手动下载或 Git 克隆安装时,如果 CakePHP 抱怨找不到插件,您需要将插件添加到 vendor/cakephp-plugins.php
中的 plugins
数组 [] -> 'AkkaCKEditor' => $baseDir . '/plugins/AkkaCKEditor/'
。如果您使用 composer,运行 php composer.phar dumpautoload
可能足够。如果不起作用,请将以下内容添加到根应用程序的 composer.json
文件中的 "autoload"
部分的 "psr-4":
部分: "AkkaCKEditor\\": "./plugins/AkkaCKEditor/src"
配置
- 在您的应用程序的
bootstrap.php
文件中加载插件
Plugin::load('AkkaCKEditor', ['bootstrap' => false, 'routes' => true]);
- 在
AppController.php
中加载插件的 Helper
class AppController extends Controller{ public $helpers = ['AkkaCKEditor.CKEditor']; }
- 您可以选择要加载的 CKEditor 的版本和分发。更多详细信息请参阅 http://cdn.ckeditor.com/
class AppController extends Controller { public $helpers = ['AkkaCKEditor.CKEditor' => [ 'version' => '4.4.7', // Default Option 'distribution' => 'full' // Default Option / Other options => 'basic', 'standard', 'standard-all', 'full-all' ]]; }
用法
Helper 模板文件设置
- 将
<?php echo $this->CKEditor->loadJs(); ?>
添加到应用程序的default.ctp
文件中,在</head>
标签之前。这将使 CKEditor 在整个应用程序中可用。它也可以在模板文件的第一行或您想要应用 CKEditor 的textarea
之前加载。
CKEditor.replace
在您想要应用 CKEditor 的 textarea 后立即插入以下代码
// replace(field-name) -> replace takes field_name and can be used multiple times throughout your application
<?php echo $this->Form->input('body'); ?> // Example
<?php echo $this->CKEditor->replace('body'); ?>
免责声明
尽管我们已经进行了许多测试以确保此插件按预期工作,但我们建议您自行承担风险使用。与其他任何事物一样,您应该首先在测试环境中测试应用中的任何新增功能。请通过问题报告或拉取请求提供任何修复或改进。