API de MediaWiki/Allusers : Différence entre versions

De Wicri Outils
imported>Jacques Ducloy
(Résultats)
imported>Jacques Ducloy
(Résultats)
Ligne 41 : Ligne 41 :
 
</api>
 
</api>
 
</source>
 
</source>
En pratique, suivant le mode opératoire choisi on peut obtenir une version encapsulée dans une page html.
+
En pratique, suivant le mode opératoire choisi, on peut obtenir une version encapsulée dans une page html.
  
Par exemple, sous unix, la commande :
+
Par exemple, sous unix, la commande [[curl]] :
  
 
<source lang="sh">
 
<source lang="sh">
Ligne 58 : Ligne 58 :
 
   ...
 
   ...
 
         <span style="color:blue;">&lt;u name=&quot;Alice Hermann&quot; /&gt;</span>
 
         <span style="color:blue;">&lt;u name=&quot;Alice Hermann&quot; /&gt;</span>
 +
</source>
 +
 +
==Exemple d'utilisation dans le réseau Wicri==
 +
 +
Le réseau Wicri est constitué de dizaines de wikis sur lesquels différents groupes d'utilisateurs sont inscrits. Pour évaluer leur nombre il faut consolider les listes obtenues sur plusieurs wikis. Voici un exemple réalisé depuis une station Unix.
 +
 +
===Extraction des inscrits en lex===
 +
 +
<source lang="lex">
 +
%START USER
 +
 +
%%
 +
"&lt;u name=&quot;"  BEGIN USER;
 +
<USER>"&quot; /&gt;</span>"  {putchar ('\n'); BEGIN 0;}
 +
<USER>.  ECHO;
 +
<USER>\n BEGIN 0;
 +
. ;
 +
\n ;
 +
%%
 +
main()
 +
{
 +
  yylex();
 +
}
 
</source>
 
</source>

Version du 2 décembre 2010 à 17:58

Le module allusers de l'API de MediaWiki permet d'obtenir une liste des contributeurs, triée par ordre alphabétique.

Exemple introductif

Ce module peut être utilisé à partir d'un navigateur en utilisant une url du type :

<url du wiki>/api.php?paramètres.

Exemple, pour ce wiki, dont l'url est : http://maquettewicri.loria.fr/ticri-outils/, l'accès normal est :

L'accès au module allusers utilise l'URL :

Paramètres

Les paramètres ont la forme identificateur = valeur, ils sont séparés par des caractères « & ».

  • Sélection de l'action liste des utilisateurs inscrits.
?action=query&list=allusers
  • aulimit : longueur maximale de la liste des résultats (valeur implicite 10).

Pour les autres options, voir :

Résultats

En principe la commande renvoie une liste structurée en xml.

<?xml version="1.0" encoding="utf-8"?>
<api>
  <query-continue>
    <allusers aufrom="Wicri robot" />
  </query-continue>
  <query>
    <allusers>
      <u name="Alice Hermann" />
      ...
      <u name="Thierry Daunois" />
    </allusers>
  </query>
</api>

En pratique, suivant le mode opératoire choisi, on peut obtenir une version encapsulée dans une page html.

Par exemple, sous unix, la commande curl :

  curl "http://maquettewicri.loria.fr/ticri-outils/api.php5?action=query&list=allusers"

donne plutôt quelque chose comme :

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
	<title>MediaWiki API Result</title>
   ...
        <span style="color:blue;">&lt;u name=&quot;Alice Hermann&quot; /&gt;</span>

Exemple d'utilisation dans le réseau Wicri

Le réseau Wicri est constitué de dizaines de wikis sur lesquels différents groupes d'utilisateurs sont inscrits. Pour évaluer leur nombre il faut consolider les listes obtenues sur plusieurs wikis. Voici un exemple réalisé depuis une station Unix.

Extraction des inscrits en lex

%START USER

%%
"&lt;u name=&quot;"  BEGIN USER;
<USER>"&quot; /&gt;</span>"  {putchar ('\n'); BEGIN 0;}
<USER>.  ECHO;
<USER>\n BEGIN 0;
. ;
\n ;
%%
main()
{
  yylex();
}