Jump to content

Расширение:SimpleBatchUpload

From mediawiki.org
This page is a translated version of the page Extension:SimpleBatchUpload and the translation is 98% 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
Последняя версия 3.0.0 (2025-08-15)
MediaWiki 1.43+
PHP 8.1+
Изменения в БД Нет
Composer mediawiki/simple-batch-upload

  • $wgSimpleBatchUploadMaxFilesPerBatch
Licence GNU General Public License 2.0 or later
Скачать Latest stable
README
release-notes
Переведите расширение SimpleBatchUpload

Расширение SimpleBatchUpload позволяет загружать несколько файлов на MediaWiki без ограничений на странице "Special:BatchUpload" с использованием JavaScript-библиотеки jQuery File Upload.

Загрузка

Рекомендуемый способ загрузки этого расширения — использовать Composer .

Добавьте следующее к файлу composer.local.json в MediaWiki и запустите php composer.phar update mediawiki/simple-batch-upload из каталога установки MediaWiki.

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

Чтобы обновить расширение, запустите php composer.phar update mediawiki/simple-batch-upload снова.

В качестве альтернативы вы можете загрузить файл tarball или zip из GitHub и добавить его в каталог extensions MediaWiki.

Установка

Добавьте следующую строку в файле "LocalSettings.php":

wfLoadExtension( 'SimpleBatchUpload' );

Чтобы убедиться, что SimpleBatchUpload установлено правильно, проверьте, появилось ли оно на странице Special:Version и работает ли страница Special:BatchUpload.

Чтобы использовать расширение, пользователю необходимо разрешение writeapi . Это стандартная настройка MediaWiki для зарегистрированных пользователей, но она может быть изменена во время конфигурации вики.

Использование

Есть много способов загрузки файлов с помощью этого расширения:

  • Перейти на Special:BatchUpload для получения простой страницы загрузки
  • Перейти к Special:BatchUpload/Foo для получения страницы загрузки, которая устанавливает {{Foo}} как викитекст страницы загруженного файла
  • Добавить {{#batchupload:}} на любую страницу в вики, чтобы получить простую кнопку загрузки
  • Добавить {{#batchupload:Foo|Bar|Baz}} на любую страницу в вики, чтобы получить кнопку загрузки, которая устанавливает {{Foo|Bar|Baz}} как викитекст страницы загруженного файла
  • Add {{#batchupload:Foo|+rename=!^(Qux-[./+]*)?!iu -->Qux-}} to get an upload page that sets {{Foo}} as the wikitext of the uploaded file's page and whose filenames are all given the prefix "Qux-".
Викитекст будет установлен только для недавно загруженных файлов. Если файл уже существует, последующие загрузки новых версий файла не изменят викитекст.

Кастомизация

Можно указать специальные страницы загрузки для конкретных типов файлов, редактируя страницу MediaWiki:Simplebatchupload-parameters. Каждая строка этой страницы рассматривается как один набор параметров.

Доступные параметры:

  • Название шаблона, которое будет сохранено как текст при начальной загрузке
  • Комментарий к загрузке
  • Заголовок страницы Special:BatchUpload/subpage

Параметры должны быть разделены вертикальными полосками (|).

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.

Пробелы в названии вашего шаблона приведут к ошибке этого процесса.

Пример:

Рассмотрим строку параметров

 Pics | These pics were uploaded using [[Extension:SimpleBatchUpload{{!}}SimpleBatchUpload]] | Upload some pics!
  • Это может быть найдено на странице Special:BatchUpload/Pics.
  • Название этой страницы будет "Upload some pics!".
  • Комментарий к загрузке будет "These pics were uploaded using SimpleBatchUpload".
  • Если файл с этим именем загружается впервые, он будет иметь {{Pics}} в виде викитекста.

Конфигурация

$wgSimpleBatchUploadMaxFilesPerBatch

Массив, определяющий максимальное количество файлов, которые могут быть загружены каждый раз в зависимости от группы пользователя. Когда пользователь пытается загрузить слишком большие партии файлов, отображается сообщение об ошибке.

По умолчанию:

$wgSimpleBatchUploadMaxFilesPerBatch = [
	'*' => 1000,
];
Обратите внимание, что это не является правильной настройкой для блокирования загрузки файлов или для их ограничения!

Пользователи могут использовать обычную загрузку файлов или API MediaWiki.

Для выборочного блокирования загрузок см. Руководство:Настройка загрузки файлов . Для загрузки с ограничением см. $wgRateLimits .

См. также