README

它是什么？

Uploads 是一个 Xaraya 工具模块。 目前它负责以下任务

允许将文件导入 Xaraya 系统中，无论是本地还是外部。
允许通过权限管理对文件的访问。
...

如何使用它？

外部导入和上传

从外部位置上传或导入的文件可以保存在数据库（DB）中或存储在文件系统（FS）中。使用每个表单下的选项（FS/DB）选择文件存储位置。

导入引擎会尽力猜测您要导入的文件名。如果它无法确定文件名，它将使用以下方法

HTTP 和 HTTPS

如果无法确定 HTTP 导入的文件名，则文件将根据导入文件的服务器主机名命名。例如，导入 http://www.xaraya.com/ 将返回一个名为 www_xaraya_com.html 的文件。
FTP

由于 FTP 协议的底层性质，无法提供有效的文件名则无法成功访问系统上的文件。在这种情况下，不会尝试进行文件名猜测，导入将失败。

本地导入沙盒

您可以将文件插入本地导入沙盒，并立即由具有添加文件和将其附加到钩子对象（文章、评论等）的足够访问权限的用户使用。您放入本地导入沙盒中的文件在添加后可以立即在“导入本地文件”表单中看到。

权限

Uploads 有以下权限级别

ViewUploads：具有对文件的读取级别访问权限
AddUploads：具有添加文件到上传系统的添加级别访问权限
EditUploads：具有编辑级别以编辑已添加到上传系统的文件
ManageUploads：具有删除级别以从上传系统中删除文件
AdminUploads：具有管理员访问权限。只有网站管理员需要此级别

一个角色需要具有 ViewUploads 权限才能查看管理员/编辑已上传和批准的文件。如果文件尚未批准但已提交，则需要 Edit 权限才能访问文件。您可以使用 autoapprove 选项自动批准某个用户上传的所有文件。

包含的块

没有包含的块。

包含的钩子

Uploads 模块确实提供了一个转换钩子。您可以通过转到模块 - 配置钩子 - Uploads 模块来激活模块或 itemtype 的上传模块钩子。从那里，检查您希望激活上传模块钩子的模块和 itemtype 旁边的单选按钮。
如果将钩子与上传属性结合使用，则可以向动态属性添加参数。使用以下选项设置选项： single;methods(-trusted,+external,+upload,+stored);basedir(/tothedir/uploads/{user});importdir(/tothedir/uploads/{user})
此选项将允许单个上传，包括外部、上传和存储的文件，但不包括受信任的文件。查找存储文件的基于目录是用户目录，并且新文件也将放置在那里。

上传模块还提供了一个显示钩子，通过访问模块 - 配置钩子 - 上传模块来获取等待内容钩子。从那里检查基本模块旁边的单选按钮。
然后请确保您的网站上有等待内容块。当一个文件处于提交状态时，它将在该块中显示。

DD上传方法

可信
“可信”目录通常指向一个包含之前上传文件的文件夹，例如管理员通过FTP上传的文件。请注意，如果配置了此选项，则在此输入方法中可以选择多个项目。
外部
顾名思义，此输入需要有效的URL，无论是HTTP还是FTP。请注意，PHP/HTTP必须配置为允许外发连接。
上传
标准的“上传”输入，允许用户从他们的电脑上传文件。目前，一次只能上传一个文件。
存储
此输入表示上传文件的库。如果选择，用户将能够从之前上传的文件中选择。请注意，如果配置了此选项，则在此输入方法中可以选择多个项目。

配置DD上传属性

大多数全局修改配置选项可以在每个属性的基础上进行覆盖，这允许管理员根据内容或用户单独存储文件，从而提供更大的灵活性。以下是对可用的选项的简要概述

多个？
勾选此选项将允许在可信或存储方法中选择多个文件。
输入方法
您可以为上传属性的这个特定实例覆盖全局配置，并使用自己的输入方法首选项。
文件类型
允许的文件类型。
基本目录
使用特定路径覆盖全局配置。
可信目录
使用特定路径覆盖全局配置。
目录名称
这是模块创建子目录时使用的目录前缀。上传模块识别几个宏，{user}和{theme}，以动态创建某些路径约定。

xaraya / uploads

维护者

详细信息