Manual:Extensions/hu

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

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. Use extensions at your own risk, particularly those tagged as insecure. If an extension requires patches to the core software, make sure to back up your database beforehand to minimize the risk of breaking your wiki.

Selecting extensions

Bundled extensions

Several extensions are bundled with MediaWiki as standard.

These extensions should generally be of high utility, perform efficiently, be stable, be well-written, and have no known major security issues. They should also be compatible with the latest versions of MediaWiki, and with each other (i.e. one extension shouldn't block the functions of another). A bundled extension may have a dependency on one or more other extensions, as long as those are also bundled.

Site admins get these automatically when installing or upgrading MediaWiki. When upgrading MediaWiki, any extension upgrades will be automatically applied as well. Site admins may choose to uninstall any of these, if they wish.

There are open, ongoing discussions about which extensions should be part of this group. You can suggest additional extensions to be bundled. Extensions will be bundled once the developers reach a consensus to do so.

An extension may be removed from bundling if its functionality is merged into MediaWiki core, it is replaced by an alternative, or in the unlikely event of any unsolvable major security vulnerabilities being discovered.

Kiterjesztések böngészése

A már megírt kiterjesztések teljes listáját a $cat kategóriában láthatod.

Telepített kiterjesztések ellenőrzése

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). 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.

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 alternative 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/extensionsNé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ó.

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/


Lásd még

Category:Customization techniques/hu#Extensions/hu Category:Extension creation/hu
Category:Customization techniques/hu Category:Extension creation/hu