Manual:Extensions/pl
Rozszerzenia pozwalają dostosować działanie i wygląd MediaWiki.
- Administratorzy mogą zainstalować (lub usunąć) rozszerzenia w instalacjach MediaWiki, którymi zarządzają.
- Deweloperzy mogą pisać nowe rozszerzenia lub rozwijać istniejące.
Wyszukiwanie rozszerzeń
Bundled extensions
Several extensions are bundled with MediaWiki as standard.
Te rozszerzenia powinny zazwyczaj cechować się wysoką użytecznością, wydajnością, stabilnością, być dobrze napisane oraz nie mieć znanych poważnych problemów bezpieczeństwa. Powinny być również kompatybilne z najnowszymi wersjami MediaWiki oraz ze sobą nawzajem (tzn. jedno rozszerzenie nie powinno blokować funkcji drugiego). Dołączone rozszerzenie może mieć zależność od jednego lub więcej innych rozszerzeń, pod warunkiem że również są one dołączone do pakietu.
Administratorzy serwisu otrzymują je automatycznie podczas instalacji lub aktualizacji MediaWiki. Podczas aktualizacji MediaWiki aktualizacje rozszerzeń zostaną również automatycznie zastosowane. Administratorzy serwisu mogą zdecydować się na odinstalowanie dowolnego z nich, jeśli zechcą.
Trwają otwarte, bieżące dyskusje na temat tego, które rozszerzenia powinny wchodzić w skład tej grupy. Możesz zasugerować dodatkowe rozszerzenia do dołączenia do pakietu . Rozszerzenia zostaną dołączone do pakietu, gdy deweloperzy osiągną w tej sprawie konsensus.
Rozszerzenie może zostać usunięte z pakietu, jeśli jego funkcjonalność zostanie scalona z rdzeniem MediaWiki , zostanie zastąpione przez alternatywę lub w mało prawdopodobnym przypadku wykrycia poważnych, nierozwiązywalnych luk bezpieczeństwa.
Przeglądanie rozszerzeń
Możesz przejrzeć $cat, aby zobaczyć wszystkie możliwe rozszerzenia, które zostały napisane.
Sprawdzanie zainstalowanych rozszerzeń
Which extensions are active on an instance of MediaWiki can be checked by accessing the Special:Version page, and scrolling down to the heading Installed extensions (anchor #mw-version-ext
).
Na przykład, te rozszerzenia są dostępne na Polskiej Wikipedii.
Popularne rozszerzenia
Istnieje wiele sposobów na znalezienie popularnych rozszerzeń.
Rozszerzenia, które są pobrane z MediaWiki.org za pośrednictwem mechanizmu ExtensionDistributor mają zebrane niektóre statystyki. Najczęściej pobrane rozszerzenia są wymienione na Special:ExtensionDistributor, a stosowne rozszerzenia mają ich liczbę pobrań w swojej skrzynce informacyjnej. Należy pamiętać, że liczby te nie uwzględniają alternatywnych sposobów instalacji rozszerzeń, takich jak via Git lub Composer.
Trzecią opcją jest spojrzenie na liczbę wiki WikiApiary , na których są zainstalowane rozszerzenia. W tym przypadku jest to korzyść, że reprezentuje rzeczywiste instalacje, a nie tylko pobierania (tj. zadaje pytania o API wiki), ale również (od 2023 r.) nie jest całkowicie aktualny. Nie liczy też instalacji na prywatnych wiki.
Instalowanie rozszerzeń
- Aby uzyskać dalsze wskazówki, zobacz także Manual:Extensions/Installation and upgrade
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.Niektóre rozszerzenia nie używają kontroli wersji i nie są zalecane. - Nieoficjalne zestawy rozszerzeń w repozytorium Wikimedia SVN można znaleźć na toolserwerze.
- Zaleca się przeczytać plik README przed instalacją.Zazwyczaj zawiera ważne informacje o konfiguracji.
- '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
extensions/ExtensionName
na nowe pliki.Nie usuwaj ustawień rozszerzenia z plikuLocalSettings.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ń
Wyjąć linię z LocalSettings.php
z nazwą rozszerzenia, aby ją usunąć:
wfLoadExtension( 'ExtensionName' );
- Musisz usunąć wszystkie linie dotyczące konfiguracji rozszerzenia.
Developing extensions
MediaWiki core provides several ways for extensions to change the behavior and appearance of a wiki. These extension points give extensions flexibility to add features and functionality, such as displaying a special page or defining an API module. To get started, see the guide to developing extensions . Before writing a new extension, consider contributing to an existing extension or helping with an unmaintained extension .
Users can also make a general request on Phabricator, and hope that your good idea is picked up by a developer. See https://phabricator.wikimedia.org/tag/mediawiki-extension-requests/
Zobacz także
- Kategoria:Rozszerzenia
- Szablon:Rozszerzenie
- Podręcznik:Tworzenie rozszerzeń
- Podręcznik:Tłumaczenie rozszerzeń - Informacje o tłumaczeniu rozszerzeń.
- Special:ExtensionDistributor - Zawiera listę 15 najczęściej pobieranych rozszerzeń w kontroli wersji Wikimedia.
- extloc - Where are MediaWiki extensions deployed in Wikimedia production?
- API:Siteinfo#Extensions