DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> JavaScript入門知識 >> AJAX入門 >> AJAX詳解
FCKeditor 設定與使用完整指南
編輯:AJAX詳解     

FCKeditor 是一個相當強大的網頁文字編輯器,支援多種腳本語言與多國語言。本文以 PHP 為例說明,其他語言的設定方式大同小異。文中使用的版本是 2.1,實際上官方(https://www.FCKeditor.Net/)已有 2.3.2 版本可下載。

假設網站目錄結構如下:

\www
\ \index.PHP
\ \inc
\ \FCKeditor

一、兩種呼叫方式

1. 建立執行個體

在需要編輯器的地方加入:

<?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();
?>

2. 透過 iframe 呼叫

<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>

3. 關於 InstanceName

上面兩種寫法都出現了字串 '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.JS 設定

工具列按鈕

找到 FCKConfig.ToolbarSets["Default"],裡面列出了所有可用按鈕,對照如下:

  • EditSource 顯示 HTML 原始碼/StrikeThrough 刪除線/Save 儲存/Subscript 下標
  • NewPage 新增空白頁/Superscript 上標/PrevIEw 預覽/JustifyLeft 靠左對齊
  • Cut 剪下/JustifyCenter 置中/Copy 複製/JustifyRight 靠右對齊
  • Paste 貼上/JustifyFull 左右對齊/PasteText 純文字貼上/InsertOrderedList 自動編號
  • PasteWord 從 Word 貼上/InsertUnorderedList 項目符號/Print 列印/Outdent 減少縮排
  • SpellCheck 拼字檢查/Indent 增加縮排/Find 尋找/ShowTableBorders 顯示表格框線
  • Replace 取代/ShowDetails 顯示明細/Undo 復原/Form 加入表單
  • Redo 重做/Checkbox 核取方塊/SelectAll 全選/Radio 單選按鈕
  • RemoveFormat 移除格式/Input 單行文字框/Link 插入或編輯連結/Textarea 多行文字框
  • RemoveLink 移除連結/Select 下拉選單/Anchor 錨點/Button 按鈕
  • Image 插入或編輯圖片/ImageButton 圖片按鈕/Table 插入或編輯表格/Hidden 隱藏欄位
  • Rule 插入水平線/Zoom 顯示比例/SpecialChar 插入特殊字元/FontStyleAdv 系統字型
  • UniversalKey 小鍵盤/FontStyle 字型樣式/Smiley 插入表情符號/FontFormat 段落格式
  • About 關於/Font 字型/Bold 粗體/FontSize 字型大小
  • Italic 斜體/TextColor 文字顏色/Underline 底線/BGColor 背景色

預設包含全部按鈕,但實際上很多用不到,還會拖慢載入速度。可以自行刪減,以下是我的設定供參考:

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'] 設為上傳目錄,最好與上面相同。

設定完成後,最後一步是刪掉不需要的檔案:凡是檔名或目錄名含底線的都可以刪,用不到的其他語言目錄也可以一併清掉,能有效縮小整體檔案大小。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved