FCKeditor.Net 2.6.3 配置说明与文件精简

FCKeditor是一个功能强大支持所见即所得功能的文本编辑器,可以为用户提供微软office软件一样的在线文档编辑服务。它不需要安装任何 形式的客户端,兼容绝大多数主流浏览器,支持ASP.Net、ASP、ColdFusion 、PHP、Java、Active-FoxPro、Lasso、Perl、ython 等编程环境。

官方网站 http://www.fckeditor.net/

官方文档 http://wiki.fckeditor.net/

下载地址 http://www.fckeditor.net/download/default.html

FCKeditor安装和配置

下载FCKeditor2.63.zip和FCKeditor.NET2.63版的2个zip包

(a)   FCKeditor_2.6.3是html文件、Javascript文件和图片等资源文件

(b)   FCKeditor.Net_2.6.3.zip是一个ASP.NET控件DLL文件

Asp.Net项目中添加对 FCKeditor 的引用

1. 项目上选择添加引用(Add Reference…),找到 浏览(Browse)标签,然后定位到你解压好的FredCK.FCKeditorV2.dll,确认就可以了

2. 为了方便RAD开发,可以把FCKeditor控件也添加到VS的工具箱(Toolbox)上来,展开工具箱的常用标签组(General),右键选择组 件(Choose Items…),在对话框上直接找到浏览按钮,定位FredCK.FCKeditorV2.dll,然后确认就可以了

3. 配置Web.Config,在<appSettings>节点添加,如下所示:

<appSettings>
<add key="FCKeditor:BasePath" value="~/Web/fckeditor/"/>
<add key="FCKeditor:UserFilesPath" value="~/Web/Upload/" />
</appSettings>

FCKeditor 的配置:

进入FCKeditor文件夹,编辑 fckconfig.js 文件

1、修改:

var _FileBrowserLanguage = ‘php’ ; // asp | aspx | cfm | lasso | perl | php | py

var _QuickUploadLanguage = ‘php’ ; // asp | aspx | cfm | lasso | php

为:

var _FileBrowserLanguage = ‘aspx’ ; // asp | aspx | cfm | lasso | perl | php | py

var _QuickUploadLanguage = ‘aspx’ ; // asp | aspx | cfm | lasso | php

2、配置语言

     修改:

FCKConfig.DefaultLanguage = ‘en’ ;

改为:

FCKConfig.DefaultLanguage = ‘zh-cn’ ;

3、配置皮肤,有default、office2003、silver风格等,可以使用默认。

FCKConfig.SkinPath = FCKConfig.BasePath + ’skins/default/’ ;

4、在编辑器域内可以使用Tab键。(1为是,0为否)

FCKConfig.TabSpaces = 0 ; 改为 FCKConfig.TabSpaces = 1 ;

5、加上几种常用的字体:

           FCKConfig.FontNames = ‘宋体;黑体;隶书;楷体_GB2312;Arial;Comic Sans MS;Courier New;Tahoma;Times New Roman;Verdana’;

6、编辑器域内默认的显示字体为12px,想要修改可以通过修改样式表来达到要求,打开/editor/css/fck_editorarea.css,修改font-size属性即可

7、关于安全性

如果你的编辑器用在前台非认证的情况下,推荐使用Basic的toolbar

FCKConfig.ToolbarSets["Basic"] = [

  ['Bold','Italic','-','OrderedList','UnorderedList','-','Link','Unlink','Image','-','About']

] ;

8、在上传文件窗口点击浏览服务器,可能会出现 the server didn’t send back a proper xml….. 错误提示,是因为FCKeditor要求不同类型的文件分别传到不同的目录,包括file,image,falsh,media 等目录,可以先建立起来试试。

FCKEditor.NET 2.6 的安全性配置

文件上传,一直是容易被利用的攻击通道,呵呵,所以这里要重点提一下:

打开 editor/filemanager/connectors/aspx/config.ascx

private bool CheckAuthentication()
{
//为了防止任意用户均可以打开上传页或者浏览服务器文件
//建议将此处和你的后台管理权限进行集成,如果不需要验证,则直接返回 true 即可
//------------------------------------------------

//1. 假设你用 session 存储用户的登录验证信息,假设 session 的 key 为 auth
// 则需要返回
//return (Session["auth"] != null && Session["auth"] == "验证值");

//2. 如果你用 FORM 验证方式,则可以验证
//return Page.User.Identity.IsAuthenticated;

// WARNING : DO NOT simply return "true". By doing so, you are allowing
// "anyone" to upload and list the files in your server. You must implement
// some kind of session validation here. Even something very simple as...
//
//return ( Session[ "IsAuthorized" ] != null && (bool)Session[ "IsAuthorized" ] == true );
//
// ... where Session[ "IsAuthorized" ] is set to "true" as soon as the
// user logs in your system.

return true;
}

FCKeditor的精简和清理

进入FCKeditor文件夹,把所有“_”开头的文件和文件夹删掉,这些都是一些范例,只保留editor文件夹、fckconfig.js、fckeditor.js、fckstyles.xml、fcktemplates.xml就可以了;

进入editor文件夹,删掉“_source”文件夹,里面放的同样是源文件;

退回上一级目录进入filemanager文件夹,有browser和upload两个文件夹。进入browser"default"connectors,只保留aspx文件夹,其余的删掉;mcpuk目录亦可删除;upload也一样,只保留aspx文件夹;

退到editor再进入images文件夹,smiley里面放的是表情图标,有msn和fun两个系列,如果你想用自己的表情图标,可以把它们都删除;如果你想用这里的表情图标那就不要删了;

lang里面放的是语言包,如果只是用简体中文,那么只保留fcklanguagemanager.js、zh-cn.js两个文件就行了,建议也 保留en.js(英文)、zh.js(繁体中文)两个文件,fcklanguagemanager.js是语言配置文件,有了它才能和 fckconfig.js里的设置成对,对应上相应的语言文件,一定要保留!

再退出lang文件夹,进入skins文件夹,如果你想使用FCKeditor默认的奶黄色,那就把除了default文件夹外的另两个文件夹直接删除,如果想用别的,那就看你自己的喜好了。


 在ToolbarSets中可设置显示的工具
可去掉About

配置选项:

AutoDetectLanguage=true/false 自动检测语言

Basehref="" _fcksavedurl="""" 相对链接的基地址

ContentLangDirection="ltr/rtl" 默认文字方向

ContextMenu=字符串数组,右键菜单的内容

CustomConfigurationsPath="" 自定义配置文件路径和名称

Debug=true/false 是否开启调试功能,这样,当调用FCKDebug.Output()时,会在调试窗中输出内容

DefaultLanguage="" 缺省语言

EditorAreaCss="" 编辑区的样式表文件

EnableSourceXHTML=true/false 为TRUE时,当由可视化界面切换到代码页时,把HTML处理成XHTML

EnableXHTML=true/false 是否允许使用XHTML取代HTML

FillEmptyBlocks=true/false 使用这个功能,可以将空的块级元素用空格来替代

FontColors="" 设置显示颜色拾取器时文字颜色列表

FontFormats="" 设置显示在文字格式列表中的命名

FontNames="" 字体列表中的字体名

FontSizes="" 字体大小中的字号列表

ForcePasteAsPlainText=true/false 强制粘贴为纯文本

ForceSimpleAmpersand=true/false 是否不把&符号转换为XML实体

FormatIndentator="" 当在源码格式下缩进代码使用的字符

FormatOutput=true/false 当输出内容时是否自动格式化代码

FormatSource=true/false 在切换到代码视图时是否自动格式化代码

FullPage=true/false 是否允许编辑整个HTML文件,还是仅允许编辑BODY间的内容

GeckoUseSPAN=true/false 是否允许SPAN标记代替B,I,U标记

IeSpellDownloadUrl=""下载拼写检查器的网址

ImageBrowser=true/false 是否允许浏览服务器功能

ImageBrowserURL="" 浏览服务器时运行的URL

ImageBrowserWindowHeight="" 图像浏览器窗口高度

ImageBrowserWindowWidth="" 图像浏览器窗口宽度

LinkBrowser=true/false 是否允许在插入链接时浏览服务器

LinkBrowserURL="" 插入链接时浏览服务器的URL

LinkBrowserWindowHeight=""链接目标浏览器窗口高度

LinkBrowserWindowWidth=""链接目标浏览器窗口宽度

Plugins=object 注册插件

PluginsPath="" 插件文件夹

ShowBorders=true/false 合并边框

SkinPath="" 皮肤文件夹位置

SmileyColumns=12 图符窗列数

SmileyImages=字符数组 图符窗中图片文件名数组

SmileyPath="" 图符文件夹路径

SmileyWindowHeight 图符窗口高度

SmileyWindowWidth 图符窗口宽度

SpellChecker="ieSpell/Spellerpages" 设置拼写检查器

StartupFocus=true/false 开启时FOCUS到编辑器

StylesXmlPath="" 设置定义CSS样式列表的XML文件的位置

TabSpaces=4 TAB键产生的空格字符数

ToolBarCanCollapse=true/false 是否允许展开/折叠工具栏

ToolbarSets=object 允许使用TOOLBAR集合

ToolbarStartExpanded=true/false 开启是TOOLBAR是否展开

UseBROnCarriageReturn=true/false 当回车时是产生BR标记还是P或者DIV标记

解决FCKEditor上传时中文文件名的方法

主要是修改文件frmUpload.html文件.用记事本打开frmUpload.html,另存为UTF-8格式即可.

上传文件自动改名:打开FileBrowser文件夹中的FileWorkerBase.cs文件。
sFileName = System.IO.Path.GetFileName( oFile.FileName );
sFileName = this.SanitizeFileName( sFileName );
string sExtension = System.IO.Path.GetExtension( oFile.FileName );
sExtension = sExtension.TrimStart( '.' );
修改为:

sFileName = System.IO.Path.GetFileName( oFile.FileName );
sFileName = this.SanitizeFileName( sFileName );
string sExtension = System.IO.Path.GetExtension(oFile.FileName );
sExtension = sExtension.TrimStart( '.' ); Random ro = new Random();
sFileName = DateTime.Now.Year.ToString() + DateTime.Now.Month.ToString() +
DateTime.Now.Day.ToString() + DateTime.Now.Hour.ToString() + DateTime.Now.Minute.ToString() + ateTime.Now.Second.ToString() + ro.Next(99, 1000) + "." + sExtension;

FCKeditor在web.config中有多项设置:

view plaincopy to clipboardprint?
<appSettings>  
<!--FCKeditor设置(主要是以下两项)-->  
<!--FCKeditor编辑器路径-->  
<add key="FCKeditor:BasePath" value="/FCKeditor/"/>  
<!--FCKeditor用户附件上传路径-->  
<add key="FCKeditor:UserFilesPath" value="/Resources/TempUpload/"/>  
</appSettings>  

<appSettings> <!--FCKeditor设置(主要是以下两项)--> <!--FCKeditor编辑器路径--> <add key="FCKeditor:BasePath" value="/FCKeditor/"/> <!--FCKeditor用户附件上传路径--> <add key="FCKeditor:UserFilesPath" value="/Resources/TempUpload/"/> </appSettings>
  用户登录后通过FCKeditor上传文件则要放置在用户共用上传路径“/Resources/UserUpload/”+“用户邮箱地址”, 如“/Resources/UserUpload/user@gmail.com”。FCKeditor.net获取上传路径文件是:FileWorkerBase.cs,打开找到以下部分

view plaincopy to clipboardprint?
protected string UserFilesPath   
     {   
      get  
       {   
        if ( sUserFilesPath == null )   
         {   
          // 第一回从Application["FCKeditor:UserFilesPath"] 中读取,如果没有尝试其它方式   
           sUserFilesPath = (string)Application["FCKeditor:UserFilesPath"] ;   
  
          // 第二回从Session["FCKeditor:UserFilesPath"] 中读取,如果没有尝试其它方式   
          if ( sUserFilesPath == null || sUserFilesPath.Length == 0 )   
           {   
             sUserFilesPath = (string)Session["FCKeditor:UserFilesPath"] ;   
               
            // 第三回从web.config中读取,如果没有尝试其它方式   
            if ( sUserFilesPath == null || sUserFilesPath.Length == 0 )   
             {   
               sUserFilesPath = System.Configuration.ConfigurationSettings.AppSettings["FCKeditor:UserFilesPath"] ;   
                 
              // 第四回从DEFAULT_USER_FILES_PATH(这个变量在同文件中)中读取,如果没有尝试其它方式   
              if ( sUserFilesPath == null || sUserFilesPath.Length == 0 )   
                 sUserFilesPath = DEFAULT_USER_FILES_PATH ;   
  
              // 第五回从网址参数ServerPath中读取   
              if ( sUserFilesPath == null || sUserFilesPath.Length == 0 )   
               {   
                 sUserFilesPath = Request.QueryString["ServerPath"] ;   
               }   
  
             }   
           }   
  
          // Check that the user path ends with slash ("/")   
          if ( ! sUserFilesPath.EndsWith("/") )   
             sUserFilesPath += "/" ;   
         }   
        return sUserFilesPath ;   
       }   
     }  

protected string UserFilesPath {           

  get {if ( sUserFilesPath == null )

      {     // 第一回从Application["FCKeditor:UserFilesPath"] 中读取,如果没有尝试其它方式               

        sUserFilesPath = (string)Application["FCKeditor:UserFilesPath"] ;                

          // 第二回从Session["FCKeditor:UserFilesPath"] 中读取,如果没有尝试其它方式               

        if ( sUserFilesPath == null || sUserFilesPath.Length == 0 )               

        {

           sUserFilesPath = (string)Session["FCKeditor:UserFilesPath"] ;                                   

          // 第三回从web.config中读取,如果没有尝试其它方式                 

           if ( sUserFilesPath == null || sUserFilesPath.Length == 0 )                 

          {                   

            sUserFilesPath = System.Configuration.ConfigurationSettings.AppSettings["FCKeditor:UserFilesPath"] ;

            // 第四回从DEFAULT_USER_FILES_PATH(这个变量在同文件中)中读取,如果没有尝试其它方式                   

            if ( sUserFilesPath == null || sUserFilesPath.Length == 0 )

              sUserFilesPath = DEFAULT_USER_FILES_PATH ; 

             // 第五回从网址参数ServerPath中读取                   

            if ( sUserFilesPath == null || sUserFilesPath.Length == 0 )                    

             {                      sUserFilesPath = Request.QueryString["ServerPath"] ;                   

             }                  

          }               

        }                

        // Check that the user path ends with slash ("/")               

         if ( ! sUserFilesPath.EndsWith("/") )                 

          sUserFilesPath += "/" ;             

        }             

        return sUserFilesPath ;           

      }         

     }   

  从上面的注释可以看到用户上传路径的顺序,只要在页面加载的时候设置下Session["FCKeditor:UserFilesPath"]就可以设置FCKeditor上用户上传路径了

  view plaincopy to clipboardprint?
  protected void Page_Load(object sender, EventArgs e)   
  {   
    if (!Page.IsPostBack)   
    Session["FCKeditor:UserFilesPath"] = "用户上传路径";   
  }  

  protected void Page_Load(object sender, EventArgs e) { if (!Page.IsPostBack) Session["FCKeditor:UserFilesPath"] = "用户上传路径"; }
  (我在配置的时候关闭了文件浏览,只提供文件快速上传)但是在使用的时候如果“Resources/UserUpload/user@gmail.com”中的user@gmail.com路径没创建,上传中FCKeditor它不会创建,也导致了文件无法上传成功,那就需要再修改FCKeditor.net项目中的Uploader.cs文件,添加一段文件夹存在的检测代码,如果不存在用户指定的文件夹侧创建一个 
原文地址:https://www.cnblogs.com/cwy173/p/1673315.html