Podręcznik:Rozszerzenia

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:Extensions and the translation is 67% complete.

Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Esperanto • ‎Tiếng Việt • ‎Türkçe • ‎dansk • ‎español • ‎français • ‎italiano • ‎magyar • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎čeština • ‎Ελληνικά • ‎български • ‎мокшень • ‎русский • ‎العربية • ‎سنڌي • ‎پښتو • ‎ไทย • ‎中文 • ‎日本語 • ‎한국어
OOjs UI icon puzzle-ltr.svg Rozszerzenia: Rozwój Rozszerzenia znaczników Podręcznik:Funkcje parsera Haki Strony specjalne Podręcznik:Skórki Podręcznik:Magiczne słowa API Content models

Rozszerzenia pozwalają dostosować działanie i wygląd MediaWiki.

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 backup your database. This helps avoid the risk of breaking your wiki.

Rodzaje rozszerzeń

OOjs UI icon markup.svg Parser tags

Parser tags extend the built-in wiki markup with additional capabilities, whether simple string processing, or full-blown information retrieval.


Learn more about parser tags

OOjs UI icon code.svg Parser functions

Parser functions are special wiki markup syntax that can 'interact' with other wiki elements in the page, and give a specific output.


Learn more about parser functions

Plug-in Noun project 4032.svg Hooks

Hooks allow custom code to be executed when some defined event (such as saving a page or a user logging in) occurs.


Learn more about hooks

OOjs UI icon pageSettings.svg Strony specjalne

Special pages are pages that are created by the software on demand to perform a specific function.


Learn more about special pages

OOjs UI icon browser-ltr.svg Motywy

Skins allow users to customize the look and feel of MediaWiki.


Learn more about skins

OOjs UI icon quotes-ltr.svg Magiczne słowa

Magic words are a technique for mapping a variety of wiki text strings to a single ID that is associated with a function.


Learn more about magic words

API - The Noun Project.svg API

MediaWiki provides an action API, a web service that allows access to some wiki-features like authentication, page operations, and search.


Learn more about the MediaWiki API

OOjs UI icon article-ltr.svg Page content models

The ContentHandler introduced in MediaWiki 1.21 makes it possible for wiki pages to be composed of data other than wikitext, such as JSON or Markdown.


Learn more about content models

OOjs UI icon lock.svg Authentication

MediaWiki provides SessionManager and AuthManager, two authentication-related frameworks to enhance security via custom authentication mechanisms.


Learn more about authentication

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.

Instalowanie rozszerzeń

MediaWiki jest gotowy do instalowania rozszerzeń już po instalacji. Aby dodać rozszerzenie, przejdź poniższe kroki:

  1. 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.
  2. 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 są dostępne jako kod źródłowy dostępny przez wiki. Możesz zautomatyzować ich kopiowanie.
    Nieoficjalne zestawy rozszerzeń w repozytorium Wikimedia SVN można znaleźć na toolserwerze.
  3. '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, Extension:Semantic Forms.
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:

  1. Pobierz nową wersję rozszerzenia
  2. Podmień wszystkie pliki w katalogu extension/NazwaRozszerzenia na nowe pliki. Nie usuwaj ustawień rozszerzenia z pliku LocalSettings.php
  3. 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.
Te instrukcje dotyczą 99% rozszerzeń. Jeżeli określone rozszerzenie posiada inne instrukcje niż powyższa, skorzystaj z instrukcji dla tego rozszerzenia

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.
  • If the extension provides any database changes, you must run update.php to remove them.

Zobacz też

Rozszerzenia : Kategoria Wszystko ProśbyTag extensions FAQ dotyczące rozszerzeń Rejestr haków rozszerzeńDomyślne przestrzenie nazw rozszerzeń