扩展:简单批量上传

This page is a translated version of the page Extension:SimpleBatchUpload and the translation is 100% complete.

PW
The Professional Wiki team maintains this extension professionally.
Professional Wiki provides official support for MediaWiki LTS releases only. It may work with other MediaWiki releases.
MediaWiki扩展手册
SimpleBatchUpload
发行状态: 稳定版
实现 特殊页面 , 解析器函数
描述 允许简单、基本地上传多个文件
作者 Stephan Gambke (F.trott留言)
维护者 Professional Wiki
最新版本 2.0.1 (2023-12-07)
兼容性政策 对于每个有长期支持的MediaWiki发行版本,扩展内都有对应的分支。
MediaWiki 1.35+
PHP 8.0+
数据库更改
Composer mediawiki/simple-batch-upload
许可协议 GNU通用公眾授權條款2.0或更新版本
下載 Latest stable
README
release-notes

  • $wgSimpleBatchUploadMaxFilesPerBatch
翻译SimpleBatchUpload扩展

SimpleBatchUpload扩展允许基本的、不加修饰的多个文件上传到MediaWiki的“Special:BatchUpload”,使用jQuery File Upload的JavaScript库。

下載

下载此扩展的推荐方式是使用Composer

将以下代码添加到MediaWiki的composer.local.json文件中,然后从MediaWiki安装目录运行php composer.phar update mediawiki/simple-batch-upload

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

要更新扩展,只需再次运行php composer.phar update mediawiki/simple-batch-upload

或者,您可以从GitHub下载tar或zip文件,并将其解压缩到MediaWiki安装的extensions目录中。

安装

将以下行添加到“LocalSettings.php”文件中:

wfLoadExtension( 'SimpleBatchUpload' );

To make sure that SimpleBatchUpload has been installed correctly, check that an entry for it exists at Special:Version and that Special:BatchUpload is working.

Note: To use the extension the user needs the writeapi right. This is the default MediaWiki setting for registered users, but it may have been changed during the configuration of the wiki.


用法

There are four ways to upload files using this extension:

  • Go to Special:BatchUpload to get a plain upload page
  • Go to Special:BatchUpload/Foo to get an upload page that sets {{Foo}} as the wikitext of the uploaded file's page
  • Add {{#batchupload:}} to any wikipage to get a simple upload button
  • Add {{#batchupload:Foo|Bar|Baz}} to any wikipage to get an upload button that sets {{Foo|Bar|Baz}} as the wikitext of the uploaded file's page

Note: The wikitext will only be set for newly uploaded files. If the file exists already, subsequent uploads of new versions of the file will not change the wikitext.

自定义

It is possible to specify dedicated upload pages for specific file types by editing the "MediaWiki:Simplebatchupload-parameters" page. Each line of that page is considered as one set of parameters.

Available parameters are:

  • Name of template to be stored as text on initial upload
  • Upload comment
  • Title line of the Special:BatchUpload/subpage page.

Parameters should be separated by pipes (|).

The line to be used is selected by appending the name of the template as the subpage to the URL of the Special:BatchUpload page.

  • Note: Spaces in the name of your template will cause this process to fail.

Example:

Consider the parameter line

 Pics | These pics were uploaded using [[mw:Extension:SimpleBatchUpload{{!}}SimpleBatchUpload]] | Upload some pics!
  • This can be selected by going to Special:BatchUpload/Pics.
  • The title of this page will be Upload some pics!.
  • The comment for the upload will be These pics were uploaded using SimpleBatchUpload.
  • If a file with that name is uploaded for the first time it will have {{Pics}} as wikitext.

配置

$wgSimpleBatchUploadMaxFilesPerBatch

Array defining the maximum number of files that can be uploaded each time depending on the user group. When a user is trying to upload larger batches of files an error message is displayed.

Default:

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

Note: Be aware that this is neither the right setting to block file uploads, nor to throttle them!

Users can still use the normal file upload or the MediaWiki API.

For selectively blocking uploads see the manual on configuring file uploads. For throttling uploads see the $wgRateLimits configuration parameter.

另见