Asp.net 中配置 CKEditor和CKFinder

一、官方Download

1、CKEditor :官方下载链接http://ckeditor.com/download

点击CKEditor.NET标题下的“Download zip”按钮

此处使用当前最新版本“CKEditor.NET 3.5.2, released on 7 March 2011”

2、CKFinder :官方下载链接http://ckfinder.com/download

点击Asp.net标签下的“Download zip”或者“Download tar.gz”按钮(PS:两个按钮下载的内容一样,说明

此处使用当前最新版本“version: 2.0.2, updated 03.03.2011”

——CKEditor是新一代的FCKEditor,很明显的不同点是CKEditor中文件上传功能独立出来了,需要配合使用CKFinder才能实现。

二、具体配置顺序

1、在项目中添加对应的文件

右击网站,添加引用。依次添加两个文件夹中“/bin/Release” 中的dll文件——CKEditor.NET.dll、CKFinder.dll(版本已经升级,可以不引用CKEditor.NET.dll,直接用ckeditor文件夹就行)

2、将“ckeditor”、“ckfinder”添加到网站的根目录下

注意,下载的文件中包括很多用不到的文件,可以稍微清理一下:

此版本对于CKEditor只需要“/_Samples”文件夹下的“ckeditor”文件夹即可,其余都可不要。

两个文件夹中的以下内容可以删除:

_source文件夹(源程序文件,可以删除)

_Samples文件夹(建议删除,否则生成解决方案可能会出错)
changes.html(更新列表,可以删除)
install.html(安装指向,可以删除)
license.html(使用许可,可以删除)

3、修改配置文件

(1)CKEditor配置:打开“ckeditor/config.js”文件,根据需要添加配置信息

CKEDITOR.editorConfig = function(config) {

config.skin = 'v2'; //选择皮肤,源文件在“ckeditor/skins/”中
config.resize_enabled = false;

// 基础工具栏
// config.toolbar = "Basic";
// 全能工具栏
// config.toolbar = "Full";
// 自定义工具栏
config.toolbar =
[
['Source', '-', 'Preview'], ['Cut', 'Copy', 'Paste', 'PasteText', 'PasteFromWord'],
['Undo', 'Redo', '-', 'Find', 'Replace', '-', 'SelectAll', 'RemoveFormat'],
['NumberedList', 'BulletedList', '-', 'Outdent', 'Indent', 'Blockquote', 'ShowBlocks'], '/',
['Bold', 'Italic', 'Underline', 'Strike', '-', 'Subscript', 'Superscript'],
['JustifyLeft', 'JustifyCenter', 'JustifyRight', 'JustifyBlock'], ['Link', 'Unlink', 'Anchor'],
['Image', 'Flash', 'Table', 'HorizontalRule', 'SpecialChar'], '/',
['Styles', 'Format', 'Font', 'FontSize'], ['TextColor', 'BGColor'], ['Maximize', '-', 'About']
];

}

(2)在CKEditor中集成CKFinder,注意对应文件的路径

将下面的内容继续添加到“ckeditor/config.js”文件中

CKEDITOR.editorConfig = function(config) {
……
config.filebrowserBrowseUrl = 'ckfinder/ckfinder.html'; //不要写成"~/ckfinder/..."或者"/ckfinder/..."
config.filebrowserImageBrowseUrl = 'ckfinder/ckfinder.html?Type=Images';
config.filebrowserFlashBrowseUrl = 'ckfinder/ckfinder.html?Type=Flash';
config.filebrowserUploadUrl = 'ckfinder/core/connector/aspx/connector.aspx?command=QuickUpload&type=Files';
config.filebrowserImageUploadUrl = 'ckfinder/core/connector/aspx/connector.aspx?command=QuickUpload&type=Images';
config.filebrowserFlashUploadUrl = 'ckfinder/core/connector/aspx/connector.aspx?command=QuickUpload&type=Flash';

config.filebrowserWindowWidth = '800';  //“浏览服务器”弹出框的size设置
config.filebrowserWindowHeight = '500'; 
}
CKFinder.SetupCKEditor(null, '../ckfinder/');//注意ckfinder的路径对应实际放置的位置
 
  
(3)CKFinder的配置:

打开“ckfinder/”下的用户控件config.ascx,更改其BaseUrl路径:

BaseUrl = "~/ckfinder/userfiles/";//or BaseUrl = "ckfinder/userfiles/";

并且更改:

public override boolCheckAuthentication() {
//return false;
return true;//此处直接设置为true有一些危险,正式使用时要适当加入自己的判断逻辑

}

至此,配置工作终于完成啦。。

三、在页面应用CKEditor控件

1、在页面的<head>中添加对应的js引用:

    <script type="text/javascript" language="javascript" src="ckfinder/ckfinder.js"></script>
    <script type="text/javascript" language="javascript" src="ckeditor/ckeditor.js"></script>

2、然后,在<body>中需要放置该控件的位置加入如下代码,分别有以下几种使用方法:

(1)给控件添加指定的class属性
    <textarea id="textarea1" name="editor1" class="ckeditor">hello!</textarea>
服务器控件:
    <asp:TextBox ID="TextBox1" runat="server" TextMode="MultiLine" CssClass="ckeditor"></asp:TextBox>
 
  
(2)注入js代码——此处js代码最好写在控件之后,也可以写在<head>中
   
    <textarea id="textarea1" name="editor1" class="ckeditor">hello!</textarea>
<script type="text/javascript"> CKEDITOR.replace('editor1', { height:400, width:800 }); </script>
服务器控件:
  <asp:TextBox ID="TextBox1" runat="server" TextMode="MultiLine" CssClass="ckeditor"></asp:TextBox>     <script type="text/javascript">
        CKEDITOR.replace('<%=mckeditor.ClientID %>');
    </script>
 
  
使用过程中难免想要对其进行一些改造,可以参考: ckeditor与ckfinder的中国本地化改造 
 
 

你可能感兴趣的:(ckeditor)