Extension:IDProvider/fi

MediaWikin laajennukset-ohje

IDProvider Julkaisustatus: vakaa
Toteutus	Jäsennintoiminto
Kuvaus	Provides IDs using different ID algorithms
Tekijä(t)	Simon Heimler, Alexander Gesinn
Ylläpitäjä(t)	gesinn.it
Viimeisin versio	3.0.0 (2024-12-16)
MediaWiki	1.39+
Tietokantamuutokset	Kyllä
Composer	gesinn-it/id-provider
Lisenssi	MIT-lisenssi
Lataa	GitHub: project page git repository URL [help ] commit history Note: No localisation updates are provided by translatewiki.net .
Käytetyt kytköspisteet ParserFirstCallInit BeforePageDisplay

The IDProvider extension provides the generation of (unique) IDs through different ID algorithms. They can be accessed through parser functions, API or as a static PHP function.

Installation

• Download, extract ja siirrä tiedosto(t) extensions/-kansiosi hakemistoon nimeltä IDProvider.
• Lisää seuraava koodi LocalSettings.php -tiedostosi loppuosaan:

  wfLoadExtension( 'IDProvider' );
  

• Suorita päivitysskripti, joka luo automaattisesti tarvittavat tietokantataulut, joita tämä laajennos käyttää.
•  Tehty – Mene wikisi sivulle Special:Version vahvistaaksesi, että laajennoksen asennus onnistui.

Installation via Composer is broken.

Käyttö

The ApiSandbox will display and document all available options. All parameters are given as key values and work the same way whether you use the parser function, api or a static php call.

Through parser functions

This makes most sense in combination with Page Forms . There it can be used for auto-creating unique page titles.

You should avoid spaces within the parser functions if you use it as a parameter of a Page Form info tag.

{{{info|page name={{#idprovider-increment:Feature_|padding=5}} }}}

#idprovider-increment

{{#idprovider-increment:}}
{{#idprovider-increment:Issue_}}
{{#idprovider-increment:
  |prefix=Issue_
  |padding=5
  |skipUniqueTest=true
}}

#idprovider-random

{{#idprovider-random:}}
{{#idprovider-random:uuid}}
{{#idprovider-random:fakeid}}
{{#idprovider-random:
  |type=uuid
  |skipUniqueTest=true
}}

Through the API

#idprovider-increment

• api.php?action=idprovider-increment
• api.php?action=idprovider-increment&prefix=Issue_&padding=8&skipUniqueTest=true

#idprovider-random

• api.php?action=idprovider-random&type=uuid
• api.php?action=idprovider-random&type=fakeid&prefix=Issue_&skipUniqueTest=true

Through a static PHP call

Lisäesimerkkejä varten, katso unit-tests.

IDProviderFunctions::getIncrement

$id = IDProviderFunctions::getIncrement([
	'prefix' => '___TEST___',
	'padding' => 8,
]);

IDProviderFunctions::getRandom

$id = IDProviderFunctions::getRandom([
	'type' => 'fakeid',
	'prefix' => 'PREFIX_',
]);

Katso myös

• Extension:IDGenerator - Provides a parser function for numeric IDs. Alternative to IDProvider that can be installed via Composer.