Template:Extension
This template employs intricate features of template syntax.
You are encouraged to familiarize yourself with its setup and parser functions before editing the template. If your edit causes unexpected problems, please undo it quickly, as this template may appear on a large number of pages. Remember that you can conduct experiments, and should test all improvements, in either the general sandbox or your user space before changing anything here. |
Uporablja Luo |
Ta predloga uporablja TemplateStyles: |
To predlogo je treba dodati na vse strani raazširitve v tem vikiju (vendar samo na glavno stran). Dodala bo uporabno infopolje (glejte spodaj) in bo razširitev samodejno dodala na Category:All extensions skupaj z ustreznim stanjem in kategorijami vrate implementacije . It autofills some fields of the infobox with extension data collected by wikitech:Tool:Extjsonuploader.
Uporaba
Skopirajte in prilepite: {{Extension |templatemode = |name = |status = |type1 = |type2 = |hook1 = |hook2 = |newhook1 = |newhook2 = |username = |author = |description = |image = |imagesize = |version = |update = |version preview = |update preview = |compatibility policy = |mediawiki = |php = |needs-updatephp = |composer = |virtual domain = |table1 = |table2 = |license = |download = |repo = |readme = |changelog = |help = |example = |namespace = |parameters = |tags = |rights = |compatibility = |phabricator = |translate = |vagrant-role = }}Za pomoč z vrednostmi parametrov glejte spodaj. |
|
Parametri vsebine
Ta razdelek opisuje parametre, ki določajo vsebino infopolja. Za pomoč pri templatemode in drugih nadzornih parametrih glejte razdelek Nadzorni parametri.
Parameter | Opis |
---|---|
name | ime razširitve |
status |
trenutno stanje izdaje Ena od:
Če je stanje kar koli drugega od zgornjega, bo prezrto in bo v predlogi namesto tega prikazana privzeta vrednost »neznano«. Če je vrednost izpuščena, bo predloga kategorizirana kot neznano. Če je vrednost neveljavna, bo predloga uvrščena v posebno kategorijo, tako da bo mogoče zaznati in popraviti napako. |
type1 type2 type3 type4 type5 type6 | Vrsta implementacije
The implementation strategy(s) employed in building this extension. This parameter is used to create categories that help programmers find examples of various MediaWiki specific implementation strategies or patterns. Although the values of this parameter sometimes coincide with the use case or purpose of an extension, that is not reason for this parameter. If the values you have chosen for this parameter do not adequately identify the purpose or possible use cases, we recommend you add additional category links as needed. Allowed values for the type1, type2, ... parameters are:
Any other value for 'type' is invalid, and will cause the extension to be placed in Category:Extensions with invalid or missing type/sl. Note: Many extensions have more than one type, if this applies to yours, replace|type= with |type1=|type2=|type3=... . You may define up to six types for an extension. |
hook1 hook2 hook3 hook4 ... |
ime vsakega vstavka, ki ga uporablja razširitev
Vnos vrednosti v to polje je dober način za začetek promocije razširitve in pomoč drugim razvijalcem. Vsak dokumentirani vstavek bo razširitev samodejno dodal v kategorijo razširitev, ki uporabljajo ta vstavek. This category is autolinked to each hook page so that programmers can easily find examples of extensions that use a particular hook. Pri več vstavkih dodelite prvemu vstavku hook1, drugemu hook2 in tako naprej. |
newhook1 newhook2 newhook3 newhook4 ... newhook90 |
ime vseh vstavkov, ki jih zagotavlja razširitev Vstavke lahko dodate tudi v Extension hook registry. |
username | Uporabniško ime avtorja na MediaWiki.org (če ga ima). Lahko ostane prazno, če pa je navedeno, se povezuje na avtorjevo uporabniško in uporabniško pogovorno stran. Navesti ga je treba brez imenskega prostora in brez [[]]s. |
Ime avtorja razširitve, če se razlikuje od njegovega uporabniškega imena na MediaWiki.org. Prosto besedilo. Če je izpuščeno, bo uporabljeno polje »username« (če je prisotno). | |
description | kratki opis |
image | zaslonski posnetek ali logotip razširitve. Navedeno mora biti brez imenskega prostora in brez [[]]s. |
imagesize | izbirno velikost slike (privzeta velikost je 220px) |
version | zadnja različica |
update | datum zadnje posodobitve |
version preview | predogledna različica |
update preview | datum zadnje posodobitve predogledne različice |
compatibility policy | politika združljivosti (sprejete vrednosti so $2, main, $3 in $x). (dnevnik zaostankov ) |
mediawiki | Potrebna različica MediaWikija. Most extensions should not need to use this — it defaults to the value of the 'requires' property of extension.json. See also Category:Extensions without MediaWiki version and Category:Extensions with manual MediaWiki version . |
php | Potrebna različica PHP-ja |
needs-updatephp |
Extensions that conform to MediaWiki extension standards come with a schema change script which you need to start manually (once) before starting and accessing the MediaWiki through your browser, and after you copied all the extension files to
$IP stands for the Installation Path (or "directory") of your MediaWiki installation, the same directory that holds LocalSettings.php , index.php etc.. |
composer | Ime sestavljalnika razširitve v standardnem formatu. Če je nastavljeno v »composer.json«, bo vključeno samodejno (tj. v tem primeru parameter ni potreben). Povezano bo na stran razširitve na Packagist. |
virtual domain | The virtual database domain used by the extension. |
table1 table2 table3 table4 ... table30 | ime vsake nejedrne tabele, ki jo uporablja razširitev Links to a subpage of your extension page. For instance, "table1 = cu_changes" at Extension:CheckUser will link to Extension:CheckUser/cu_changes table . Don't list core tables such as page or revision ; only list tables that are added by extensions. |
license | License governing use of this extension, as one of the codes found in https://spdx.org/licenses/, e.g. GPL-2.0-or-later , GPL-2.0-only or GPL-3.0-or-later , etc. |
download | povezava za prenos : Git, {{WikimediaDownload/sl }}. |
repo | Name of the Gerrit repository the extension's code is stored in, if different from the page name. Setting this automatically sets |download= , and allows the template to automatically load data from the appropriate extension.json file. |
readme | External link to the readme file, e.g. https://phabricator.wikimedia.org/r/browse/mediawiki/extensions/Flow;master;README |
changelog | External link to the changelog file, e.g. Extension:GeoGebra/Changelog |
help | Link to user-help for the extension. If not provided, will look for Help:Extension:ExtensionName . If provided, full wikitext link should be given (because you may want to link to e.g. an external page). |
example | Example, website or screenshot of working extension |
namespace | imenski prostor, v katerem se uporablja ta razširitev |
parameters | razpoložljivi parametri za LocalSettings.php |
vse značke, ki jih uporablja razširitev (npr. <tag1>, <tag2>). | |
rights | pravice, ki jih doda razširitev. Ne zamenjajte z licenco! Pravice so npr. makebot ali desysop ; GFDL ali LGPL ali GPL pa so licence! |
compatibility | Additional compatibility information, for instance compatibility charts. It's encouraged to add any client-side compatibility information here too, especially when diverging from expectations of full support for a browser. |
bugzilla | Ime razširitvene komponente MediaWikija v Bugzilli |
phabricator | Ime projekta v Phabricatorju |
translate |
Optional parameter to link the exact page where (message group id with which) the extension will be translatable on translatewiki.net if enabled. If the default link is incorrect, manually set it to:
|
vagrant-role | vloga MediaWiki-Vagrant |
CheckUsageNameOverride | povozi ime strani, ki ga uporablja povezava za preverjanje uporabe. |
Nadzorni parametri
Parameter | Opis |
---|---|
templatemode |
Nadzoruje avtokategorizacijo gostiteljske strani. Običajno ostane prazno. Druge mogoče vrednosti so:
|
Uporaba infopolja
Obstoječe strani razširitev
Če želite dodati infopolje obstoječi strani, skopirajte in prilepite kodo na vrhu te strani.
Ustvarite novo stran o razširitvi
Če želite ustvariti novo stran o razširitvi, spodaj vnesite ime in kliknite gumb. Ustvarjena bo nova stran s predlogo infopolja, ki že obstaja.
A developer sharing their code in the MediaWiki code repository should expect:
- Feedback / Criticism / Code reviews
- Review and comments by other developers on things like framework use, security, efficiency and usability.
- Developer tweaking
- Other developers modifying your submission to improve or clean-up your code to meet new framework classes and methods, coding conventions and translations.
- Improved access for wiki sysadmins
- If you do decide to put your code on the wiki, another developer may decide to move it to the MediaWiki code repository for easier maintenance. You may then create a developer account to continue maintaining it.
- Future versions by other developers
- New branches of your code being created automatically as new versions of MediaWiki are released. You should backport to these branches if you want to support older versions.
- Incorporation of your code into other extensions with duplicate or similar purposes — incorporating the best features from each extension.
- Credit
- Credit for your work being preserved in future versions — including any merged extensions.
- Similarly, you should credit the developers of any extensions whose code you borrow from — especially when performing a merger.
Any developer who is uncomfortable with any of these actions occurring should not host in the code repository. You are still encouraged to create a summary page for your extension on the wiki to let people know about the extension, and where to download it.
Izboljšanje te predloge
Če želite izboljšati to predlogo, hvala! To je zapletena predloga, zato je tu nekaj pomoči.
Gumb Ustvari razširitev
Za izboljšanje delovanja gumba Ustvari razširitev:
- Template:Extension/Sample : Nadomestna razširitev, ki se prednaloži na novoustvarjenih straneh.
- Template:Extension/CreateExtensionInputBox : Vnosno polje, ki se lahko vstavi, kjer koli uporabniki želijo preprosto ustvarjati razširitve. Za dokumentacijo značke
<inputbox>
glejte Extension:InputBox .
Parametri infopolja
Na splošno:
- Za preprosto uporabo te predloge je vsaka oznaka v infopolju povezana z dokumentacijo parametra(ov), ki ga(jih) prikazuje. Če dodate parameter, ga dodajte tudi v dokumentacijo parametrov vsebine in njegovo oznako povežite s to dokumentacijo.
Če želite spremeniti/popraviti/dodati parametre vrste implementacije:
- Preverite pogovorno stran – o tem polju je bila že obsežna razprava.
- Veljavne vrste in strani, s katerimi se povezujejo, so navedene na Module:Extension
Za spremembo delovanja parametrov vstavkov:
- Template:Extension/HookInUse: Adds links and categories for a hook in use. Multiple hooks in use are implemented by calling this template with Template:Foreach.
- Template:Extension/HookInUseNoCats: Used instead of Template:Extension/HookInUse when this template is used in
templatemode=nocats
. Templates used with Template:Foreach can only take one parameter so we need to wrap the call to Template:Extension/HookInUse with another template that sets the mode.
Testni primer
Oglejte si, ali so naslednje strani še vedno v redu, ko ste uredili to predlogo.
TemplateData
TemplateData | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
This is the TemplateData documentation for this template used by VisualEditor and other tools. Extension An infobox for a MediaWiki extension.
|
Maintenance: vulnerabilities, archived