Plugin Jour J 0.5

PluginNouvelle version du plugin Jour J

Installation

Changements

  • Mise au propre (et à la norme) de la documentation des codes sources
  • Ajout de la gestion d'une liste de numéros de jours J à traiter
  • Ajout de la gestion de filtre en fonction des échéances des jours J traités

Usage de la fonction pour l'affichage

Pour afficher la liste des jours J, insérez le code suivant dans votre fichier template :

<?php dcDday::showList(); ?>

La forme complète de la fonction est la suivante :

showList(
 [arry_dday],
 ["<ul class="dday">%s</ul>"],
 ["<li>%s</li>"],
 [" il y a <span class="dday_days">%s</span> jours"],
 [" <span class="dday_text">hier</span>"],
 [" <span class="dday_text">aujourd\'hui</span>"],
 [" <span class="dday_text">demain</span>"],
 [" dans <span class="dday_days">%s</span> jours"],
 [" <span class="dday_text">aujourd\'hui</span>
  dans <span class="dday_hours">%2\$d</span>
  h<span class="dday_minutes">%3\$02d</span>"],
 [arry_filter])

Avec arry_dday étant soit le numéro du jour J soit un tableau de numéro de jour J, dans ce cas, l'affichage sera limité à ce ou ces jours. Mettre null pour obtenir la liste complète. arry_filter étant un tableau représentant la liste des échéances à lister. Ce tableau doit contenir 6 valeurs égales à 00 pour masquer ces échéances ou égales à 1 pour les afficher. Dans l'ordre les valeurs s'appliquent au jours J dont l'échéance est :

  • passée depuis plus d'un jour,
  • passée la veille,
  • passée ce même jour,
  • à venir ce même jour,
  • à venir le lendemain,
  • à venir le sur-lendemain ou plus tard

Les paramètres suivants permettent respectivement de formatter :

  • l'ensemble de la liste
  • chaque élément de la liste
  • le nombre de jours :
    • passés (sur-lendemain du jour J et suivants)
    • passés (lendemain du jour J)
    • quand il est égal à 0 (on est au jour J)
    • restants (veille du jour J)
    • restants (avant-veille du jour J et précédents)
    • quand il est égal à 0 (on est au jour J) avec affichage du temps restant (en heures et minutes)

Exemple :

  • Pour obtenir l'affichage des jours J numéros 1, 4, 5 et 12. Les numéros sont indiqués entre crochets sur la page d'administration des jours J :
showList(array(1,4,5,12));
  • Pour obtenir l'affichage de tous les jours J dont l'échéance est à venir :
showList(null, 
"<ul class="dday">%s</ul>",
"<li>%s</li>",
" il y a <span class="dday_days">%s</span> jours",
" <span class="dday_text">hier</span>",
" <span class="dday_text">aujourd\'hui</span>",
" <span class="dday_text">demain</span>",
" dans <span class="dday_days">%s</span> jours",
" <span class="dday_text">aujourd\'hui</span>
  dans <span class="dday_hours">%2\$d</span>
  h<span class="dday_minutes">%3\$02d</span>",
array(0, 0, 0, 1, 1, 1));

Haut de page