ozerk / akka-ck-editor
AkkaCKEditor插件用于CakePHP
Requires
- php: >=5.4
- cakephp/cakephp: ~3.0
Requires (Dev)
This package is not auto-updated.
Last update: 2024-10-02 10:27:28 UTC
README
一个允许将CKEditor集成到应用程序的CakePHP 3.x插件。
要求
- CakePHP 3.x
- PHP 5.4.6+
- CKEditor - 由本助手使用CKEditor的CDN自动加载 http://cdn.ckeditor.com/
包含
- CKEditor助手
安装
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
中加载插件的助手
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' ]]; }
使用方法
助手模板文件设置
- 在应用程序的
default.ctp
文件中,在</head>
标签之前添加<?php echo $this->CKEditor->loadJs(); ?>
。这将使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'); ?>
免责声明
尽管我们已经进行了许多测试以确保此插件按预期工作,但我们建议您自行承担风险使用它。与其他任何事物一样,您应该在测试环境中首先测试您应用程序中的任何新增功能。请通过问题或拉取请求提供任何修复或增强。