Kézikönyv:Kiterjesztések

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

Outdated translations are marked like this.
Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Esperanto • ‎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 Kiterjesztések: Fejlesztés Címkék Parser functions Hooks Speciális lapok Kézikönyv:Felületek Kézikönyv:Varázsszavak API Content models

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

Kiterjesztések típusai

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 Special pages

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 Skins

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


Learn more about skins

OOjs UI icon quotes-ltr.svg Magic words

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

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.

Kiterjesztések telepítése

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.
  3. Telepítsd a kiterjesztést..
    A LocalSettings.php aljához a következő sort kell beillesztened:
    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:Semantic 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 extension/ExtensionName alatt szereplő régi fájlokat az újakkal. Ne töröld a kiterjesztés LocalSettings.php-ben szereplő beállításait
  1. 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

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.

Lásd még

Kiterjesztések : Kategória Összes KérésekTag extensions Kiterjesztések GYIK Extension hook registryAlapértelmezett névterek