README

SimpleBatchUpload 扩展提供了将多个文件基本无装饰地上传到MediaWiki的基本功能。

由 Professional.Wiki 维护。如有商业支持或开发工作需求，请联系我们。

需求

• PHP 8.0 或更高版本
• MediaWiki 1.35 或更高版本

安装

您需要使用 Composer 来安装此扩展。只需将以下内容添加到 MediaWiki 的 "composer.local.json" 文件中，然后在 MediaWiki 安装目录中运行 php composer.phar update mediawiki/simple-batch-upload。

{
	"require": {
		"mediawiki/simple-batch-upload": "^2.0"
	}
}

然后，将以下行添加到您的 "LocalSettings.php" 文件中

wfLoadExtension( 'SimpleBatchUpload' );

注意：要使用此扩展，用户需要拥有 writeapi 权限。这是注册用户的默认 MediaWiki 设置，但在配置维基时可能已被更改。

使用方法

使用此扩展上传文件有四种方式

• 转到 特殊:BatchUpload 获取一个简单的上传页面
• 转到 特殊:BatchUpload/Foo 获取一个设置 {{Foo}} 为上传文件页面维基文本的上传页面
• 将 {{#batchupload:}} 添加到任何维基页面，以获取一个简单的上传按钮
• 将 {{#batchupload:Foo|Bar|Baz}} 添加到任何维基页面，以获取一个设置 {{Foo|Bar|Baz}} 为上传文件页面维基文本的上传按钮

自定义

可以通过编辑 MediaWiki:Simplebatchupload-parameters 页面来指定为上传特定文件类型而预留的参数集。该页面的每一行都被视为一组参数。

可用的参数包括

• 初始上传时作为文本存储的模板名称
• 上传注释
• 特殊:BatchUpload 页面的标题行

参数应由管道（|）分隔。

要使用的行是通过将模板名称作为子页面追加到特殊:BatchUpload 页面的 URL 中来选择的。

示例

考虑以下参数行

Pics | These pics were uploaded using [[mw:Extension:SimpleBatchUpload{{!}}SimpleBatchUpload]] | Upload some pics!

• 可以通过转到 特殊:BatchUpload/Pics 来选择。
• 此页面的标题将是 上传一些图片！。
• 上传注释将是 这些图片是使用 [[mw:Extension:SimpleBatchUpload{{!}}SimpleBatchUpload]] 上传的。
• 如果首次上传具有该名称的文件，它将具有 {{Pics}} 作为维基文本。

配置

可用的配置选项

• $wgSimpleBatchUploadMaxFilesPerBatch - 根据用户组定义每次可以上传的文件最大数量的数组。
  默认值

$wgSimpleBatchUploadMaxFilesPerBatch = [
	'*' => 1000,
];

注意：请记住，这并不是完全阻止文件上传的正确设置！用户仍然可以使用常规文件上传或MediaWiki API。请参阅mediawiki.org上的用户权限段落配置文件上传。

许可证

GNU通用公共许可证2.0版或更高版本