FCKeditor 的配置和使用方法(for PHP)

    FCKeditor 是一個十分強大的網頁文本編輯器，它支持多種腳本編程語言(包括 PHP)和支持多國語言。

    FCKeditor 截至 2008年4月6日，其最新版本是 2.6RC，RC 就是 Release Candidate，修訂後的候選版本，很可能作爲該版本的穩定版在未來發布。目前的最新的穩定版(Latest Stable)是 2.5.1。我們可以到他的官方網站上去下載 http://www.FCKeditor.net 合適的版本，開源、免費的。

    本文介紹 PHP 中的配置方法，其他語言的配置方法和它是基本一樣的。

    〇、假設網站的目錄爲：
    \website_root
      \index.php
      \FCKeditor

    一、調用FCKeditor 的兩種方法

    1、通過創建實例來調用

      在 index.php 文件中，調用它的代碼，把下面的代碼加在需要編輯器的地方：
      <Form name="frm1">
      <?php
        //引用FCKeditor.php這個文件，基本的類和數據結構都在這裏
        include_once("FCKeditor/fckeditor.php");
        //創建FCKeditor對象的實例。myFCKeditor即提交後，接收數據頁面 $_POST['myFCKeditor']使用
        $FCKeditor=new FCKeditor('myFCKeditor');
        //FCKeditor所在的位置，這裏它的位置就是'FCKeditor' 文件夾
        $FCKeditor->BasePath='./FCKeditor/';
        //工具按鈕設置
        $FCkeditor->ToolbarSet='Default';
        //設置它的寬度
        $FCKeditor->Width='100%';
        //設置它的高度
        $FCKeditor->Height='300px';
        //生成
        $FCkeditor->Create();
      ?>
      </Form>

    2、通過 IFRAME 調用

    <Form name="frm1">
      <INPUT name="myFCKeditor" id="myFCKeditor" style="DISPLAY: none" type=hidden>
      <INPUT id="myFCKeditor___Config" style="DISPLAY: none" type=hidden>
      <IFRAME id="myFCKeditor___Frame" src="FCKeditor/editor/fckeditor.html?InstanceName=myFCKeditor&amp;Toolbar=Default" frameBorder=0 width=100% scrolling=no height=300>
      </IFRAME>
    </Form>

    注意：name="myFCKeditor" 和 IFRAME 中 InstanceName=myFCKeditor 的“myFCKeditor”必須相同。

    其實，用 IFRAME 調用和用第一種方法本質是完全一樣的！不信的話，請在用瀏覽器打開網站上的 index.php 文件，然後查看“源代碼”，就是本 IFRAME 調用的代碼。所以推薦通過創建實例來調用。

    3、當用 Javascript 來獲得內容的時候是不是發現得不到內容，如：
    <script>
      <input type=button onclick="alert(document.all.frm1.myFCKeditor.value);" value="GetHtml">
    </script>
    你會發現彈談出的窗口沒內容。

    我們可以通過下面的代碼來獲得它的內容：

    <script>
      function getContentValue()
      {
        var oEditor = FCKeditorAPI.GetInstance('myFCKeditor');
        var acontent = oEditor.GetXHTML();
        return acontent;
      }
    </script>
    <input type=button onclick="alert(getContentValue());">

    二、配置一些文件

    1、fckconfig.js的配置

    (1)工具按鈕設置

    查找 FCKConfig.ToolbarSets["Default"]，這裏有很多按鈕，下面我們將對他們詳細介紹

    EditSource 顯示HTML源代碼
    StrikeThrough 刪除線
    Save 保存
    NewPage 新建空白頁面
    Superscript 上標
    Subscript 下標
    Preview 預覽
    JustifyLeft 左對齊
    Cut 剪切
    Copy 複製
    Paste 粘貼
    JustifyCenter 居中對齊
    JustifyRight 右對齊
    JustifyFull 兩端對齊
    PasteText 純文本粘貼
    InsertOrderedList 自動編號
    PasteWord 來自Word的粘貼
    InsertUnorderedList 項目符號
    Print 打印
    Outdent 減少縮進
    SpellCheck 拼寫檢查
    Indent 增加縮進
    Find 查找
    ShowTableBorders 顯示錶格線
    Replace 替換
    ShowDetails 顯示明細
    Undo 撤銷
    Form 添加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']
    ];

    再例如：
    FCKConfig.ToolbarSets["Basic"] = [
    ['Bold','Italic','-','OrderedList','UnorderedList','-','Link','Unlink','-','About']
    ];

    這樣的話，你在前臺調用的時候就要用 $FCKeditor->ToolbarSet='Basic'，不能再是"Default"了。

    (2)語言的配置

    查找FCKConfig.DefaultLanguage將它設置爲'zh-cn'.

    (3)腳本語言的設置

    查找var _FileBrowserLanguage和var _QuickUploadLanguage將他們設置爲'php', 默認是'asp',如果這裏不設置的話，圖片將不能上傳，這點很重要。當時我在用FCKeditor由於沒配置這個，不能上傳圖片，而我同寢室的用asp能上傳圖片，讓我煩惱了好多天，最後終於找到是這個原因。

    2、圖片上傳的配置

    打開文件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']，將它設置上傳文件的目錄，最好與上面的圖片目錄相同。

    好了，現在所有的配置都已經完成了，現在你要做的只是刪除一些不必要的文件了。只要包含'_'的目錄名和文件名都可以刪除，這都是一些說明文件。因爲我們用在 PHP 環境中，其他語言相關的一些文件也都可以刪除。