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 champs suivis d'un * sont obligatoires

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