#######################################################################

# 

# KindEditor 自述文件

#

#######################################################################



一 简单使用方法



1. 把所有文件上传到程序所在目录下，例如：http://你的域名/editor/。



2. 在此目录下创建attached文件夹，并把权限改成777。



3. 要添加编辑器的地方加入以下代码。（原来的TEXTAREA或其它编辑器可以先注释。）

   这里[]里的内容要根据你的实际情况修改。

-----------------------------------------------------------------------

<input type="hidden" name="[原TEXTAREA名字]" value="[这里放你要编辑的内容]">

<script type="text/javascript" charset="utf-8" src="[JS路径]/KindEditor.js"></script>

<script type="text/javascript">

var editor = new KindEditor("editor"); //创建编辑器对象

editor.hiddenName = "[原TEXTAREA名字]";

editor.editorWidth = "[编辑器宽度,例如：700px]";

editor.editorHeight = "[编辑器高度,例如：400px]";

editor.show(); //显示

//提交时获得最终HTML代码的函数

function KindSubmit() {

	editor.data();

}

</script>

-----------------------------------------------------------------------



4. FORM的onsubmit属性里添加KindSubmit()函数。

<form name="formname" onsubmit="javascript:KindSubmit();">

或可以放在提交按钮的onclick属性里。

<input type="button" value="Submit" onclick="javascript:KindSubmit();">



5. 如果KindEditor文件放在其它目录下，那就需要通过skinPath、iconPath属性指定图片、笑脸目录。



* 使用方法可以参考demo文件。



-----------------------------------------------------------------------



二 属性介绍

-----------------------------------------------------------------------

1. siteDomain

网站域名，这个域名下的图片改成相对路径。

默认值：无

例：wwww.kindsoft.net



2. editorType

simple或full，简单模式或完全模式

默认值：full



3. safeMode

true或false，安全模式。true时过滤Script脚本。

默认值：false



4. uploadMode

true或false，上传模式。true时使用上传功能。

默认值：true



5. hiddenName

提交时编辑内容的POST参数名

默认值：无



6. editorWidth

编辑器宽度

默认值：700px



7. editorHeight

编辑器高度

默认值：400px



8. skinPath

编辑器图片路径

默认值：./skins/default/



9. iconPath

编辑器笑脸图片路径

默认值：./icons/



10. imageAttachPath

保存上传图片的路径

默认值：./attached/



11. imageUploadCgi

上传图片的CGI文件路径

默认值：./upload_cgi/upload.php



12. menuBorderColor

下拉菜单边框颜色

默认值：#AAAAAA



13. menuBgColor

下拉菜单背景颜色

默认值：#EFEFEF



14. menuTextColor

下拉菜单文本颜色

默认值：#222222



15. menuSelectedColor

下拉菜单选中颜色

默认值：#DDDDDD



16. toolbarBorderColor

工具栏背景颜色

默认值：#DDDDDD



17. toolbarBgColor

工具栏背景颜色

默认值：#EFEFEF



18. formBorderColor

编辑框边框颜色

默认值：#DDDDDD



19. formBgColor

编辑框背景颜色

默认值：#FFFFFF



20. buttonColor

按钮背景颜色

默认值：#AAAAAA



21. cssPath

指定CSS文件路径

默认值：./common.css

-----------------------------------------------------------------------



属性例子：

-----------------------------------------------------------------------

<input type="hidden" name="content" value="[这里放你要编辑的内容]">

<script type="text/javascript" src="./KindEditor.js"></script>

<script type="text/javascript">

var editor = new KindEditor("editor");

editor.siteDomain = "www.kindsoft.net";

editor.safeMode = true; // true 或 false

editor.uploadMode = true; // true 或 false

editor.hiddenName = "content"; //上面hidden的名字

editor.imageUploadCgi = "./upload_cgi/upload.php"; //图片上传CGI程序

editor.editorType = "simple"; // simple 或 full

editor.skinPath = "./skins/fck/"; //编辑器图片目录

editor.editorWidth = "700px"; //宽度

editor.editorHeight = "400px"; //高度

editor.menuBorderColor = '#696969';

editor.menuBgColor = '#EFEFDE';

editor.menuTextColor = '#000000';

editor.menuSelectedColor = '#C7C78F';

editor.toolbarBorderColor = '#696969';

editor.toolbarBgColor = '#EFEFDE';

editor.formBorderColor = '#696969';

editor.buttonColor = '#C7C78F';

editor.show();

function KindSubmit() {

	editor.data(); //把编辑器的内容放在content隐藏Form里。

}

</script>

-----------------------------------------------------------------------



三 编写上传CGI

-----------------------------------------------------------------------

KindEditor不建议您使用upload_cgi里自带的CGI程序，因为用这个上传图片无法进行管理。

建议您图片原名和更改后名字一起保存到文件或数据库里，并按栏目保存在不同的目录下。



1. Form结构

--------------------------------------

<form name="uploadForm" method="post" enctype="multipart/form-data" action="[imageUploadCgi指定的处理程序]">

更改后文件名<input type="hidden" name="fileName" value="">

文件<input type="file" name="fileData">

描述<input type="text" name="imgTitle" value="">

宽<input type="text" name="imgWidth" value="">

高<input type="text" name="imgHeight" value="">

边<input type="text" name="imgBorder" value="">

<select name="imgAlign">

<option value="">对齐方式</option>

</select>

横隔<input type="text" name="imgHspace" value="">

竖隔<input type="text" name="imgVspace" value="">

<input type="submit" name="button" value="确定">

</form>

--------------------------------------



2. 调用的JavaScript函数

parent.KindInsertImage("[图片URL]","[图片宽度]","[图片高度]","[图片边框]","[ALT里的描述]","[图片对齐方式]","[图片横向空白]","[图片竖向空白]");

最后上传成功后执行这个函数插入图片并关闭下拉菜单。

* 注意点: 文件要上传到JavaScript里imageAttachPath目录里。



parent.KindDisableMenu();

隐藏所有弹出菜单。



parent.KindReloadIframe();

重新装载图片弹出菜单。



3. 具体编写方法请参考upload_cgi里的程序。



-----------------------------------------------------------------------



四、风格制作方法

-----------------------------------------------------------------------

1. 首先在skins目录下建立一个目录。例如： skins/myskin/



2. 把skins/default/目录下的所有文件复制到自定义风格目录下。

然后可以一个一个替换，大小可以不同，但名字必须保持一致。



3. 在调用编辑器的地方，通过属性配置风格路径和编辑器颜色。



例如：

editor.skinPath = "./skins/myskin/"; //指向刚才制作好的目录

editor.menuBorderColor = '#696969';

editor.menuBgColor = '#EFEFDE';

editor.menuTextColor = '#000000';

editor.menuSelectedColor = '#C7C78F';

editor.toolbarBorderColor = '#696969';

editor.toolbarBgColor = '#EFEFDE';

editor.formBorderColor = '#696969';

editor.buttonColor = '#C7C78F';

-----------------------------------------------------------------------



-----------------------------------------------------------------------



五、常见问题

-----------------------------------------------------------------------

1. 怎么在GB2312编码下使用KindEditor？



答：本编辑器默认采用UTF-8格式。要改成GB2312格式，用任何带有编码转换功能的编辑器（UltraEdit, EditPlus等）把KindEditor.js文件格式转换成GB2312就可以。

若使用图片上传功能，upload程序也要改成GB2312。

或者包含KindEditor.js时指定charset。

<script type="text/javascript" charset="utf-8" src="[JS路径]/KindEditor.js"></script>

-----------------------------------------------------------------------



要了解详情或有疑问，请访问http://www.kindsoft.net。