Plugin Jour J - Etude

Voilà mes premières réflexions pour le développement de mon prochain plugin que j'ai nommé Jour J.

Identité

Plugin jour J (D day en anglais). On utilisera dday comme nom abrégé pour le plugin, le nom de la table, etc...

Principe

Gestion d'une liste de jour J pour lequelles on effectue un compte à rebours jusqu'à un jour J (comme pour un anniversaire, une date de sortie, une fête) ou un compte du nombre de jours passés depuis ce jour J (comme pour montrer le nombre de jours écoulés depuis le nouvel an).

La liste des jours J et leurs paramètres seront stockés dans une nouvelle table nommée dc_dday (avec dc_ étant le préfixe standard des tables de DotClear).

Chaque jour J sera doté d'un numéro (identificateur) unique. Il pourra être accompagné d'un texte, d'une URL (accompagnée de l'indicateur de langue). Un jour J pourra être unique ou répété à intervalle régulier. On indiquera également le sens de comptage (avant, après ou les deux)[1], avant donnera le nombre de jours restant avant la date et le comptage s'arrêta au jour J, après donnera le nombre de jours passés depuis le jour J et le comptage ne commencera qu'à partir du jour J, les deux combinera ces derniers.

Un jour J pourra être actif ou inactif. Un numéro d'ordre sera également disponible, permettant le tri en fonction des besoins de l'utilisateur. (ajouté le 4 mars 2005).

Une interface d'administration permettra l'installation de la table et la gestion des jours J.

Une fonction sera fournie pour afficher un jour J ou la liste complète des jours J :

dcDday::ShowList($dday_id = '',
$block = '<ul>%s</ul>', $item = '<li>%s</li>',
$passe = ' il y a %s jours', $hier = ' hier',
$present = ' aujourd\'hui',
$demain = ' demain', $futur = ' dans %s jours')

avec :

  • $dday_id = identificateur du jour J à lister (laisser vide pour obtenir tous les jours J)
  • $block = Bloc XHTML englobant toute la liste des jours J
  • $item = Bloc XHTML englobant un jour J de la liste
  • 5 blocs de formattage en fonction du nombre de jours restants ou à venir

Structure de la table dc_dday

  • dday_id : identificateur du jour J, numérique, auto-incrémenté, indexé et obligatoire
  • dday_dt : date du jour J, date, obligatoire
  • dday_titre : texte associé au jour J, facultatif
  • dday_titre_url : URL associée au jour J, facultatif
  • dday_desc : texte descriptif pour l'URL, facultatif
  • dday_lang : langue, texte (5)
  • dday_pub : indicateur d'activité, booléen
  • dday_dir : sens de comptage (0 = avant, 1 = après ou 2 = les deux) (ajouté le 14 mars 2005).
  • dday_repeat : répétition, booléen, défaut = non (ajouté le 14 mars 2005).
  • dday_repeat_nb : valeur de répétition, numérique, défaut = 1 , infini = 0 (retiré le 14 mars 2005).
  • dday_repeat_unit : unité de répétition (jour, semaine, mois, année[2])
  • dday_ord : numéro d'ordre (0 à n) (ajouté le 4 mars 2005).

Exemples d'utilisation

  • Liste d'anniversaires
  • Liste de sortie de films ou de jeux
  • Compte à rebours avant un événement particulier (naissance, mariage, ...)
  • ...

Notes

[1] Si un jour J est répété, le sens de comptage ne pourra être qu'avant.

[2] Ici le jour et le mois sont conservés, et on incrémente uniquement l'année.

Ajouter un commentaire

Les commentaires peuvent être formatés en utilisant la syntaxe Markdown Extra.

Ajouter un rétrolien

URL de rétrolien : https://open-time.net/trackback/2829

Haut de page