Extension:UserFunctions

This page is a translated version of the page Extension:UserFunctions and the translation is 57% complete.
Manuel des extensions MediaWiki
OOjs UI icon advanced-invert.svg
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)
Dernière version 2.8.0 (2021-04-18)
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
Exemple sandbox.semantic-mediawiki.org

  • $wgUFEnablePersonalDataFunctions
  • $wgUFAllowedNamespaces
  • $wgUFEnableSpecialContexts
Traduire l’extension UserFunctions sur translatewiki.net si elle y est disponible

Vérifier la matrice des utilisations et des versions.

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

Utilisation

By default functions are only enabled in NS_MEDIAWIKI namespace, for enabling them in other namespaces, see the examples below.
If you are using these functions within you wiki's sidebar, you cannot set $wgEnableSidebarCache = true;.

Les quatre fonctions suivantes sont toujours disponible pour utilisation :

  • {{#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}}

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

The functions described below are called personal data functions. They can be used to leak some of your user's personal data like their email address and real name.


If unsure, do not activate personal data functions.
  • {{#realname:alt}}
Retourne le nom réel de l'utilisateur actuel. Si l'utilisateur n'est pas logué, cette fonction retourne le texte alternatif fourni, ou l'IP si aucune alternative n'est fournie.
  • {{#username:alt}}
Retourne le nom d'usage actuel. Si l'utilisateur n'est pas logué, la fonction retourne le texte alternatif fourni, ou l'IP si aucune alternative n'est fournie.
  • {{#useremail:alt}}
Retourne l'adresse courriel de l'utilisateur actuel. Si l'utilisateur n'est pas logué, cette fonction retourne le texte alternatif fourni, ou l'IP si aucune alternative n'est fournie.
  • {{#nickname:alt}}
Retourne le prénom de l'utilisateur actuel. Si l'utilisateur n'a pas de prénom, retourne le nom d'usage. Si l'utilisateur n'est pas logué, cette fonction retourne le texte alternatif fourni, ou l'IP si aucune alternative n'est fournie.
  • {{#ip:}}
Retourne l'adresse IP de l'utilisateur actuel.

Installation

  • Téléchargez et placez le(s) fichiers (s) dans un répertoire appelé UserFunctions dans votre dossier extensions/.
  • Ajoutez le code suivant à la fin de votre fichier LocalSettings.php :
    wfLoadExtension( 'UserFunctions' );
    
  • If you want to use the following functions: #realname, #username, #useremail, #nickname and #ip, add:
    $wgUFEnablePersonalDataFunctions = true;
    
    just after that line.
  • If you want to enable functions in other namespaces apart from NS_MEDIAWIKI (default), follow the model of some of the examples below.
  •   Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Pour les utilisateurs de MediaWiki 1.35 ou précédents :

Les instructions ci-dessus décrivent la nouvelle procédure pour installer cette extension en utilisant wfLoadExtension(). Si vous avez besoin d'installer cette extension sur les précédentes versions de MediaWiki (1.35 ou antérieur), à la place de wfLoadExtension( 'UserFunctions' );, vous devez utiliser :

require_once "$IP/extensions/UserFunctions/UserFunctions.php";

Autoriser les espaces de noms

By default, user functions only work in NS_MEDIAWIKI namespace.

Below there are some examples of allowing or disallowing the functions to work in other namespaces. The syntax is based on the one used with subpages.

// Enable user functions additionally in namespace "Main"
// Adds values to the existing array
$wgUFAllowedNamespaces[NS_MAIN] = true;
// Enable user functions in namespaces "Main" and "User", but not in namespace "MediaWiki"
// Replaces values in the existing array
$wgUFAllowedNamespaces = [
        NS_MAIN => true,
        NS_USER => true
];
// Enable user functions in namespaces with the indexes from 0 to 200
// Replaces values in the existing array
$wgUFAllowedNamespaces = array_fill( 0, 200, true );

Plus d'info sur la numérotation des espace de nommage.

In other contexts (recognized as NS -1, but not always a Special Page), such as in Page Forms pages, check you have the following parameter enabled:

$wgUFEnableSpecialContexts = true;

The parameter above is enabled by default.

If you experience any problem with bots or maintenance scripts, turn it to false and report it to this talk page.

Historique des versions

Authors: Algorithm and others

  • Version 2.8.0 (2021-04-18) Convert to ExtensionRegistry and other code cleanups - Universal Omega
  • Version 2.7.0 (2017-07-26) Removed PHP i18n shim - Kghbln
  • Version 2.6.1 (2014-11-15) Provided syntax changes - Kghbln, Umherirrender
  • Version 2.6.0 (2014-09-18) Composer-compatible extension - Toniher
  • Version 2.5.0 (2014-04-01) Migrated to JSON i18n - Siebrand
  • Version 2.4.3 (2014-03-16) Accumulated fixes and code cleaning - Chad and Uckelman
  • Version 2.4.2 (2013-04-08) Some code cleaning - Reedy
  • Version 2.4.1 (2012-07-17) Fixed problems with Sidebar (report Kghbln). Cleared PHP warnings in functions - Toniher
  • Version 2.4 (2012-06-02) Cleaned using current ParserFunctions models. Fix when editing Semantic Forms - Toniher
  • Version 2.3 (2012-05-27) fixed problems when using scripts and allowed multiple groups to be checked against in ifingroup. - Toniher
  • Version 2.2 (2012-01-03) added $wgUFAllowedNamespaces parameter. Users need to define in which allowed NS functions will work. - Toniher
  • Version 2.1 (2011-12-21) added $wgUFEnablePersonalDataFunctions parameter. Migrated $wgUser to ParserOptions equivalent - Toniher
  • Version 2.0 (2011-12-13) added i18n and compatibility with other parser function extensions - Toniher
  • Version 1.5 (2011-10-30) added ip - Kghbln
  • Version 1.4 (2011-09-27) added realname - Kghbln
  • Version 1.3 (2010-02-13) added useremail - Wikinaut
  • Version 1.2 (2008-07-25) added ifingroup - Louperivois
  • Version 1.1 (2008-06-27) added nickname - Lexw
  • Version 1.0 (2006-05-21) Algorithm

Voir aussi