ASP FCKeditor線上編輯器使用方法

本文使用的是最新的FCKeditor 2.3.1版本
官方網站下載: http://ckeditor.com/download[建議直接在官方網站下載最新版本]

下面就開始用了:

第一項工作就是對這個功能宏大的編輯器進行精簡，當然是檔案精簡而非功能精簡化。在這裡我以asp版的FCKeditor為例進行，進入到FCKeditor 檔案夾下，先把以“_”為開頭的檔案夾統統刪除，這些檔案夾裡放的是範例或是一些其它工具。其實也就是只保留editor檔案夾、fckconfig.js、fckeditor.asp、fckeditor.js、fckstyles.xml、fcktemplates.xml就可以了，最外層的精簡化完畢，進入到editor檔案夾內，先把“_source”檔案夾刪除，這裡是一些源檔案，對於使用來說沒什麼用處。

進入images檔案夾，刪除smiley檔案夾，些檔案是放表情表徵圖的，你想用這裡的表情表徵圖那就不要刪掉,想換自己的就刪了吧,不過我覺得還是用自己的表情好,現在有很多有個性的圖。退出 images再進入lang檔案夾內，這裡的東西可以來個大清洗了，fcklanguagemanager.js(最新版本沒有這個檔案)、zh-cn.js、en.js、zh.js這四個檔案，第一個檔案是語言設定檔，有了它才能和fckconfig.js裡的設定成對對應上相應的語言檔案,zh-cn.js是簡體中文語言套件,en.js是英語，zh.js是繁體中文的。

再退出lang檔案夾，進入skin檔案夾，default檔案夾是預設的這種奶黃色.silver是銀色的,也就是灰色和任何顏色配起來都不會難看，那個office2003的皮膚不是很好看,不建議使用,如果想換最簡單的方法就是把喜歡的檔案夾的東西拷到default檔案夾下…

精簡的最後一步，退出skin檔案夾，再進入filemanager，如果你用的不是最新版的fckeditor的話，那這裡就一個檔案夾browser，新版的還有一個upload檔案夾。先進入到filemanager/browser/default/connectors/下，除asp檔案夾外(如果你的網頁是其他的如PHP就留相應的php檔案夾,類推)，全部刪除。然後再進入filemanager/upload/下，同樣，只留asp檔案夾，至此，編輯器的精簡化已經結束了，接下來，我們對編輯器進行設定修改。

第一個修改的檔案，也就是fckeditor總設定檔，位於根目錄下的fckconfig.js檔案。配置選項:

AutoDetectLanguage=true/false 自動檢測語言
BaseHref=”” 相對連結的基地址
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標記

如果你不知道從那下手,看看下面的流程可能對你有用:

找到 FCKConfig.DefaultLanguage = 'en' ;改為 FCKConfig.DefaultLanguage = 'zh-cn' ;設定預設語言為簡體中文
找到FCKConfig.TabSpaces = 0 ; 改為FCKConfig.TabSpaces = 1 ; 即在編輯器域內可以使用Tab鍵。

如果你的編輯器還用在網站前台的話，比如說用於留言本或是日記回複時，那就不得不考慮安全了，在前台千萬不要使用Default的toolbar，要麼自訂一下功能，要麼就用系統已經定義好的Basic，也就是基本的toolbar，

FCKConfig.ToolbarSets[”Basic”] = [
['Bold','Italic','-','OrderedList','UnorderedList','-',/*'Link',*/'Unlink','-','Style','FontSize','TextColor','BGColor','-','Smiley','SpecialChar','Replace','Preview']
] ;

這是我改過的Basic，把映像功能去掉，把添加連結功能去掉，因為映像和連結和flash和映像按鈕添加功能都能讓前台頁直接存取和上傳檔案，要是這兒不改直接給你上傳個木馬還不馬上玩完？但是光這樣還不行，fckeditor還支援編輯域內的滑鼠右鍵功能。

FCKConfig.FontNames = 'Arial;Comic Sans MS;Courier New;Tahoma;Times New Roman;Verdana' ;

加上幾種我們常用的字型 FCKConfig.FontNames = '宋體;黑體;隸書;楷體_GB2312;Arial;Comic Sans MS;Courier New;Tahoma;Times New Roman;Verdana' ;

接下來就設定上傳功能了，還是以ASP為例，其實fck預設的就是asp的，把100行以下的所有被注釋掉的代碼全部刪掉就行，然後再把下面所有有關於browser.html和upload.asp的後面的?Type=XX都改成Type=YY，其中YY為你想儲存檔案的檔案夾名稱。

而如果你還想用自己的表情表徵圖的話，那跳到131行，改掉那個表情表徵圖的檔案夾地址，以及下面的表情表徵圖的檔案名稱，再下面那三個數字是每行顯示表情數及快顯視窗的寬和高了，這個的大小要根據您的表情表徵圖排列的視窗的大小而定了。OK，總設定檔修改結束。

接下來是編輯器位置的設定，我的習慣是把editor放在根目錄下，最開始所述的五個檔案也放在根目錄下（Tips:建議放在根目錄下，並且建議使用時設定路徑也採用絕對路徑，如”/fckeditor/”，而我的習慣的設定是”/”），這樣有利於fckeditor的更新升級，並且網站下所有檔案夾都可以任意調用，不存在其它檔案夾名變了而其它地方就無法使用編輯器的問題。

開啟fckeditor.asp檔案，找到 sBasePath = ”/fckeditor/”改為 sBasePath = ”/”
開啟fckeditor.js檔案，找到 this.BasePath = '/fckeditor/' ;改為 this.BasePath = '/' ;

編輯器域內預設的顯示字型為12px，而我的首頁預設字型為14px，所以看著就很不舒服，想要修改可以通過修改樣式表來達到要求，開啟/editor/css/fck_editorarea.css，把第4行改為 font-size: 14px;即可。

接下來就是上傳檔案的設定了，這個比較麻煩，請仔細操作。

開啟\editor\filemanager\browser\default\frmresourcetype.html，找到第15行，插入“ ['uploadfile','uploadfile'],”配合上剛才在fckconfig.js裡的設定，那麼我的上傳檔案路徑就是/uploadfile，當然你也可以改成你想要的檔案夾，但這裡的名稱一定要和fckconfig.js裡的那個“Type=YY”裡的YY一致才行。

還沒完，繼續進入到editor\filemanager\browser\default\connectors\asp，開啟config.asp，先把ConfigIsEnabled = False改成為ConfigIsEnabled = True，要不是沒法上傳檔案的，再把ConfigUserFilesPath = ”/UserFile”改成我想要的ConfigUserFilesPath = ”/”。
接著在“Set ConfigDeniedExtensions = CreateObject( ”Scripting.Dictionary” )”後面加入
ConfigAllowedExtensions.Add ”uploadfile”, ””
ConfigDeniedExtensions.Add ”uploadfile”, ””

同理，這裡的設定也是要和上面以及fckconfig.js裡面對應的。

還有一個上傳，就是快速上傳，這個功能是在fckeditor 2.0裡才有的，以前的版本沒這個功能。進入\editor\filemanager\upload\asp，同樣開啟config.asp，也同樣的把ConfigIsEnabled = False 設定成 ConfigIsEnabled = True，我這裡把ConfigUserFilesPath = ”/UserFiles/”改成我想要的 ConfigUserFilesPath = ”/uploadfile/”& Year(Date()) &”-”& Month(Date()) &”/”，因為我的上傳檔案是放在uploadfile檔案夾下，並且是按月分開放置的。快速上傳，不會讓你選擇檔案夾，而是通過這裡的設定直接上傳的，這兒設定如果和前面的設定配合不好的話，你的檔案就會被上傳得亂七八糟，很不方便管理。接前重複前一個config.asp裡的操作，在後面加上

ConfigAllowedExtensions.Add ”uploadfile”, ””
ConfigDeniedExtensions.Add ”uploadfile”, ””
接下來呢，就講一下如何建立自己的線上編輯器，這裡以ASP為例：

測試環境：XPSP2，IIS5.1，FCKeditor2.0

在IIS上建立一個新的網站，我直接取名為FCKeditor
在DW裡建立一個相對應的網站，測試伺服器為本機，支援VBScript
在網站根目錄下，建立一個index.asp頁面，<body>段內加如下代碼（調用編輯器）：

<%
Dim oFCKeditor
Set oFCKeditor = New FCKeditor
oFCKeditor.BasePath = ”/FCKeditor/” //設定編輯器的路徑，我網站根目錄下的一個目錄
oFCKeditor.ToolbarSet = ”Default”
oFCKeditor.Width = ”100%”
oFCKeditor.Height = ”600″

oFCKeditor.Value = ”” //這個是給編輯器初始值
oFCKeditor.Create ”logbody” //以後編輯器裡的內容都是由這個logbody取得，命名由你定

%>

加了這一段別忘了在index.asp前面第一行加上<!–#include file=”FCKeditor/fckeditor.asp” –>把fckeditor.asp包含進來。

現在你只要把這個編輯器當成一個控制項來使用，提取它的資料時用：request(”logbody”)

這裡推薦一個執行個體，大家可以參考下修改到最新版本中
http://www.jb51.net/codes/23160.html