FCKeditor 是一個相當強大的網頁文字編輯器,支援多種腳本語言與多國語言。本文以 PHP 為例說明,其他語言的設定方式大同小異。文中使用的版本是 2.1,實際上官方(https://www.FCKeditor.Net/)已有 2.3.2 版本可下載。
假設網站目錄結構如下:
\www
\ \index.PHP
\ \inc
\ \FCKeditor
在需要編輯器的地方加入:
<?PHP
include_once("FCKeditor/fckeditor.php"); // 引用 fckeditor.php
$FCKeditor = new FCKeditor('welefen'); // 建立物件
$FCKeditor->BasePath = 'FCKeditor/'; // FCKeditor 所在位置
$FCkeditor->ToolbarSet = 'Default'; // 工具列設定
$FCKeditor->Width = '100%'; // 寬度
$FCKeditor->Height = '300px'; // 高度
$FCkeditor->Create();
?>
<INPUT id=content style="DISPLAY: none" type=hidden name="welefen">
<INPUT id=content___Config style="DISPLAY: none" type=hidden>
<IFRAME id=content___Frame src="FCKeditor/editor/fckeditor.Html?InstanceName=welefen&Toolbar=Default" frameBorder=0 width=100% scrolling=no height=300>
</IFRAME>
上面兩種寫法都出現了字串 'welefen',它就是編輯器的執行個體名稱。若要把內容顯示在另一頁或存進資料庫,用 $_POST['welefen'] 或 $_GET['welefen'] 取值,取決於表單的傳遞方式;名稱也可以自行改成 'content' 等。
如果你用 Ajax 取值,會發現 document.form.content.value 是空的,因為 FCKeditor 並不是普通的 textarea。改用官方 API 即可:
function getContentValue()
{
var oEditor = FCKeditorAPI.GetInstance('content');
var acontent = oEditor.GetXHtml();
return acontent;
}
找到 FCKConfig.ToolbarSets["Default"],裡面列出了所有可用按鈕,對照如下:
預設包含全部按鈕,但實際上很多用不到,還會拖慢載入速度。可以自行刪減,以下是我的設定供參考:
FCKconfig.ToolbarSets["Default"] = [
['EditSource','Save','NewPage','PrevIEw','-','Cut','Copy','Paste','PasteText','-','Find','Replace','-','Undo','Redo','-','SelectAll','-','Link','RemoveLink','-','Image','Table','Rule','SpecialChar','Smiley'],
['Bold','Italic','Underline','-','JustifyLeft','JustifyCenter','JustifyRight','-','InsertOrderedList','InsertUnorderedList','-','Form','Checkbox','Radio','Input','Textarea','Select','Button','-','FontStyleAdv','TextColor'] ] ;
如果是在前台讓使用者回覆文章,還可以再簡化,多定義一組 Basic:
FCKConfig.ToolbarSets["Basic"] = [
['Bold','Italic','-','OrderedList','UnorderedList','-','Link','Unlink','-','About']
] ;
這樣前台呼叫時要寫 $FCKeditor->ToolbarSet='Basic',而不是 "Default"。
找到 FCKConfig.DefaultLanguage,設為 'zh-cn'。
找到 var _FileBrowserLanguage 與 var _QuickUploadLanguage,設為 'PHP'(預設是 'ASP')。這一步如果不改,圖片將無法上傳。當時我就是漏了這個設定,圖片上傳一直失敗,同寢室用 ASP 的人卻沒問題,困擾了好幾天最後才找到原因。
開啟 FCKeditor/editor/filemanager/browser/default/connectors/php/config.PHP:
$Config['Enabled'] 設為 true。$Config['UserFilesPath'] 設為圖片目錄,路徑相對於主目錄,例如 blog 可設為 /blog/upload/。再開啟 FCKeditor/editor/filemanager/upload/php/config.PHP:
$Config['Enabled'] 設為 true。$Config['UseFileType'] 設為上傳目錄,最好與上面相同。設定完成後,最後一步是刪掉不需要的檔案:凡是檔名或目錄名含底線的都可以刪,用不到的其他語言目錄也可以一併清掉,能有效縮小整體檔案大小。