Розширення:Медіапереглядач
MultimediaViewer Статус релізу: стабільний |
|
---|---|
![]() |
|
Реалізація | User interface, Ajax |
Опис | Надає кращий досвід користувачам, коли вони натискають на мініатюри на сторінці |
Автор(и) | |
MediaWiki | 1.25+ |
PHP | 5.4+ |
Ліцензія | GNU General Public License 2.0 or later |
Завантажити | |
Приклад | MediaWiki.org |
|
|
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 — це не жорстка вимога, але без нього ви не отримаєте дуже багато інформації у своїх лайтбоксах.
- Завантажте і розмістіть файли в каталозі з назвою
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
зареєструє налаштування з 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 й імпортуйте його у свою Вікіпедію.
Див. також
- Схожі розширення
Це розширення використовується в одному або декількох проектах Вікімедіа. Це, мабуть, означає, що розширення стабільне і працює досить добре, щоб його могли використовувати веб-сайти з великим трафіком. Шукайте назву цього розширення у файлах конфігурації Wikimedia CommonSettings.php та InitialiseSettings.php, щоб побачити, де це встановлене. Повний перелік розширень, встановлених на певній вікі, можна переглянути на сторінці Special:Version вікі. |