SourceForge.net Logo
16 Juillet, 2006
© GPL
FractalWikiFR - ProWikiCentre
Commande

Techniquement les commandes sont l'interface primaire vers ProWiki. Par exemple, la commande

http://www.wikiservice.at/fractal/wikidev.cgi?action=index

produit la liste de toutes les pages du FractalWiki. Seule la partie après le point d'interrogation (dans cet exemple "action=index") est d'intérêt parce que la partie avant le point d'interrogation est identique pour toutes les commandes pour accéder à un wiki spécifique.

Les commandes sont généralement cachées derrière les liens étiquetés de l'InterfaceUtilisateur. Parfois elles sont directement écrites à l'intérieur des pages. On peut utiliser "CeWiki" comme une forme d'abréviation "locale InterWiki" pour écrire des commandes, par exemple CeWiki:action=index.

Qui a besoin de connaître les commandes ?

Un utilisateur normal n'a pas besoin de connaître les commandes, même s'il peut occasionnellement remarquer leur apparition dans la LigneCommandeNavigateur.

Les administrateurs devraient connaître les Commandes, parce qu'elles incarnent l'ensemble complet des fonctions du ProWiki. Elles peuvent s'écrire à l'intérieur des pages et des BarreLatérales pour améliorer l'InterfaceUtilisateur dans la recherche d'une utilisabilité maximale.

Les utilisateurs avancés peuvent saisir directement les Commandes qui ne sont pas offertes par l'InterfaceUtilisateur.

La syntaxe des commandes

Les trois formats de syntaxe de commandes sont :

...wiki.cgi?action=nomcommande&nomparamètre=valeur&par2=val2&...
...wiki.cgi?nomcommande=nompage&par1=val1&par2=val2&...
...wiki.cgi?nompage

La première forme (vert) est la plus générale et chaque commande peut s'écrire de cette façon, comme une liste d'assignations séparées par des ampersands "&"

La seconde forme (jaune) est une abréviation pour quelques commandes communes, remplaçant en fait "action=nomcommande&id=nompage" par un plus court "nomcommande=nompage".

La troisième forme (bleu) est la commande la plus commune utilisée pour afficher des pages, remplaçant en fait "browse=nompage" ou "action=browse&id=nompage".

Ainsi chaque commande peut s'écrire comme une Action et les termes Action et Commande sont souvent utilisés "interchangeably".

Paramètres Généraux

Les paramètres peuvent changer le résultat d'une Commande et sont documentés avec la Commande spécifique. Un certain nombre de paramètres ont un sens général et sont utilisés dans un bon nombre de commandes.

Ils sont documentés dans la branche Commande/Paramètre.

Documentation en attente

Déprécié (sera retiré dans la version 2.0.39):
  • ActionPageprop -- formulaire de propriétés de page (déprécié, Administrateur)

LangueFrançaise PageTranslation ProWiki:Command DossierActions DossierFonctionnalitésWiki


Attention à partir de cette ligne la documentation risque d'être obsolète et reste à vérifier pour des expériences

action=browse

Presque la même que donner simplement le nom de la page. Le nom de la page doit être donné en utilisant le paramètre id.

Le seul avantage est que vous pouvez désormais ajouter plus de paramètres.

Utilisez le paramètre diff pour ajouter l'affichage de différence avec un respect de la dernière modification :

Utiliser le paramètre lang pour outrepasser l'interface utilisateur de langue :

Note : il y a un raccourci commande (évitant action + id) :

action=FrontPage

Cette commande pointe vers la page par défaut d'un wiki. Typiquement lié avec les liens interwiki ( ProWiki:InterWikiLinks), spécialement quand vous êtes peu sûr du nom exact de la page par défaut que vous pointez.

Note : le vieux formulaire "action=HomePage" est encore supporté mais déprécié.

action=index

Cette commande affiche la liste complète des pages wiki..

action=log

Cette commande produit un log de session :

Vous pouvez utiliser un bon nombre de paramètres pour modifier l'information produite :

  • days (default=1) élargit l'intervalle de temps de l'anlayse de session
  • sum=1 (default=0) produit les sommes des différentes données mesurées
  • admins=1 (default=0) inclut les sessions administrateur
  • robots=1 (default=0) inclut les sessions de robot (moteur recherche)
Combiné :

L'information pour savoir qui est un administrateur est extraite du fichier de configuration wiki. Les Robots peuvent être identifiés dans tout fichier de configuration. Il y a un fichier global de configuration qui identifie la plupart d'entre eux, de telle manière que cela ne peut être fait pour chaque wiki séparamment. C'est la même information utilisée dans action=stat&detail=1 pour produire les formes d'accès colorées.

action=login

Offre le formulaire de connexion standard.

L'information de Login est détenue tant que le navigateur est ouvert (dans un cookie temporaire).

Ce format est aussi ouvert automatiquement quand un utilisateur tente une commande qui est au-dessus de ses droits en cours d'utilisateurs.

Note : le navigateur doit avoir autorisé les cookies permises pour se souvenir d'un login réussi.

action=members

Cette commande affiche une liste complète des listes de membres.

Note : cette fonction peut être configuré pour supporter toute catégorie (ou dossier).

action=projects

Cette commande affiche la liste complète des pages projets.

Note : cette fonction peut être configurée pour supporter n'importe quelle catégorie (ou dossier).

action=random

Cette commande affiche une page qui est sélectionée en utilisant un générateur de pseudo de nombre au hasard.

Note : Il peut être utile pour quelqu'un dans le ProWiki:HostRole (RôleHôte) de regarder le wiki de cette façon. Cela lui donne un sentiment de la qualité moyenne de son wiki et beaucoup d'idées pour améliorer le système.

action=rc

Cette commande est identique à ouvir la page RecentChanges.

Paramètres edits (montre edits=petites corrections) :

Paramètre days: (montre les RecentChanges N jours en arrière)

Note : Les RecentChanges sont construites à partir des rc logfiles. Les entrées sont typiquement non conservées depuis un long moment. S'il y a pas d'arrangements spéciaux produits (i.e. pour des statistiques à long terme) elles sont effacées après environ 4 à 6 mois.

action=rcg

Des mots comme action=rc, mais pour le groupe de wikis qui est défini dans action=userdata.

action=referer

Cette commande donne un montant statistique de l'information du HTTP_REFERER qui est une partie de la communication entre le logiciel wiki et le navigateur.

Paramètre days (default=30 days):

action=set

La commande set sert l'affichage et modifie le fichier de configuration wiki. Cette fonction est typiquement et seulement permise pour l'administrateur (vous pouvez vous connecter comme FractalUser / context88):

Note : Un wiki peut être complètement administré à partir de n'importe quel navigateur dans le monde sans l'aide des commandes d'accès FTP ou TELNET / SSH (souvenez-vous que le fichier gabaritet les logos peuvent être maintenus dans le répertoire de téléversement)

action=stat

Cette commande montre les statistiques d'accès (en barres et en nombres) pour le wiki (fond gris = weekends) :

Paramètre detail (affiche vert=admins rose=robots bleu=usernames rouge=anonymous):

Paramètre days (default=21 jours) :

action=statg

Fonctionne comme stat, mais pour le goupe de wikis défini dans action=userdata.

Il y a aussi des options addionnelles pour les détails :

action=unlock

Cette commande débloque la database page.

C'est une des fonctions d'un administrateur quand une erreur sérieuse dont on a seulement besoin quand une erreur sérieuse survient durant la mise à jour d'une page, qui peut laisser le wiki dans un état verrouillé.

Le symptôme est que l'opération d'édition ne renvoie pas mais tourne dans un timeout après 20 à 30 secondes. Si cela se reproduit, demandez à un administrateur de faire un action = unlock.

action=upload

Ouvre le formulaire de téléversement. Tout utilisateur enregistré a son propre répertoire de fichier. Le formulaire de téléversement affiche le contenu du répertoire de téléversement et permet de téléverser ou d'effacer des fichiers.

Note : Quand un utilisateur est enregistré dans plus d'un wiki, son quota de téléversement augmente d'autant.

action=userdata

La commande userdata permet de maintenir de l'information spécifique à l'utilisateur, cad le réglage de la notification par email et les fonctionnalités de groupe wiki (comme action=rcg, action=statg et action=logg) pour les groupes de wikis.