FreeTextBox 編輯器完整設定指南

FreeTextBox 是經典的 ASP.NET 富文本編輯器，本文詳細記錄安裝、設定、工具列客製化、圖片上傳等完整流程。

安裝步驟

1. 專案建立 Bin 資料夾，放入 FreeTextBox.dll
2. Web.config 註冊 HttpHandler：

<configuration>
  <system.web>
    <httpHandlers>
      <add verb="GET" path="FtbWebResource.axd" 
           type="FreeTextBoxControls.AssemblyResourceHandler, FreeTextBox" />
    </httpHandlers>
  </system.web>
</configuration>

3. 頁面頂端註冊標籤前綴：<%@ Register TagPrefix="FTB" Namespace="FreeTextBoxControls" Assembly="FreeTextBox" %>
4. 頁面引用：<FTB:FreeTextBox id="FreeTextBox1" runat="Server" />

進階設定

工具列外觀

ToolbarStyleConfiguration：Office2003、OfficeXP、Office2000、MAC

工具列按鈕配置

ToolbarLayout 屬性以逗號、分號、管道符分隔按鈕：

ParagraphMenu, FontFacesMenu, FontSizesMenu, FontForeColorsMenu, 
Bold, Italic, Underline, Strikethrough, Superscript, Subscript,
InsertImageFromGallery, CreateLink, Unlink, RemoveFormat,
JustifyLeft, JustifyRight, JustifyCenter, JustifyFull,
BulletedList, NumberedList, Indent, Outdent,
Cut, Copy, Paste, Delete, Undo, Redo, Print, Save,
ieSpellCheck, StyleMenu, SymbolsMenu, InsertHtmlMenu, InsertRule,
InsertDate, InsertTime, WordClean, InsertImage, InsertTable, EditTable,
InsertTableRowBefore, InsertTableRowAfter, DeleteTableRow,
InsertTableColumnBefore, InsertTableColumnAfter, DeleteTableColumn,
InsertForm, InsertTextBox, InsertTextArea, InsertRadioButton,
InsertCheckBox, InsertDropDownList, InsertButton, InsertDiv,
Preview, SelectAll, EditStyle

圖片上傳設定

1. 工具列加入 InsertImageFromGallery 按鈕
2. 複製 ftb.imagegallery.aspx 與 aspnet_client 資料夾至同目錄
3. 設定屬性：

ImageGalleryPath = "~/image/upload"        // 上傳實體路徑
ImageGalleryUrl = "ftb.imagegallery.aspx?rif={0}&cif={0}"  // 相對路徑

4. ftb.imagegallery.aspx 內 ImageGallery 控制項設定權限：

<FTB:ImageGallery id="ImageGallery1" 
    AllowImageDelete="true" AllowImageUpload="true"
    AllowDirectoryCreate="false" AllowDirectoryDelete="false"
    AcceptedFileTypes="jpg,jpeg,gif,png,bmp" />

5. 關閉上傳視窗（可選）：編輯 FTB-ImageGallery.js，在 FTB_InsertImage 末尾加入 window.close()

安全性設定

頁面指令加入 ValidateRequest="false" 允許 HTML 內容提交（需自行防範 XSS）。