Manual:Extensions/ro

Extensions:

Extensiile vă permit să personalizați modul în care MediaWiki arată și funcționează.

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

Extensiile de navigare

Puteți căuta $cat pentru a vedea întreaga gamă de extensii care au fost deja scrise.

Verificarea extensiilor instalate

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). De exemplu, aceste extensii sunt active în Wikipedia engleză.

There are a number of ways of finding popular extensions.

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.

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:

  1. Î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.
  2. 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.
  3. 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.
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:

  1. Descărcați noua versiune a extensiei
  2. Înlocuiți toate fișierele de extensie din directorul extensions/ExtensionName cu fișierele noi.Nu eliminați configurația de extensie prezentă în LocalSettings.php
  3. 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.
Aceste instrucțiuni acoperă 99% din extensii.Dacă extensia specifică pe care o actualizați are instrucțiuni care diferă de acestea, ar trebui probabil să urmați instrucțiunile de extensie specifică

Dezinstalați o extensie

Remove the line from LocalSettings.php with the extension name to uninstall it:

wfLoadExtension( 'ExtensionName' );
  • You must also remove any lines pertaining to the configuration of the extension.

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/


Vezi şi

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