.Net在线编辑器：KindEditor及CkEditor+CkFinder配置说明

Net在线编辑器：KindEditor及CkEditor+CkFinder配置说明

一、KindEditor(免费)

KindEditor是一套开源的HTML可视化编辑器，主要用于让用户在网站上获得所见即所得编辑效果，兼容IE、Firefox、Chrome、Safari、Opera等主流浏览器。 KindEditor使用JavaScript编写，可以无缝的与Java、.NET、PHP、ASP等程序接合。
KindEditor非常适合在CMS、商城、论坛、博客、Wiki、电子邮件等互联网应用上使用，2006年7月首次发布2.0以来，KindEditor依靠出色的用户体验和领先的技术不断扩大编辑器市场占有率，目前在国内已经成为最受欢迎的编辑器之一。

目前最新版本 KindEditor 3.5.2，官网及下载地址

KindEditor配置步骤：

1、在项目中建立KindEditor文件夹，把下载下来后的文件解压，将其中的skins，plugins，kindeditor.js 拷到该KindEditor文件夹目录下；

2、在.aspx文件中放入TextBox控件，并设置控件ID

如：<asp:TextBox ID="txtContent" TextMode="MultiLine"  runat="server"></asp:TextBox>

3、在.aspx文件中引入kindeditor.js文件及Js代码，可将TextBox控件设置成KindEditor在线编辑器，代码如下：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

<script src="../kindeditor/kindeditor.js" type="text/javascript"></script> <script type="text/javascript">     KE.show({         id: txtContent,         imageUploadJson: '/handler/upload_json.ashx',         items : [         'source', '|', 'fullscreen', 'undo', 'redo', 'print', 'cut', 'copy', 'paste',         'plainpaste', 'wordpaste', '|', 'justifyleft', 'justifycenter', 'justifyright',         'justifyfull', 'insertorderedlist', 'insertunorderedlist', 'indent', 'outdent', 'subscript',         'superscript', '|', 'selectall', '-',         'title', 'fontname', 'fontsize', '|', 'textcolor', 'bgcolor', 'bold',         'italic', 'underline', 'strikethrough', 'removeformat', '|', 'image',         'flash', 'media', 'advtable', 'hr', 'emoticons', 'link', 'unlink'          ]     }); </script>

其中，id为TextBox控件的ID，imageUploadJson: '/handler/upload_json.ashx'可设置图片上传(文件上传设置同理)，item为设置编辑器工具栏上的每一个功能是否显示，可根据需要手动增删对应单词，如不需要“HTML代码”功能则删除“'source',”；

4、在.aspx页面的第一句话及Page指令中加上validaterequest=”false”，禁止.net自动屏蔽上传Html代码；

　　如：<%@ Page Language="C#" ValidateRequest="false"...

5、设置完毕，后台可直接通过TextBox的text属性来获取编辑器内容；

另：设置KindEditor的图片上传功能
1、在刚才在.aspx页面中添加的js代码中添加imageUploadJson参数，

　　如：imageUploadJson: '/handler/upload_json.ashx'
2、建立一般处理程序页面upload_json.ashx，该页面用于编写文件上传代码，在下载下来的源码有，在asp.net中，稍作修改，代码如下：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91

using System; using System.Collections.Generic; using System.Linq; using System.Web; using System.Collections; using System.IO; using System.Globalization; using LitJson; // 需先手动添加LitJson.dll的引用，在asp.net\bin中   namespace Yongbin.Shop.Web.handler {     /// <summary>     /// upload_json 的摘要说明     /// </summary>     public class upload_json : IHttpHandler     {         //文件保存目录路径         private String savePath = "/upload/" + DateTime.Now.ToString("yyyyMMdd") + "/";  // 修改上传目录         //文件保存目录URL(显示在kindeditor编辑器中的地址)         private String saveUrl = "/upload/" + DateTime.Now.ToString("yyyyMMdd") + "/";         //定义允许上传的文件扩展名         private String fileTypes = "gif,jpg,jpeg,png,bmp";         //最大文件大小         private int maxSize = 1000000;           private HttpContext context;           public void ProcessRequest(HttpContext context)         {             this.context = context;               HttpPostedFile imgFile = context.Request.Files["imgFile"];             if (imgFile == null)             {                 showError("请选择文件。");             }               String dirPath = context.Server.MapPath(savePath);             if (!Directory.Exists(dirPath))             {                 Directory.CreateDirectory(dirPath);  // 复制过来的代码改了这里，自动创建目录             }               String fileName = imgFile.FileName;             String fileExt = Path.GetExtension(fileName).ToLower();             ArrayList fileTypeList = ArrayList.Adapter(fileTypes.Split(','));               if (imgFile.InputStream == null || imgFile.InputStream.Length > maxSize)             {                 showError("上传文件大小超过限制。");             }               if (String.IsNullOrEmpty(fileExt) || Array.IndexOf(fileTypes.Split(','), fileExt.Substring(1).ToLower()) == -1)             {                 showError("上传文件扩展名是不允许的扩展名。");             }               String newFileName = DateTime.Now.ToString("yyyyMMddHHmmss_ffff", DateTimeFormatInfo.InvariantInfo) + fileExt;             String filePath = dirPath + newFileName;               imgFile.SaveAs(filePath);               String fileUrl = saveUrl + newFileName;               Hashtable hash = new Hashtable();             hash["error"] = 0;             hash["url"] = fileUrl;             context.Response.AddHeader("Content-Type", "text/html; charset=UTF-8");             context.Response.Write(JsonMapper.ToJson(hash));             context.Response.End();         }           private void showError(string message)         {             Hashtable hash = new Hashtable();             hash["error"] = 1;             hash["message"] = message;             context.Response.AddHeader("Content-Type", "text/html; charset=UTF-8");             context.Response.Write(JsonMapper.ToJson(hash));             context.Response.End();         }           public bool IsReusable         {             get             {                 return false;             }         }     } }

3、配置成功

二、CkEditor（免费）+CkFinder（收费）
看过一个非官方非正式的关于.net在线编辑器的使用调查，CkEditor是被使用做多的，属于重量级编辑器，功能很强大；

CKEditor是新一代的FCKeditor，是一个重新开发的版本。CKEditor是全球最优秀的网页在线文字编辑器之一，因其惊人的性能与可扩展性而广泛的被运用于各大网站。

（CKEditor 不具备上传功能，需要集成 文件管理器CKFinder 才能实现上传功能。）

我这里使用的版本是ckeditor_3.2及ckfinder_aspnet_1.4.3

1、下载 ckeditor_3.2及ckfinder_aspnet_1.4.3，解压；

2、将下载的两个文件夹拷到网站目录同个文件夹下，删除没必要的文件,其中的 _sample和_source部分，语言包lang中保留zh-cn.js，zh.js,en.js,其它都可不要，其实什么install.txt，license.txt，changelog.txt都可以删除不要。如图：

3、破解CKFinder，打开ckfinder/core/js/ckfinder_ie.js及chfinder_gecko.js，搜索  en.call(window,qo);  删掉该段代码；

4、项目中添加引用ckfinder/bin/release/CKFinder.dll（在下载的源文件中）

5、在页面中或者模板页中引入 ckeditor.js 和 ckfinder.js文件
6、在.aspx页面的第一句话及Page指令中加上validaterequest=”false”，禁止.net自动屏蔽上传Html代码；

　　如：<%@ Page Language="C#" ValidateRequest="false"...

7、在.aspx文件中放入TextBox控件，并设置控件CssClass="ckeditor",或是Html控件，则加上class="ckeditor"再随便加个id="xxx";

如：<asp:TextBox ID="txtContent"   CssClass="ckeditor" extMode="MultiLine"  runat="server"></asp:TextBox>

后台便可通过txtContent.text来取得编辑器的内容；

8、在 ckeditor/config.js中配置编辑器的样式，如：

CKEDITOR.editorConfig = function( config )

{

 

    //在CKEditor中集成 CKFinder，配置CKFinder路径，从网站根目录开始,“..”表示网站根目录

    CKFinder.SetupCKEditor(null, '../admin/js/ckfinder/');  // 主要是增加这一句，下面可不添加，编辑器会按默认进行设置

     

     

     

    config.skin = 'v2'; // 皮肤

    //config.uiColor = '#FFF'; // 皮肤背景颜色

    //config.resize_enabled = false;   // 取消 “拖拽以改变尺寸”功能  

    config.language = 'zh-cn'; //配置语言

    config.font_names = '宋体;楷体_GB2312;新宋体;黑体;隶书;幼圆;微软雅黑;Arial;Comic Sans MS;Courier New;Tahoma;Times New Roman;Verdana';// 字体

    config.width = 771; //宽度

    config.height = 300; //高度

 

    //config.toolbar = "Basic";  // 基础工具栏

    config.toolbar = "Full";  // 全能工具栏

    // 自定义工具栏 

    config.toolbar_Full =

    [

        ['Source', '-', 'Preview', '-', 'Templates'],

        ['Cut', 'Copy', 'Paste', 'PasteText', 'PasteFromWord', '-', 'Print', 'SpellChecker', 'Scayt'],

        ['Undo', 'Redo', '-', 'Find', 'Replace', '-', 'SelectAll', 'RemoveFormat'],

        ['Form', 'Checkbox', 'Radio', 'TextField', 'Textarea', 'Select', 'Button', 'ImageButton', 'HiddenField'],

        '/',

        ['Bold', 'Italic', 'Underline', 'Strike', '-', 'Subscript', 'Superscript'],

        ['NumberedList', 'BulletedList', '-', 'Outdent', 'Indent', 'Blockquote', 'CreateDiv'],

        ['JustifyLeft', 'JustifyCenter', 'JustifyRight', 'JustifyBlock'],

        ['Link', 'Unlink', 'Anchor'],

          ['Image', 'Flash', 'Table', 'HorizontalRule', 'Smiley', 'SpecialChar', 'PageBreak'],

        '/',

        ['Styles', 'Format', 'Font', 'FontSize'],

        ['TextColor', 'BGColor'],

        ['Maximize', 'ShowBlocks', '-', 'About']

    ];

 

    config.toolbar_Basic =

    [

        ['Bold', 'Italic', '-', 'NumberedList', 'BulletedList', '-', 'Link', 'Unlink', '-', 'About']

    ];

 

     

};

9、修改ckeditor/config.ascx，配置CKFinder的文件上传权限及目录：

修改如下地方：

/// <summary>检查用户上传权限</summary>

/// <returns>true可使用上传，false禁止使用</returns>

public override bool CheckAuthentication()

{

    return true;

}

 

public override void SetConfig()

{

 

    // 指定文件上传路径，“~”表示网站根目录，相关文件夹会自动创建

    BaseUrl = "~/UploadFiles/ckfinderUpload/userfiles/";

    BaseDir = "";

    Thumbnails.Url = "";

    Thumbnails.Dir = "";

    // 主要修改上面这四句，其它默认便可

     

    // 。。。。。。

}

10、设置权限让IIS用户对上传目录有写的权限

11、配置成功