• CKEditor＆ckfindtor

    前言

    之前的项目中一直使用的是FCKeditor，昨天突然有个想法：为什么不试一下新的CKEditor呢？于是花了大半天的时间去学习它的使用方法，如今把我的学习过程与大家分享一下。

    谈起FCKeditor，相信没几个Web程序猿不知道的吧。只是，官方已经停止了该产品的更新，其最新版是2.6.6，于2010年2月15日公布。

    代替FCKeditor的产品叫CKEditor（Content And Knowledge Editor），与其说是对FCKeditor的升级，不如说是全新的一个产品。相比FCKeditor，其载入速度更快，功能更强大，更丰富的插件和API，更友好的界面，生成的html更标准化。我们先一睹它的风採吧。

    它与FCKeditor最大的一个差别是CKEditor不集成文件上传与管理功能（乍一看到，心里瓦凉瓦凉的），这部分被独立出来放到还有一个产品CKFinder中，这是一个商业授权的产品。CKEditor + CKFinder 两者结合起来才算一个完整的在线编辑器，所以我会把它们的配置放到一起，毕竟两者是缺一不可的。接下来我们看看怎样在项目中使用它们吧。

    (一)  下载和部署

    眼下CKEditor最新版为3.6.1，于2011-6-16公布。官方下载地址：http://ckeditor.com/download。

    CKEditor.NET，最新版为3.6.1，于2011-6-17公布，这是CKEditor的.Net的源代码项目。 官方下载地址：http://ckeditor.com/download，请选择ASP.NET版下载。

    CKFinder的最新版为2.0.2.1，于2011-4-19公布。官方下载地址：http://ckfinder.com/download，请选择ASP.NET版本号下载。

    分别解压下载下来的这3个文件，并把解压后的ckeditor_3.6.1和ckfinder_aspnet_2.0.2.1目录复制到你的项目中（解压出来后的目录原本是ckeditor和ckfinder，但我更习惯把他们的版本也加上去，方便项目后期的追踪），把“ckeditor_aspnet_3.6.1inReleaseCKEditor.NET.dll”和“ckfinder_aspnet_2.0.2.1inReleaseCKFinder.dll”这两个文件复制到站点根目录下的bin目录中，以下是部署后的目录结构图。

    注意：

    1. 不要拷贝ckfinder_aspnet_2.0.2.1下的_source（源码项目）和bin目录，否则将导致无法成功编译你原来的项目。

    2. 你能够把CKEditor和CKFinder放到你喜欢的随意文件夹中，然后正确配置他们的基路径（接下来就会说到），这丝毫不影响使用。

    (二)  配置和使用

    CKFinder的必要配置

    打开/editor/ckfinder_aspnet_2.0.2.1/ config.ascx文件，完毕验证逻辑（很重要）、设置文件保存路径。

    view plain
    1. public override bool CheckAuthentication()  
    2. {  
    3.     // WARNING : DO NOT simply return "true". By doing so, you are allowing  
    4.     // "anyone" to upload and list the files in your server. You must implement  
    5.     // some kind of session validation here. Even something very simple as...  
    6.     //  
    7.     //      return ( Session[ "IsAuthorized" ] != null && (bool)Session[ "IsAuthorized" ] == true );  
    8.     //  
    9.     // ... where Session[ "IsAuthorized" ] is set to "true" as soon as the  
    10. // user logs on your system.  
    11. //重视上面这段话，在用户试图管理文件前，你必须在这里验证用户是否有权限操作，  
    12. //比方检查用户是否登录了，等等。假设验证成功，返回true，  
    13. //否则返回false以拒绝此操作。  
    14. //假设你直接返回true，这将是很危急的，不论什么一个人，仅仅要知道你ckfinder的路径，  
    15. //都能够任意上传或者删除文件，这将是毁灭性的  
    16.   
    17.     //return false;  
    18.     return true;  
    19. }  
    20.   
    21. /** 
    22.  * All configuration settings must be defined here. 
    23.  */  
    24. public override void SetConfig()  
    25. {  
    26.     // Paste your license name and key here. If left blank, CKFinder will  
    27.     // be fully functional, in Demo Mode.  
    28.     LicenseName = "";  
    29.     LicenseKey = "";  
    30.   
    31.     // The base URL used to reach files in CKFinder through the browser.  
    32. BaseUrl = "/ckfinder/userfiles/";   //在这里指明你想把上传的文件放到哪里  
    33. // The phisical directory in the server where the file will end up. If  
    34. // blank, CKFinder attempts to resolve BaseUrl.  
    35. BaseDir = "";  
    36.   
    37. //后面还有代码  
    38. //...  

    接下来，你能够通过下面3种方式使用CKEditor，使用哪一种取决于你的偏好和习惯。

    方式1 控件载入法

    这是在.Net环境下最简便的方式，对于习惯了拖控件的同志们来说，这是最好的方式，推荐使用。

    1. 加入�CKEditorControl控件

    在Visual Studio左側的工具箱中点击右键，在弹出的菜单中选择“选择项(I)…”①菜单，将弹出选择工具箱项窗体，点击“浏览”button②在你站点根文件夹的Bin文件夹中找到刚刚加入�的CKEditor.NET.dll③，一路点确定完毕。你会发现工具箱里多了一个叫“CKEditorControl”的控件，没错，那个就是我们须要的CKEditor编辑器控件。

    2. 加入�dll引用

    右键点击你的Web项目，选择“加入�引用(R)…”菜单，找到之前拷贝进来的CKEditor.NET.dll和CKFinder.dll，点击“确定”button完毕操作，见下图。

    3. 还等什么，赶快试用吧

    双击该控件或直接把该控件拖放到你的aspx页面中，并配置CKEditor的基路径BasePath。

    view plain
    1. <CKEditor:CKEditorControl ID="CKEditorControl1" runat="server"   
    2. BasePath="/editor/ckeditor_3.6.1/"></CKEditor:CKEditorControl>  

    说明：若你的CKEditor放在根文件夹的ckeditor文件夹中，你无需配置BasePath属性，直接把控件拖到页面中就能正常使用，CKEditor将自己主动搜索该路径。CKFinder的默认基路径为根文件夹下的ckfinder。以下提到的基路径配置规则与此同样。

    后台代码，必须创建一个CKFinder并绑定到CKEditor上，以使用文件上传与管理功能。

    view plain
    1. protected void Page_Load(object sender, EventArgs e)  
    2. {  
    3.     CKFinder.FileBrowser fileBrowser = new CKFinder.FileBrowser();  
    4.     fileBrowser.BasePath = "/editor/ckfinder_aspnet_2.0.2.1/";  //设置CKFinder的基路径  
    5.     fileBrowser.SetupCKEditor(CKEditorControl1);  
    6. }  

    恭喜你，你已经学会了CKEditor的用法，执行页面去体验一下吧。

    方式2 使用官方原始的JavaScript方式载入

    1. 必要的配置

    打开/editor/ckeditor_3.6.1/config.js，配置CKEeditor的基路径，例如以下：

    view plain
    1. CKEDITOR.editorConfig = function( config )  
    2. {  
    3.     // Define changes to default configuration here. For example:  
    4.     // config.language = 'fr';  
    5.     // config.uiColor = '#AADC6E';    
    6.     basePath = '/editor/ckeditor_3.6.1/';   //配置CKEditor的根路径  
    7.   
    8. };  

    2. 使用

    首先在页面中引入CKEditor和CKFinder的js文件。

    view plain
    1. <script src="/editor/ckeditor_3.6.1/ckeditor.js" type="text/javascript"></script>  
    2. <script src="/editor/ckfinder_aspnet_2.0.2.1/ckfinder.js" type="text/javascript"></script>  

    初始化代码，下面两种方式都能够完毕初始化。

    view plain
    1. <!--方式1-->  
    2. <textarea id="content" name="content" class="ckeditor"><%=Request.Form["content"] %></textarea>  
    3. <script type="text/javascript">  
    4.     //绑定CKFinder到当前编辑器中，第二个參数指定CKFinder的路径  
    5.     CKFinder.setupCKEditor(null, '/editor/ckfinder_aspnet_2.0.2.1/');  
    6. </script>  
    7.   
    8. <!--方式2-->  
    9. <textarea id="content" name="content"><%=Request.Form["content"] %></textarea>  
    10. <script type="text/javascript">  
    11.     //在id为content的textarea处创建一个编辑器  
    12.     var editor = CKEDITOR.replace('content');   
    13.     //绑定CKFinder到当前编辑器中，第二个參数指定CKFinder的路径  
    14.     CKFinder.setupCKEditor(editor, '/editor/ckfinder_aspnet_2.0.2.1/');   
    15. </script>  


     

    聪明的你一定注意到了，第一种初始化代码并没有显式创建编辑器，textarea拥有css类名“ckeditor”而另外一种没有。默认情况下，CKEditor会把页面中全部拥有css类名为“ckeditor”的textarea都创建为编辑器，你能够亲自试一下。

     

    方式3 通过官方的jQuery适配器载入

    首先引入必要的js

    view plain
    1. <script src="/js/jquery/jquery-1.6.2.js" type="text/javascript"></script>  
    2. <script src="/editor/ckeditor_3.6.1/ckeditor.js" type="text/javascript"></script>  
    3. <!--注意 适配器js必须放在ckeditor.js后面，否则将会出错，由于适配器须要引用ckeditor.js里面定义的类-->  
    4. <script src="/editor/ckeditor_3.6.1/adapters/jquery.js" type="text/javascript"></script>  
    5. <script src="/editor/ckfinder_aspnet_2.0.2.1/ckfinder.js" type="text/javascript"></script>  

    编写初始化代码

    view plain
    1. <textarea id="content" name="content"><%=Request.Form["content"] %></textarea>  
    2. <script type="text/javascript">  
    3.     $(function() {  
    4.         //利用jQuery载入  
    5.         $('#content').ckeditor();  
    6.         //绑定CKFinder到当前编辑器中，第二个參数指定CKFinder的路径  
    7.         CKFinder.setupCKEditor(null, '/editor/ckfinder_aspnet_2.0.2.1/');  
    8.     });  
    9. </script>  

    (三) 精简你的CKEditor

    解压后的CKEditor目录占用空间7M多，还是挺大的，让我们把不是必需的东西清理一下吧，我的Editor我做主。

    _samples：里面放的是演示样例，删除。

    _source：存放的是开发用的源文件，不须要，删除。

    adapters：假设你不使用jQuery方式来初始化CKEditor（上面的第3种方式），能够删除。

    images：必要的文件，保留。

    plugins：存放的是插件，有一些是CKEditor必须使用的，所有保留吧。

    lang：里面放的是语言文件，保留_languages.js、zh-cn.js和en.js这3个文件，其他所有删除。

    themes：必要的文件，保留。

    skins：存放的是皮肤文件，默认的皮肤是kama，其他两个认为用不到的话能够直接删除。

    删除CKEditor根文件夹下的.htaccess、CHANGES.html、ckeditor.asp、ckeditor.pack、ckeditor.php、ckeditor_basic.js、ckeditor_basic_source.js、ckeditor_php4.php、ckeditor_php5.php、ckeditor_source.js和INSTALL.html共11个文件。

    下面是清理前后的对照：


    (四) CKFinder版权的破解

    CKFinder要商业授权才干使用的，未授权时在使用中会跳出一些版本号信息，尽管不影响正常使用，但不喜欢的能够把它去掉，破解的版本号为2.0.2.1，其他版本号可能会不同。

    注意：此方法仅供个人学习用，请不要在商业中使用！



    打开CKFinder下的ckfinder.js文件，搜索“message_content”（不包含双引號），会找到下面片段：<h4 class='message_content' '></h4>，批发它 改为<h4 class='message_content' style='display:none;'></h4>，让它隐藏。

    搜索“x3c144x69x7640143x6cx61163x7375x27166x69x65x7740x74x6f157154137160141x6e1451544740x73164x79154x657547x64x69163160x6c141x79x3a40142154x6fx63153x2041151155160x6f162164141156164x3b40160157163x69x74x69157x6ex3a40163164x61164x69143x20x21x69x6d160157x72x74141156164x3bx20x63157154x6fx72x3ax20x62x6c141x63153x2041x69155160157x72164141x6ex74x3bx20x62141x63153147162x6f165x6e14455x63157154x6fx727240x77x68x69164145x2041151x6dx7015716216414115616473x27x3ex54150151163x20151x73x20x74150x65x20x44x4511511740x76145162163151x6fx6e40x6fx66x20x43113x46x69x6e144x65x72x2e40x50154145141x73x6540166151163x69x7440x74x68x6540x3cx61x20150162145x6675x27x68164x74160x3a5757143153146x69156x64x65x72x2e143157x6dx27x20164x61x72x67x6516475x2713714215414115615347x3e103113106151x6ex64145162x20x77x6514240x73151x7414574x2f141x3ex2016415740157x62x74x61151x6ex20x61x20x76x61154151144x20x6c151x63x65x6e163145x2e7457144x69x7676”（不包含双引號），把这一串字符改为“x20”。

    事实上上面那些符号都是JavaScript的转义字符，其相应的是“<div class='view tool_panel' style='display: block !important; position: static !important; color: black !important; background-color: white !important;'>This is the DEMO version of CKFinder. Please visit the <a href='http://ckfinder.com' target='_blank'>CKFinder web site</a> to obtain a valid license.</div>”，即左下角那些文字。

    后记

    以上不过CKEditor的基本使用方法，基本上能满足一般的须要。要想真正了解并用好它，还得下一番苦功夫。试用后感觉非常不错，特别是官方的API文档，非常具体非常给力。

    官方文档：http://docs.cksource.com/
  • 相关阅读:
    如何让Jboss的debug在myeclise上运行
    ./configure --prefix /?/? 解释
    解决locate无法使用的问题
    ifconfig command not found
    安装tomcat
    通过wget下载tomcat
    通过rpm安装jdk
    通过wget下载jdk
    oracle 创建表空间
    在ASP中使用VFP编写脚本程序
  • 原文地址：https://www.cnblogs.com/hrhguanli/p/3920426.html
Copyright © 2020-2023  润新知