Kézikönyv:Kiterjesztések
A kiterjesztésekkel testre szabhatod a MediaWiki kinézetét és működését.
- A wiki felhasználók böngészhetnek a létező kiterjesztések között.
- A rendszer-adminisztrátorok beiktathatnak (vagy eltávolíthatnak) kiterjesztéseket a MediaWikin.
- A fejlesztők írhatnak újakat vagy fejleszthetik és karbantarthatják a kiterjesztéseket.
Néhány kiterjesztést a MediaWiki fejlesztői tartanak karban, néhányat pedig harmadik fél készített. Emiatt számos kiterjesztésben találhatóak hibák, és nem biztos, hogy kompatibilisek egymással. Néhány nem áll aktív fejlesztés alatt, valamint nem minden kiterjesztés működik minden MediaWiki-verzió alatt. A kiterjesztéseket (főleg a nem biztonságosként jelölteket) saját felelősségre használhatod. 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.
Kiterjesztések típusai
Elemzőcímkék
Elemzőfüggvények
Hookok
Speciális lapok
Varázsszavak
API
Tartalommodellek
Finding extensions
Kiterjesztések böngészése
A már megírt kiterjesztések teljes listáját a Kategória:Kiterjesztések kategória alapján kategóriában láthatod. Ezek telepítéséről, illetve saját kiterjesztésed megírásáról alább találsz információt.
Telepített kiterjesztések ellenőrzése
Csak a fájlrendszerhez (és gyakran az adatbázishoz is) adminisztrátori hozzáféréssel rendelkezők telepíthetnek MediaWiki-kiterjesztéseket, de a Special:Version lapon bárki láthatja ezek listáját. Például a magyar Wikipédián ezek a kiterjesztések vannak telepítve.
Népszerű kiterjesztések
Számos módon találhatók népszerű kiterjesztések.
Az egyik csoport a MediaWikivel együtt érkezőkből áll (e lista értékelése rendszeresen történik, és bárki javasolhat hozzáadást).
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.
Egy harmadik lehetőség a WikiApiary oldalon egyes kiterjesztéseket tartalmazó wikik számainak megtekintése. Ez a tényleges telepítéseket számolja (a wikik API-jait kérdezi le), de (2023-ban) nem teljesen naprakész. Ez nem számolja a magánwikiken lévő telepítéseket se.
Kiterjesztések telepítése
- For further guidance, see also Manual:Extensions/Installation and upgrade
A kiterjesztések használatához először telepíteni szükséges azokat. Egy kiterjesztés telepítéséhez kövesd az alábbi lépéseket:
- 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.
- 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.
- 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 .
- A
- 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.
Kiterjesztések frissítése
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:
- Töltsd le az új verziót
- Írd felül az
extensions/ExtensionName
alatt szereplő régi fájlokat az újakkal. Ne töröld a kiterjesztésLocalSettings.php
-ben szereplő beállításait - 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.
Kiterjesztés eltávolítása
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ó.
Lásd még
- 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 - Includes a list of the 15 most downloaded extensions in Wikimedia version control
- extloc - Where are MediaWiki extensions deployed in Wikimedia production?
- API:SiteInfo extension information