Jump to content

Extension:IDProvider

From mediawiki.org
This page is a translated version of the page Extension:IDProvider and the translation is 100% complete.
Manuel des extensions MediaWiki
IDProvider
État de la version : stable
Implémentation Fonction d'analyseur
Description Fournit des identifiants à l'aide de différents algorithmes d'identification
Auteur(s) Simon Heimler, Alexander Gesinn
Maintenance gesinn.it
Dernière version 3.0.0 (2024-12-16)
MediaWiki 1.39+
Modifie la base
de données
Oui
Composer gesinn-it/id-provider
Licence Licence MIT
Téléchargement

L'extension IDProvider permet de générer des identifiants (uniques) via différents algorithmes d'identification. Ils sont accessibles via des fonctions d'analyse, une API ou en tant que fonction PHP statique.

Installation

  • Download, extract et placez le(s) fichier(s) dans un répertoire appelé IDProvider dans votre dossier extensions/.
  • Ajoutez le code suivant à la fin de votre fichier LocalSettings.php  :
    wfLoadExtension( 'IDProvider' );
    
  • Exécutez le script de mise à jour qui va créer automatiquement les tables de base de données dont cette extension a besoin.
  • Yes Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.


L'installation via Composer est interrompue.

Utilisation

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.

Via les fonctions de l'analyseur

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

Vous devez éviter les espaces dans les fonctions de l'analyseur si vous l'utilisez comme paramètre d'une balise d'information de formulaire de page.
{{{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

IDProvider Example

Through a static PHP call

Pour plus d'exemples, jetez un œil au unit-tests.

IDProviderFunctions::getIncrement

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

IDProviderFunctions::getRandom

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

Voir aussi

  • Extension:IDGenerator - Fournit une fonction d'analyseur pour les ID numériques. Alternative à IDProvider qui peut être installée via Composer.