Podręcznik:Rozszerzenia
Rozszerzenia pozwalają dostosować działanie i wygląd MediaWiki.
- Właściciele wiki mogą przeglądać stworzone rozszerzenia.
- Administratorzy mogą zainstalować (lub usunąć) rozszerzenia w instalacjach MediaWiki, którymi zarządzają.
- Deweloperzy mogą pisać nowe rozszerzenia lub rozwijać istniejące.
Podczas gdy niektóre rozszerzenia są utrzymywane przez twórców MediaWiki, inne zostały napisane przez osoby trzecie. Z tego powodu, wiele z nich zawiera błędy i nie można zagwarantować ich kompatybilności z innymi. Niektóre z nich nie są rozwijane; nie wszystkie działają na wszystkich wersjach MediaWiki. Używasz rozszerzeń, szczególnie oznaczonych jako niebezpieczne, na własne ryzyko. If you are using an extension that requires patches to the core software, be sure to back up your database. This helps avoid the risk of breaking your wiki.
Rodzaje rozszerzeń
Parser tags
Parser functions
Hooks
Strony specjalne
Magiczne słowa
API
Page content models
Przeglądanie rozszerzeń
Możesz przejrzeć Kategoria:Rozszerzenia według kategorii , aby zobaczyć wszystkie możliwe rozszerzenia, które zostały napisane. Po więcej informacji na temat instalacji tych rozszerzeń lub pisania własnego, zobacz poniżej.
Sprawdzanie zainstalowanych rozszerzeń
Tylko osoby z administracyjnym dostępem do plików (często też do bazy danych) na serwerze mogą instalować rozszerzenia dla MediaWiki, ale każdy może sprawdzić jakie rozszerzenia są aktywne na danej instalacji MediaWiki, poprzez wywołanie strony Special:Version. Na przykład, te rozszerzenia są dostępne na Polskiej Wikipedii.
Popularne rozszerzenia
There are a number of ways of finding popular extensions.
The first set is those that are bundled with MediaWiki (a list that is reviewed regularly, and to which anyone can suggested an addition).
Extensions that are downloaded from MediaWiki.org via the ExtensionDistributor mechanism have some statistics gathered. The top 15 most downloaded extensions are listed at Special:ExtensionDistributor, and applicable extensions have their download count shown in their infobox. Note that these numbers do not account for alternate ways of installing extensions, such as via Git or Composer.
A third option is to look at WikiApiary 's counts of wikis that extensions are installed on. This has the advantage of representing actual installations and not just downloads (i.e. it queries the wiki's APIs), but it is also (as of 2023) not completely up to date. It also doesn't count installations on private wikis.
Instalowanie rozszerzeń
MediaWiki jest gotowy do instalowania rozszerzeń już po instalacji. Aby dodać rozszerzenie, przejdź poniższe kroki:
- Zanim zaczniesz
- Wiele rozszerzeń zawiera instrukcje przeznaczone dla instalacji z wykorzystaniem komend unix-a. Musisz więc posiadać dostęp shell (SSH), aby wprowadzić wymienione na stronach pomocy rozszerzenia komendy.
- Pobierz rozszerzenie.
- Extension Distributor pomaga wybrać i pobrać większość najbardziej popularnych rozszerzeń.
- Rozszerzenia są zazwyczaj rozprowadzane w modułowych pakietach. Zazwyczaj wgrywa się je do ich własnego podkatalogu w
$IP /extensions/
. Lista rozszerzeń przechowywanych przez Wikimedia w repozytorium Git jest zlokalizowana w git:mediawiki/extensions. Some extensions don't use version control and are not recommended. - Nieoficjalne zestawy rozszerzeń w repozytorium Wikimedia SVN można znaleźć na toolserwerze.
- It's recommended to read the README file before installation. It usually contains important info about configuration.
- 'Zainstaluj rozszerzenie'..
- Na końcu pliku
LocalSettings.php
dodaj: wfLoadExtension( 'ExtensionName' );
- Ta linia wskazuje interpreterowi PHP aby odczytał plik tego rozszerzenia, oraz w ten sposób uczunił je dostępnym dla MediaWiki.
- Niektóre rozszerzenia mogą być w konflikcie ze skryptami konserwacyjnymi, na przykład, gdy bezpośrednio uzyskują dostęp do zmiennej $_SERVER (nie zalecane).
- W tym przypadku mogą zostać otoczone warunkiem, więc te skrypty mogą być nadal uruchamiane.
if ( !$wgCommandLineMode ) { wfLoadExtension ( 'ExtensionName' ); }
- Skrypt konserwacyjny importDump.php może nie zadziałać jeżeli zainstalowano rozszerzenie, które wymaga dodatkowej przestrzeni nazw, która jest zarejestrowana wewnątrz warunku opisanego powyżej, np. Extension:Semantic MediaWiki , Rozszerzenie:Page Forms .
- Na końcu pliku
- Upewnij się, że zostały ustawione wymagane przez rozszerzenie uprawnienia!
- Mimo, że te procedury instalacyjne są wystarczające dla większości rozszerzeń, niektóre z nich wymagają innych procedur instalacyjnych. Zobacz dokumentację tego rozszerzenia aby zobaczyć szczegóły.
- Jeżeli chcesz zmienić zmienne konfiguracyjne w LocalSettings.php, zazwyczaj musisz to zrobić po dołączeniu tego rozszerzenia. W innym przypadku, wartości domyślne zdefiniowane w tym rozszerzeniu nadpisza twoje ustawienia.
Aktualizowanie rozszerzeń
Niektóre rozszerzenia wymagają aktualizacji zawsze, kiedy aktualizujesz MediaWiki, podczas gdy inne działają z wieloma wersjami. Aby zaktualizować do nowej wersji rozszerzenia:
- Pobierz nową wersję rozszerzenia
- Podmień wszystkie pliki w katalogu
extension/NazwaRozszerzenia
na nowe pliki.
Nie usuwaj ustawień rozszerzenia z pliku LocalSettings.php
- Jeżeli rozszerzenie wymaga zmian w bazie danych MediaWiki, będziesz musiał uruchomić skrypt update.php . Wiele rozszerzeń wspomina o tym, czy uruchomić ten skrypt czy nie. (Wykonaj kopię zapasową danych przed uruchomieniem tego skryptu). Jeżeli nie posiadasz dostępu do linii poleceń, możesz użyć web updatera.
Deinstalacja rozszerzeń
Remove the line from LocalSettings.php with the extension name to uninstall it:
wfLoadExtension( 'ExtensionName' );
- You must remove any lines pertaining to the configuration of the extension.
Zobacz też
- Kategoria:Rozszerzenia
- Szablon:Rozszerzenie
- Podręcznik:Tworzenie rozszerzeń
- Podręcznik:Tłumaczenie rozszerzeń - Informacje o tłumaczeniu rozszerzeń.
- Special:ExtensionDistributor - Includes a list of the 15 most downloaded extensions in Wikimedia version control