Extension:IDProvider/pl
![]() Status wydania: stabilne |
|
---|---|
Realizacja | Funkcja parsera |
Opis | Provides IDs using different ID algorithms |
Autor(zy) | Simon Heimler, Alexander Gesinn |
Opiekun(owie) | gesinn.it |
Ostatnia wersja | 2.0.2 (2022-02-02) |
MediaWiki | 1.31+ |
Zmiany w bazie danych | Tak |
Composer | gesinn-it/id-provider |
Licencja | Licencja MIT |
Pobieranie | GitHub: Uwaga: |
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 i umieść plik(i) w katalogu o nazwie
IDProvider
w swoim kataloguextensions/
. - Dodaj poniższy kod na dole twojego pliku
LocalSettings.php
:wfLoadExtension( 'IDProvider' );
- Uruchom skrypt aktualizujący, który automatycznie stworzy potrzebne tabele dla tego rozszerzenia.
- Zrobione – Przejdź do Special:Version na twojej wiki, aby sprawdzić czy rozszerzenie zostało pomyślnie zainstalowane.
Installation via Composer is broken.
Usage
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 Rozszerzenie: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
For more examples, take a look at the unit-tests.
IDProviderFunctions::getIncrement
$id = IDProviderFunctions::getIncrement(array(
'prefix' => '___TEST___',
'padding' => 8,
));
IDProviderFunctions::getRandom
$id = IDProviderFunctions::getRandom(array(
'type' => 'fakeid',
'prefix' => 'PREFIX_',
));
Zobacz też
- Extension:IDGenerator - Provides a parser function for numeric IDs. Alternative to IDProvider that can be installed via Composer.
- Extension:Substitutor – Allows to substitute the IDs generated
To rozszerzenie jest dołączone do następujących pakietów lub farm wiki: To nie jest pełna lista. Niektóre farmy/wiki mogą wykorzystywać to extension, nawet jeśli nie są tutaj wymienione. Zawsze sprawdzaj swoje farmy/hosty wiki, aby to potwierdzić. |