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.

Télécharger Easy Timer gratuitement

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 cotillons dans mon thème WordPress ?
    3. Comment puis-je utiliser des cotillons dans les commentaires ?
    4. Comment puis-je utiliser des cotillons dans les attributs des cotillons ?
    5. Comment puis-je imbriquer plusieurs cotillons identiques ?

1. Installation

Vous pouvez installer Easy Timer via la page Ajouter des extensions du menu Extensions de WordPress (Extensions => Ajouter => Téléverser une extension). 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), ou encore via la page Ajouter des extensions du menu Extensions de WordPress (Extensions => Ajouter => Téléverser une extension, envoyez le fichier du plugin sans le dézipper). 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 cotillon 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 :

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 cotillon [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 cotillon [timer]. Vous pouvez utiliser les cotillons suivants :

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

3.3 Substitution Automatique de Contenu

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

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

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

Plus que 252 jours 6 heures 30 minutes 3 secondes avant 2025 !

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 cotillon [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=2025/01/01]
Nous serons bientôt en 2025 !
[after]Bonne Année 2025 ![/countdown]

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

Nous serons bientôt en 2025 !

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=2024/12/25//2025/01/01]
Plus que [timer] avant Noël ![after]
Plus que [timer] avant 2025 ![after]
Bonne Année 2025 ![/countdown]

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

Plus que 245 jours 6 heures 30 minutes 3 secondes avant Noël !

Vous pouvez utiliser les cotillons suivants :

Autre exemple :

[countdown date=2024/01/01//2025/01/01//2026/01/01//2027/01/01//2028/01/01]
Plus que [timer] avant 2024 et [total-timer] avant 2028 ![after]
Plus que [timer] avant 2025 et [total-timer] avant 2028 ![after]
Plus que [timer] avant 2026 et [total-timer] avant 2028 ![after]
Plus que [timer] avant 2027 et [total-timer] avant 2028 ![after]
Plus que [timer] avant 2028 ![after]Bonne Année 2028 ![/countdown]

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

Plus que 252 jours 6 heures 30 minutes 3 secondes avant 2025 et 1347 jours 6 heures 30 minutes 3 secondes avant 2028 !

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 :

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 6 heures 30 minutes 3 secondes avant demain !

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

[countdown date=2024/01/07//2024/01/10 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 6 heures 30 minutes 3 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 :

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 cotillon 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 :

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 cotillon [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 cotillon [timer]. Vous pouvez utiliser les cotillons suivants :

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

4.3 Substitution Automatique de Contenu

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

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

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

Depuis 113 jours 17 heures 29 minutes 57 secondes, nous sommes en 2024 !

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 cotillon [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=2025/01/01]
Bonne Année 2025 ![before]
Nous serons bientôt en 2025 ![/countup]

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

Nous serons bientôt en 2025 !

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=2024/01/01//2023/12/25]
Depuis [timer], nous sommes en 2024 ![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 113 jours 17 heures 29 minutes 57 secondes, nous sommes en 2024 !

Vous pouvez utiliser les cotillons suivants :

Autre exemple :

[countup date=2027/01/01//2026/01/01//2025/01/01//2024/01/01//2023/01/01]
Depuis [timer], nous sommes en 2027 et depuis [total-timer], 2023 est arrivé ![before]
Depuis [timer], nous sommes en 2026 et depuis [total-timer], 2023 est arrivé ![before]
Depuis [timer], nous sommes en 2025 et depuis [total-timer], 2023 est arrivé ![before]
Depuis [timer], nous sommes en 2024 et depuis [total-timer], 2023 est arrivé ![before]
Depuis [timer], nous sommes en 2023 ![before]Nous serons bientôt en 2023 ![/countup]

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

Depuis 113 jours 17 heures 29 minutes 57 secondes, nous sommes en 2024 et depuis 478 jours 17 heures 29 minutes 57 secondes, 2023 est arrivé !

4.5 Chronomètres

Pour afficher un chronomètre, insérez dans vos articles/pages/widgets un cotillon 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 cotillon 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 cotillon 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 :

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 cotillon 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 :

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 cotillons [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=2025/01/01]
Nous serons bientôt en 2025 !
[after]Bonne Année 2025 ![/counter]

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

Nous serons bientôt en 2025 !

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 cotillons [elapsed-timer] et [remaining-timer]. Vous pouvez utiliser les cotillons suivants :

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

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=2023/12/25//2024/01/01]
Plus que [remaining-timer] avant Noël ![after]
Depuis [elapsed-timer], Noël est arrivé !
Plus que [remaining-timer] avant 2024 ![after]
Depuis [elapsed-timer], nous sommes en 2024 ![/counter]

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

Depuis 113 jours 17 heures 29 minutes 57 secondes, nous sommes en 2024 !

Vous pouvez utiliser les cotillons suivants :

Autre exemple :

[counter date=2023/01/01//2024/01/01//2025/01/01//2026/01/01//2027/01/01]
Plus que [remaining-timer] avant 2023 et [total-remaining-timer] avant 2027 ![after]
Depuis [elapsed-timer], nous sommes en 2023 !
Plus que [remaining-timer] avant 2024 et [total-remaining-timer] avant 2027 ![after]
Depuis [elapsed-timer], nous sommes en 2024 et depuis [total-elapsed-timer], 2023 est arrivé !
Plus que [remaining-timer] avant 2025 et [total-remaining-timer] avant 2027 ![after]
Depuis [elapsed-timer], nous sommes en 2025 et depuis [total-elapsed-timer], 2023 est arrivé !
Plus que [remaining-timer] avant 2026 et [total-remaining-timer] avant 2027 ![after]
Depuis [elapsed-timer], nous sommes en 2026 et depuis [total-elapsed-timer], 2023 est arrivé !
Plus que [remaining-timer] avant 2027 ![after]
Depuis [elapsed-timer], nous sommes en 2027 et depuis [total-elapsed-timer], 2023 est arrivé ![/counter]

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

Depuis 113 jours 17 heures 29 minutes 57 secondes, nous sommes en 2024 et depuis 478 jours 17 heures 29 minutes 57 secondes, 2023 est arrivé ! Plus que 252 jours 6 heures 30 minutes 3 secondes avant 2025 et 982 jours 6 heures 30 minutes 3 secondes avant 2027 !

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 :

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 6 heures 30 minutes 3 secondes avant demain !

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

[counter date=2024/01/07//2024/01/10 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 6 heures 30 minutes 3 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 :

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 cotillon comme celui-ci :

Il est [clock].

Résultat (fuseau horaire = UTC) :

Il est 17:29.

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 17:29:57.

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 17:29.

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 cotillons 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 cotillon comme celui-ci :

Nous sommes en [year].

Résultat (fuseau horaire = UTC) :

Nous sommes en 2024.

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 cotillon comme celui-ci :

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

Résultat (fuseau horaire = UTC) :

Nous sommes dans la semaine 17 de l'année 2024.

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 cotillon 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 114ème jour de l'année 2024.

6.5 Mois

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

Nous sommes en [month].

Résultat (fuseau horaire = UTC) :

Nous sommes en Avril.

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 :

6.6 Jour du Mois

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

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

Résultat (fuseau horaire = UTC) :

Nous sommes le 23 Avril 2024.

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 cotillon comme celui-ci :

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

Résultat (fuseau horaire = UTC) :

Nous sommes le Mardi 23 Avril 2024.

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 :

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 22 Avril 2024.
Aujourd'hui, nous sommes le mardi 23 avril 2024.
Demain, nous serons le MERCREDI 24 AVRIL 2024.

6.8 L'Attribut filter

L'attribut filter (défini ici) est disponible pour tous les cotillons 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 cotillon 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 cotillon [timezone].

8. Affichage des Options

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

[easy-timer option]

en remplaçant option par :

Exemple :

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

Résultat :

Préfixe par défaut du cotillon [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

où ll_CC est la valeur affichée par cette ligne de cotillon :

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 cotillons dans mon thème WordPress ?

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

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

10.3 Comment puis-je utiliser des cotillons 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 cotillon :

add_filter('comment_text', 'do_shortcode');

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

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

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

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

10.5 Comment puis-je imbriquer plusieurs cotillons identiques ?

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

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

Traducteurs