Extension:UserFunctions

**Manuel des extensions MediaWiki**
UserFunctions; État de la version : stable
Implémentation	Fonction d'analyseur
Description	Fournit un ensemble de fonctions d'analyse qui s'appliquent à l'utilisateur actuel
Auteur(s)	Algorithm,; Toniher,; Universal Omega,; and others;
Dernière version	2.8.1 (2022-07-20)
MediaWiki	1.35+
PHP	7.2+
Modifie la base; de données	Non
Composer	mediawiki/user-functions
Licence	Licence publique générale GNU v2.0 ou supérieur
Téléchargement	Télécharger l'extension ; Git [?]: Télécharger la branche master de Git; parcourir le dépôt (Phabricator · GitHub); historique des validations (commits); contributeurs du dépôt (GitHub); relecture du code;
Exemple	sandbox.semantic-mediawiki.org
	Paramètres $wgUFEnabledPersonalDataFunctions; $wgUFAllowedNamespaces; $wgUFEnableSpecialContexts;
	Accroches utilisées ParserFirstCallInit; ParserClearState;
Téléchargements trimestriels	23 (Ranked 117th)
	Traduire l’extension UserFunctions sur translatewiki.net si elle y est disponible

This page is a translated version of the page Extension:UserFunctions and the translation is 93% complete.

L'extension UserFunctions fournit un ensemble de fonctions d'analyse dynamique qui se déclenchent sur l'utilisateur actuel.

Utilisation

Par défaut, les fonctions ne sont activées que dans l'espace de noms NS_MEDIAWIKI; pour les autres espaces de noms, voir les exemples ci-dessous.

Si vous utilisez ces fonctions dans la barre latérale de votre wiki, vous ne pouvez pas mettre $wgEnableSidebarCache = true;.

Functions (always available)

Les quatre fonctions suivantes sont disponibles partout :

{{#ifanon:then|else}}

Teste si l'utilisateur actuel est anonyme.

{{#ifblocked:then|else}}

Teste si l'utilisateur actuel est bloqué.

{{#ifsysop:then|else}}

Teste si l'utilisateur actuel est un sysop.

{{#ifingroup:group|then|else}}

Teste si l'utilisateur actuel est membre du groupe "groupe". Vous pouvez faire le test pour plusieurs groupes ainsi :

{{#ifingroup:group1, group2, group3|then|else}}

Functions (disabled by default)

Les cinq fonctions suivantes relatives aux données personnelles sont désactivées par défaut (voir la section Installation pour la façon de les activer) :

Les fonctions décrites ci-dessous sont appelées fonctions de données personnelles. Elles peuvent être utilisées pour divulguer certaines de vos données personnelles comme d'adresse courriel ou votre vrai nom.

Si vous n'êtes pas sûr de vous, n'activez pas les données personnelles.

{{#realname:alt}}

Renvoie le nom réel de l'utilisateur actuel. Si l'utilisateur n'est pas logué, cette fonction renvoie le texte alternatif fourni, ou l'IP si aucune alternative n'est fournie.

{{#username:alt}}

Renvoie le nom d'usage actuel. Si l'utilisateur n'est pas logué, la fonction renvoie le texte alternatif fourni, ou l'IP si aucune alternative n'est fournie.

{{#useremail:alt}}

Renvoie l'adresse courriel de l'utilisateur actuel. Si l'utilisateur n'est pas logué, cette fonction renvoie le texte alternatif fourni, ou l'IP si aucune alternative n'est fournie.

{{#nickname:alt}}

Renvoie le prénom de l'utilisateur actuel. Si l'utilisateur n'a pas de prénom, renvoie le nom d'usage. Si l'utilisateur n'est pas logué, cette fonction renvoie le texte alternatif fourni, ou l'IP si aucune alternative n'est fournie.

{{#ip:}}

Renvoie l'adresse IP de l'utilisateur actuel.

Installation

Téléchargez et placez le(s) fichier(s) dans un répertoire appelé UserFunctions dans votre dossier extensions/.
Les développeurs et les contributeurs au code doivent à la place installer l'extension à partir de Git en utilisant:cd extensions/ git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/UserFunctions
Ajoutez le code suivant à la fin de votre fichier LocalSettings.php :
```
wfLoadExtension( 'UserFunctions' );
```
Si vous voulez utiliser l’une des fonctions suivantes : #realname, #username, #useremail, #nickname ou #ip, ajoutez ceci juste après cette ligne :
```
$wgUFEnabledPersonalDataFunctions = [
	'ip',
	'nickname',
	'realname',
	'useremail',
	'username',
];
```

Si vous utilisez une ancienne version de l'extension, les fonctions sont incluses dans le paquet via : $wgUFEnablePersonalDataFunctions = true;

Si vous souhaitez activer les fonctions dans d'autres espaces de noms, outre NS_MEDIAWIKI (par défaut), suivez le modèle des exemples ci-dessous.
Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Autoriser les espaces de noms

Par défaut, les fonctions utilisateur ne fonctionnent que dans l'espace de noms NS_MEDIAWIKI .

Vous trouverez ci-dessous des exemples qui permettent ou interdisent aux fonctions de fonctionner dans les autres espaces de noms. La syntaxe est basée sur l'une de celles décrites avec les sous-pages.

// Autoriser les fonctions utilisateur dans l'espace de noms "Main"
// Ajouter les valeurs au tableau existant
$wgUFAllowedNamespaces[NS_MAIN] = true;

// Activer les fonctions utilisateur dans l'espace de noms 'Main" et "User", mais pas dans l'espace de noms "MediaWiki"
// en remplaçant les valeurs présentes dans le tableau
$wgUFAllowedNamespaces = [
        NS_MAIN => true,
        NS_USER => true
];

// Active les fonctions utilisateur dans les espaces de  noms avec les index de 0 à 200
// en remplaçant les valeurs dans le tableau suivant
$wgUFAllowedNamespaces = array_fill( 0, 200, true );

Plus d'info sur la numérotation des espaces de noms.

Dans les autres contextes (reconnus comme NS -1, mais pas toujours une page spéciale), tels que les pages de formulaire , vérifiez si les paramètres suivants sont activés :

$wgUFEnableSpecialContexts = true;

Le paramètre ci-dessus est activé par défaut.

Si vous rencontrez des problèmes avec les robots ou les scripts de maintenance, mettez le à false et signalez-le sur cette page de discussion.

Historique des versions

Auteurs : algorithme et autres

Version 2.8.1 (20 juillet 2022) Permet d'activer et de désactiver les fonctions spécifiques des données personnelles - Universal Omega

Avant cette version, la variable de configuration $wgUFEnabledPersonalDataFunctions s'appelait $wgUFEnablePersonalDataFunctions, et en la mettant à true vous activiez toutes les fonctions sur les données personnelles; elle ne pouvait que les activer ou les désactiver toutes ensemble, ou aucune.

Version 2.8.0 (18 avril 2021) Conversion en ExtensionRegistry et autres nettoyages de code - Universal Omega
Version 2.7.0 (26 juillet 2017) Suppression des structures de base PHP i18n - Kghbln
Version 2.6.1 (15 novembre 2014) Propositions de modification de syntaxte - Kghbln, Umherirrender
Version 2.6.0 (18 septembre 2014) Extension compatible avec Composer - Toniher
Version 2.5.0 (1^er avril 2014) Migré vers JSON i18n - Siebrand
Version 2.4.3 (16 mars 2014) Corrections en attente et nettoyage de code - Chad Uckelman
Version 2.4.2 (8 avril 2013) Nettoyage partiel du code - Reedy
Version 2.4.1 (17 juillet 2012) Correction de problèmes avec la barre latérale (signalés par Kghbln). Suppression des avertissements PHP dans les fonctions - Toniher
Version 2.4 (2 juin 2012) Nettoyage en utilisant les modèles actuels de ParserFunctions. Correction de la modification des formulaires - Toniher
Version 2.3 (27 mai 2012) correction des problèmes liés à l'utilisation des scripts et des groupes multiples autorisés et qui sont testés dans ifingroup. - Toniher
Version 2.2 (3 janvier 2012) ajout du paramètre $wgUFAllowedNamespaces. Les utilisateurs doivent définir dans quels espaces de noms de fonctions autorisés, ils vont travailler. - Toniher
Version 2.1 (21 décembre 2011) ajout du paramètre $wgUFEnablePersonalDataFunctions. Migration de $wgUser vers l'équivalent ParserOptions - Toniher
Version 2.0 (13 décembre 2011) ajout de i18n et compatibilité avec les autres extensions des fonctions d'analyse syntaxique - Toniher
Version 1.5 (30 octobre 2011) ajout de ip (adresse IP) - Kghbln
Version 1.4 (27 septembre 2011) ajout de realname (vrai nom) - Kghbln
Version 1.3 (13 février 2010) ajout de useremail (adresse courriel) - Wikinaut
Version 1.2 (25 juillet 2008) ajout de ifingroup - Louperivois
Version 1.1 (27 juin 2008) ajout de nickname - Lexw
Version 1.0 (21 mai 2006) Algorithme

Issues and feature requests

Please report them on the talk page.

Troubleshooting

Invalid magic word

If you are getting an error that looks like this Error: invalid magic word 'ifanon', then you should try rebuilding the localization cache. The functions within this extension will not load correctly without this extension's localization information within the cache.

Voir aussi

Cette extension est incluse dans les fermes de wikis ou les hôtes suivants et / ou les paquets :

Cette liste ne fait pas autorité. Certaines fermes de wikis ou hôtes et / ou paquets peuvent contenir cette extension même s'ils ne sont pas listés ici. Vérifiez toujours cela avec votre ferme de wikis ou votre hôte ou votre paquet avant de confirmer.

UserFunctions État de la version : stable
Implémentation	Fonction d'analyseur
Description	Fournit un ensemble de fonctions d'analyse qui s'appliquent à l'utilisateur actuel
Auteur(s)	Algorithm, Toniher, Universal Omega, and others
Dernière version	2.8.1 (2022-07-20)
MediaWiki	1.35+
PHP	7.2+
Modifie la base de données	Non
Composer	mediawiki/user-functions
Licence	Licence publique générale GNU v2.0 ou supérieur
Téléchargement	Télécharger l'extension Git ^[?]: Télécharger la branche master de Git parcourir le dépôt (Phabricator · GitHub) historique des validations (commits) contributeurs du dépôt (GitHub) relecture du code
Exemple	sandbox.semantic-mediawiki.org
Paramètres $wgUFEnabledPersonalDataFunctions $wgUFAllowedNamespaces $wgUFEnableSpecialContexts
Accroches utilisées ParserFirstCallInit ParserClearState
Téléchargements trimestriels	23 (Ranked 117^th)
Traduire l’extension UserFunctions sur translatewiki.net si elle y est disponible