Розширення:Медіапереглядач

This extension comes with MediaWiki 1.31 and above. Thus you do not have to download it again. However, you still need to follow the other instructions provided.

shortcut: MV

Довідка про розширення MediaWiki

MultimediaViewer Статус релізу: стабільний
Реалізація	User interface, Ajax
Опис	Надає кращий досвід користувачам, коли вони натискають на мініатюри на сторінці
Автор(и)	Mark Holmquist Gergő Tisza Gilles Dubuc
MediaWiki	1.25+
PHP	5.4+
Зміни в БД	No
Ліцензія	GNU General Public License 2.0 or later
Завантажити	Download extension Git [?]: Download Git master browse repository (GitHub) commit history code review
Приклад	MediaWiki.org
Простір назв main
Параметри $wgEnableMediaViewerForLoggedInUsersOnly $wgMediaViewerIsInBeta
Використані hook'и GetBetaFeaturePreferences BeforePageDisplay CategoryPageView ResourceLoaderGetConfigVars
Translate the MultimediaViewer extension if it is available at translatewiki.net
Переглянути використання
Issues	Open tasks · Report a bug

Розширення Медіапереглядач дає користувачеві Вікіпедії інший інтерфейс для перегляду повнорозмірних, або майже повнорозмірних, зображень у їхньому браузері без завантажень додаткових сторінок або бентежних проміжних сторінок.

Встановлення

Варіант А: використання Vagrant. Див. сторінку MediaWiki-Vagrant для інструкцій з отримання перебігу встановлення MediaWiki з системою віртуальних машин Vagrant.

Потім виконайте vagrant enable-role multimediaviewer, а потім vagrant provision.

Варіант Б: встановлення вручну.

Спочатку розглянемо встановлення Extension:BetaFeatures. Це може бути корисним, аби сховати можливість Медіапереглядача за налаштуванням. Якщо ви не встановили це, він буде увімкнений усюди. Медіапереглядач використовує хук GetBetaFeaturePreferences, який створюється та запускається з BetaFeatures, для реєстрації цього налаштування.

Ви також, імовірно, захочете завантажити Extension:CommonsMetadata — це не жорстка вимога, але без нього ви не отримаєте дуже багато інформації у своїх лайтбоксах.

• Download and place the file(s) in a directory called MultimediaViewer in your extensions/ folder.

• Add the following code at the bottom of your LocalSettings.php:

  wfLoadExtension( 'MultimediaViewer' );
  

•  Готово – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

To users running MediaWiki 1.26 or earlier:

The instructions above describe the new way of installing this extension using wfLoadExtension(). If you need to install this extension on these earlier versions (MediaWiki 1.26 and earlier), instead of wfLoadExtension( 'MultimediaViewer' );, you need to use:

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

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

• $wgMediaViewerIsInBeta зареєструє налаштування з BetaFeatures, якщо встановлено в «істина»
• $wgMediaViewerEnableByDefault і $wgMediaViewerEnableByDefaultForAnonymous визначать, чи увімкнений Медіапереглядач за замовчуванням для кожного та для анонімних користувачів відповідно. Вони обидва за замовчуванням істинні. $wgDefaultUserOptions['multimediaviewer-enable'] = 1; може використовуватися як заміна $wgMediaViewerEnableByDefault.
• $wgMediaViewerUseThumbnailGuessing поліпшить продуктивність, коли увімкнене, але можлива крихка залежність від того, як Вікіпедія налаштована (ймовірно, працюватиме добре, якщо ви використовуєте обробник 404).

Примусове завантаження

Для гарантування того, що файли пропонуються для завантаження, а не переглядаються у браузері користувача, після натискання кнопки «Завантажити…», сервер має бути налаштований, за винятком використання Vagrant:

Якщо запитуваний URL до директорії з зображенням містить параметр запиту download, заголовок Content-Disposition повинен встановлюватися в attachment. Це може досягатися в Apache та сумісних серверахвикористанням mod_rewrite і mod_headers у файлі .htaccess. Конфігурація Varnish може виглядати як така.

Використання розширення

Насамперед, перед тестуванням, потрібно переконатися, що ви увійшли та маєте увімкнене налаштування: увійдіть до Вікіпедії та перейдіть до Спеціальна:Налаштування, потім відвідайте вкладку «Бета-функції» і позначте відповідний прапорець.

Далі, перейдіть на сторінку, що має мініатюру. Спробуйте натиснути на зображенні чи на піктограмі «розширити» поряд із ним. Повинен сплинути лайтбокс і дати вам збільшений вигляд зображення.

Якщо ви хочете, існує експортоване тестове середовище, яке ви можете використовувати через Спеціальна:Імпорт для швидкого встановлення придатного тестувального середовища.

Розширення скриптами користувача

Якщо ви хочете додати функціональність, вам доведеться копатися у класах і змінювати функціональність у ручному режимі. Ми працюватимемо над поліпшенням досвіду, але дана ієрархія класів і методів ми побудували, вважаючи, що наразі вона не жахливо складна.

ПРОТЕ, ви повинні уникати робити так забагато. Якщо щось зміниться внутрішньо, то ваш код може зламатися неочікуваним способом, і ви (та ваші користувачі) будуть здивовані. НЕ дайте цьому статися й очікуйте стабільнішого способу розширити продукт.

Див. /Extension:Metadata для прикладу.

Шаблони

Медіапереглядач і Майстер завантажень потребують кількох шаблонів для показу даних фотографій. Просто збережіть цей код у файл XML й імпортуйте його у свою Вікіпедію.

Див. також

• Help:Extension:Media Viewer
• Multimedia
• Multimedia/Media Viewer

Схожі розширення

• Extension:FancyBoxThumbs
• Extension:SlimboxThumbs