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

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

→ Tudjon meg többet az elemzőcímkékről

Elemzőfüggvények

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

→ Tudjon meg többet az elemzőfüggvényekről

Hookok

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

→ Tudjon meg többet a hookokról

Speciális lapok

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

→ Tudjon meg többet a speciális lapokról

Felületek

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

→ Tudjon meg többet a felületekről

Varázsszavak

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

→ Tudjon meg többet a varázsszavakról

API

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

→ Tudjon meg többet a MediaWiki API-ról

Tartalommodellek

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.

→ Tudjon meg többet a tartalommodellekről

Hitelesítés

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

→ Tudjon meg többet a hitelesítésről

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:

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.

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:

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.

Ezek az instrukciók a kiterjesztések 99%-ánál érvényesek. Ha az általad használni kívánt kiterjesztés más útmutatóval érkezik, akkor érdemesebb az abban szereplő információkra hagyatkozni.

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