Manual:Extensiuni
Extensiile vă permit să personalizați modul în care MediaWiki arată și funcționează.
- Utilizatorii Wiki pot naviga prin extensiile existente.
- Administratorii de sistem pot extinde instala (sau elimina) extensiile instalărilor MediaWiki pe care le administrează.
- Dezvoltatorii pot scrie noi extensii sau îmbunătăți sau întreține actuale.
În timp ce unele extensii sunt menținute de dezvoltatorii MediaWiki, altele au fost scrise de dezvoltatori terți. Ca rezultat, mulți au bug-uri, și nu toate sunt garantate a fi compatibile unul cu celălalt. Unele sunt neîntreținute; nu toate extensiile funcționează pe toate versiunile de MediaWiki. Utilizați orice extensie, în special cele marcate ca nesigure, pe propriul dvs. risc. 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.
Types of extensions
Parser tags
Parser functions
Hooks
Special pages
Magic words
API
Page content models
Finding extensions
Extensiile de navigare
Puteți căuta Categorie:Extensii după categorie pentru a vedea întreaga gamă de extensii care au fost deja scrise. Pentru informații despre instalarea acestor extensii sau despre scrierea propriilor dvs., vedeți mai jos.
Verificarea extensiilor instalate
Numai cineva cu acces administrativ la sistemul de fișiere (și adesea și baza de date) pe un server poate instala extensii pentru MediaWiki, dar oricine poate verifica ce extensii sunt active pe o instanță a MediaWiki prin accesarea Special:Version page. De exemplu, aceste extensii sunt active în Wikipedia engleză.
Popular extensions
There are a number of ways of finding popular extensions.
The first set is those that are bundled with MediaWiki (a list that is reviewed regularly, and to which anyone can suggest an addition).
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.
O a treia opțiune este să se uite la numărarea de wikis pe care sunt instalate extensiunile de la WikiApiary . This has the advantage of representing actual installations and not just downloads (i.e. it queries the wiki's APIs), but it is also (as of 2023) not completely up to date. It also doesn't count installations on private wikis.
Instalarea unei extensii
- For further guidance, see also Manual:Extensions/Installation and upgrade
MediaWiki este gata să accepte extensii imediat după finalizarea instalarea. Pentru a adăuga o extensie, urmați acești pași:
- Înainte de a începe
- Multe extensii oferă instrucțiuni destinate instalării folosind comenzi unix. Aveți nevoie de accesul shell (SSH) pentru a introduce aceste comenzi afișate pe paginile de ajutor pentru extensii.
- Descărcați extensia.
- Distribuitor Extensie vă ajută să selectați și să descărcați majoritatea extensiilor populare.
- Extensiile sunt de obicei distribuite ca pachete modulare. În general, aceștia merg în propriul lor subdirector de
$IP /extensions/
. O listă de extensii stocate în depozitul Wikimedia Git repository este localizată la git:mediawiki/extensions. Unele extensii nu folosesc controlul versiunii și nu sunt recomandate. - Unele extensii sunt de asemenea disponibile în bundles, composer sau package repositories.
- It's recommended to read the README file before installation. It usually contains important info about configuration.
- Instalați extensia.
- La sfârșitul fișierului
LocalSettings.php
, adăugați: wfLoadExtension( 'ExtensionName' );
- Această linie forțează interpretul PHP să citească fișierul de extensie și astfel să îl acceseze pentru MediaWiki.
- Unele extensii pot intra în conflict cu scripturile de întreținere, de exemplu dacă accesează direct $_SERVER (nu se recomandă).
- În acest caz, ele pot fi înfășurate în condiționat, astfel încât scripturile de întreținere pot fi încă executate.
if ( !$wgCommandLineMode ) { wfLoadExtension ( 'ExtensionName' ); }
- Scriptul de întreținere importDump.php va eșua pentru orice extensie care necesită spațiu de nume personalizat care este inclus în interiorul condiționalului de mai sus, cum ar fi Extension:Semantic MediaWiki , Extension:Page Forms .
- La sfârșitul fișierului
- Asigurați-vă că permisiunile necesare sunt setate pentru extensii!
- În timp ce această procedură de instalare este suficientă pentru majoritatea extensiilor, unele necesită o altă procedură de instalare. Verificați documentația extensiei pentru detalii.
- Dacă doriți să modificați variabilele de configurare în
LocalSettings.php
, trebuie să faceți acest lucru de obicei după, inclusiv extensia. În caz contrar, valorile implicite definite în extensie vor suprascrie setările.
Actualizarea unei extensii
Unele extensii trebuie să fie actualizate ori de câte ori actualizați MediaWiki, în timp ce altele lucrează cu mai multe versiuni. Pentru a trece la o versiune nouă a unei extensii:
- Descărcați noua versiune a extensiei
- Înlocuiți toate fișierele de extensie din directorul
extensions/ExtensionName
cu fișierele noi. Nu eliminați configurația de extensie prezentă înLocalSettings.php
- Dacă extensia necesită modificări în baza de date MediaWiki, va trebui să rulați scriptul de întreținere update.php . Majoritatea extensiilor vor menționa dacă acest script trebuie rulat sau nu. (Perform backup of your data before executing the script). Dacă nu aveți acces la linia de comandă, puteți utiliza, de asemenea, web updater.
Dezinstalați o extensie
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.
Vezi şi
- Categorie:Extensii
- Format:Extensie
- Manual:Developing extensions
- Manual:Translating extensions - Informații despre traducerea extensiilor.
- 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