Fckeditor

FckEditor中文配置手册详细说明

FCKeditor目前已经更新到2.6版，详情请看官方http://www.fckeditor.net/

因为下载下来的压缩包里面有包含很多在我们使用时，用不到的，不删除也行。看个人喜好下面以PHP为例，进行程序瘦身

删除所有”_”开头的文件和文件夹
删除FCKeditor的目录下：
fckeditor.afp
fckeditor.asp
fckeditor.cfc
fckeditor.cfm
fckeditor.lasso
fckeditor.pl
fckeditor.py
htaccess.txt
license.txt
删除语言包editor/lang中除中文和英文以外的语言
删除skin目录下除默认皮肤以外的文件夹
filemanager/browser/default/connectors/目录下除php以外的文件
filemanager/upload/目录下除php以外的文件
如果你不想要表情包 删除 editor/images/smiley下的msn文件夹及表情按钮
好了 精简完毕

我们通常把编辑器用以个文件夹存放、通常情况下 我们可以明白为fckeditor或editor

找到里面两关键文件 fckeditor_php4.php   fckeditor_php5.php    这两个文件的代码相差不了多少，很显然跟php版本有关

打开这两个文件

XML/HTML代码

function FCKeditor( $instanceName )   
{   
    $this->InstanceName = $instanceName ;   
    $this->BasePath     = './editor/' ;   默认编辑器所在的文件位置
    $this->Width        = '100%' ;        默认编辑器宽
    $this->Height       = '350' ;         默认编辑器高
    $this->ToolbarSet   = 'Default' ;     默认编辑器SKIN
    $this->Value        = '' ;            初始值
    $this->Config       = array() ;   
}   

FCKeditor设置文件 "fckconfig.js"

XML/HTML代码

FCKConfig.CustomConfigurationsPath = '' ; // 自定义配置文件路径和名称   
FCKConfigFCKConfig.EditorAreaCSS = FCKConfig.BasePath + 'css/fck_editorarea.css'; // 编辑区的样式表文件   
FCKConfig.EditorAreaStyles = '' ; // 编辑区的样式表风格   
FCKConfig.ToolbarComboPreviewCSS =''; //工具栏预览CSS   
FCKConfig.DocType = '' ;//文档类型   
FCKConfig.BaseHref = ''; // 相对链接的基地址   
FCKConfig.FullPage = false ; //是否允许编辑整个HTML文件,还是仅允许编辑BODY间的内容   
FCKConfig.StartupShowBlocks = false ;//决定是否启用"显示模块"   
FCKConfig.Debug = false ;//是否开启调试功能   
FCKConfigFCKConfig.SkinPath = FCKConfig.BasePath + 'skins/default/' ; //皮肤路径   
FCKConfig.PreloadImages=... //预装入的图片   
FCKConfigFCKConfig.PluginsPath = FCKConfig.BasePath + 'plugins/' ; //插件路径   
FCKConfig.AutoDetectLanguage = true ; //是否自动检测语言   
FCKConfig.DefaultLanguage   = 'zh-cn' ; //默认语言   
FCKConfig.ContentLangDirection = 'ltr' ; //默认的文字方向,可选"ltr/rtl",即从左到右或从右到左   
FCKConfig.ProcessHTMLEntities = true ; //处理HTML实体   
FCKConfig.IncludeLatinEntities = true ; //包括拉丁文   
FCKConfig.IncludeGreekEntities = true ;//包括希腊文   
FCKConfig.ProcessNumericEntities = false ;//处理数字实体   
FCKConfig.AdditionalNumericEntities = '' ;   //附加的数字实体   
FCKConfig.FillEmptyBlocks = true ; //是否填充空块   
FCKConfig.FormatSource   = true ; //在切换到代码视图时是否自动格式化代码   
FCKConfig.FormatOutput   = true ; //当输出内容时是否自动格式化代码   
FCKConfig.FormatIndentator = '    ' ; //当在源码格式下缩进代码使用的字符   
FCKConfig.StartupFocus = false ; //开启时焦点是否到编辑器,即打开页面时光标是否停留在fckeditor上   
FCKConfig.ForcePasteAsPlainText = false ; //是否强制粘贴为纯文件内容   
FCKConfig.AutoDetectPasteFromWord = true ; //是否自动探测从word粘贴文件,仅支持IE   
FCKConfig.ShowDropDialog = true ;//是否显示下拉菜单   
FCKConfig.ForceSimpleAmpersand = false ;//是否不把&符号转换为XML实体   
FCKConfig.TabSpaces   = 0 ;//按下Tab键时光标跳格数,默认值为零为不跳格   
FCKConfig.ShowBorders = true ;//合并边框   
FCKConfig.SourcePopup = false ;//弹出   
FCKConfig.ToolbarStartExpanded = true ;//启动fckeditor工具栏默认是否展开   
FCKConfig.ToolbarCanCollapse = true ;//是否允许折叠或展开工具栏   
FCKConfig.IgnoreEmptyParagraphValue = true ;//是否忽略空的段落值   
FCKConfig.FloatingPanelsZIndex = 10000 ;//浮动面板索引   
FCKConfig.HtmlEncodeOutput = false ;//是否将HTML编码输出   
FCKConfig.TemplateReplaceAll = true ;//是否替换所有模板   
FCKConfig.ToolbarLocation = 'In' ;//工具栏位置,   
FCKConfig.CustomConfigurationsPath = '' ; // 自定义配置文件路径和名称   
FCKConfigFCKConfig.EditorAreaCSS = FCKConfig.BasePath + 'css/fck_editorarea.css'; // 编辑区的样式表文件   
FCKConfig.BaseHref = ''; // 相对链接的基地址   
FCKConfig.Debug = true/false; // 是否开启调试功能，当调用FCKDebug.Output()时，会在调试窗中输出内容   
FCKConfigFCKConfig.SkinPath = FCKConfig.BasePath + 'skins/default/'; // 设置皮肤   
FCKConfig.AutoDetectLanguage = true/false ; // 是否自动检测语言   
FCKConfig.DefaultLanguage = 'zh-cn' ; // 设置默认语言   
FCKConfig.ContentLangDirection = 'ltr/rtr'; // 默认文字方向，ltr左，rtr右   
FCKConfig.FillEmptyBlocks = true/false ; // 使用这个功能，可以将空的块级元素用空格来替代   
FCKConfig.FormatSource = true/false; // 切换到代码视图时，是否自动格式化代码   
FCKConfig.FormatOutput = true/false; // 当输出内容时是否自动格式化代码   
FCKConfig.FormatIndentator = ""; // 当在“源码格式”下缩进代码使用的字符   
FCKConfig.GeckoUseSPAN = true/false; // 是否允许SPAN标记代替B，I，U标记   
FCKConfig.StartupFocus = true/false; // 开启时是否FOCUS到编辑器   
FCKConfig.ForcePasteAsPlainText = true/false;// 强制粘贴为纯文本   
FCKConfig.ForceSimpleAmpersand = true/false; // 是否不把&符号转换为XML实体   
FCKConfig.TabSpaces = 0/1; // TAB是否有效   
FCKConfig.TabSpaces = 4; // TAB键产生的空格字符数   
FCKConfig.ShowBorders = true/false; // 是否合并边框   
FCKConfig.ToolbarStartExpanded = true/false; // 页面载入时，工具栏是否展开，点“展开工具栏”时才出现   
FCKConfig.ToolBarCanCollapse = true/false; // 是否允许展开折叠工具栏   
FCKConfig.ToolbarSets = object ; // 编辑器的工具栏，可以自行定义，删减，可参考已存在工具栏   
FCKConfig.EnterMode = 'p'; // 编辑器中直接回车，在代码中生成，可选为p | div | br   
FCKConfig.ShiftEnterMode = 'br'; // 编辑器中Shift+回车，在代码中生成，可选为p | div | br   
FCKConfig.ContextMenu = 字符串数组; // 右键菜单的内容   
FCKConfig.FontColors = ""; // 文字颜色列表   
FCKConfig.FontNames = ""; // 字体列表   
FCKConfig.FontSizes = ""; // 字号列表   
FCKConfig.FontFormats = ""; // 文字格式列表   
FCKConfig.StylesXmlPath = ""; // CSS样式列表的XML文件的位置   
FCKConfig.TemplatesXmlPath = ""; // 模版的XML文件位置   
FCKConfig.SpellChecker = "ieSpell/Spellerpages"; // 拼写检查器   
FCKConfig.IeSpellDownloadUrl = ""; // 下载拼写检查器的网址   
FCKConfigFCKConfig.SmileyPath = FCKConfig.BasePath + 'images/smiley/msn/'; // 表情文件存放路径   
FCKConfig.SmileyImages = ''; // 表情文件名称列表，具体参考默认设置   
FCKConfig.SmileyColumns = 8; // 表情窗口显示表情列数   
FCKConfig.SmileyWindowWidth = 320; // 表情窗口显示宽度，此窗口会因为表情文件的改变而作调整   
FCKConfig.SmileyWindowHeight = 240; // 表情窗口显示高度，此窗口会因为表情文件的改变而作调整   
FCKConfig.FullPage = true/false; // 是否允许编辑整个HTML文件，还是仅允许编辑BODY间的内容   
  
  
上传设置   
  
var _FileBrowserLanguage         = 'php' ;         // asp | aspx | cfm | lasso | perl | php | py      
var _QuickUploadLanguage         = 'php' ;         // asp | aspx | cfm | lasso | php[/code]   
//第一个是文件浏览器使用的语言，第二个快速上传使用的语言，改成你需要的   
FCKConfig.LinkUploadAllowedExtensions         = "" ;                         // empty for all   
FCKConfig.LinkUploadDeniedExtensions =".(php|php3|php5|phtml|asp|aspx|ascx|jsp|cfm|cfc|pl|bat|exe|dll|reg|cgi)$"  
//这是两个允许和拒绝上传的文件类型列表   
FCKConfig.ImageBrowser = false ;是否在插入图片功能里面启用服务器文件浏览功能   
FCKConfigFCKConfig.ImageBrowserURL = FCKConfig.BasePath + 'filemanager/browser/default/browser.html?Type=ImageConnector=connectors/' + _FileBrowserLanguage + '/connector.' + _FileBrowserExtension ;   
Type=Image   表示文件类型是image这会使文件浏览器定位到文件上传路径/image/文件夹下面   
FCKConfig.FlashBrowser = false ;是否在插入flash功能中启用服务器文件浏览功能   
FCKConfig.LinkUpload = false ;是否启用插入链接的快速上传功能   
FCKConfig.ImageUpload = false ;是否启用图片快速上传功能   
FCKConfig.FlashUpload = false ;是否启用flash上传功能   
  
  
服务器文件设置   
  
文件浏览器的设置：   
fckeditor/editor/filemanager/connectors/asp/config.asp   
  
ConfigIsEnabled = true 决定是否启用文件浏览器。这个是在服务器上执行的   
ConfigUserFilesPath = "/test/upload/" 上传文件的路径（相对的）   
ConfigAllowedExtensions.Add         "File", ""   
ConfigDeniedExtensions.Add         "File", "php|php2|php3|php4|php5|phtml|pwml|inc|asp|aspx|ascx|jsp|cfm|cfc|pl|bat|exe|com|dll|vbs|js|reg|cgi"   
ConfigAllowedExtensions.Add         "Image", "jpg|gif|jpeg|png|bmp"   
ConfigDeniedExtensions.Add         "Image", ""   
ConfigAllowedExtensions.Add         "Flash", "swf|fla"   
ConfigDeniedExtensions.Add         "Flash", ""   
ConfigAllowedExtensions.Add         "Media", "swf|fla|jpg|gif|jpeg|png|avi|mpg|mpeg|mp(1-4)|wma|wmv|wav|mid|midi|rmi|rm|ram|rmvb|mov|qt"   
ConfigDeniedExtensions.Add         "Media", ""   
这是4个不同的filetype类型 分别对应了 前台编辑器的 插入链接 插入图片 插入flash 插入媒体 4个功能
  
这里的文件类型与上面提到的两处文件类型是一致的要改必须许全改
Z,m8X IV)G0快速上传：

XML/HTML代码

ConfigIsEnabled = False //是否启用快速上传   
ConfigUserFilesPath = "/UserFiles/"  
  
//如果想上传到 /test/upload/yyymmdd/的文件夹下面   
则修改为 ConfigUserFilesPath = "/test/upload/" & year(now())& right("0"& month(now()),2)&right("0" & day(now()),2)  

FCKeditor设置多个工具栏样式

FCKeditor中自带了两种工具栏样式，Default 和Base。可是我现在想再加一种工具栏样式。 我试了一下。将Default样式的设置复制了一下 改为FCKConfig.ToolbarSets["Blogedit"],里面个体的工具栏项我就不写了。可是当我在调用这个工具栏时，却提示我说工具栏Blogedit设置没有找到，这是怎么回事啊？难道FCKeditor只能使用Def ault 和Base这两种样式吗？ 找到 fckconfig.js 里面设置 这里我添加了 ddd 工具栏样式 要用的时候只需要 在

引用的时候   $this->ToolbarSet = 'ddd' ; 就OK 了

XML/HTML代码

FCKConfig.ToolbarSets["Default"] = [   
['Source','DocProps','-','Save','NewPage','Preview','-','Templates'],   
['Cut','Copy','Paste','PasteText','PasteWord','-','Print','SpellCheck'],   
['Undo','Redo','-','Find','Replace','-','SelectAll','RemoveFormat'],   
['Form','Checkbox','Radio','TextField','Textarea','Select','Button','ImageButton','HiddenField'],   
'/',   
['Bold','Italic','Underline','StrikeThrough','-','Subscrīpt','Superscrīpt'],   
['OrderedList','UnorderedList','-','Outdent','Indent','Blockquote'],   
['JustifyLeft','JustifyCenter','JustifyRight','JustifyFull'],   
['Link','Unlink','Anchor'],   
['Image','Flash','Table','Rule','Smiley','SpecialChar','PageBreak'],   
'/',   
['Style','FontFormat','FontName','FontSize'],   
['TextColor','BGColor'],   
['FitWindow','ShowBlocks','-','About'] // No comma for the last row.   
] ;   
FCKConfig.ToolbarSets["Basic"] = [   
['Bold','Italic','-','OrderedList','UnorderedList','-','Link','Unlink','-','About']   
] ;   
FCKConfig.ToolbarSets["ddd"] = [   
        ['OrderedList','UnorderedList','-','Link','Unlink','-','About','Bold','Italic','Underline','StrikeThroug   
h','-','Subscrīpt','Superscrīpt']   
] ;  
有时间我再把ADODB+SMARTY中应用板块写上去
将FCKEDITOR整合进我的页面

由于目前的版本提供的FCKEDITOR仅提供了JAVAscrīpt式的整合,因此,这里仅讲述如何应用JAVAscrīpt来整合FCKEDITOR到站点中,当然,其他各种语言的整合,你可以参考_samples文件夹中的例子来完成
假如编辑器已经安装在你的站点的/FCKEDITOR/文件夹下.那么,第一步我们需要做的就是在页面的HEAD段中放入scrīpt标记以引入JAVAscrīpt整合模块.例如:
<scrīpt type="text/javascrīpt" src="/fckeditor/fckeditor.js"></scrīpt>

其中路径是可更改的

现在,FCKEDITOR类已经可以使用了.有两个方法在页面中建立一个FCKEDITOR编辑器:
方法1:内联方式(建议使用):在页面的FORM标记内需要插入编辑器的地方置入以下代码:
<scrīpt type="text/javascrīpt">
var ōFCKeditor = new FCKeditor( 'FCKeditor1' ) ;
oFCKeditor.Create() ;
</scrīpt>

方法2:TEXTAREA标记替换法(不建议使用):在页面的ONLOAD事件中,添加以下代码以替换一个已经存在的TEXTAREA标记

<html>
<head>
<scrīpt type="text/javascrīpt">
window.onload = function()
{
var ōFCKeditor = new FCKeditor( 'MyTextarea' ) ;
}
</scrīpt>
</head>
<body>
<textarea id="MyTextarea" name="MyTextarea">This is <b>the</b> initial value.</textarea>
</body>
</html>

现在,编辑器可以使用了

FCKEDITOR类参考:
下面是用来在页面中建立编辑器的FCKEDITOR类的说明

构造器:
FCKeditor( instanceName[, width, height, toolbarSet, value] )
instanceName:编辑器的唯一名称(相当于ID)
WIDTH:宽度
HEIGHT:高度
toolbarSet:工具条集合的名称
value:编辑器初始化内容

属性:
instanceName:编辑器实例名
width:宽度,默认值为100%
height:高度,默认值是200
ToolbarSet:工具集名称,参考FCKCONFIG.JS,默认值是Default
value:初始化编辑器的HTML代码,默认值为空
BasePath:编辑器的基路径,默认为/Fckeditor/文件夹,注意,尽量不要使用相对路径.最好能用相对于站点根路径的表示方法,要以/结尾
CheckBrowser:是否在显示编辑器前检查浏览器兼容性,默认为true
DisplayErrors:是否显示提示错误,默为true;
集合:
Config[Key]=value;
这个集合用于更改配置中某一项的值,如
Fckeditor.Config["DefaultLanguage"]="pt-br";

方法:
Create()  
建立并输出编辑器

RepaceTextArea(TextAreaName)
用编辑器来替换对应的文本框

如何配置FCKEDITOR?
FCKEDITOR提供了一套用于定制其外观,特性及行为的设置集.主配置文件名为Fckconfig.js
你既可以编辑主配置文件,也可以自己定义单独的配置文件.配置文件使用JAVAscrīpt语法.

修改后,在建立编辑器时,可以使用以下语法:
n9I_!DA e,M0var ōFCKeditor = new FCKeditor( 'FCKeditor1' ) ;
oFCKeditor.Config['CustomConfigurationsPath'] = '/myconfig.js' ;
oFCKeditor.Create() ;

提醒:当你修改配置后,请清空浏览器缓存以查看效果

自定义样式列表
FCKEDITOR的样式工具栏中提供了预定义的样式,样式是通过XML文件定义的,默认的XML样式文件存在于FCkEditor根文件夹下的FckStyls.xml文件中
这个XML文件的结构分析如下:
<?xml version="1.0" encoding="utf-8" ?>
<Styles>
<Style name="My Image" element="img">
<Attribute name="style" value="padding: 5px" />
<Attribute name="border" value="2" />
</Style >
<Style name="Italic" element="em" />
<Style name="Title" element="span">
<Attribute name="class" value="Title" />
</Style >
<Style name="Title H3" element="h3" />
</Styles>
每一个STYLE标记定义一种样式,NAME是显示在下拉列表中的样式名,ELEMENT属性指定此样式所适用的对象,因为FCKEDITOR中的样式是上下文敏感的,也就是说,选择不同的对象,仅会显示针对这类对象定义的样式

拼写检查
FCKEDITOR带了两种拼写检查工具,一种是ieSpell,默认情况下使用这种,使用这种方式的拼写检查,要求客户下载并安装iespell这个小软件,另外,也提供SpellPager的方式来进行拼写检查,不过,由于SPELLPAGER是由PHP编写的服务器端脚本,因此,要求你的WEB服务器必须支持PHP脚本语言方可更改拼写检查器的方式请参见有关配置文件的详细说明
压缩脚本

为了提供脚本载入的效率,FCKEDITOR采用以下方法对脚本尽量压缩以减少脚本尺寸:
1,移除掉脚本中的注释
2.移除掉脚本中所有无意义的空白
另外,FCKEDITOR还提供了一个专门用于压缩脚本的工具以便 你在发布时能减小文件尺寸, 你可以将_Packager文件夹中的Fckeditor.Packager.exe复制到FCKEDITOR根文件夹来运行并压缩脚本

本地化FCKEDITOR
如果FCKEDITOR没有提供您所需要的语言(实际上全有了),你也可以自行制作新的语言,你只需要复制出EN.JS,然后在其基础上进行翻译.另外,语言名称与对应的脚本文件名必须遵循RFC 3066标准,但是,需要小写,例如:Portuguess Language对应的脚本文件名必须为pt.js
如果需要针对某个国家的某种语系,则可以在语系缩写后加上横线及国家缩写即可
在使用时,系统会自动侦测客户端语系及国别而运用适当的界面语言.
当建立一种新的语言后,你必须在"Edit/lang/fcklanguagemanager.js"中为其建立一个条目,如下所示:
FCKLanguageManager.AvailableLanguages =
{
en : 'English',
0pt : 'Portuguese'
}

需要提醒的是,文件必须保存为UTF-8格式