FCKeditor 的配置和使用方法(for PHP)

帅帅男孩

　　FCKeditor 是一个十分强大的网页文本编辑器，它支持多种脚本编程语言(包括 PHP)和支持多国语言。
　　FCKeditor 截至 2008年4月6日，其最新版本是 2.6RC，RC 就是 Release Candidate，修订后的候选版本，很可能作为该版本的稳定版在未来发布。目前的最新的稳定版(Latest Stable)是 2.5.1。我们可以到他的官方网站上去下载 http://www.FCKeditor.net 合适的版本，开源、免费的。
　　本文介绍 PHP 中的配置方法，其他语言的配置方法和它是基本一样的。
　　〇、假设网站的目录为：
\website_root
\index.php
\FCKeditor
　　一、调用FCKeditor 的两种方法
　　1、通过创建实例来调用
　　在 index.php 文件中，调用它的代码，把下面的代码加在需要编辑器的地方：
<Form name="frm1">
<?php
//引用FCKeditor.php这个文件，基本的类和数据结构都在这里
include_once("FCKeditor/fckeditor.php");
//创建FCKeditor对象的实例。myFCKeditor即提交后，接收数据页面 $_POST['myFCKeditor']使用
$FCKeditor=new FCKeditor('myFCKeditor');
//FCKeditor所在的位置，这里它的位置就是'FCKeditor' 文件夹
$FCKeditor->BasePath='./FCKeditor/';
//工具按钮设置
$FCkeditor->ToolbarSet='Default';
//设置它的宽度
$FCKeditor->Width='100%';
//设置它的高度
$FCKeditor->Height='300px';
//生成
$FCkeditor->Create();
?>
</Form>
　　2、通过 IFRAME 调用
　　<Form name="frm1">
<INPUT name="myFCKeditor" id="myFCKeditor" style="DISPLAY: none" type=hidden>
<INPUT id="myFCKeditor___Config" style="DISPLAY: none" type=hidden>
<IFRAME id="myFCKeditor___Frame" src="FCKeditor/editor/fckeditor.html?InstanceName=myFCKeditor&amp;Toolbar=Default" frameBorder=0 width=100% scrolling=no height=300>
</IFRAME>
</Form>
　　注意：name="myFCKeditor" 和 IFRAME 中 InstanceName=myFCKeditor 的“myFCKeditor”必须相同。
　　其实，用 IFRAME 调用和用第一种方法本质是完全一样的！不信的话，请在用浏览器打开网站上的 index.php 文件，然后查看“源代码”，就是本 IFRAME 调用的代码。所以推荐通过创建实例来调用。
　　3、当用 Javascript 来获得内容的时候是不是发现得不到内容，如：
<script>
<input type=button  value="GetHtml">
</script>
你会发现弹谈出的窗口没内容。
　　我们可以通过下面的代码来获得它的内容：
　　<script>
function getContentValue()
{
var oEditor = FCKeditorAPI.GetInstance('myFCKeditor');
var acontent = oEditor.GetXHTML();
return acontent;
}
</script>
<input type=button >
　　二、配置一些文件
　　1、fckconfig.js的配置
　　(1)工具按钮设置
　　查找 FCKConfig.ToolbarSets["Default"]，这里有很多按钮，下面我们将对他们详细介绍
　　EditSource 显示HTML源代码
StrikeThrough 删除线
Save 保存
NewPage 新建空白页面
Superscript 上标
Subscript 下标
Preview 预览
JustifyLeft 左对齐
Cut 剪切
Copy 复制
Paste 粘贴
JustifyCenter 居中对齐
JustifyRight 右对齐
JustifyFull 两端对齐
PasteText 纯文本粘贴
InsertOrderedList 自动编号
PasteWord 来自Word的粘贴
InsertUnorderedList 项目符号
Print 打印
Outdent 减少缩进
SpellCheck 拼写检查
Indent 增加缩进
Find 查找
ShowTableBorders 显示表格线
Replace 替换
ShowDetails 显示明细
Undo 撤销
Form 添加Form动作
Redo 还原
Checkbox 复选框
SelectAll 全选
Radio 单选按钮
RemoveFormat 去除格式
Input 单行文本框
Link 插入/编辑 链接
Textarea 滚动文本框
RemoveLink 去除连接
Select 下拉菜单
Anchor 锚点
Button 按钮
Image 插入/编辑 图片
ImageButton 图片按钮
Table 插入/编辑 表格
Hidden 隐藏
Rule 插入水平线
Zoom 显示比例
SpecialChar 插入特殊字符
FontStyleAdv 系统字体
UniversalKey 软键盘
FontStyle 字体样式
Smiley 插入表情符号
FontFormat 字体格式
About 关于
Font 字体
Bold 粗体
FontSize 字体大小
Italic 斜体
TextColor 文字颜色
Underline 下划线
BGColor 背景色
　　这个默认的是包含了所有的工具按钮，但是有时有的按钮并不需要。那么我们可以将不需要的按钮给删了。下面是一个定制的配置，给大家一个参考。
FCKconfig.ToolbarSets["Default"] = [
['EditSource','Save','NewPage','Preview','-','Cut','Copy','Paste','PasteText','-','Find','Replace','-','Undo','Redo','-','SelectAll','-','Link','RemoveLink','-','Image','Table','Rule','SpecialChar','Smiley'] ,
['Bold','Italic','Underline','-','JustifyLeft','JustifyCenter','JustifyRight','-','InsertOrderedList','InsertUnorderedList','-','Form','Checkbox','Radio','Input','Textarea','Select','Button','-','FontStyleAdv','TextColor']
];
　　再例如：
FCKConfig.ToolbarSets["Basic"] = [
['Bold','Italic','-','OrderedList','UnorderedList','-','Link','Unlink','-','About']
];
　　这样的话，你在前台调用的时候就要用 $FCKeditor->ToolbarSet='Basic'，不能再是"Default"了。
　　(2)语言的配置
　　查找FCKConfig.DefaultLanguage将它设置为'zh-cn'.
　　(3)脚本语言的设置
　　查找var _FileBrowserLanguage和var _QuickUploadLanguage将他们设置为'php', 默认是'asp',如果这里不设置的话，图片将不能上传，这点很重要。当时我在用FCKeditor由于没配置这个，不能上传图片，而我同寝室的用asp能上传图片，让我烦恼了好多天，最后终于找到是这个原因。
　　2、图片上传的配置
　　打开文件FCKeditor/editor/filemanager/browser/default/connectors/php/config.php：
查找$Config['Enabled']，将它设置为'true'；查找$Config['UserFilesPath']，将它设置图片的目录，这个目录是相对于主目录的。
　　例如：我写了一个blog，就可以设置为/blog/upload/
　　打开文件FCKeditor/editor/filemanager/upload/php/config.php：
查找$Config['Enabled']，将它设置为'true'；查找$Config['UseFileType']，将它设置上传文件的目录，最好与上面的图片目录相同。
　　好了，现在所有的配置都已经完成了，现在你要做的只是删除一些不必要的文件了。只要包含'_'的目录名和文件名都可以删除，这都是一些说明文件。因为我们用在 PHP 环境中，其他语言相关的一些文件也都可以删除。
　　张庆 http://www.why100000.com
2008-4-6