VELA Logo Compteur d'accès et horloge VELA Logo

Texte librement adapté du mode d'emploi du compteur WWWCOUNT développé par Muhammad A. Muquit.

Sommaire

  1. Introduction
  2. Caractéristiques
  3. Styles de chiffres
  4. Comment appeler le compteur ?
  5. Les options du compteur
  6. Messages d'erreurs

1. Introduction

Le serveur VELA offre la possibilité de compter le nombre d'accès (de l'extérieur du site) à des pages choisies.  Ceci se fait par l'intermédiaire d'un sous-programme "compteur" qui génère en temps réel une image GIF de la valeur enregistrée, image affichable telle quelle par le client WEB.  De nombreuses options permettent de contrôler le format de cet affichage (publique/restreint, types et couleurs de chiffres, etc).

2. Caractéristiques


3. Styles de chiffres

les styles disponibles sont :

Style A styleA
Style B styleB
Style C styleC
Style D styleD
Style E styleE

Le choix d'un style se fait en donnant son nom comme argument de l'option "dd=".

4. Comment appeler le compteur ?

Par l'instruction suivante :

<IMG SRC="/cgi-bin/Count.cgi?option=argument[|option=argument]">

La chaîne de caractères comprise entre guillemets ne peut être coupée d'aucune façon : ni blanc, ni saut de ligne.  Le texte suivant le point d'interrogation est appelé "REQUETE" et peut contenir plusieurs options, séparées soit par "|", soit par "&" (les deux peuvent coexister).  Par exemple :

<IMG SRC="/cgi-bin/Count.cgi?ft=8&frgb=gold|df=file.dat">

L'ordre des options n'a pas d'importance, pas plus que la présence ou non de majuscules.

Pour que le compteur "compte", il lui faut au minimum l'option df=file.dat, avec file.dat le nom d'un fichier où il comptabilisera tous les appels de l'instruction précitée.  Ce fichier doit être ouvert par l'administrateur car son emplacement est imposé par le programme.  Bien entendu, des compteurs différents auront des fichiers différents : évitons les confusions!  Une page locale (accès restreint) affiche l'état de tous les compteurs actifs.

Remarques importantes :

5. Les options du compteur

Option Usage Description Défaut
display=C Choix du type d'affichage. Sélectionne l'affichage du compteur, du calendrier ou de l'horloge.  L'argument C a pour valeurs counter, date ou clock. display=counter
dd=C Choix du style de chiffres. Cinq styles de chiffres sont disponibles, l'argument C prenant les valeurs respectives A, B, C, D ou E. dd=A
timezone=C Choix du fuseau horaire. Cette option n'a de signification qu'en présence de l'option display=clock ou display=date.  Elle permet d'afficher l'heure ou la date d'un autre fuseau horaire.  L'argument C a pour forme GMT±HHMM avec HHMM un décalage horaire.
Ce programme n'est pas capable de gérer le changement "heure d'été/heure d'hiver"...
Aucun.
tformat=N Choix du format de l'horloge. Deux types de formats : par 12 ou 24h selon les valeurs respectives de N.  L'option n'a pas de signification en l'absence de display=clock. tformat=12
dformat=C Choix du format de la date. Format obtenu par combinaison des codes DD : jour, MM : mois et YY : année.  L'argument C est donc une chaîne de 6 caractères.  L'option n'a pas de signification en l'absence de display=date. dformat=MMDDYY
ft=N Epaisseur du cadre. On peut entourer le compteur d'un cadre de N pixels d'épaisseur.  Utilisez 0 pour supprimer le cadre.  L'aspect 3D apparait pour des valeurs de N supérieures à 5. ft=6
frgb=C Couleur du cadre. Spécifie la couleur du cadre dans un des formats C suivants :
  • R;G;B, avec R, G et B les valeurs décimales, comprises entre 0 et 255, des composantes rouge, verte (Green) et bleue de la couleur.
  • RRGGBB, avec RR, GG et BB les valeurs hexadécimales (00 à FF) de ces composantes.
  • Couleur, ou Couleur est une des couleurs standard de la base de couleurs RGB.
frgb=648BD8
(100;139;216)
tr=B Rend la couleur noire "transparente". Le "noir" de l'image du compteur sera "invisible" si l'argument logique B est vrai : valeurs Y, T ou 1.
Pour rendre une autre couleur "invisible", utilisez l'option "trgb="Remarque :il ne peut y avoir qu'une seule couleur transparente : l'option "trgb=" annule l'option présente...
tr=F
trgb=C Choix d'une couleur "transparente". Spécifie la couleur à rendre "invisible" dans un des formats C suivants :
  • R;G;B, avec R, G et B les valeurs décimales, comprises entre 0 et 255, des composantes rouge, verte (Green) et bleue de la couleur.
  • RRGGBB, avec RR, GG et BB les valeurs hexadécimales (00 à FF) de ces composantes.
  • Couleur, ou Couleur est une des couleurs standard de la base de couleurs RGB.
Aucune.
md=N Nombre (maximum) de chiffres affichés. Spécifie le nombre de chiffres à afficher.  Valeurs permises : de 5 à 10.  Des zéros rempliront les cases vides sauf instruction contraire (voir l'option "pad=").  Si la valeur du compte dépasse les capacités de l'affichage, seuls les N derniers chiffres seront affichés. md=6
pad=B Autorise le remplissage par des zéros. L'autorisation de complèter l'affichage du compteur par des zéros est donnée par la valeur de l'argument logique B : Y,T,1 ou N,F,0. pad=T
srgb=C1
&
prgb=C2
Remplacement d'une couleur. Cette option permet de modifier une couleur de l'affichage.  La couleur à remplacer est donnée par l'argument de srgb, et la couleur remplaçante, par celui de prgbC1 et C2 s'écrivent dans un des formats suivants :
  • R;G;B, avec R, G et B les valeurs décimales, comprises entre 0 et 255, des composantes rouge, verte (Green) et bleue de la couleur.
  • RRGGBB, avec RR, GG et BB les valeurs hexadécimales (00 à FF) de ces composantes.
  • Couleur, ou Couleur est une des couleurs standard de la base de couleurs RGB.
srgb=00FF00
(0;255;0 green)

prgb=00FFFF
(0;255;255 cyan)
chcolor=B Change la couleur "verte" en "cyan". La couleur "verte" de l'image du compteur sera remplacée par du "cyan" si l'argument logique B est vrai : valeurs Y, T ou 1.
C'est un raccourci pour la double option précédente.
chcolor=F
sh=B Autorise l'affichage du compteur. L'autorisation d'afficher le compteur est donnée par la valeur de l'argument logique B : Y,T,1 ou N,F,0.
  • B vrai (valeur par défaut) : le compteur est affiché.
  • B faux : l'image du compteur est remplacée par une image GIF transparente de taille 1x1, invisible.
    Les accès continuent à être comptés.
sh=T
df=F Spécifie le fichier d'enregistrement des accès. Le fichier F, obligatoirement crée et installé par l'administrateur, contiendra, sous format entier, le nombre d'appels du/des compteur(s) se référant à ce fichier.  En l'absence de l'option, une valeur aléatoire est affichée. df=random
incr=B Autorise le comptage des accès. L'autorisation de compter l'accès est donnée par la valeur de l'argument logique B : Y,T,1 ou N,F,0.
Une valeur fausse permet d'afficher et d'examiner le compte sans le modifier.
incr=T
negate=B Inverse les couleurs. Les couleurs du compteur (à l'exception du cadre) seront inversées si l'argument logique B est vrai : valeurs Y, T ou 1. negate=F
degrees=N Rotation de N°. Permet de tourner le compteur par pas de 90° dans le sens horlogique. Valeurs permises : 90, 180 et 270. degrees=0
rotate=B Rotation de 270°. Le compteur sera tourné de 270° si l'argument logique B est vrai : valeurs Y, T ou 1. rotate=F


6. Messages d'erreur.

En cas de problème, le compteur retournera des messages d'erreur sous la forme d'images de texte qui s'afficheront en lieu et place du compte attendu.


Information VELA
hyperion@astro.ulg.ac.be