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.