FckEditor中文配置手冊(cè)詳細(xì)說(shuō)明

對(duì)FckEditor的一點(diǎn)使用經(jīng)驗(yàn)，及網(wǎng)絡(luò)上的資料整理正題：下載FckEditor

FCKeditor目前已經(jīng)更新到2.6版，詳情請(qǐng)看官方/因?yàn)橄螺d下來(lái)的壓縮包里面有包含很多在我們使用時(shí)，用不到的，不刪除也行?？磦€(gè)人喜好下面以PHP為例，進(jìn)行程序瘦身刪除所有”_”開(kāi)頭的文件和文件夾

刪除FCKeditor的目錄下：

fckeditor.afp

fckeditor.asp

fckeditor.cfc

fckeditor.cfm

fckeditor.lasso

fckeditor.pl

fckeditor.py

htaccess.txt

license.txt

刪除語(yǔ)言包editor\lang中除中文和英文以外的語(yǔ)言

刪除skin目錄下除默認(rèn)皮膚以外的文件夾

filemanager/browser/default/connectors/目錄下除php以外的文件

filemanager/upload/目錄下除php以外的文件

如果你不想要表情包刪除editor\images\smiley下的msn文件夾及表情按鈕

好了精簡(jiǎn)完畢我們通常把編輯器用以個(gè)文件夾存放、通常情況下我們可以明白為fckeditor或editor找到里面兩關(guān)鍵文件fckeditor_php4.php

fckeditor_php5.php

這兩個(gè)文件的代碼相差不了多少，很顯然跟php版本有關(guān)打開(kāi)這兩個(gè)文件XML/HTML代碼function

FCKeditor(

$instanceName

)

{

$this->InstanceName

=

$instanceName

;

$this->BasePath

=

'./editor/'

;

默認(rèn)編輯器所在的文件位置

$this->Width

=

'100%'

;

默認(rèn)編輯器寬

$this->Height

=

'350'

;

默認(rèn)編輯器高

$this->ToolbarSet

=

'Default'

;

默認(rèn)編輯器SKIN

$this->Value

=

''

;

初始值

$this->Config

=

array()

;

}

FCKeditor設(shè)置文件"fckconfig.js"

XML/HTML代碼FCKConfig.CustomConfigurationsPath

=

''

;

//

自定義配置文件路徑和名稱

FCKConfigFCKConfig.EditorAreaCSS

=

FCKConfig.BasePath

+

'css/fck_editorarea.css';

//

編輯區(qū)的樣式表文件

FCKConfig.EditorAreaStyles

=

''

;

//

編輯區(qū)的樣式表風(fēng)格

FCKConfig.ToolbarComboPreviewCSS

='';

//工具欄預(yù)覽CSS

FCKConfig.DocType

=

''

;//文檔類型

FCKConfig.BaseHref

=

'';

//

相對(duì)鏈接的基地址

FCKConfig.FullPage

=

false

;

//是否允許編輯整個(gè)HTML文件,還是僅允許編輯BODY間的內(nèi)容

FCKConfig.StartupShowBlocks

=

false

;//決定是否啟用"顯示模塊"

FCKConfig.Debug

=

false

;//是否開(kāi)啟調(diào)試功能

FCKConfigFCKConfig.SkinPath

=

FCKConfig.BasePath

+

'skins/default/'

;

//皮膚路徑

FCKConfig.PreloadImages=...

//預(yù)裝入的圖片

FCKConfigFCKConfig.PluginsPath

=

FCKConfig.BasePath

+

'plugins/'

;

//插件路徑

FCKConfig.AutoDetectLanguage

=

true

;

//是否自動(dòng)檢測(cè)語(yǔ)言

FCKConfig.DefaultLanguage

=

'zh-cn'

;

//默認(rèn)語(yǔ)言

FCKConfig.ContentLangDirection

=

'ltr'

;

//默認(rèn)的文字方向,可選"ltr/rtl",即從左到右或從右到左

FCKConfig.ProcessHTMLEntities

=

true

;

//處理HTML實(shí)體

FCKConfig.IncludeLatinEntities

=

true

;

//包括拉丁文

FCKConfig.IncludeGreekEntities

=

true

;//包括希臘文

FCKConfig.ProcessNumericEntities

=

false

;//處理數(shù)字實(shí)體

FCKConfig.AdditionalNumericEntities

=

''

;

//附加的數(shù)字實(shí)體

FCKConfig.FillEmptyBlocks

=

true

;

//是否填充空塊

FCKConfig.FormatSource

=

true

;

//在切換到代碼視圖時(shí)是否自動(dòng)格式化代碼

FCKConfig.FormatOutput

=

true

;

//當(dāng)輸出內(nèi)容時(shí)是否自動(dòng)格式化代碼

FCKConfig.FormatIndentator

=

'

'

;

//當(dāng)在源碼格式下縮進(jìn)代碼使用的字符

FCKConfig.StartupFocus

=

false

;

//開(kāi)啟時(shí)焦點(diǎn)是否到編輯器,即打開(kāi)頁(yè)面時(shí)光標(biāo)是否停留在fckeditor上

FCKConfig.ForcePasteAsPlainText

=

false

;

//是否強(qiáng)制粘貼為純文件內(nèi)容

FCKConfig.AutoDetectPasteFromWord

=

true

;

//是否自動(dòng)探測(cè)從word粘貼文件,僅支持IE

FCKConfig.ShowDropDialog

=

true

;//是否顯示下拉菜單

FCKConfig.ForceSimpleAmpersand

=

false

;//是否不把&符號(hào)轉(zhuǎn)換為XML實(shí)體

FCKConfig.TabSpaces

=

0

;//按下Tab鍵時(shí)光標(biāo)跳格數(shù),默認(rèn)值為零為不跳格

FCKConfig.ShowBorders

=

true

;//合并邊框

FCKConfig.SourcePopup

=

false

;//彈出

FCKConfig.ToolbarStartExpanded

=

true

;//啟動(dòng)fckeditor工具欄默認(rèn)是否展開(kāi)

FCKConfig.ToolbarCanCollapse

=

true

;//是否允許折疊或展開(kāi)工具欄

FCKConfig.IgnoreEmptyParagraphValue

=

true

;//是否忽略空的段落值

FCKConfig.FloatingPanelsZIndex

=

10000

;//浮動(dòng)面板索引

FCKConfig.HtmlEncodeOutput

=

false

;//是否將HTML編碼輸出

FCKConfig.TemplateReplaceAll

=

true

;//是否替換所有模板

FCKConfig.ToolbarLocation

=

'In'

;//工具欄位置,

FCKConfig.CustomConfigurationsPath

=

''

;

//

自定義配置文件路徑和名稱

FCKConfigFCKConfig.EditorAreaCSS

=

FCKConfig.BasePath

+

'css/fck_editorarea.css';

//

編輯區(qū)的樣式表文件

FCKConfig.BaseHref

=

'';

//

相對(duì)鏈接的基地址

FCKConfig.Debug

=

true/false;

//

是否開(kāi)啟調(diào)試功能，當(dāng)調(diào)用FCKDebug.Output()時(shí)，會(huì)在調(diào)試窗中輸出內(nèi)容

FCKConfigFCKConfig.SkinPath

=

FCKConfig.BasePath

+

'skins/default/';

//

設(shè)置皮膚

FCKConfig.AutoDetectLanguage

=

true/false

;

//

是否自動(dòng)檢測(cè)語(yǔ)言

FCKConfig.DefaultLanguage

=

'zh-cn'

;

//

設(shè)置默認(rèn)語(yǔ)言

FCKConfig.ContentLangDirection

=

'ltr/rtr';

//

默認(rèn)文字方向，ltr左，rtr右

FCKConfig.FillEmptyBlocks

=

true/false

;

//

使用這個(gè)功能，可以將空的塊級(jí)元素用空格來(lái)替代

FCKConfig.FormatSource

=

true/false;

//

切換到代碼視圖時(shí)，是否自動(dòng)格式化代碼

FCKConfig.FormatOutput

=

true/false;

//

當(dāng)輸出內(nèi)容時(shí)是否自動(dòng)格式化代碼

FCKConfig.FormatIndentator

=

"";

//

當(dāng)在“源碼格式”下縮進(jìn)代碼使用的字符

FCKConfig.GeckoUseSPAN

=

true/false;

//

是否允許SPAN標(biāo)記代替B，I，U標(biāo)記

FCKConfig.StartupFocus

=

true/false;

//

開(kāi)啟時(shí)是否FOCUS到編輯器

FCKConfig.ForcePasteAsPlainText

=

true/false;//

強(qiáng)制粘貼為純文本

FCKConfig.ForceSimpleAmpersand

=

true/false;

//

是否不把&符號(hào)轉(zhuǎn)換為XML實(shí)體

FCKConfig.TabSpaces

=

0/1;

//

TAB是否有效

FCKConfig.TabSpaces

=

4;

//

TAB鍵產(chǎn)生的空格字符數(shù)

FCKConfig.ShowBorders

=

true/false;

//

是否合并邊框

FCKConfig.ToolbarStartExpanded

=

true/false;

//

頁(yè)面載入時(shí)，工具欄是否展開(kāi)，點(diǎn)“展開(kāi)工具欄”時(shí)才出現(xiàn)

FCKConfig.ToolBarCanCollapse

=

true/false;

//

是否允許展開(kāi)折疊工具欄

FCKConfig.ToolbarSets

=

object

;

//

編輯器的工具欄，可以自行定義，刪減，可參考已存在工具欄

FCKConfig.EnterMode

=

'p';

//

編輯器中直接回車，在代碼中生成，可選為p

|

div

|

br

FCKConfig.ShiftEnterMode

=

'br';

//

編輯器中Shift+回車，在代碼中生成，可選為p

|

div

|

br

FCKConfig.ContextMenu

=

字符串?dāng)?shù)組;

//

右鍵菜單的內(nèi)容

FCKConfig.FontColors

=

"";

//

文字顏色列表

FCKConfig.FontNames

=

"";

//

字體列表

FCKConfig.FontSizes

=

"";

//

字號(hào)列表

FCKConfig.FontFormats

=

"";

//

文字格式列表

FCKConfig.StylesXmlPath

=

"";

//

CSS樣式列表的XML文件的位置

FCKConfig.TemplatesXmlPath

=

"";

//

模版的XML文件位置

FCKConfig.SpellChecker

=

"ieSpell/Spellerpages";

//

拼寫(xiě)檢查器

FCKConfig.IeSpellDownloadUrl

=

"";

//

下載拼寫(xiě)檢查器的網(wǎng)址

FCKConfigFCKConfig.SmileyPath

=

FCKConfig.BasePath

+

'images/smiley/msn/';

//

表情文件存放路徑

FCKConfig.SmileyImages

=

'';

//

表情文件名稱列表，具體參考默認(rèn)設(shè)置

FCKConfig.SmileyColumns

=

8;

//

表情窗口顯示表情列數(shù)

FCKConfig.SmileyWindowWidth

=

320;

//

表情窗口顯示寬度，此窗口會(huì)因?yàn)楸砬槲募母淖兌髡{(diào)整

FCKConfig.SmileyWindowHeight

=

240;

//

表情窗口顯示高度，此窗口會(huì)因?yàn)楸砬槲募母淖兌髡{(diào)整

FCKConfig.FullPage

=

true/false;

//

是否允許編輯整個(gè)HTML文件，還是僅允許編輯BODY間的內(nèi)容

上傳設(shè)置

var

_FileBrowserLanguage

=

'php'

;

//

asp

|

aspx

|

cfm

|

lasso

|

perl

|

php

|

py

var

_QuickUploadLanguage

=

'php'

;

//

asp

|

aspx

|

cfm

|

lasso

|

php[/code]

//第一個(gè)是文件瀏覽器使用的語(yǔ)言，第二個(gè)快速上傳使用的語(yǔ)言，改成你需要的

FCKConfig.LinkUploadAllowedExtensions

=

""

;

//

empty

for

all

FCKConfig.LinkUploadDeniedExtensions

=".(php|php3|php5|phtml|asp|aspx|ascx|jsp|cfm|cfc|pl|bat|exe|dll|reg|cgi)$"

//這是兩個(gè)允許和拒絕上傳的文件類型列表

FCKConfig.ImageBrowser

=

false

;是否在插入圖片功能里面啟用服務(wù)器文件瀏覽功能

FCKConfigFCKConfig.ImageBrowserURL

=

FCKConfig.BasePath

+

'filemanager/browser/default/browser.html?Type=ImageConnector=connectors/'

+

_FileBrowserLanguage

+

'/connector.'

+

_FileBrowserExtension

;

Type=Image

表示文件類型是image這會(huì)使文件瀏覽器定位到文件上傳路徑/image/文件夾下面

FCKConfig.FlashBrowser

=

false

;是否在插入flash功能中啟用服務(wù)器文件瀏覽功能

FCKConfig.LinkUpload

=

false

;是否啟用插入鏈接的快速上傳功能

FCKConfig.ImageUpload

=

false

;是否啟用圖片快速上傳功能

FCKConfig.FlashUpload

=

false

;是否啟用flash上傳功能

服務(wù)器文件設(shè)置

文件瀏覽器的設(shè)置：

fckeditor\editor\filemanager\connectors\asp\config.asp

ConfigIsEnabled

=

true

決定是否啟用文件瀏覽器。這個(gè)是在服務(wù)器上執(zhí)行的

ConfigUserFilesPath

=

"/test/upload/"

上傳文件的路徑（相對(duì)的）

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個(gè)不同的filetype類型分別對(duì)應(yīng)了前臺(tái)編輯器的插入鏈接插入圖片插入flash插入媒體4個(gè)功能

這里的文件類型與上面提到的兩處文件類型是一致的要改必須許全改

快速上傳：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設(shè)置多個(gè)工具欄樣式

FCKeditor中自帶了兩種工具欄樣式，Default和Base。可是我現(xiàn)在想再加一種工具欄樣式。我試了一下。將Default樣式的設(shè)置復(fù)制了一下改為FCKConfig.ToolbarSets["Blogedit"],里面?zhèn)€體的工具欄項(xiàng)我就不寫(xiě)了。可是當(dāng)我在調(diào)用這個(gè)工具欄時(shí)，卻提示我說(shuō)工具欄Blogedit設(shè)置沒(méi)有找到，這是怎么回事啊？難道FCKeditor只能使用Default和Base這兩種樣式嗎？找到

fckconfig.js

里面設(shè)置這里我添加了

ddd

工具欄樣式要用的時(shí)候只需要在引用的時(shí)候

$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']

]

;

有時(shí)間我在吧！ADODB+SMARTY中應(yīng)用板塊寫(xiě)上去

將FCKEDITOR整合進(jìn)我的頁(yè)面由于目前的版本提供的FCKEDITOR僅提供了JAVAscrīpt式的整合,因此,這里僅講述如何應(yīng)用JAVAscrīpt來(lái)整合FCKEDITOR到站點(diǎn)中,當(dāng)然,其他各種語(yǔ)言的整合,你可以

參考_samples文件夾中的例子來(lái)完成

1,假如編輯器已經(jīng)安裝在你的站點(diǎn)的/FCKEDITOR/文件夾下.那么,第一步我們需要做的就是在頁(yè)面的HEAD段中放入scrīpt標(biāo)記以引入JAVAscrīpt整合模塊.例如:

<scrīpttype="text/javascrīpt"src="/fckeditor/fckeditor.js"></scrīpt>其中路徑是可更改的2,現(xiàn)在,FCKEDITOR類已經(jīng)可以使用了.有兩個(gè)方法在頁(yè)面中建立一個(gè)FCKEDITOR編輯器:

方法1:內(nèi)聯(lián)方式(建議使用):在頁(yè)面的FORM標(biāo)記內(nèi)需要插入編輯器的地方置入以下代碼:

scrīpttype="text/javascrīpt">

varōFCKeditor=newFCKeditor('FCKeditor1');

oFCKeditor.Create();

</scrīpt>方法2:TEXTAREA標(biāo)記替換法(不建議使用):在頁(yè)面的ONLOAD事件中,添加以下代碼以替換一個(gè)已經(jīng)存在的TEXTAREA標(biāo)記<html>

<head>

<scrīpttype="text/javascrīpt">

window.onload=function()

{

varōFCKeditor=newFCKeditor('MyTextarea');

oFCKeditor.ReplaceTextarea();

}

</scrīpt>

</head>

<body>

<textareaid="MyTextarea"name="MyTextarea">Thisis<b>the</b>initialvalue.</textarea>

</body>

</html>現(xiàn)在,編輯器可以使用了

FCKEDITOR類參考:

下面是用來(lái)在頁(yè)面中建立編輯器的FCKEDITOR類的說(shuō)明構(gòu)造器:

FCKeditor(instanceName[,width,height,toolbarSet,value])

instanceName:編輯器的唯一名稱(相當(dāng)于ID)

WIDTH:寬度

HEIGHT:高度

toolbarSet:工具條集合的名稱

value:編輯器初始化內(nèi)容屬性:

instanceName:編輯器實(shí)例名

width:寬度,默認(rèn)值為100%

height:高度,默認(rèn)值是200

ToolbarSet:工具集名稱,參考FCKCONFIG.JS,默認(rèn)值是Default

value:初始化編輯器的HTML代碼,默認(rèn)值為空

BasePath:編輯器的基路徑,默認(rèn)為/Fckeditor/文件夾,注意,盡量不要使用相對(duì)路徑.最好能用相對(duì)于站點(diǎn)根路徑的表示方法,要以/結(jié)尾

CheckBrowser:是否在顯示編輯器前檢查瀏覽器兼容性,默認(rèn)為true

DisplayErrors:是否顯示提示錯(cuò)誤,默為true;

集合:

Config[Key]=value;

這個(gè)集合用于更改配置中某一項(xiàng)的值,如

oFckeditor.Config["DefaultLanguage"]="pt-br";方法:

Create()

建立并輸出編輯器RepaceTextArea(TextAreaName)

用編輯器來(lái)替換對(duì)應(yīng)的文本框如何配置FCKEDITOR?

FCKEDITOR提供了一套用于定制其外觀,特性及行為的設(shè)置集.主配置文件名為Fckconfig.js

你既可以編輯主配置文件,也可以自己定義單獨(dú)的配置文件.配置文件使用JAVAscrīpt語(yǔ)法.修改后,在建立編輯器時(shí),可以使用以下語(yǔ)法:

varōFCKeditor=newFCKeditor('FCKeditor1');

oFCKeditor.Config['CustomConfigurationsPath']='/myconfig.js';

oFCKeditor.Create();提醒:當(dāng)你修改配置后,請(qǐng)清空瀏覽器緩存以查看效果自定義樣式列表

FCKEDITOR的樣式工具欄中提供了預(yù)定義的樣式,樣式是通過(guò)XML文件定義的,默認(rèn)的XML樣式文件存在于FCkEditor根文件夾下的FckStyls.xml文件中

這個(gè)XML文件的結(jié)構(gòu)分析如下:

<?xmlversion=