danny3b / akka-ckeditor
AkkaCKEditor插件用于CakePHP
Requires
- php: >=5.4
Requires (Dev)
This package is auto-updated.
Last update: 2024-09-24 21:20:55 UTC
README
A CakePHP 3.x 插件,允许将 CKEditor 集成到应用程序中。
需求
- CakePHP 3.x
- PHP 5.4.6+
- CKEditor - 本助手使用 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 Clone
git clone git@github.com:akkaweb/AKKA-CakePHP-CKEditor-Plugin.git
下载
https://github.com/akkaweb/AKKA-CakePHP-CKEditor-Plugin/archive/master.zip
注意:当使用手动下载或Git Clone安装时,如果 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'); ?>
免责声明
虽然我们已经进行了许多测试以确保此插件按预期工作,但我们建议您自行承担风险使用它。与任何其他事物一样,您应首先在测试环境中测试任何添加到应用程序的内容。请通过问题或拉取请求提供任何修复或改进。