Rozszerzenie: MultimediaViewer
MultimediaViewer Status wydania: stabilne |
|
---|---|
![]() |
|
Realizacja | Interfejs użytkownika, Ajax |
Opis | Dostarcza lepszych doświadczeń dla użytkowników, klikających na obramowane obrazki na stronie |
Autor(zy) | |
MediaWiki | 1.25+ |
PHP | 5.4+ |
Licencja | GNU General Public License 2.0 or later |
Pobieranie | |
Przykład | MediaWiki.org |
|
|
Przetłumacz rozszerzenie MultimediaViewer jeżeli jest dostępne na translatewiki.net | |
Problemy | Otwarte zadania · Zgłoś błąd |
Rozszerzenie MultimediaViewer daje użytkownikowi wiki ładniejszy interfejs, możliwość zobaczenia obrazów w pełym lub w prawie pełnym rozmiarze, plików w przeglądarce bez dodatkowego ładowania strony.
Instalacja
Option A: use Vagrant. See the MediaWiki-Vagrant page for instructions to get a MediaWiki installation going with a Vagrant virtual machine system.
Then do vagrant enable-role multimediaviewer
and then vagrant provision
.
Option B: install manually.
First, consider installing Rozszerzenie:BetaFeatures . It may be helpful to hide the media viewer feature behind a preference. If you don't install this, it will be enabled everywhere. MultimediaViewer uses the GetBetaFeaturePreferences hook, which is created and run from BetaFeatures, to register this preference.
You'll also likely want to download Extension:CommonsMetadata - it's not a hard requirement, but without it you won't get very much information in your lightboxes.
- Pobierz i umieść plik(i) w katalogu o nazwie
MultimediaViewer
w swoim kataloguextensions/
. - Dodaj poniższy kod na dole swojego pliku LocalSettings.php:
wfLoadExtension( 'MultimediaViewer' );
- Zrobione – Przejdź do Special:Version na swojej wiki, aby sprawdzić czy rozszerzenie zostało pomyślnie zainstalowane.
Do użytkowników mających wersję MediaWiki 1.26 lub wcześniejszą:
Powyższe instrukcje opisują nowy sposób instalowania tego rozszerzenia, poprzez wfLoadExtension()
.
Jeżeli chcesz zainstalować to rozszerzenie we wcześniejszych wersjach (MediaWiki 1.26 i wcześniejsze), zamiast wfLoadExtension( 'MultimediaViewer' );
użyj:
require_once "$IP/extensions/MultimediaViewer/MultimediaViewer.php";
Konfiguracja
$wgMediaViewerIsInBeta
will register a preference with BetaFeatures if set to "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.
Using the extension
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.
Rozszerzenie za pomocą skryptów użytkownika
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.
See /Extension:Metadata for an example.
Szablony
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.
Zobacz też
- Similar extension(s):
To rozszerzenie jest wykorzystywane przez jeden lub więcej projektów Wikimedia. Oznacza to prawdopodobnie, że to rozszerzenie jest stabilne i działa wystarczająco dobrze, aby wykorzystywać je na stronach o dużym natężeniu ruchu. Odnajdź nazwę tego rozszerzenia w plikach konfiguracyjnych Wikimedia CommonSettings.php oraz InitialiseSettings.php, aby zobaczyć gdzie są zainstalowane. Pełną listę rozszerzeń zainstalowanych na określonej wiki można znaleźć na stronie Special:Version na danej wiki. |