Help:Format calendrier

Le format de résultat calendrier (calendar en anglais), partie intégrante de l'extension Semantic MediaWiki, peut être utilisé pour afficher les pages qui ont un temps associé, par exemple des événements, sur un calendrier.

Utilisation
Une requête au format calendrier devrait être appelée de la manière suivante :

...En d'autres termes, la propriété date que l'on demande devrait aussi êtres utilisée pour filtrer les dates : #calendarstartdate et #calendarenddate donneront la première et la dernière date (en fait, le jour après la dernière date) respectivement, pour un mois spécifique. Ceci est fait afin que seules les dates situées dans le mois courant, au lieu de toutes, sont passées pour être affichées par le calendrier.

Quelques notes sur la création de telles requêtes :


 * Assurez-vous d'inclure les deux points, « : », dans les appels de fonction parseur #calendarstartdate et #calendarenddate ; dans le cas contraire, cela ne marchera pas.
 * Ne vous inquiétez pas du fait que les opérateurs de comparaisons sont « < » et « > » au lieu de « <= » et « >= » ; la valeur de retour des fonctions parseur sont paramétrées pour que cela ne soit pas un problème.
 * Vous pouvez aussi ajouter un paramètre « sort= » comme « sort=Has date », ainsi les événements compris dans chaque journée seront triés selon l'heure à laquelle ils se déroulent (en supposant que la propriété « Has date » dans ce cas inclue aussi une valeur de temps).

Options d'affichage
Vous pouvez paramétrer la couleur des entrées que sont marquées en ajoutant l'option couleur dans la requête :

|color=red

Différentes couleurs pour chaque jeu d'événements peuvent être affichées en utilisant les requêtes sémantiques complexes (Semantic Compound Queries).

L'option template =  peut être utilisée pour modifier l'affichage d'un objet/événement calendrier :

|format=calendar
 * template=<...>

Pour plus d'informations concernant le modèle utilisé, voir Format modèle.

Comme pour SRF 1.6, vous pouvez aussi paramétrer le premier jour où commence la semaine (par défaut, c'est dimanche) dans tout le wiki en modifiant la variable $srfgFirstDayOfWeek dans LocalSettings.php après l'inclusion des formats de résultat sémantiques. Pour le paramétrer sur lundi, par exemple, vous pouvez ajouter la ligne suivante si vous utilisez un wiki en français :

Veuillez noter que le jour doit être défini suivant la langue du wiki.

Le problème de cache
Dans les versions précédentes de formats de résultats sémantiques, les calendriers ne s'affichaient pas correctement à moins que le cache de MediaWiki soit désactivé manuellement au moins sur les pages qui contenaient des calendriers. Ce problème est maintenant résolu dans le code : si le problème existe toujours dans votre cas, veuillez upgrader vers la dernière version de SRF.

Changement des limites de résultats
La limite par défaut des résultats affichées dans une requête intégrée est de 20. S'il y a plus de 20 événements dans un mois, vous devriez ajouter un paramètre limit= dans la requête avec un nombre supérieur au nombre maximum que vous avez. Par exemple :

Dans le cas où le nombre d'événements dans le mois dépasse les 500, vous aurez besoin de faire une seconde opération - ajouter la ligne suivante dans votre fichier LocalSettings.php après l'inclusion de Semantic MediaWiki :

$smwgQMaxInlineLimit = 1000;

La valeur peut être n'importe quel nombre supérieur au nombre maximum d'événement que vous avez par mois.

Exemple
Vous pouvez voir un exemple du format calendrier en fonction sur cette page calendrier sur Discourse DB.