Расширение:Медиа-просмотрщик

This page is a translated version of the page Extension:MultimediaViewer and the translation is 32% complete.

Outdated translations are marked like this.

Other languages:

Deutsch • ‎Deutsch (Sie-Form)‎ • ‎English • ‎Nederlands • ‎dansk • ‎español • ‎français • ‎italiano • ‎polski • ‎português do Brasil • ‎sicilianu • ‎русский • ‎українська • ‎اردو • ‎فارسی • ‎中文 • ‎日本語 • ‎한국어

Это расширение поставляется с MediaWiki 1.31 и выше. Таким образом, вам не нужно загружать его снова. Тем не менее, вы всё равно должны следовать другим инструкциям.

shortcut: MV

**Справка по расширениям MediaWiki**
MultimediaViewer Статус релиза: стабильный

Реализация	Пользовательский интерфейс, Ajax
Описание	Предоставляет более удобное отображение изображений при нажатии на их миниатюры в статьях
Автор(ы)	Mark Holmquist Gergő Tisza Gilles Dubuc
MediaWiki	1.25+
PHP	5.4+
Лицензия	GNU General Public License 2.0 or later
Загрузка	Download extension Git ^[?]: Загрузить Git master browse repository (GitHub) commit history repository contributors (GitHub) code review
Пример	MediaWiki.org
Параметры $wgMediaViewerDurationLoggingLoggedinSamplingFactor $wgMediaViewerAttributionLoggingSamplingFactor $wgMediaViewerDimensionLoggingSamplingFactor $wgMediaViewerImageQueryParameter $wgMediaViewerActionLoggingSamplingFactorMap $wgMediaViewerUseThumbnailGuessing $wgMediaViewerNetworkPerformanceSamplingFactor $wgMediaViewerRecordVirtualViewBeaconURI $wgMediaViewerDurationLoggingSamplingFactor $wgMediaViewerEnableByDefault $wgMediaViewerEnableByDefaultForAnonymous $wgMediaViewerExtensions
Использованные hook'и BeforePageDisplay CategoryPageView GetPreferences MakeGlobalVariablesScript ResourceLoaderGetConfigVars ThumbnailBeforeProduceHTML UserGetDefaultOptions
Переведите расширение MultimediaViewer если оно доступно на translatewiki.net
Проверьте использование и версию.
Проблемы	Открытые задачи · Сообщить об ошибке

Расширение Медиа-просмотрщик предоставляет пользователю вики более удобный интерфейс для отображения изображений в полный размер экрана без ухода со страницы статьи и без посещения запутывающих промежуточных страниц.

Установка

Option A: use Vagrant. See the MediaWiki-Vagrant page for instructions to get a MediaWiki installation going with a Vagrant virtual machine system.

Тогда напишите vagrant enable-role multimediaviewer и затем vagrant provision.

Вариант B: установка вручную.

Желательно установить расширение Бета-Функции (новые возможности): тогда Медиа-просмотрщик будет можно отключить в настройках. В противном случае он будет включен везде. Для регистрации этой настройки Медиа-просмотрщик пользуется «крюком» GetBetaFeaturePreferences, который создаётся и запускается расширением Бета-Функции.

Также желательно поставить Расширение:Метаданные со Склада — оно необязательно, но без него в Медиа-просмотрщике будет отображаться довольно мало информации об изображении.

Скачайте и распакуйте файл(ы) в папку с названием MultimediaViewer в вашей папке extensions/.

Добавьте следующие строки в конец файла LocalSettings.php:
```
wfLoadExtension( 'MultimediaViewer' );
```
Готово – Перейдите на страницу Special:Version на своей вики, чтобы удостовериться в том, что расширение успешно установлено.

Для использующих MediaWiki 1.26 или более ранние версии:

В приведенных выше инструкциях описывается новый способ установки этого расширения с использованием wfLoadExtension(). Если вам нужно установить это расширение на более ранние версии (MediaWiki 1.26 и более ранние), вместо wfLoadExtension( 'MultimediaViewer' );, вам необходимо использовать:

require_once "$IP/extensions/MultimediaViewer/MultimediaViewer.php";

Настройка

Есть две переменные, имеющие отношение к настройке Медиа-просмотрщика:

$wgMediaViewerIsInBeta — если 'true', добавляет Медиа-просмотрщик в список Бета-Функций;
$wgEnableMediaViewerForLoggedInUsersOnly — если 'true', включает Медиа-просмотрщик только для зарегистрированных пользователей.

Если ни одна из переменных не указана, Медиа-просмотрщик будет включен для всех пользователей!

$wgMediaViewerEnableByDefault and $wgMediaViewerEnableByDefaultForAnonymous will determine whether MMV is enabled by default for everyone and for anonymous users, respectively. They both default to true. $wgDefaultUserOptions['multimediaviewer-enable'] = 1; can be used as a replacement for $wgMediaViewerEnableByDefault.
$wgMediaViewerUseThumbnailGuessing will improve performance when enabled, but can be fragile depending on how the wiki is set up (it will probably work fine if you use a 404 handler).

Forced download

To ensure files are offered for download and not viewed in the user's browser following a click on the Download … button, the server has to be configured, except when using vagrant:

If the requested URL to an image directory contains the download query parameter, the Content-Disposition-header must be set to attachment. This can be achieved in Apache and compatible servers using mod_rewrite and mod_headers in a .htaccess file. Varnish configuration can look like this.

Как пользоваться расширением

First thing, before testing, is to make sure you're logged in and you have the preference enabled: Log in to the wiki and go to Special:Preferences, then visit the "Beta features" tab and check the appropriate box.

Next, go to a page that has a thumbnail on it. Try clicking on the image or on the "expand" icon near it. The lightbox should pop up and give you a bigger view of the image.

If you'd prefer, there's an exported test environment that you can use via Special:Import to quickly set up a suitable testing environment.

Extending with user scripts

If you want to add functionality, you'll have to dig around in the classes and change the functionality pretty manually. We'll work on making this a nicer experience, but given the class and method hierarchy we've built, we think it's not terribly difficult right now.

HOWEVER, you should avoid doing this too much. If things change internally, then your code might break in unexpected ways, and you (and your users) will be surprised. Don't let that happen, and wait for a more stable way to extend the product.

См. /Extension:Metadata для примера.

Templates

Multimedia Viewer and Upload Wizard needs several templates to show data of photos. Just save this code in a xml file and import it in your wiki.

Смотрите также

Similar extension(s)

Это расширение используется в одном или нескольких проектах Викимедиа. Вероятно, это означает, что расширение стабильно и работает достаточно хорошо, чтобы использоваться такими сайтами с высоким трафиком. Найдите название этого расширения в файлах конфигурации Викимедиа CommonSettings.php и InitialiseSettings.php, чтобы узнать, где оно установлено. Полный список расширений, установленных на конкретной вики, можно увидеть на странице Special:Version wiki.