Thinkphp编辑器扩张类kindeditor使用方法

Thinkphp编辑器扩展类kindeditor使用方法


一, 使用前的准备。
使用前请确认你已经建立好了一个Thinkphp网站项目。
1Keditor.class.php和JSON.class.php 是编辑器扩展类文件,将他们复制到你的网站项目的ThinkPHP\Lib\ORG\Net 文件夹下。
2editor文件夹是kindeditor的核心包。将其复制到你项目的Public文件夹下(和入口文件同级的那个Public,并在Public下再建立一个Upload文件夹,用于存放使用编辑器上传的图片。
3KeditorAction.class.php是编辑器的上传图片功能和浏览远程图片功能,将其复制到你项目的lib\Action 文件夹下。

二, 对象的调用
在控制器方法中调用对象:

import("ORG.Net.Keditor");
$ke=new Keditor();
$ke->id="content";//指定textarea的id
$keshow=$ke->show();//生成js代码
$this->assign("keshow",$keshow);
$this->display();



在方法对应的模版文件中显示编辑器:

<html>
<head>{$keshow}</head><!--输出js,建议放在head-->
<body>
<form id="form1" name="form1" method="post" action="">
<textarea name="content" id="content" cols="70" rows="20"><!-文本域,id为content-->
</textarea>
<input name="img" id="img" type="hidden" value="" /><!--隐藏域存储编辑器上传的图片地址,id为img-->
</form>
</body>
</html>


上面的是最简单的调用方法,扩展类还有很多属性和方法。要想实现更完美的功能,接着往下读。

三, 对象的属性
   我把属性分为两种,一种是kindeditor自带属性,一种是扩展新增属性。如果你以前就使用过kindeditor,你应该知道kindeditor自身有id、items、width、height、afterCreate等等30个属性。这些属性现在可以用过php直接定义,比如定义id$ke->id=”content”,定义宽度:$ke->width=”700px”; 我先说对象新增属性。
对象的新增属性:
1jspath:定义kindeditor的核心js文件,默认值为/Public/editor/kindeditor.js ,如果你的editor文件夹没有放在Publib下需要指定此属性,$ke->jspath=”/kind/ kindeditor.js”;
2form指定提交的表单(from)的id,默认为form1,这个属性是结合ctrl+enter提交功能使用的,比如有个你的编辑器放在表单id为 “formid”内,要实现ctrl+enter提交formid表单,需要定义$ke->form=”formid” 。  ctrl+enter提交功能还要设置其他属性,后面再讲解。
3imgid指定存放图片地址的隐藏域id,默认为img。编辑器每上传一张图片,会把图片地址存储到该隐藏域。在向数据库添加数据时,可以把此隐藏域中的数据也保存到数据库字段中,在删除数据时候,先读取数据库存放的图片地址,进行删除。删除过程只要调用对象的delimg方法即可,此方法后面详解。这样就达到删除内容同时删除图片的目的。
自带属性:
1items:配置编辑器的工具栏,定义方法如
$ke->items=”['source', '|', 'fullscreen', 'undo', 'redo', 'print', 'cut', 'copy', 'paste']”; 
我增加了little关键词,可以快速定义一个精简模型的编辑器,使用方法$ke->items=”little”;
2afterCreate:设置编辑器创建后执行的回调函数,定义方法如
$ke->afterCreate=”function(id){
alert(‘成功创建’+id)
}”;
我增加了ctrlenter关键词,可以快速定义ctrl+enter提交表单,使用方法:
$ke->afterCreate=”ctrlenter”;
同时需要定义$ke->form=”formname”, formname换为你编辑器所在的表单id
3resizeMode:2102时可以拖动改变宽度和高度,1时只能改变高度,0时不能拖动。定义方法如:$ke->resizeMode=1; 注意,数字类型的属性值不要放在引号中,如$ke->resizeMode=”1”;这么定义是错误的。
4allowFileManager:truefalsetrue时显示浏览服务器图片功能(点击上传图片按钮可以看到此功能),定义方法如
$ke-> allowFileManager=ture;
注意,属性值为布尔值时不要放在引号中。
5imageUploadJson指定上传图片的服务器端程序,默认值为 /index.php/Keditor/upload
6fileManagerJson:指定浏览远程图片的服务器端程序,
默认值为/index.php/Keditor/filemanager 
注:之前你复制过的KeditorAction.class.php就是供上传图片和浏览远程图片使用的。文件内的upload方法定义了上传图片处理过程,文件内的filemanager方法定义了浏览图片的处理过程。你可以在这两个方法上加入判断权限的代码,实现只有管理员才能上传图片或浏览图片。你也可以不使用默认的KeditorAction.class.php,自己定义上传处理过程和浏览图片处理过程,则是你需要重新定义imageUploadJson属性值和fileManagerJson属性值。 自定义处理过程,后面详解。
还有其他自带属性,我就不一一列举了。大家可以查看kindeditor官方文档
http://www.kindsoft.net/doc.php?cmd=config
注意,数字类型或布尔类型的属性值,不要放在引号内。其他属性值放在引号中,属性值的格式和kindeditor自身格式一样。



四 对象的方法。
1upload,上传图片。此方法在编辑器上传图片处理过程中使用,使用方法:

import("ORG.Net.Keditor");
Keditor::upload('./Public/Upload/','/Public/Upload/',array('gif','jpg','jpeg','png','bmp'),1000000);


 upload方法有三个参数,依次是,“上传图片目录”,“图片显示地址”,“允许上传图片格式”,“允许的图片大小(单位kb)”
上传图片目录:默认值“./Public/Upload/”(注意Public前面有个“点”符号,是使用的相对地址,不可使用绝对地址),上传图片目录地址是相当于处理文件的。Thinkphp所有的代码都是通过入口文件运行的,所以这个地址其实是相对于入口文件的。
显示图片地址:默认值“/Public/Upload”(一般是绝对地址),假设我们上传了一张图片,服务器端生成的图片名为 12345.gif。上传会显示的图片地址则为/Public/Upload/12345.gif ,因为我们使用的是绝对地址,所以编辑器发布的内容不管在网站的哪儿,图片都能正常显示。
允许上传的图片格式:定义一个数组,默认值为array('gif','jpg','jpeg','png','bmp')
允许的图片大小:默认值为,1000000 ,单位是bk
2filemanager,浏览服务器的图片。此方法在浏览图片处理过程中使用。使用方法:

import("ORG.Net.Keditor");
Keditor::filemanager("./Public/Upload/","/Public/Upload/",array('gif','jpg','jpeg', 'png', 'bmp'));


参数依次是:“浏览图片目录”,“图片显示地址”,“允许浏览的图片格式”,和upload方法一样,浏览图片目录是相对地址,图片显示地址是觉得地址。

3delimg:删除通过编辑器上传的图片。此方法一般在你删除数据库数据时使用。

import("ORG.Net.Keditor");
Keditor::delimg($imgfield);
//$imgfield 一般是你数据库存放图片地址的字段。



4show返回生成的js代码。此方法一般在显示编辑器的控制器中使用。
show方法可以使用一个参数定义kindeditor自带属性。如:

import("ORG.Net.Keditor");
$ke=new Keditor();
$ke->show(“{
id : ”content”,
width: ‘700px’;
height : ”300px”;
imgid : ”img”
}”);


不建议用show传参方式定义kindeditor属性。show传参方式不能定义jspathform两个新站属性,也不能使用littlectrlenter关键词。