Kézikönyv:Kiterjesztések

A kiterjesztésekkel testre szabhatod a MediaWiki kinézetét és működését.

• A rendszer-adminisztrátorok beiktathatnak (vagy eltávolíthatnak) kiterjesztéseket a MediaWikin.
• A fejlesztők új kiterjesztéseket írhatnak, vagy közreműködhetnek a meglévő kiterjesztések fejlesztésében.

A MediaWiki alapértelmezetten több kiterjesztést is tartalmaz .

Ezeknek a kiterjesztéseknek általában széles körben hasznosnak, hatékonyan működőnek, stabilnak és jól megírtnak kell lenniük, továbbá nem lehet ismert súlyos biztonsági problémájuk. Emellett kompatibilisnek kell lenniük a MediaWiki legújabb verzióival és egymással is (vagyis egyik kiterjesztés sem akadályozhatja egy másik működését). A MediaWikihez mellékelt kiterjesztés függhet egy vagy több másik kiterjesztéstől, feltéve, hogy azok szintén a MediaWikihez vannak mellékelve.

A webhely-adminisztrátorok ezeket automatikusan megkapják a MediaWiki telepítésekor vagy frissítésekor. A MediaWiki frissítésekor a kiterjesztések frissítései is automatikusan települnek. A webhely-adminisztrátorok igény szerint bármelyiket eltávolíthatják.

Jelenleg is nyílt egyeztetések folynak arról, hogy mely kiterjesztések tartozzanak ebbe a csoportba. Javasolhatod további kiterjesztések mellékelését . A kiterjesztéseket akkor mellékelik a MediaWikihez, ha a fejlesztők ebben konszenzusra jutnak.

Egy kiterjesztés kikerülhet a MediaWikihez mellékelt kiterjesztések közül, ha a funkcióit beépítik a MediaWiki alaprendszerébe , egy másik megoldás váltja fel, vagy – bár ez nem valószínű – olyan súlyos biztonsági sebezhetőséget fedeznek fel benne, amely nem javítható.

Böngészd a Kategória:Minden kiterjesztés vagy a Kategória:Kiterjesztések kategória alapján lapot az elérhető kiterjesztések teljes kínálatának megtekintéséhez.

Azt, hogy egy MediaWiki-példányon mely kiterjesztések aktívak, a Special:Version lap megnyitásával, majd a Telepített kiterjesztések szakaszhoz (horgony: #mw-version-ext) görgetve ellenőrizheted. Például ezek a kiterjesztések vannak telepítve ezen a wikin, az angol Wikipédián pedig ezek a kiterjesztések aktívak.

A WikiApiary azt számolja, hogy az egyes kiterjesztések hány wikin vannak telepítve. Ez a tényleges telepítéseket mutatja, nem csupán a letöltéseket (vagyis lekérdezi a wikik API-jait), ugyanakkor – 2023-as állapot szerint – nem teljesen naprakész. A magánwikiken végzett telepítéseket sem veszi számításba.

További útmutatásért lásd még: Manual:Extensions/Installation and upgrade

A MediaWiki a telepítés befejezése után azonnal készen áll a kiterjesztések fogadására. Kiterjesztés hozzáadásához kövesd az alábbi lépéseket:

1. Mielőtt elkezdenéd

   Számos kiterjesztés útmutatója tartalmaz unix parancsokat. A segítséglapokon szereplő parancsok futtatásához shell-hozzáféréssel (SSH) kell rendelkezned.

2. Töltsd le a kiterjesztést.

   Az Extension Distributor segít a népszerűbb kiterjesztések kiválasztásában és letöltésében.

   A kiterjesztéseket általában moduláris csomagok formájában terjesztik. Legtöbbjük saját alkönyvtárral rendelkezik az $IP /extensions/ alatt. A Wikimédia Git tárhelyén található kiterjesztések listáját a következő címen találod: git:mediawiki/extensions Néhány kiterjesztés nem használ verziókövetést és nem ajánlott használatuk.

   Néhányuk elérhető összeállításokban, Composer segítségével vagy tárhelyeken keresztül is.

   Ajánlott a README fájl elolvasása telepítés előtt. Általában fontos információt tartalmaz a konfigurációról.

3. Telepítsd a kiterjesztést.

   A LocalSettings.php aljához hozzá:

   wfLoadExtension( 'ExtensionName' );
   

   Ez a sor kényszeríti a PHP-értelmezőt arra, hogy olvassa be a kiterjesztés fájlját, azaz tegye elérhetővé azt a MediaWiki számára.

   Néhány kiterjesztés összeakadhat a karbantartószkriptekkel, például ha közvetlenül próbálják elérni a $_SERVER-t (nem ajánlott). Ebben az esetben a feltételek módosításával biztosítható a karbantartószkriptek további működése.

   if ( !$wgCommandLineMode ) {
    wfLoadExtension ( 'ExtensionName' );
   }
   

   Az importDump.php karbantartószkript nem tud lefutni, ha bármely kiterjesztés olyan egyedi névteret igényel, amely a feltétel része, példul Kiterjesztés:Semantic MediaWiki vagy Extension:Page Forms .

Győződj meg róla, hogy a szükséges engedélyeket beállítottad!

Habár ez a telepítési útmutató a legtöbb kiterjesztésnél használható, némelyeket eltérő úton kell telepíteni. A részletekért olvasd el a kiterjesztés leírását.

Ha módosítani szeretnéd a LocalSettings.php-ban szereplő változókat, ezt általában a telepítés után teheted meg. Ellenben a kiterjesztésben meghatározott alapértelmezések felülírják a beállításaidat.

Néhány kiterjesztést a MediaWikivel együtt frissíteni kell, néhányuk pedig több verzióval is működik. A kiterjesztések új verziójára frissítéshez:

1. Töltsd le az új verziót
2. Írd felül az extensions/ExtensionName alatt szereplő régi fájlokat az újakkal. Ne töröld a kiterjesztés LocalSettings.php-ben szereplő beállításait
3. A kiterjesztéstől függően lehet, hogy futtatnod kell az update.php karbantartószkriptet. A kiterjesztések többségénél szerepel, ha igénylik a szkript futtatását. (A futtatás előtt készíts biztonsági mentést). Ha nincsen parancssori hozzáférésed, a webes frissítést is választhatod.

Távolítsd el a kiterjesztésnevet tartalmazó sort a LocalSettings.php-ből az eltávolításhoz:

wfLoadExtension( 'ExtensionName' );

• Minden, a konfigurációhoz kapcsolódó sor eltávolítandó.

A MediaWiki alaprendszere többféle lehetőséget biztosít a kiterjesztések számára a wiki működésének és megjelenésének módosítására. A különféle kiterjesztési pontok rugalmasságot biztosítanak a kiterjesztéseknek új képességek és funkciók hozzáadásához, például egy speciális lap megjelenítéséhez vagy egy API-modul meghatározásához. Első lépésként lásd a kiterjesztések fejlesztéséről szóló útmutatót . Új kiterjesztés írása előtt fontold meg, hogy közreműködsz-e egy meglévő kiterjesztés fejlesztésében, vagy segítesz-e egy karban nem tartott kiterjesztés továbbfejlesztésében.

A felhasználók általános kérést is benyújthatnak a Phabricatoron, abban bízva, hogy egy fejlesztő felkarolja a jó ötletüket. Lásd: https://phabricator.wikimedia.org/tag/mediawiki-extension-requests/

• Kategória:Kiterjesztések
• Sablon:Kiterjesztés
• Kézikönyv:Bővítmények fejlesztése
• Manual:Translating extensions – Információ a kiterjesztések fordításával kapcsolatban.
• Special:ExtensionDistributor – Tartalmazza a Wikimedia verziókövető rendszerében található 15 legtöbbet letöltött kiterjesztés listáját.
• extloc – Hol vannak telepítve a MediaWiki-kiterjesztések a Wikimedia éles környezetében?
• API:Siteinfo#Extensions
• Manual:Extending wiki markup
• Kézikönyv:Hookok
• Kézikönyv:Varázsszavak
• Kézikönyv:Felületek

• Customization techniques/hu
• Extension creation/hu