Attachments 說明文檔

版本 1.2 - 2008年2月20日

  1. 簡介
  2. 上傳限制
  3. 設定
  4. 自訂附件列表樣式
  5. 檔案類型圖示
  6. 警告
  7. 升級
  8. 致謝

簡介

Attachments 是一款針對 Joomla! 1.5 開發的擴展套件,它可以讓你上傳檔案并以附件形式附加到文章中。Attachments 擴展套件包括一個插件,用于在文章中顯示附件;一個元件,用于上傳及管理附件;一個按鈕插件,用于在文章編輯窗口添加一個“插入附件”的按鈕。設置選項包括誰能看到附件以及誰能上傳附件,還有一些其它選項來提升其靈活性及可用性。注意: 本擴展套件只能工作在 Joomla! 1.5 及更高版本。 【回到頁頂】

上傳限制

并非任何類型的檔案都可以作為附件來上傳。Attachments 不會允許上傳 Joomla! 的媒體管理器禁止上傳的檔案。要想知道(或者更改)哪些檔案被允許上傳,請進入 全局設置 頁面,點擊 系統 標簽。在 媒體設定 部分,那里有關于允許上傳哪些檔案類型及媒體類型的選項。Attachments 元件完全遵守這些限制。不過,“允許的圖片類型(檔案類型)”部分的設定不予參考。 【回到頁頂】

附件設定

Attachments 元件的所有設定都是通過其插件的參數頁面完成的。要更改這些設定,請登入后臺管理界面,點擊“擴展套件”菜單上的“插件管理”,找到名為“Content-Attachments”的項目并打開,您就可以在頁面右側看到一系列參數。這些參數包括:
【回到頁頂】

自訂附件列表的樣式

網站前臺的附件列表是通過特殊的含有表格的 ’div’ 來實現的。該表格擁有幾個不同的 CSS 類,以便給網站開發人員提供自訂表格外觀的靈活性。請打開插件的 CSS 檔案( plugins/content/attachments.css) 查看實例。如果您希望更改樣式,先復制原始的樣式代碼到該檔案的末尾,然后將新復制部分的 'attachmentsList' 名稱修改為您自己想要的名稱。然后在本元件的參數(元件 - 文章附件)中, 將 附件表格樣式 一項填寫為新修改的名稱。接下來在您復制的代碼部分修改 CSS 類定義,以適應您的需要。這個方法可以讓您在需要時迅速還原到初始的樣式,只需要將元件參數中的 附件表格樣式 名稱改回默認的“attachmentList”即可。此法還有一個優勢就是,已修改的樣式代碼部分可以被復制到某個檔案中保存下來,然后在 Attachments 元件升級之后輕松地復原回去。這個操作也可以通過 CSS @import 命令來完成。 【回到頁頂】

檔案類型圖示

'Attachments' 元件在附件列表上的每一個附件前面都會顯示一個圖示。如果您想要增加一種新的圖示類型,這樣操作: (1) 上傳圖示檔案到 'media/attachments/icons' 目錄(如果你沒有在該目錄中找到合適的圖示檔案的話); (2) 修改 'components/com_attachments/file_types.php' 這個檔案,在靜態序列 $attachments_icon_from_file_extension 中添加一行代碼,該序列是檔案擴展名與圖示名稱(都在 media/attachments/icons 目錄中)的映射關系。如果還不能生效,您或許還需要在序列 $attachments_icon_from_mime_type 中添加一行代碼。(3) 以后升級 Attachments 元件時,一定要首先復制該圖示檔案及修改過的 file_types.php 檔案到網站之外的某個目錄中。 【回到頁頂】

警告

【回到頁頂】

升級

如果您之前已經上傳了附件,現在希望在升級時繼續保留,請按照下列步驟操作:
  1. 通過 phpMyAdmin (或其它 SQL 備份工具) 保存 jos_attachments 資料表的內容(使用“導出”功能)。
  2. 卸載“Attachments”元件。如果 Joomla 提示說無法刪除媒體檔案,您就必須手動刪除 /media/attachments 目錄。
  3. 卸載“Attachments”插件。
  4. 安裝新版本元件和插件。
  5. 啟用“Attachments”插件。
  6. 最后通過 phpMyAdmin 導入前面保存的附件資料到新創建的 jos_attachments 資料表中。
  7. 如果您是從低于 1.0 的某個版本升級到高于 1.0 的版本,并且您有以前的附件檔案, 您還需要在新的“icon_filename”字段中添加適當的值。方法是以管理員身份登入網站后臺,然后在瀏覽器中打開下面這個 URL:
    /administrator/index.php?option=com_attachments&task=add_icon_filenames

注意:卸載“Attachments”元件不會刪除以前上傳的檔案,但是會刪除資料庫中的附件資料表。因此在重新安裝新版本之后,只需導入附件資料表即可恢復所有以前的附件。

如果您不需要恢復附件資料庫,請別忘記刪除附件目錄中以前上傳的附件檔案,以免后面發生檔名沖突。

【回到頁頂】

致謝

對以下資料及人員表示衷心感謝: 【回到頁頂】
 
如果您發現了 bug 或者有什么寶貴意見,請發郵件到 jmcameron@jmcameron.net.