Le nouveau sélecteur de date de Joomla! 3.7

Written by | 01 June 2017 | Published in 2017 June
Depuis ses tout débuts, Joomla! propose un champ de saisie de date incluant un sélecteur. Celui-ci permet de naviguer facilement dans un calendrier, mois par mois et de simplement cliquer sur la date souhaitée pour obtenir une saisie au bon format. C'est bien pratique !  
Nouveau sélecteur de date de Joomla! 3.7 Nouveau sélecteur de date de Joomla! 3.7 Marc Studer

 

Nouveau sélecteur de date et format automatique

La venue de Joomla! 3.7 inclut le remplacement du champ DatePicker originel (nommé 'Calendar'). Cela fait d'autant plus plaisir que ce champ n'avait pas évolué depuis plusieurs années !

Difficultés de maintenance, faibles possibilités de personnalisation, le passage au nouveau champ Calendar a permis de compléter grandement le paramètrage de ce champ de selection de date.

Désormais, il est possible pour les développeurs de préciser les personnalisations suivantes :

  • selection de l'année et du mois, groupée sur 1 seule ligne ou séparée sur 2 lignes independantes (paramètre singleheader)
  • précisions des bornes limites des années min et max (paramètres minyear et maxyear)
  • affichage ou pas des numeros de semaine (paramètre weeknumbers)
  • activation de la selection des heures et minutes (paramètre showtime)
  • format des heures sur 12h (AM/PM) ou 24h (paramètre timeformat)
  • affichage grisé mais selectionnable des jours des mois precedents et suivants (dans la grille du mois courant) (paramètre filltable)
  • affichage du bouton 'Aujourd'hui' pour selectionner la date du jour (paramètre todaybutton)

Nouveau sélecteur de date 'datepicker' de joomla 3.7

Afin d'expliquer et de documenter le paramétage suite à la refonte du champ Calendar en Joomla 3.7.0, le wiki officiel de documentation a été mis à jour et présente plusieurs exemples d'utilisation.
https://docs.joomla.org/Calendar_form_field_type/fr


Pourquoi du XML ?

Pour ceux qui ont cliqué sur le lien ci-dessus, vous constaterez que les champs ne sont pas codés en HTML, mais en XML !
Dés le début, Joomla a fait le choix de "séparer le fond de la forme" et trés rapidement (dès la version 1.6), il a été décidé de modéliser la structure des formulaires de saisie en XML, dans un fichier séparé de l'écran HTML.
Les connaisseurs diront "ce n'est pas une révolution" et ils auront raison ! Joomla a juste choisi de respecter un n-ieme modèle de programmation qui a fait ces preuves dans l'industrie informatique : la modélisation XML de la structure des formulaires

Page HTML contre modélisation XML

Cette solution permet d'opposer la page Web qui integre tout le code de l'écran (1) avec une solution où la page Web ne contient plus que la partie graphique (2). Le detail de la structure des champs du formulaire est codé dans un fichier XML (3).

En séparant le fond de la forme, Joomla! permet aux editeurs d'extensions de gagner sur de nombreux tableaux :

  • facilité de conception et de maintenabilité du code des écrans HTML
  • chargement et enregistrement des formulaires de saisie normalisés
  • fiabilité dans les processus de chargement et d'enregistrement
  • maintenance et évolution de la structure des formulaires simplifiées
  • création simple et fiable de nouveaux champs
  • partage facilité avec la communauté
  • ... etc

L'approche peut paraitre déroutante pour un nouveau développeur qui ne serait pas habitué à cette facon de programmer, mais avec peu d'investissement, on constate a très court terme que les avantages fournis par cette solution sont un gain de temps et de fiabilité !


La caverne de Joomla et des 62 champs !

Les pages de documentation de Joomla! sont une mine d'informations importante pour les administrateurs, intégrateurs et developpeurs Joomla.
La page présentant le fonctionnement du sélecteur de date n'est qu'une des 62 pages présentant les champs utilisables dans les extensions Joomla :
https://docs.joomla.org/Standard_form_field_types/fr

Cette richesse documentaire sur les champs de formulaires de saisie est une des bibles de la documentation Joomla.
Je ne connais pas de développeurs qui n'y passe très régulierement, qu'il soit débutant ou confirmé !

J'en profite pour rappeler que la tenue à jour de la documentation officielle n'est possible que grace aux bénévoles !
Pas besoin d'être un développeur, toute personne connaissant une fonctionnalité de Joomla peut se créer un compte sur le wiki et compléter/corriger la documentation, tout en venant inscrire son nom dans la plaque de marbre des auteurs de la documentation Joomla !

Un grand merci aux administrateurs et aux rédacteurs du Wiki docs.joomla.org pour le travail énorme qu'ils abattent !
... et qui nous facilitent la vie tous les jours ;)

 

Read 5018 times Tagged under French
Marc Studer

Marc Studer

Membre de la francophonie Joomla, formateur et développeur Joomla! professionnel.
Member of the french Joomla community, teacher and professionnal Joomla! Developer


Auteur de manuels Joomla! aux éditions ENI.
Ancien membre du Conseil d'administration de l'AFUJ / Joomla! France.
Conférencier sur le Framework Joomla! lors des JoomlaDays France depuis 2009.