Easy Timer

Easy Timer vous permet d'insérer facilement dans les articles, pages et widgets de votre site Web un nombre illimité de compteurs de temps restant/passé qui se réactualisent toutes les secondes, ainsi que l'heure ou la date. Chaque compteur de temps restant indique le temps restant avant la date que vous avez choisie, et, si vous le souhaitez, révèle un contenu caché lorsque cette date est atteinte. Chaque compteur de temps passé indique le temps passé depuis la date que vous avez choisie ou le temps passé par l'internaute sur la page.

Easy Timer vous permet également de programmer une modification automatique de contenu.

WordPress Télécharger

Sommaire

  1. Installation
  2. Mise à Jour
  3. Compteurs de Temps Restant [+]
    1. L'Attribut filter
    2. Affichage du Temps Restant
    3. Substitution Automatique de Contenu
    4. Succession de Compteurs
    5. Compteurs Périodiques
    6. Dates Relatives
  4. Compteurs de Temps Passé [+]
    1. L'Attribut filter
    2. Affichage du Temps Passé
    3. Substitution Automatique de Contenu
    4. Succession de Compteurs
    5. Chronomètres
    6. Dates Relatives
  5. Compteurs de Temps Passé et Restant [+]
    1. L'Attribut filter
    2. Affichage des Temps Passé et Restant
    3. Succession de Compteurs
    4. Compteurs Périodiques
    5. Dates Relatives
  6. Heure et Date [+]
    1. Heure
    2. Année
    3. Année et Semaine ISO 8601
    4. Jour de l'Année
    5. Mois
    6. Jour du Mois
    7. Jour de la Semaine
    8. L'Attribut filter
  7. Fuseau Horaire [+]
    1. L'Attribut filter
  8. Affichage des Options [+]
    1. L'Attribut default
    2. L'Attribut filter
  9. Personnalisation Avancée [+]
    1. Fichiers Personnalisés
    2. Langues Personnalisées
  10. FAQ [+]
    1. Pourquoi mon compteur ne se réactualise-t-il pas toutes les secondes ?
    2. Comment puis-je utiliser des shortcodes dans mon thème WordPress ?
    3. Comment puis-je utiliser des shortcodes dans les commentaires ?
    4. Comment puis-je utiliser des shortcodes dans les attributs des shortcodes ?
    5. Comment puis-je imbriquer plusieurs shortcodes identiques ?

1. Installation

Vous pouvez installer Easy Timer via la page Ajouter des extensions du menu Extensions de WordPress (Extensions => Ajouter => Mettre une extension en ligne). Envoyez le fichier du plugin sans le dézipper. Vous pouvez aussi l'installer comme ceci :

  1. Dézippez le fichier du plugin.
  2. Uploadez via votre logiciel FTP le dossier easy-timer, et uniquement ce dossier, dans le répertoire des plugins de votre site Web (ce devrait être wp-content/plugins).

Lorsque vous avez installé Easy Timer :

  1. Activez le plugin via le menu Extensions de WordPress.
  2. Configurez le plugin via la page d'options d'Easy Timer.

2. Mise à Jour

Mettre à jour Easy Timer ne vous fait perdre aucun réglage, ni aucune donnée.

Vous pouvez mettre à jour Easy Timer via le menu Extensions de WordPress, et via la page Mises à jour de WordPress du menu Tableau de bord de WordPress (Tableau de bord => Mises à jour). Vous pouvez aussi le mettre à jour comme ceci :

  1. Dézippez le fichier du plugin.
  2. Uploadez via votre logiciel FTP le dossier easy-timer, et uniquement ce dossier, dans le répertoire des plugins de votre site Web (ce devrait être wp-content/plugins), sans supprimer le dossier easy-timer déjà présent dans ce répertoire.

Vous n'avez pas besoin de désactiver puis réactiver le plugin.

3. Compteurs de Temps Restant

Pour afficher un compteur de temps restant, insérez dans vos articles/pages/widgets un code comme celui-ci :

[countdown date=AAAA/MM/JJ-hh:mm:ss]
Plus que [timer] avant que ce film sorte au cinéma !
[/countdown]

AAAA = année
MM = mois (de 1 à 12)
JJ = jour du mois (de 1 à 31)
hh = heures
mm = minutes
ss = secondes

Dans certains cas, vous pouvez indiquer la date plus simplement :

  • AAAA/MM/JJ est équivalent à AAAA/MM/JJ-00:00:00
  • AAAA/MM/JJ-hh est équivalent à AAAA/MM/JJ-hh:00:00
  • AAAA/MM/JJ-hh:mm est équivalent à AAAA/MM/JJ-hh:mm:00

La date doit être indiquée suivant le fuseau horaire de votre site Web. Pensez à régler correctement votre fuseau horaire via l'interface d'administration de WordPress si vous ne l'avez pas fait. Vous pouvez ponctuellement spécifier un décalage par rapport au temps UTC différent de celui de votre fuseau horaire en utilisant l'attribut offset :

[countdown date=AAAA/MM/JJ-hh:mm:ss offset=x]
Plus que [timer] avant que ce film sorte au cinéma !
[/countdown]

L'attribut offset est le décalage (en heures) par rapport au temps UTC. Vous pouvez entrer n'importe quel nombre relatif pour cet attribut. Dans certains pays, le décalage par rapport au temps UTC n'est pas constant, ce qui peut fausser le calcul du temps restant. Pour résoudre ce problème, vous pouvez utiliser l'attribut offset (offset=x pour chaque date en période d'heure d'hiver et offset=x+1 pour chaque date en période d'heure d'été, remplacez x par la bonne valeur numérique).

Le compteur de temps restant indique le même temps restant partout dans le monde. Lorsque la date est atteinte, le contenu entre [countdown date=AAAA/MM/JJ-hh:mm:ss] et [/countdown] disparaît. Vous pouvez mettre en forme ce contenu comme n'importe quel autre contenu de votre site Web.

Vous pouvez insérer le shortcode [timer] autant de fois que vous le souhaitez entre [countdown date=AAAA/MM/JJ-hh:mm:ss] et [/countdown]. Vous pouvez même ne pas l'insérer du tout. Dans ce cas, Easy Timer vous permet de programmer une disparition de contenu sans afficher de compteur :

[countdown date=AAAA/MM/JJ-hh:mm:ss]
Lorsque ce film sortira au cinéma, cette phrase disparaîtra !
[/countdown]

3.1 L'Attribut filter

Vous pouvez spécifier une fonction PHP qui sera appliquée au contenu avant que celui-ci soit affiché, en utilisant l'attribut filter, comme ceci :

[countdown date=AAAA/MM/JJ-hh:mm:ss filter=fonction]Contenu[/countdown]

Remplacez fonction par le nom de la fonction que vous souhaitez appliquer.

Il est possible de spécifier plusieurs fonctions PHP pour l'attribut filter, en séparant les différentes fonctions par /, comme ceci :

[countdown date=AAAA/MM/JJ-hh:mm:ss filter=fonction1/fonction2/…/fonctionN]Contenu[/countdown]

Les fonctions seront appliquées dans l'ordre indiqué.

3.2 Affichage du Temps Restant

Vous n'êtes pas limité au shortcode [timer]. Vous pouvez utiliser les shortcodes suivants :

  • [timer] pour afficher le temps restant
  • [dhmstimer] pour afficher le temps restant en jours, heures, minutes et secondes
  • [dhmtimer] pour afficher le temps restant en jours, heures et minutes
  • [dhtimer] pour afficher le temps restant en jours et heures
  • [dtimer] pour afficher le temps restant en jours
  • [hmstimer] pour afficher le temps restant en heures, minutes et secondes
  • [hmtimer] pour afficher le temps restant en heures et minutes
  • [htimer] pour afficher le temps restant en heures
  • [mstimer] pour afficher le temps restant en minutes et secondes
  • [mtimer] pour afficher le temps restant en minutes
  • [stimer] pour afficher le temps restant en secondes
  • [hmsrtimer] pour afficher seulement les heures, minutes et secondes du temps restant en jours, heures, minutes et secondes
  • [hmrtimer] pour afficher seulement les heures et minutes du temps restant en jours, heures, minutes et secondes
  • [hrtimer] pour afficher seulement les heures du temps restant en jours, heures, minutes et secondes
  • [msrtimer] pour afficher seulement les minutes et secondes du temps restant en jours, heures, minutes et secondes
  • [mrtimer] pour afficher seulement les minutes du temps restant en jours, heures, minutes et secondes
  • [srtimer] pour afficher seulement les secondes du temps restant en jours, heures, minutes et secondes

Quel que soit le shortcode utilisé, tous les compteurs afficheront :

  • les heures (et optionnellement les minutes et les secondes) restantes si le temps restant est inférieur à 1 jour
  • les minutes (et optionnellement les secondes) restantes si le temps restant est inférieur à 1 heure
  • les secondes restantes si le temps restant est inférieur à 1 minute

3.3 Substitution Automatique de Contenu

Si vous souhaitez programmer une substitution de contenu, insérez dans vos articles/pages/widgets un code comme celui-ci :

[countdown date=2018/01/01]
Plus que [timer] avant 2018 !
[after]Bonne Année 2018 ![/countdown]

Résultat (avec un peu de mise en forme, fuseau horaire = UTC) :

Plus que 96 jours 15 heures 2 minutes 20 secondes avant 2018 !

Insérez le contenu que vous souhaitez substituer entre [after] et [/countdown]. Lorsque la date est atteinte, le contenu entre [countdown date=AAAA/MM/JJ-hh:mm:ss] et [after] disparaît, et le contenu entre [after] et [/countdown] apparaît. Le contenu entre [after] et [/countdown] n'est jamais envoyé au navigateur avant cette date.

Vous pouvez insérer le shortcode [timer] autant de fois que vous le souhaitez entre [countdown date=AAAA/MM/JJ-hh:mm:ss] et [after]. Vous pouvez même ne pas l'insérer du tout. Dans ce cas, Easy Timer vous permet de programmer une substitution de contenu sans afficher de compteur :

[countdown date=2018/01/01]
Nous serons bientôt en 2018 !
[after]Bonne Année 2018 ![/countdown]

Résultat (avec un peu de mise en forme, fuseau horaire = UTC) :

Nous serons bientôt en 2018 !

3.4 Succession de Compteurs

Il est possible de spécifier plusieurs dates pour l'attribut date, en séparant les différentes dates par //, comme ceci :

[countdown date=2017/12/25//2018/01/01]
Plus que [timer] avant Noël ![after]
Plus que [timer] avant 2018 ![after]
Bonne Année 2018 ![/countdown]

Résultat (avec un peu de mise en forme, fuseau horaire = UTC) :

Plus que 89 jours 15 heures 2 minutes 20 secondes avant Noël !

Vous pouvez utiliser les shortcodes suivants :

  • [total-timer] pour afficher le temps restant avant la dernière date de l'attribut date
  • [total-dhmstimer] pour afficher le temps restant avant la dernière date de l'attribut date en jours, heures, minutes et secondes
  • [total-dhmtimer] pour afficher le temps restant avant la dernière date de l'attribut date en jours, heures et minutes
  • [total-dhtimer] pour afficher le temps restant avant la dernière date de l'attribut date en jours et heures
  • [total-dtimer] pour afficher le temps restant avant la dernière date de l'attribut date en jours
  • [total-hmstimer] pour afficher le temps restant avant la dernière date de l'attribut date en heures, minutes et secondes
  • [total-hmtimer] pour afficher le temps restant avant la dernière date de l'attribut date en heures et minutes
  • [total-htimer] pour afficher le temps restant avant la dernière date de l'attribut date en heures
  • [total-mstimer] pour afficher le temps restant avant la dernière date de l'attribut date en minutes et secondes
  • [total-mtimer] pour afficher le temps restant avant la dernière date de l'attribut date en minutes
  • [total-stimer] pour afficher le temps restant avant la dernière date de l'attribut date en secondes
  • [total-hmsrtimer] pour afficher seulement les heures, minutes et secondes du temps restant avant la dernière date de l'attribut date en jours, heures, minutes et secondes
  • [total-hmrtimer] pour afficher seulement les heures et minutes du temps restant avant la dernière date de l'attribut date en jours, heures, minutes et secondes
  • [total-hrtimer] pour afficher seulement les heures du temps restant avant la dernière date de l'attribut date en jours, heures, minutes et secondes
  • [total-msrtimer] pour afficher seulement les minutes et secondes du temps restant avant la dernière date de l'attribut date en jours, heures, minutes et secondes
  • [total-mrtimer] pour afficher seulement les minutes du temps restant avant la dernière date de l'attribut date en jours, heures, minutes et secondes
  • [total-srtimer] pour afficher seulement les secondes du temps restant avant la dernière date de l'attribut date en jours, heures, minutes et secondes

Autre exemple :

[countdown date=2017/01/01//2018/01/01//2019/01/01//2020/01/01//2021/01/01]
Plus que [timer] avant 2017 et [total-timer] avant 2021 ![after]
Plus que [timer] avant 2018 et [total-timer] avant 2021 ![after]
Plus que [timer] avant 2019 et [total-timer] avant 2021 ![after]
Plus que [timer] avant 2020 et [total-timer] avant 2021 ![after]
Plus que [timer] avant 2021 ![after]Bonne Année 2021 ![/countdown]

Résultat (avec un peu de mise en forme, fuseau horaire = UTC) :

Plus que 96 jours 15 heures 2 minutes 20 secondes avant 2018 et 1192 jours 15 heures 2 minutes 20 secondes avant 2021 !

3.5 Compteurs Périodiques

Vous pouvez afficher un compteur périodique, comme ceci :

[countdown date=AAAA/MM/JJ-hh:mm:ss period=d:h:m:s]
Plus que [timer] ![/countdown]

d = nombre de jours
h = nombre d'heures
m = nombre de minutes
s = nombre de secondes

Dans certains cas, vous pouvez indiquer la période plus simplement :

  • d est équivalent à d:0:0:0
  • d:h est équivalent à d:h:0:0
  • d:h:m est équivalent à d:h:m:0

Le compteur se répète selon une période égale à la durée spécifiée pour l'attribut period.

Exemple (compteur se répétant tous les jours) :

[countdown date=2009/09/23 period=1]
Plus que [timer] avant demain ![/countdown]

Résultat (avec un peu de mise en forme, fuseau horaire = UTC) :

Plus que 15 heures 2 minutes 20 secondes avant demain !

Autre exemple (compteur se répétant toutes les semaines) :

[countdown date=2017/01/01//2017/01/04 period=7]
Plus que [timer] avant dimanche ![after]
Plus que [timer] avant mercredi ![/countdown]

Résultat (avec un peu de mise en forme, fuseau horaire = UTC) :

Plus que 15 heures 2 minutes 20 secondes avant mercredi !

3.6 Dates Relatives

Il est possible de spécifier une date relative pour l'attribut date, comme ceci :

[countdown date=+d:h:m:s]
Plus que [timer] ![after]Compte à rebours terminé !
[/countdown]

d = nombre de jours
h = nombre d'heures
m = nombre de minutes
s = nombre de secondes

Dans certains cas, vous pouvez indiquer la durée plus simplement :

  • +d est équivalent à +d:0:0:0
  • +d:h est équivalent à +d:h:0:0
  • +d:h:m est équivalent à +d:h:m:0

La date est alors celle du premier affichage du contenu par l'internaute, augmentée de la durée spécifiée pour l'attribut date.

Exemple :

[countdown date=+0:0:2]
Plus que [timer] ![after]Compte à rebours terminé !
[/countdown]

Résultat (avec un peu de mise en forme) :

Plus que 2 minutes 0 seconde !

Grâce à l'attribut origin, vous pouvez utiliser la date du dernier affichage du contenu par l'internaute, plutôt que la date du premier affichage du contenu.

Exemple :

[countdown date=+0:18 origin=last-visit]
Plus que [timer] ![/countdown]

Résultat (avec un peu de mise en forme) :

Plus que 18 heures 0 seconde !

4. Compteurs de Temps Passé

Pour afficher un compteur de temps passé, insérez dans vos articles/pages/widgets un code comme celui-ci :

[countup date=AAAA/MM/JJ-hh:mm:ss]
Depuis [timer], ce film est sorti au cinéma !
[/countup]

AAAA = année
MM = mois (de 1 à 12)
JJ = jour du mois (de 1 à 31)
hh = heures
mm = minutes
ss = secondes

Dans certains cas, vous pouvez indiquer la date plus simplement :

  • AAAA/MM/JJ est équivalent à AAAA/MM/JJ-00:00:00
  • AAAA/MM/JJ-hh est équivalent à AAAA/MM/JJ-hh:00:00
  • AAAA/MM/JJ-hh:mm est équivalent à AAAA/MM/JJ-hh:mm:00

La date doit être indiquée suivant le fuseau horaire de votre site Web. Pensez à régler correctement votre fuseau horaire via l'interface d'administration de WordPress si vous ne l'avez pas fait. Vous pouvez ponctuellement spécifier un décalage par rapport au temps UTC différent de celui de votre fuseau horaire en utilisant l'attribut offset :

[countup date=AAAA/MM/JJ-hh:mm:ss offset=x]
Depuis [timer], ce film est sorti au cinéma !
[/countup]

L'attribut offset est le décalage (en heures) par rapport au temps UTC. Vous pouvez entrer n'importe quel nombre relatif pour cet attribut. Dans certains pays, le décalage par rapport au temps UTC n'est pas constant, ce qui peut fausser le calcul du temps passé. Pour résoudre ce problème, vous pouvez utiliser l'attribut offset (offset=x pour chaque date en période d'heure d'hiver et offset=x+1 pour chaque date en période d'heure d'été, remplacez x par la bonne valeur numérique).

Le compteur de temps passé indique le même temps passé partout dans le monde. Si la date n'est pas encore atteinte, le contenu entre [countup date=AAAA/MM/JJ-hh:mm:ss] et [/countup] n'apparaît pas. Vous pouvez mettre en forme ce contenu comme n'importe quel autre contenu de votre site Web.

Vous pouvez insérer le shortcode [timer] autant de fois que vous le souhaitez entre [countup date=AAAA/MM/JJ-hh:mm:ss] et [/countup]. Vous pouvez même ne pas l'insérer du tout. Dans ce cas, Easy Timer vous permet de programmer une apparition de contenu sans afficher de compteur :

[countup date=AAAA/MM/JJ-hh:mm:ss]
Lorsque ce film sortira au cinéma, cette phrase apparaîtra !
[/countup]

4.1 L'Attribut filter

Vous pouvez spécifier une fonction PHP qui sera appliquée au contenu avant que celui-ci soit affiché, en utilisant l'attribut filter, comme ceci :

[countup date=AAAA/MM/JJ-hh:mm:ss filter=fonction]Contenu[/countup]

Remplacez fonction par le nom de la fonction que vous souhaitez appliquer.

Il est possible de spécifier plusieurs fonctions PHP pour l'attribut filter, en séparant les différentes fonctions par /, comme ceci :

[countup date=AAAA/MM/JJ-hh:mm:ss filter=fonction1/fonction2/…/fonctionN]Contenu[/countup]

Les fonctions seront appliquées dans l'ordre indiqué.

4.2 Affichage du Temps Passé

Vous n'êtes pas limité au shortcode [timer]. Vous pouvez utiliser les shortcodes suivants :

  • [timer] pour afficher le temps passé
  • [dhmstimer] pour afficher le temps passé en jours, heures, minutes et secondes
  • [dhmtimer] pour afficher le temps passé en jours, heures et minutes
  • [dhtimer] pour afficher le temps passé en jours et heures
  • [dtimer] pour afficher le temps passé en jours
  • [hmstimer] pour afficher le temps passé en heures, minutes et secondes
  • [hmtimer] pour afficher le temps passé en heures et minutes
  • [htimer] pour afficher le temps passé en heures
  • [mstimer] pour afficher le temps passé en minutes et secondes
  • [mtimer] pour afficher le temps passé en minutes
  • [stimer] pour afficher le temps passé en secondes
  • [hmsrtimer] pour afficher seulement les heures, minutes et secondes du temps passé en jours, heures, minutes et secondes
  • [hmrtimer] pour afficher seulement les heures et minutes du temps passé en jours, heures, minutes et secondes
  • [hrtimer] pour afficher seulement les heures du temps passé en jours, heures, minutes et secondes
  • [msrtimer] pour afficher seulement les minutes et secondes du temps passé en jours, heures, minutes et secondes
  • [mrtimer] pour afficher seulement les minutes du temps passé en jours, heures, minutes et secondes
  • [srtimer] pour afficher seulement les secondes du temps passé en jours, heures, minutes et secondes

Quel que soit le shortcode utilisé, tous les compteurs afficheront :

  • les heures (et optionnellement les minutes et les secondes) passées si le temps passé est inférieur à 1 jour
  • les minutes (et optionnellement les secondes) passées si le temps passé est inférieur à 1 heure
  • les secondes passées si le temps passé est inférieur à 1 minute

4.3 Substitution Automatique de Contenu

Si vous souhaitez programmer une substitution de contenu, insérez dans vos articles/pages/widgets un code comme celui-ci :

[countup date=2017/01/01]
Depuis [timer], nous sommes en 2017 !
[before]Nous serons bientôt en 2017 ![/countup]

Résultat (avec un peu de mise en forme, fuseau horaire = UTC) :

Depuis 268 jours 8 heures 57 minutes 40 secondes, nous sommes en 2017 !

Insérez le contenu que vous souhaitez substituer entre [countup date=AAAA/MM/JJ-hh:mm:ss] et [before]. Lorsque la date est atteinte, le contenu entre [countup date=AAAA/MM/JJ-hh:mm:ss] et [before] apparaît, et le contenu entre [before] et [/countup] disparaît. Le contenu entre [before] et [/countup] n'est jamais envoyé au navigateur après cette date.

Vous pouvez insérer le shortcode [timer] autant de fois que vous le souhaitez entre [countup date=AAAA/MM/JJ-hh:mm:ss] et [before]. Vous pouvez même ne pas l'insérer du tout. Dans ce cas, Easy Timer vous permet de programmer une substitution de contenu sans afficher de compteur :

[countup date=2018/01/01]
Bonne Année 2018 ![before]
Nous serons bientôt en 2018 ![/countup]

Résultat (avec un peu de mise en forme, fuseau horaire = UTC) :

Nous serons bientôt en 2018 !

4.4 Succession de Compteurs

Il est possible de spécifier plusieurs dates pour l'attribut date, en séparant les différentes dates par //, comme ceci :

[countup date=2017/01/01//2016/12/25]
Depuis [timer], nous sommes en 2017 ![before]
Depuis [timer], Noël est arrivé ![before]
Noël arrive bientôt ![/countup]

Résultat (avec un peu de mise en forme, fuseau horaire = UTC) :

Depuis 268 jours 8 heures 57 minutes 40 secondes, nous sommes en 2017 !

Vous pouvez utiliser les shortcodes suivants :

  • [total-timer] pour afficher le temps passé depuis la dernière date de l'attribut date
  • [total-dhmstimer] pour afficher le temps passé depuis la dernière date de l'attribut date en jours, heures, minutes et secondes
  • [total-dhmtimer] pour afficher le temps passé depuis la dernière date de l'attribut date en jours, heures et minutes
  • [total-dhtimer] pour afficher le temps passé depuis la dernière date de l'attribut date en jours et heures
  • [total-dtimer] pour afficher le temps passé depuis la dernière date de l'attribut date en jours
  • [total-hmstimer] pour afficher le temps passé depuis la dernière date de l'attribut date en heures, minutes et secondes
  • [total-hmtimer] pour afficher le temps passé depuis la dernière date de l'attribut date en heures et minutes
  • [total-htimer] pour afficher le temps passé depuis la dernière date de l'attribut date en heures
  • [total-mstimer] pour afficher le temps passé depuis la dernière date de l'attribut date en minutes et secondes
  • [total-mtimer] pour afficher le temps passé depuis la dernière date de l'attribut date en minutes
  • [total-stimer] pour afficher le temps passé depuis la dernière date de l'attribut date en secondes
  • [total-hmsrtimer] pour afficher seulement les heures, minutes et secondes du temps passé depuis la dernière date de l'attribut date en jours, heures, minutes et secondes
  • [total-hmrtimer] pour afficher seulement les heures et minutes du temps passé depuis la dernière date de l'attribut date en jours, heures, minutes et secondes
  • [total-hrtimer] pour afficher seulement les heures du temps passé depuis la dernière date de l'attribut date en jours, heures, minutes et secondes
  • [total-msrtimer] pour afficher seulement les minutes et secondes du temps passé depuis la dernière date de l'attribut date en jours, heures, minutes et secondes
  • [total-mrtimer] pour afficher seulement les minutes du temps passé depuis la dernière date de l'attribut date en jours, heures, minutes et secondes
  • [total-srtimer] pour afficher seulement les secondes du temps passé depuis la dernière date de l'attribut date en jours, heures, minutes et secondes

Autre exemple :

[countup date=2020/01/01//2019/01/01//2018/01/01//2017/01/01//2016/01/01]
Depuis [timer], nous sommes en 2020 et depuis [total-timer], 2016 est arrivé ![before]
Depuis [timer], nous sommes en 2019 et depuis [total-timer], 2016 est arrivé ![before]
Depuis [timer], nous sommes en 2018 et depuis [total-timer], 2016 est arrivé ![before]
Depuis [timer], nous sommes en 2017 et depuis [total-timer], 2016 est arrivé ![before]
Depuis [timer], nous sommes en 2016 ![before]Nous serons bientôt en 2016 ![/countup]

Résultat (avec un peu de mise en forme, fuseau horaire = UTC) :

Depuis 268 jours 8 heures 57 minutes 40 secondes, nous sommes en 2017 et depuis 634 jours 8 heures 57 minutes 40 secondes, 2016 est arrivé !

4.5 Chronomètres

Pour afficher un chronomètre, insérez dans vos articles/pages/widgets un code comme celui-ci :

[countup]Vous avez passé [timer] sur cette page Web.[/countup]

Résultat :

Vous avez passé 0 seconde sur cette page Web.

Pour afficher un chronomètre qui commence à une durée de n secondes (n entier naturel), insérez dans vos articles/pages/widgets un code comme celui-ci :

[countup date=n]Temps total : [timer][/countup]

Résultat (avec n=55) :

Temps total : 55 secondes

Pour afficher un chronomètre qui commence à une durée de m minutes et n secondes (m et n entiers naturels), insérez dans vos articles/pages/widgets un code comme celui-ci :

[countup date=m:n]Temps total : [timer][/countup]

Résultat (avec m=5 et n=8) :

Temps total : 5 minutes 8 secondes

4.6 Dates Relatives

Il est possible de spécifier une date relative pour l'attribut date, comme ceci :

[countup date=-d:h:m:s]Temps total : [timer][/countup]

d = nombre de jours
h = nombre d'heures
m = nombre de minutes
s = nombre de secondes

Dans certains cas, vous pouvez indiquer la durée plus simplement :

  • -d est équivalent à -d:0:0:0
  • -d:h est équivalent à -d:h:0:0
  • -d:h:m est équivalent à -d:h:m:0

La date est alors celle du premier affichage du contenu par l'internaute, diminuée de la durée spécifiée pour l'attribut date.

Exemple :

[countup date=-0]
Temps écoulé depuis votre première consultation de cette page : [timer]
[/countup]

Résultat (avec un peu de mise en forme) :

Temps écoulé depuis votre première consultation de cette page : 0 seconde

Grâce à l'attribut origin, vous pouvez utiliser la date du dernier affichage du contenu par l'internaute, plutôt que la date du premier affichage du contenu.

Exemple :

[countup date=-0 origin=last-visit]
Temps écoulé depuis votre dernière consultation de cette page : [timer]
[/countup]

Résultat (avec un peu de mise en forme) :

Temps écoulé depuis votre dernière consultation de cette page : 0 seconde

5. Compteurs de Temps Passé et Restant

Pour afficher un compteur de temps passé et restant, insérez dans vos articles/pages/widgets un code comme celui-ci :

[counter date=AAAA/MM/JJ-hh:mm:ss]
Plus que [remaining-timer] avant que ce film sorte au cinéma !
[after]Depuis [elapsed-timer], ce film est sorti au cinéma ![/counter]

AAAA = année
MM = mois (de 1 à 12)
JJ = jour du mois (de 1 à 31)
hh = heures
mm = minutes
ss = secondes

Dans certains cas, vous pouvez indiquer la date plus simplement :

  • AAAA/MM/JJ est équivalent à AAAA/MM/JJ-00:00:00
  • AAAA/MM/JJ-hh est équivalent à AAAA/MM/JJ-hh:00:00
  • AAAA/MM/JJ-hh:mm est équivalent à AAAA/MM/JJ-hh:mm:00

La date doit être indiquée suivant le fuseau horaire de votre site Web. Pensez à régler correctement votre fuseau horaire via l'interface d'administration de WordPress si vous ne l'avez pas fait. Vous pouvez ponctuellement spécifier un décalage par rapport au temps UTC différent de celui de votre fuseau horaire en utilisant l'attribut offset :

[counter date=AAAA/MM/JJ-hh:mm:ss offset=x]
Plus que [remaining-timer] avant que ce film sorte au cinéma !
[after]Depuis [elapsed-timer], ce film est sorti au cinéma ![/counter]

L'attribut offset est le décalage (en heures) par rapport au temps UTC. Vous pouvez entrer n'importe quel nombre relatif pour cet attribut. Dans certains pays, le décalage par rapport au temps UTC n'est pas constant, ce qui peut fausser le calcul du temps restant. Pour résoudre ce problème, vous pouvez utiliser l'attribut offset (offset=x pour chaque date en période d'heure d'hiver et offset=x+1 pour chaque date en période d'heure d'été, remplacez x par la bonne valeur numérique).

Le compteur de temps passé et restant indique les mêmes temps passé et restant partout dans le monde. Lorsque la date est atteinte, le contenu entre [counter date=AAAA/MM/JJ-hh:mm:ss] et [after] disparaît, et le contenu entre [after] et [/counter] apparaît. Le contenu entre [after] et [/counter] n'est jamais envoyé au navigateur avant cette date.

Vous pouvez insérer les shortcodes [elapsed-timer] et [remaining-timer] autant de fois que vous le souhaitez entre [counter date=AAAA/MM/JJ-hh:mm:ss] et [/counter]. Vous pouvez même ne pas les insérer du tout. Dans ce cas, Easy Timer vous permet de programmer une substitution de contenu sans afficher de compteur :

[counter date=2018/01/01]
Nous serons bientôt en 2018 !
[after]Bonne Année 2018 ![/counter]

Résultat (avec un peu de mise en forme, fuseau horaire = UTC) :

Nous serons bientôt en 2018 !

5.1 L'Attribut filter

Vous pouvez spécifier une fonction PHP qui sera appliquée au contenu avant que celui-ci soit affiché, en utilisant l'attribut filter, comme ceci :

[counter date=AAAA/MM/JJ-hh:mm:ss filter=fonction]
Contenu 1[after]Contenu 2[/counter]

Remplacez fonction par le nom de la fonction que vous souhaitez appliquer.

Il est possible de spécifier plusieurs fonctions PHP pour l'attribut filter, en séparant les différentes fonctions par /, comme ceci :

[counter date=AAAA/MM/JJ-hh:mm:ss filter=fonction1/fonction2/…/fonctionN]
Contenu 1[after]Contenu 2[/counter]

Les fonctions seront appliquées dans l'ordre indiqué.

5.2 Affichage des Temps Passé et Restant

Vous n'êtes pas limité aux shortcodes [elapsed-timer] et [remaining-timer]. Vous pouvez utiliser les shortcodes suivants :

  • [timer] pour afficher le temps passé
  • [dhmstimer] pour afficher le temps passé en jours, heures, minutes et secondes
  • [dhmtimer] pour afficher le temps passé en jours, heures et minutes
  • [dhtimer] pour afficher le temps passé en jours et heures
  • [dtimer] pour afficher le temps passé en jours
  • [hmstimer] pour afficher le temps passé en heures, minutes et secondes
  • [hmtimer] pour afficher le temps passé en heures et minutes
  • [htimer] pour afficher le temps passé en heures
  • [mstimer] pour afficher le temps passé en minutes et secondes
  • [mtimer] pour afficher le temps passé en minutes
  • [stimer] pour afficher le temps passé en secondes
  • [hmsrtimer] pour afficher seulement les heures, minutes et secondes du temps passé en jours, heures, minutes et secondes
  • [hmrtimer] pour afficher seulement les heures et minutes du temps passé en jours, heures, minutes et secondes
  • [hrtimer] pour afficher seulement les heures du temps passé en jours, heures, minutes et secondes
  • [msrtimer] pour afficher seulement les minutes et secondes du temps passé en jours, heures, minutes et secondes
  • [mrtimer] pour afficher seulement les minutes du temps passé en jours, heures, minutes et secondes
  • [srtimer] pour afficher seulement les secondes du temps passé en jours, heures, minutes et secondes
  • [elapsed-timer] pour afficher le temps passé
  • [elapsed-dhmstimer] pour afficher le temps passé en jours, heures, minutes et secondes
  • [elapsed-dhmtimer] pour afficher le temps passé en jours, heures et minutes
  • [elapsed-dhtimer] pour afficher le temps passé en jours et heures
  • [elapsed-dtimer] pour afficher le temps passé en jours
  • [elapsed-hmstimer] pour afficher le temps passé en heures, minutes et secondes
  • [elapsed-hmtimer] pour afficher le temps passé en heures et minutes
  • [elapsed-htimer] pour afficher le temps passé en heures
  • [elapsed-mstimer] pour afficher le temps passé en minutes et secondes
  • [elapsed-mtimer] pour afficher le temps passé en minutes
  • [elapsed-stimer] pour afficher le temps passé en secondes
  • [elapsed-hmsrtimer] pour afficher seulement les heures, minutes et secondes du temps passé en jours, heures, minutes et secondes
  • [elapsed-hmrtimer] pour afficher seulement les heures et minutes du temps passé en jours, heures, minutes et secondes
  • [elapsed-hrtimer] pour afficher seulement les heures du temps passé en jours, heures, minutes et secondes
  • [elapsed-msrtimer] pour afficher seulement les minutes et secondes du temps passé en jours, heures, minutes et secondes
  • [elapsed-mrtimer] pour afficher seulement les minutes du temps passé en jours, heures, minutes et secondes
  • [elapsed-srtimer] pour afficher seulement les secondes du temps passé en jours, heures, minutes et secondes
  • [remaining-timer] pour afficher le temps restant
  • [remaining-dhmstimer] pour afficher le temps restant en jours, heures, minutes et secondes
  • [remaining-dhmtimer] pour afficher le temps restant en jours, heures et minutes
  • [remaining-dhtimer] pour afficher le temps restant en jours et heures
  • [remaining-dtimer] pour afficher le temps restant en jours
  • [remaining-hmstimer] pour afficher le temps restant en heures, minutes et secondes
  • [remaining-hmtimer] pour afficher le temps restant en heures et minutes
  • [remaining-htimer] pour afficher le temps restant en heures
  • [remaining-mstimer] pour afficher le temps restant en minutes et secondes
  • [remaining-mtimer] pour afficher le temps restant en minutes
  • [remaining-stimer] pour afficher le temps restant en secondes
  • [remaining-hmsrtimer] pour afficher seulement les heures, minutes et secondes du temps restant en jours, heures, minutes et secondes
  • [remaining-hmrtimer] pour afficher seulement les heures et minutes du temps restant en jours, heures, minutes et secondes
  • [remaining-hrtimer] pour afficher seulement les heures du temps restant en jours, heures, minutes et secondes
  • [remaining-msrtimer] pour afficher seulement les minutes et secondes du temps restant en jours, heures, minutes et secondes
  • [remaining-mrtimer] pour afficher seulement les minutes du temps restant en jours, heures, minutes et secondes
  • [remaining-srtimer] pour afficher seulement les secondes du temps restant en jours, heures, minutes et secondes

Quel que soit le shortcode utilisé, tous les compteurs afficheront :

  • les heures (et optionnellement les minutes et les secondes) passées/restantes si le temps passé/restant est inférieur à 1 jour
  • les minutes (et optionnellement les secondes) passées/restantes si le temps passé/restant est inférieur à 1 heure
  • les secondes passées/restantes si le temps passé/restant est inférieur à 1 minute

5.3 Succession de Compteurs

Il est possible de spécifier plusieurs dates pour l'attribut date, en séparant les différentes dates par //, comme ceci :

[counter date=2016/12/25//2017/01/01]
Plus que [remaining-timer] avant Noël ![after]
Depuis [elapsed-timer], Noël est arrivé !
Plus que [remaining-timer] avant 2017 ![after]
Depuis [elapsed-timer], nous sommes en 2017 ![/counter]

Résultat (avec un peu de mise en forme, fuseau horaire = UTC) :

Depuis 268 jours 8 heures 57 minutes 40 secondes, nous sommes en 2017 !

Vous pouvez utiliser les shortcodes suivants :

  • [total-timer] pour afficher le temps passé depuis la première date de l'attribut date
  • [total-dhmstimer] pour afficher le temps passé depuis la première date de l'attribut date en jours, heures, minutes et secondes
  • [total-dhmtimer] pour afficher le temps passé depuis la première date de l'attribut date en jours, heures et minutes
  • [total-dhtimer] pour afficher le temps passé depuis la première date de l'attribut date en jours et heures
  • [total-dtimer] pour afficher le temps passé depuis la première date de l'attribut date en jours
  • [total-hmstimer] pour afficher le temps passé depuis la première date de l'attribut date en heures, minutes et secondes
  • [total-hmtimer] pour afficher le temps passé depuis la première date de l'attribut date en heures et minutes
  • [total-htimer] pour afficher le temps passé depuis la première date de l'attribut date en heures
  • [total-mstimer] pour afficher le temps passé depuis la première date de l'attribut date en minutes et secondes
  • [total-mtimer] pour afficher le temps passé depuis la première date de l'attribut date en minutes
  • [total-stimer] pour afficher le temps passé depuis la première date de l'attribut date en secondes
  • [total-hmsrtimer] pour afficher seulement les heures, minutes et secondes du temps passé depuis la première date de l'attribut date en jours, heures, minutes et secondes
  • [total-hmrtimer] pour afficher seulement les heures et minutes du temps passé depuis la première date de l'attribut date en jours, heures, minutes et secondes
  • [total-hrtimer] pour afficher seulement les heures du temps passé depuis la première date de l'attribut date en jours, heures, minutes et secondes
  • [total-msrtimer] pour afficher seulement les minutes et secondes du temps passé depuis la première date de l'attribut date en jours, heures, minutes et secondes
  • [total-mrtimer] pour afficher seulement les minutes du temps passé depuis la première date de l'attribut date en jours, heures, minutes et secondes
  • [total-srtimer] pour afficher seulement les secondes du temps passé depuis la première date de l'attribut date en jours, heures, minutes et secondes
  • [total-elapsed-timer] pour afficher le temps passé depuis la première date de l'attribut date
  • [total-elapsed-dhmstimer] pour afficher le temps passé depuis la première date de l'attribut date en jours, heures, minutes et secondes
  • [total-elapsed-dhmtimer] pour afficher le temps passé depuis la première date de l'attribut date en jours, heures et minutes
  • [total-elapsed-dhtimer] pour afficher le temps passé depuis la première date de l'attribut date en jours et heures
  • [total-elapsed-dtimer] pour afficher le temps passé depuis la première date de l'attribut date en jours
  • [total-elapsed-hmstimer] pour afficher le temps passé depuis la première date de l'attribut date en heures, minutes et secondes
  • [total-elapsed-hmtimer] pour afficher le temps passé depuis la première date de l'attribut date en heures et minutes
  • [total-elapsed-htimer] pour afficher le temps passé depuis la première date de l'attribut date en heures
  • [total-elapsed-mstimer] pour afficher le temps passé depuis la première date de l'attribut date en minutes et secondes
  • [total-elapsed-mtimer] pour afficher le temps passé depuis la première date de l'attribut date en minutes
  • [total-elapsed-stimer] pour afficher le temps passé depuis la première date de l'attribut date en secondes
  • [total-elapsed-hmsrtimer] pour afficher seulement les heures, minutes et secondes du temps passé depuis la première date de l'attribut date en jours, heures, minutes et secondes
  • [total-elapsed-hmrtimer] pour afficher seulement les heures et minutes du temps passé depuis la première date de l'attribut date en jours, heures, minutes et secondes
  • [total-elapsed-hrtimer] pour afficher seulement les heures du temps passé depuis la première date de l'attribut date en jours, heures, minutes et secondes
  • [total-elapsed-msrtimer] pour afficher seulement les minutes et secondes du temps passé depuis la première date de l'attribut date en jours, heures, minutes et secondes
  • [total-elapsed-mrtimer] pour afficher seulement les minutes du temps passé depuis la première date de l'attribut date en jours, heures, minutes et secondes
  • [total-elapsed-srtimer] pour afficher seulement les secondes du temps passé depuis la première date de l'attribut date en jours, heures, minutes et secondes
  • [total-remaining-timer] pour afficher le temps restant avant la dernière date de l'attribut date
  • [total-remaining-dhmstimer] pour afficher le temps restant avant la dernière date de l'attribut date en jours, heures, minutes et secondes
  • [total-remaining-dhmtimer] pour afficher le temps restant avant la dernière date de l'attribut date en jours, heures et minutes
  • [total-remaining-dhtimer] pour afficher le temps restant avant la dernière date de l'attribut date en jours et heures
  • [total-remaining-dtimer] pour afficher le temps restant avant la dernière date de l'attribut date en jours
  • [total-remaining-hmstimer] pour afficher le temps restant avant la dernière date de l'attribut date en heures, minutes et secondes
  • [total-remaining-hmtimer] pour afficher le temps restant avant la dernière date de l'attribut date en heures et minutes
  • [total-remaining-htimer] pour afficher le temps restant avant la dernière date de l'attribut date en heures
  • [total-remaining-mstimer] pour afficher le temps restant avant la dernière date de l'attribut date en minutes et secondes
  • [total-remaining-mtimer] pour afficher le temps restant avant la dernière date de l'attribut date en minutes
  • [total-remaining-stimer] pour afficher le temps restant avant la dernière date de l'attribut date en secondes
  • [total-remaining-hmsrtimer] pour afficher seulement les heures, minutes et secondes du temps restant avant la dernière date de l'attribut date en jours, heures, minutes et secondes
  • [total-remaining-hmrtimer] pour afficher seulement les heures et minutes du temps restant avant la dernière date de l'attribut date en jours, heures, minutes et secondes
  • [total-remaining-hrtimer] pour afficher seulement les heures du temps restant avant la dernière date de l'attribut date en jours, heures, minutes et secondes
  • [total-remaining-msrtimer] pour afficher seulement les minutes et secondes du temps restant avant la dernière date de l'attribut date en jours, heures, minutes et secondes
  • [total-remaining-mrtimer] pour afficher seulement les minutes du temps restant avant la dernière date de l'attribut date en jours, heures, minutes et secondes
  • [total-remaining-srtimer] pour afficher seulement les secondes du temps restant avant la dernière date de l'attribut date en jours, heures, minutes et secondes

Autre exemple :

[counter date=2016/01/01//2017/01/01//2018/01/01//2019/01/01//2020/01/01]
Plus que [remaining-timer] avant 2016 et [total-remaining-timer] avant 2020 ![after]
Depuis [elapsed-timer], nous sommes en 2016 !
Plus que [remaining-timer] avant 2017 et [total-remaining-timer] avant 2020 ![after]
Depuis [elapsed-timer], nous sommes en 2017 et depuis [total-elapsed-timer], 2016 est arrivé !
Plus que [remaining-timer] avant 2018 et [total-remaining-timer] avant 2020 ![after]
Depuis [elapsed-timer], nous sommes en 2018 et depuis [total-elapsed-timer], 2016 est arrivé !
Plus que [remaining-timer] avant 2019 et [total-remaining-timer] avant 2020 ![after]
Depuis [elapsed-timer], nous sommes en 2019 et depuis [total-elapsed-timer], 2016 est arrivé !
Plus que [remaining-timer] avant 2020 ![after]
Depuis [elapsed-timer], nous sommes en 2020 et depuis [total-elapsed-timer], 2016 est arrivé ![/counter]

Résultat (avec un peu de mise en forme, fuseau horaire = UTC) :

Depuis 268 jours 8 heures 57 minutes 40 secondes, nous sommes en 2017 et depuis 634 jours 8 heures 57 minutes 40 secondes, 2016 est arrivé ! Plus que 96 jours 15 heures 2 minutes 20 secondes avant 2018 et 826 jours 15 heures 2 minutes 20 secondes avant 2020 !

5.4 Compteurs Périodiques

Vous pouvez afficher un compteur périodique, comme ceci :

[counter date=AAAA/MM/JJ-hh:mm:ss period=d:h:m:s]
Plus que [remaining-timer] ![/counter]

d = nombre de jours
h = nombre d'heures
m = nombre de minutes
s = nombre de secondes

Dans certains cas, vous pouvez indiquer la période plus simplement :

  • d est équivalent à d:0:0:0
  • d:h est équivalent à d:h:0:0
  • d:h:m est équivalent à d:h:m:0

Le compteur se répète selon une période égale à la durée spécifiée pour l'attribut period.

Exemple (compteur se répétant tous les jours) :

[counter date=2009/09/23 period=1]
Plus que [remaining-timer] avant demain ![/counter]

Résultat (avec un peu de mise en forme, fuseau horaire = UTC) :

Plus que 15 heures 2 minutes 20 secondes avant demain !

Autre exemple (compteur se répétant toutes les semaines) :

[counter date=2017/01/01//2017/01/04 period=7]
Plus que [remaining-timer] avant dimanche ![after]
Plus que [remaining-timer] avant mercredi ![/counter]

Résultat (avec un peu de mise en forme, fuseau horaire = UTC) :

Plus que 15 heures 2 minutes 20 secondes avant mercredi !

5.5 Dates Relatives

Il est possible de spécifier une date relative pour l'attribut date, comme ceci :

[counter date=+d:h:m:s]
Plus que [remaining-timer] ![after]Compte à rebours terminé !
[/counter]
[counter date=-d:h:m:s][after]Temps total : [timer][/counter]

d = nombre de jours
h = nombre d'heures
m = nombre de minutes
s = nombre de secondes

Dans certains cas, vous pouvez indiquer la durée plus simplement :

  • +d est équivalent à +d:0:0:0
  • +d:h est équivalent à +d:h:0:0
  • +d:h:m est équivalent à +d:h:m:0
  • -d est équivalent à -d:0:0:0
  • -d:h est équivalent à -d:h:0:0
  • -d:h:m est équivalent à -d:h:m:0

La date est alors celle du premier affichage du contenu par l'internaute, augmentée ou diminuée de la durée spécifiée pour l'attribut date.

Exemple :

[counter date=+0:0:2]
Plus que [remaining-timer] ![after]Compte à rebours terminé !
[/counter]

Résultat (avec un peu de mise en forme) :

Plus que 2 minutes 0 seconde !

Autre exemple :

[counter date=-0][after]
Temps écoulé depuis votre première consultation de cette page : [timer]
[/counter]

Résultat (avec un peu de mise en forme) :

Temps écoulé depuis votre première consultation de cette page : 0 seconde

Grâce à l'attribut origin, vous pouvez utiliser la date du dernier affichage du contenu par l'internaute, plutôt que la date du premier affichage du contenu.

Exemple :

[counter date=-0 origin=last-visit][after]
Temps écoulé depuis votre dernière consultation de cette page : [timer]
[/counter]

Résultat (avec un peu de mise en forme) :

Temps écoulé depuis votre dernière consultation de cette page : 0 seconde

6. Heure et Date

6.1 Heure

Pour afficher l'heure, insérez dans vos articles/pages/widgets un code comme celui-ci :

Il est [clock].

Résultat (fuseau horaire = UTC) :

Il est 08:57.

Par défaut, l'heure s'affiche en heures et minutes. Si vous souhaitez l'afficher en heures, minutes et secondes, utilisez l'attribut format et écrivez [clock format=hms] plutôt que [clock] :

Il est [clock format=hms].

Résultat (fuseau horaire = UTC) :

Il est 08:57:40.

L'heure affichée est celle correspondant au fuseau horaire de votre site Web. Pensez à régler correctement votre fuseau horaire via l'interface d'administration de WordPress si vous ne l'avez pas fait. Vous pouvez ponctuellement spécifier un décalage par rapport au temps UTC différent de celui de votre fuseau horaire en utilisant l'attribut offset.

Pour afficher l'heure du visiteur de votre site Web :

Il est [clock offset=local].

Résultat :

Il est 08:57.

L'attribut offset est le décalage (en heures) par rapport au temps UTC. Vous pouvez entrer n'importe quel nombre relatif pour cet attribut, ainsi que la valeur local pour afficher l'heure ou la date du visiteur de votre site Web. L'attribut offset peut être utilisé pour tous les shortcodes des sections Heure et Date et Fuseau Horaire.

6.2 Année

Pour afficher l'année, insérez dans vos articles/pages/widgets un code comme celui-ci :

Nous sommes en [year].

Résultat (fuseau horaire = UTC) :

Nous sommes en 2017.

Par défaut, l'année s'affiche sur 4 chiffres. Si vous souhaitez l'afficher sur 2 chiffres, utilisez l'attribut format et écrivez [year format=2] plutôt que [year].

6.3 Année et Semaine ISO 8601

Pour afficher le numéro de la semaine et l'année ISO 8601, insérez dans vos articles/pages/widgets un code comme celui-ci :

Nous sommes dans la semaine [yearweek] de l'année [isoyear].

Résultat (fuseau horaire = UTC) :

Nous sommes dans la semaine 39 de l'année 2017.

6.4 Jour de l'Année

Pour afficher le numéro du jour dans l'année, insérez dans vos articles/pages/widgets un code comme celui-ci :

Aujourd'hui, c'est le [yearday]ème jour de l'année [year].

Résultat (fuseau horaire = UTC) :

Aujourd'hui, c'est le 269ème jour de l'année 2017.

6.5 Mois

Pour afficher le mois, insérez dans vos articles/pages/widgets un code comme celui-ci :

Nous sommes en [month].

Résultat (fuseau horaire = UTC) :

Nous sommes en Septembre.

Par défaut, le mois s'affiche en toutes lettres, avec la première lettre en majuscule. Utilisez l'attribut format et donnez-lui la valeur :

  • lower pour l'afficher en lettres minuscules
  • upper pour l'afficher en lettres majuscules
  • 1 pour l'afficher sous la forme d'un nombre à 1 ou 2 chiffres (1 chiffre pour les neuf premiers mois de l'année, 2 chiffres pour les autres)
  • 2 pour l'afficher sous la forme d'un numéro comportant 2 chiffres (premier chiffre égal à 0 pour les neuf premiers mois de l'année)

6.6 Jour du Mois

Pour afficher le numéro du jour dans le mois, insérez dans vos articles/pages/widgets un code comme celui-ci :

Nous sommes le [monthday] [month] [year].

Résultat (fuseau horaire = UTC) :

Nous sommes le 26 Septembre 2017.

Par défaut, le numéro du jour dans le mois s'affiche sous la forme d'un nombre à 1 ou 2 chiffres (1 chiffre pour les neuf premiers jours du mois, 2 chiffres pour les autres). Si vous souhaitez l'afficher sur 2 chiffres (premier chiffre égal à 0 pour les neuf premiers jours du mois), utilisez l'attribut format et écrivez [monthday format=2] plutôt que [monthday].

6.7 Jour de la Semaine

Pour afficher le jour de la semaine, insérez dans vos articles/pages/widgets un code comme celui-ci :

Nous sommes le [weekday] [monthday] [month] [year].

Résultat (fuseau horaire = UTC) :

Nous sommes le Mardi 26 Septembre 2017.

Par défaut, le jour de la semaine s'affiche avec la première lettre en majuscule. Utilisez l'attribut format et donnez-lui la valeur :

  • lower pour l'afficher en lettres minuscules
  • upper pour l'afficher en lettres majuscules

Exemple :

Hier, nous étions le [weekday offset=-24] [monthday offset=-24] [month offset=-24] [year offset=-24].
Aujourd'hui, nous sommes le [weekday format=lower offset=0] [monthday offset=0] [month format=lower offset=0] [year offset=0].
Demain, nous serons le [weekday format=upper offset=24] [monthday offset=24] [month format=upper offset=24] [year offset=24].

Résultat :

Hier, nous étions le Lundi 25 Septembre 2017.
Aujourd'hui, nous sommes le mardi 26 septembre 2017.
Demain, nous serons le MERCREDI 27 SEPTEMBRE 2017.

6.8 L'Attribut filter

L'attribut filter (défini ici) est disponible pour tous les shortcodes de la section Heure et Date.

7. Fuseau Horaire

Pour afficher le fuseau horaire de votre site Web, insérez dans vos articles/pages/widgets un code comme celui-ci :

Le fuseau horaire de ce site Web est [timezone].

Résultat :

Le fuseau horaire de ce site Web est UTC.

Le fuseau horaire affiché sera ainsi automatiquement mis à jour chaque fois que vous modifierez le fuseau horaire de votre site Web.

Pour afficher le fuseau horaire du visiteur de votre site Web :

Votre fuseau horaire est [timezone offset=local].

Résultat :

Votre fuseau horaire est UTC.

7.1 L'Attribut filter

L'attribut filter (défini ici) est disponible pour le shortcode [timezone].

8. Affichage des Options

Pour afficher une option d'Easy Timer, insérez dans vos articles/pages/widgets un code comme celui-ci :

[easy-timer option]

en remplaçant option par :

  • cookies-lifetime pour afficher la durée de vie des cookies
  • default-timer-prefix pour afficher le préfixe par défaut du shortcode [timer]
  • javascript-enabled pour afficher l'activation du JavaScript (valeurs possibles : yes, no)
  • version pour afficher la version d'Easy Timer

Exemple :

Préfixe par défaut du shortcode <code>[timer]</code> : [easy-timer default-timer-prefix]

Résultat :

Préfixe par défaut du shortcode [timer] : dhms

8.1 L'Attribut default

Vous pouvez spécifier un texte qui sera affiché à la place de l'option lorsque celle-ci est vide, en utilisant l'attribut default, comme ceci :

[easy-timer option default="texte"]

N'oubliez pas les guillemets au début et à la fin de la valeur de l'attribut default.

8.2 L'Attribut filter

Vous pouvez spécifier une fonction PHP qui sera appliquée à l'option avant que celle-ci soit affichée, en utilisant l'attribut filter, comme ceci :

[easy-timer option filter=fonction]

Remplacez fonction par le nom de la fonction que vous souhaitez appliquer.

Parfois, l'option est un mot anglais. Vous pouvez alors le traduire dans la langue de votre site Web en entrant i18n comme valeur pour l'attribut filter.

Exemple :

JavaScript activé : [easy-timer javascript-enabled filter=i18n]

Résultat :

JavaScript activé : oui

Il est possible de spécifier plusieurs fonctions PHP pour l'attribut filter, en séparant les différentes fonctions par /, comme ceci :

[easy-timer option filter=fonction1/fonction2/…/fonctionN]

Les fonctions seront appliquées dans l'ordre indiqué.

9. Personnalisation Avancée

9.1 Fichiers Personnalisés

Vous pouvez remplacer tous les fichiers d'Easy Timer (sauf easy-timer.php) par vos propres fichiers. Pour cela, créez le dossier easy-timer-custom-files dans le répertoire des plugins (celui dans lequel vous avez installé Easy Timer) de votre site Web.

Par exemple, si vous souhaitez remplacer le fichier includes/data.php d'Easy Timer par un fichier que vous avez personnalisé, créez le dossier includes dans le dossier easy-timer-custom-files, et uploadez votre fichier data.php dans ce dossier.

Vous pouvez définir vous-même le répertoire dans lequel sont stockés vos fichiers personnalisés, en insérant cette ligne :

define('EASY_TIMER_CUSTOM_FILES_PATH', ABSPATH.'custom-files/easy-timer/');

juste après :

if ( !defined('ABSPATH') )
	define('ABSPATH', dirname(__FILE__) . '/');

dans votre fichier wp-config.php.

Remplacez custom-files/easy-timer par ce que vous voulez. La valeur de EASY_TIMER_CUSTOM_FILES_PATH doit se terminer par un /.

9.2 Langues Personnalisées

Easy Timer est développé en anglais et contient des fichiers qui le traduisent en français. Si vous le souhaitez, vous pouvez le traduire dans une autre langue.

Pour cela, créez votre répertoire de fichiers personnalisés en suivant ces indications. Créez le dossier languages à l'intérieur de celui-ci, et uploadez vos fichiers de traduction dans ce dossier.

Vous pouvez créer vos fichiers de traduction grâce au fichier languages/easy-timer.pot du plugin, et en utilisant le logiciel gratuit Poedit. Vos deux fichiers de traduction MO et PO doivent être nommés comme ceci :

easy-timer-ll_CC.mo
easy-timer-ll_CC.po

ll_CC est la valeur affichée par cette ligne de code :

echo get_locale();

lorsqu'elle est exécutée dans l'un des fichiers de votre site WordPress.

10. FAQ

10.1 Pourquoi mon compteur ne se réactualise-t-il pas toutes les secondes ?

Javascript n'est peut-être pas activé dans votre navigateur. Dans ce cas, activez-le. Vérifiez que la case Ajouter le code JavaScript de la page d'options d'Easy Timer est cochée. Vérifiez le fichier footer.php de votre thème WordPress. Assurez-vous qu'il contient un appel à la fonction wp_footer.

10.2 Comment puis-je utiliser des shortcodes dans mon thème WordPress ?

Insérez dans les fichiers PHP de votre thème un code comme celui-ci :

<?php echo do_shortcode('[votre-shortcode]'); ?>

10.3 Comment puis-je utiliser des shortcodes dans les commentaires ?

Modifiez le fichier functions.php (créez-le s'il n'existe pas) de votre thème WordPress et ajoutez cette ligne de code :

add_filter('comment_text', 'do_shortcode');

10.4 Comment puis-je utiliser des shortcodes dans les attributs des shortcodes ?

Vous pouvez entrer des shortcodes pour la plupart des attributs des shortcodes d'Easy Timer, à condition de remplacer [ par ( et ] par ), comme ceci :

[votre-shortcode attribut='(votre-autre-shortcode)']

N'oubliez pas les guillemets simples au début et à la fin du shortcode.

10.5 Comment puis-je imbriquer plusieurs shortcodes identiques ?

Lorsque vous imbriquez plusieurs shortcodes identiques, vous devez ajouter un nombre entier entre 1 et 3 à la fin des tags de ces shortcodes afin qu'ils fonctionnent correctement, comme ceci :

[countdown…]…
[countdown1…]…
[countdown2…]…
[countdown3…]…
[/countdown3]…
[/countdown2]…
[/countdown1]…
[/countdown]

Traducteurs

  • Aboelabbas (arabe)
  • Ales J. (tchèque)
  • Alexander Ovsov - WebHostingGeeks (biélorusse)
  • Chris K. (hongrois)
  • Dave (portugais)
  • Dovis (chinois)
  • Flemming (danois)
  • Gunlukucretsiz (turc)
  • Johan (suédois)
  • Kaloyan (bulgare)
  • Krzysztof (polonais)
  • Mihalcea (roumain)
  • Omer (hébreu)
  • Peter (slovaque)
  • Reza E. (persan)
  • Sofokli (albanais)
  • Tohru M. (japonais)
  • Vladimir (russe)