Accueil du site > Horloges > Le plugin SPIP FreeClock 1.0

Le plugin SPIP FreeClock 1.0

Une horloge qui cause

samedi 9 juin 2012, par Franck Ruzzin

FreeClock est une horloge écrite en actionscript très facile à intégrer.
On a la possibilité de placer plusieurs horloges dans une page, chacune indiquant l’heure d’un lieu différent.
On dispose d’un modèle et aussi d’une balise.
Le réglage des paramètres de chaque occurrence est enfantin...

L’horloge FreeClock permet d’afficher l’heure courante d’un lieu.
Vous choisissez

- le lieu, grâce au paramètre zone (voir plus bas), la valeur par défaut est "Paris"
- le texte à afficher juste en dessus de l’horloge, la valeur par défaut est la valeur du paramètre zone
- si l’heure doit être annoncée, et dans l’affirmative si c’est toutes les heures, demi-heure ou quarts d’heure, la valeur par défaut est 4 (tous les quarts d’heure)

Exemples :

freeclock1

Alternative content

Get Adobe Flash player

freeclock2

Alternative content

Get Adobe Flash player

freeclock3

Alternative content

Get Adobe Flash player

Un clic sur le fond de l’horloge déclenche la lecture de l’heure.

I) Implantation du plugin

1) Installation classique :

Extraire le contenu de l’archive freeclock-spip-1-0.zip, dans le dossier plugins de votre installation SPIP.
L’activer via l’administration des plugins. (Consulter la documentation officielle pour plus de détails.)

2) Installation automatique :

Créer un sous-dossier /plugins/auto pour permettre l’installation automatique de plugins. Il suffit ensuite d’indiquer l’URL du fichier zip du plugin et de suivre les indications du système (l’installation automatique est disponible à partir de SPIP 2.0).
Pour le plugin freeclock-spip-1-0, l’URL à indiquer est : http://lededansdubocal.net/IMG/zip/freeclock-spip-1-0.zip

Dans ce plugin, on utilise l’utilitaire javascript d’installation d’objet Flash swfobject 2.2. S’il n’est pas installé, le plus simple est d’installer Le plugin SPIP SWFObject 2.2 disponible à l’adresse http://lededansdubocal.net/Le-plugin-SPIP-SWFObject-2-2.html

II - Le modèle mod_freeclock

Lorsque le plugin est activé, on dispose du modèle mod_freeclock (à écrire dans un champ) pour implanter une horloge FreeClock.

La syntaxe complète est :

<mod_freeclockxxx -> ou xxx est l'id que l'on souhaite donner à l'horloge
|zone= lieu dont souhaite afficher l'heure. Défaut -> Paris
|carillon=0, 1, 2 ou 4. Lecture automatique de l'heure. Défaut -> 4 (fois par heure)
|texte=texte à afficher en dessus de l'horloge. Défaut ->  valeur du paramètre zone
|right ou left ou center>

Par exemple :

<mod_freeclock10
|zone=Havana
|carillon=1
|texte=La Havane (Cuba)
|align=right>

Insère une horloge FreeClock : id=10, zone horaire de la Havane, carillon toutes les heures, texte La Havane (Cuba), flottant à droite

La syntaxe minimale est :

<mod_freeclock|>
qui insère une horloge avec comme identifiant id=freeclock

III) La balise #FREECLOCK

Lorsque le plugin est activé, on dispose de la balise #FREECLOCK (à insérer dans un squelette) pour implanter une horloge FreeClock.

Les paramètres suivant permettent de modifier le comportement par défaut :

#FREECLOCK{id=iii} identifiant de l'horloge. défaut : freeclock.
#FREECLOCK{zone=zzz} zone horaire à afficher (voir dans la documentation les valeurs possibles). défaut : Paris.
#FREECLOCK{carillon=c} lecture de l'heure. 0 -> jamais, 1 -> toutes les heures, 2 -> toutes les 1/2 heures, 4 -> tous les 1/4 heures. défaut : 4.
#FREECLOCK{texte=ttt} le texte à afficher au dessus de l'horloge. Par défaut, c'est la valeur de zone.
#FREECLOCK{align=left ou right ou center} pour positionner l'horloge à gauche, à droite ou au centre.

Par exemple :

[(#FREECLOCK{id=10}{zone=Havana}{carillon=1}{texte=La Havane (Cuba)}{align=right})]
ou
[(#FREECLOCK{id=10,zone=Havana,carillon=1,texte=La Havane (Cuba),align=right})]

Insère une horloge FreeClock : id=10, zone horaire de la Havane, carillon toutes les heures, texte La Havane (Cuba), flottant à droite

La syntaxe minimale est :

#FREECLOCK
qui insère une horloge avec comme identifiant id=freeclock
Les valeurs possibles pour les paramètres zone, carillon et texte sont expliquées ci-dessous.


IV) Le paramètre zone

Le paramètre zone peut être un nombre indiquant la valeur du décalage horaire par rapport au temps GMT, mais peut aussi être une chaîne de caractères.
Si on choisit une ville comme valeur pour le paramètre zone alors l’horloge tiendra compte des changements d’horaire été/hiver.
Le paramètre zone est insensible à la casse. Voici les villes prisent en charge par le plugin.

Villes
Addis Ababa Guatemala Nassau *
Adelaide Halifax * New Delhi
Aden Hanoi New Orleans *
Algiers Harare New York *
Almaty Havana * Oslo *
Amman * Helsinki * Ottawa *
Amsterdam * Hong Kong Paris *
Anadyr * Honolulu Perth
Anchorage * Houston * Philadelphia *
Ankara * Indianapolis * Phoenix
Antananarivo Islamabad Prague *
Asuncion Istanbul * Reykjavik
Athens * Jakarta Rio de Janeiro
Atlanta * Jerusalem * Riyadh
Auckland Johannesburg Rome *
Baghdad Kabul San Francisco *
Bangkok Kamchatka * San Juan
Barcelona * Karachi San Salvador
Beijing Kathmandu Santiago
Beirut * Khartoum Santo Domingo
Belgrade * Kingston Sao Paulo
Berlin * Kiritimati Seattle *
Bogota Kolkata Seoul
Boston * Kuala Lumpur Shanghai
Brasilia Kuwait City Singapore
Brisbane Kyiv * Sofia *
Brussels * La Paz St. John’s *
Bucharest * Lagos St. Paul *
Budapest * Lahore Stockholm *
Buenos Aires Lima Suva
Cairo Lisbon * Sydney
Canberra London * Taipei
Cape Town Los Angeles * Tallinn *
Caracas Madrid * Tashkent
Casablanca Managua Tegucigalpa
Chatham Islands Manila Tehran *
Chicago * Melbourne Tokyo
Copenhagen * Mexico City * Toronto *
Darwin Miami * Vancouver *
Denver * Minneapolis * Vienna *
Detroit * Minsk * Vladivostok *
Dhaka Montevideo Warsaw *
Dubai Montgomery * Washington DC *
Dublin * Montreal * Winnipeg *
Edmonton * Moscow * Yangon
Frankfurt * Mumbai Zagreb *
Geneva * Nairobi Zürich *

* : Villes appliquant un changement d’horaire été/hiver
la valeur par défaut est "Paris"
Mise à jour des données : le 23/04/2010 ; Champ d’application : 2010 - 2019 ; Références : http://www.timeanddate.com/ et Une horloge pour le Couteau Suisse.

 

Les raccourcis suivants peuvent être également utilisés pour le paramètre zone, mais sont moins utiles à cause des changements été/hiver.

Raccourci Valeur Raccourci Valeur
GMT GMT + 00:00 GMT1000 GMT + 10:00
GMT0100 GMT + 01:00 GMT1100 GMT + 11:00
GMT0200 GMT + 02:00 GMT1200 GMT + 12:00
GMT0300 GMT + 03:00 GMT1300 GMT + 13:00
GMT0330 GMT + 03:30 GMT-0100 GMT - 01:00
GMT0400 GMT + 04:00 GMT-0200 GMT - 02:00
GMT0430 GMT + 04:30 GMT-0230 GMT - 02:30
GMT0500 GMT + 05:00 GMT-0300 GMT - 03:00
GMT0530 GMT + 05:30 GMT-0330 GMT - 03:30
GMT0545 GMT + 05:45 GMT-0400 GMT - 04:00
GMT0600 GMT + 06:00 GMT-0430 GMT - 04:30
GMT0630 GMT + 06:30 GMT-0500 GMT - 05:00
GMT0700 GMT + 07:00 GMT-0600 GMT - 06:00
GMT0710 GMT + 07:10 GMT-0700 GMT - 07:00
GMT0730 GMT + 07:30 GMT-0800 GMT - 08:00
GMT0800 GMT + 08:00 GMT-0900 GMT - 09:00
GMT0830 GMT + 08:30 GMT-1000 GMT - 10:00
GMT0900 GMT + 09:00 GMT-1100 GMT - 11:00
GMT0930 GMT + 09:30 GMT-1200 GMT - 12:00

 

Zones de temps :

Raccourci Libellé Continent
ACDT Australien Central Daylight Time (UTC + 10:30) Australie
ACST Australien Central Standard Time (UTC + 9:30) Australie
AEDT Australien Eastern Daylight Time or Australien Eastern Summer Time (UTC + 11) Australie
AEST Australien Eastern Standard Time (UTC + 10) Australie
AWDT Australien Western Daylight Time (UTC + 9) Australie
AWST Australien Western Standard Time (UTC + 8) Australie
CDT Central Daylight Time (UTC + 10:30) Australie
CST Central Summer Time (UTC + 10:30) Australie
CST Central Standard Time (UTC + 9:30) Australie
CXT Christmas Island Time (UTC + 7) Australie
EDT Eastern Daylight Time (UTC + 11) Australie
EST Eastern Summer Time (UTC + 11) Australie
EST Eastern Standard Time (UTC + 10) Australie
NFT Norfolk (Island) Time (UTC + 11:30) Australie
WDT Western Daylight Time (UTC + 9) Australie
WST Western Summer Time (UTC + 9) Australie
WST Western Standard Time (UTC + 8) Australie
BST British Summer Time (UTC + 1) Europe
CEDT Central European Daylight Time (UTC + 2) Europe
CEST Central European Summer Time (UTC + 2) Europe
CET Central European Time (UTC + 1) Europe
EEDT Eastern European Daylight Time (UTC + 3) Europe
EEST Eastern European Summer Time (UTC + 3) Europe
EET Eastern European Time (UTC + 2) Europe
GMT Greenwich Mean Time (UTC) Europe
IST Irish Summer Time (UTC + 1) Europe
MESZ Mitteleuroäische Sommerzeit (UTC + 2) Europe
MEZ Mitteleuropäische Zeit (UTC + 1) Europe
MSD Moscow Daylight Time (UTC + 4) Europe
MSK Moscow Standard Time (UTC + 3) Europe
UTC Coordinated Universal Time (UTC) Europe
WEDT Western European Daylight Time (UTC + 1) Europe
WEST Western European Summer Time (UTC + 1) Europe
WET Western European Time (UTC) Europe
ADT Atlantic Daylight Time (UTC - 3) Amérique du nord
AKDT Alaska Daylight Time (UTC - 8) Amérique du nord
AKST Alaska Standard Time (UTC - 9) Amérique du nord
AST Atlantic Standard Time (UTC - 4) Amérique du nord
CDT Central Daylight Time (UTC - 5) Amérique du nord
CST Central Standard Time (UTC - 6) Amérique du nord
EDT Eastern Daylight Time (UTC - 4) Amérique du nord
EST Eastern Standard Time (UTC - 5) Amérique du nord
HAA Heure Avancée de l’Atlantique (UTC - 3) Amérique du nord
HAC Heure Avancée du Centre (UTC - 5) Amérique du nord
HADT Hawaii-Aleutian Daylight Time (UTC - 9) Amérique du nord
HAE Heure Avancée de l’Est (UTC - 4) Amérique du nord
HAP Heure Avancée du Pacifique (UTC - 7) Amérique du nord
HAR Heure Avancée des Rocheuses (UTC - 6) Amérique du nord
HAST Hawaii-Aleutian Standard Time (UTC - 10) Amérique du nord
HAT Heure Avancée de Terre-Neuve (UTC - 2:30) Amérique du nord
HAY Heure Avancée du Yukon (UTC - 8) Amérique du nord
HNA Heure Normale de l’Atlantique (UTC - 4) Amérique du nord
HNC Heure Normale du Centre (UTC - 6) Amérique du nord
HNE Heure Normale de l’Est (UTC - 5) Amérique du nord
HNP Heure Normale du Pacifique (UTC - 8) Amérique du nord
HNR Heure Normale des Rocheuses (UTC - 7) Amérique du nord
HNT Heure Normale de Terre-Neuve (UTC - 3:30) Amérique du nord
HNY Heure Normale du Yukon (UTC - 9) Amérique du nord
HST Hawaii Standard Time (UTC - 10) Amérique du nord
MDT Mountain Daylight Time (UTC - 6) Amérique du nord
MST Mountain Standard Time (UTC - 7) Amérique du nord
NDT Newfoundland Daylight Time (UTC - 2:30) Amérique du nord
NST Newfoundland Standard Time (UTC - 3:30) Amérique du nord
PDT Pacific Daylight Time (UTC - 7) Amérique du nord
PST Pacific Standard Time (UTC - 8) Amérique du nord


V) Le paramètre carillon

Le paramètre carillon permet d’indiquer à l’horloge si l’heure doit être annoncée, et la fréquence de l’annonce.
Le paramètre carillon accepte les valeurs 0, 1, 2 et 4.
Si la valeur est :
- 0 : l’horloge n’annonce pas d’heure
- 1 : l’horloge annonce les heures
- 2 : l’horloge annonce l’heure toutes les demi heures
- 4 : l’horloge annonce l’heure tous les quart d’heures
- x (autre valeur) : l’horloge n’annonce pas d’heure

VI) Le paramètre texte

La valeur fixée grâce au paramètre texte sera affichée juste en dessus de l’horloge. Si le texte est plus large que l’écran de l’horloge alors il défilera une fois pour apparaître dans son intégralité, puis s’arrêtera.
La valeur par défaut est la valeur du paramètre zone.

 

 

Creative Commons License Le plugin FreeClock est mis à disposition selon les termes de la licence Creative Commons Paternité-Partage des Conditions Initiales à l’Identique 2.0 France.

Documents joints

2 Messages de forum

Répondre à cet article