Libraire iCalcreator
Le plugin icalendar contient la librairie iCalcreator de Kjell-Inge Gustafsson (disponible sur le site http://www.kigkonsult.se/iCalcreator/ en licence GNU/GPL 2.1 ou ultérieure). Cette librairie permet notamment d’écrire et de lire des fichiers au format iCalendar (RFC 2445). C’est le format d’échange qu’utilisent la plupart des logiciels de calendrier, qu’ils soient « de bureau » ou « en ligne ». Vous pouvez utiliser ce plugin pour exploiter la librairie en PHP.
Utilisation avec les itérateurs de SPIP
Vous pouvez alors utiliser le plugin avec la boucle (DATA)
(cf. Les Itérateurs pour SPIP 2.1).
Avec ce format il devient possible de boucler sur les événements d’un calendrier géré depuis un logiciel spécialisé, ou publié sur un site internet.
Voici un exemple de boucle en faisant usage.
<BOUCLE_vacances(DATA)
{source ics, https://fr.ftp.opendatasoft.com/openscol/fr-en-calendrier-scolaire/Zone-A.ics}
{par dtstart/str}
{description/0/value != ''}
{dtend/str>=#GET{today}}
{dtstart/str<=#GET{nextyear}}
>
<h3>#VALEUR{description/0/value}</h3>
<dt>
[(#SET{date,#VALEUR{dtstart/str}})]
[(#GET{date}|jour) ][(#GET{date}|nom_mois)][ (#GET{date}|annee{#_zone0:VALEUR})]
[(#SET{date,#VALEUR{dtend/str}})]
[ — (#GET{date}|jour) ][(#GET{date}|nom_mois)][ (#GET{date}|annee{#_zone0:VALEUR})]
</dt>
[<dd>(#VALEUR{summary/0/value})</dd>]
</BOUCLE_vacances>
Résultat :
- 18 décembre — 3 janvier
- Vacances de Noël
- 19 février — 7 mars
- Vacances d'hiver
- 16 avril — 2 mai
- Vacances de printemps
- 2 juillet — 5 septembre
- Vacances d'été
- 22 octobre — 3 novembre
- Vacances de la Toussaint
(Une fois le plugin installé, vous pouvez visualiser l’adresse spip.php?page=demo/iter_icalendar
pour une version élaborée de cet exemple.)
Données accessibles
Comme le montre l’exemple ci-dessus, la date de début de chaque événement se trouve au format YYYY-MM-DD hh:mm:ss
dans le datapath
(chemin XPath) dtstart/str
.
Pour aller plus loin on peut aussi récupérer l’année, le mois etc. dans les variables dtstart/value/year
, dtstart/value/month
et dtstart/value/day
, dtstart/value/hour
, dtstart/value/min
, dtstart/value/sec
et dtstart/value/tz
(time zone).
La date de fin figure, de même, dans le tableau dtend
; la définition du format ics veut que, lorsque l’événement dure une journée entière, dtend
soit la date du lendemain (autrement dit, on indique mardi à 00h00 plutôt que lundi à 23h59).
Pour trier par date de début de l’événement, on utilisera :
{par dtstart/str}
.
Le résumé (titre) de l’événement se trouve dans summary/value
.
Les données possibles sont nombreuses ; pour les explorer dans une boucle icalendar, il suffit d’indiquer [<pre>(#VALEUR|print_r{1})</pre>]
. On voit alors apparaître un enregistrement complet, où l’on peut lire le datapath
de chaque élément.
Par exemple, le code ci-dessous indique que le contenu du champ description peut s’obtenir via #VALEUR{description/0/value}
:
[description] => Array
(
[0] => Array
(
[value] => Vacances d'hiver
[params] =>
)
)
En procédant ainsi on peut trouver notamment :
— created
: date de création de l’événement dans le calendrier ;
— lastmodified
: date de mise à jour de l’événement ;
— location/value
: lieu de l’événement ;
— uid/value
: identifiant unique de l’événement ;
— rrule/0/value/FREQ
: fréquence de récurrence (pour les événements se répétant à intervalle défini)
— etc.
Trouvailles
Si vous utilisez ce plugin, n’hésitez pas à partager vos trouvailles dans le forum ci-dessous.
modèle « prochainement »
C’est ce qu’à fait Jérome. Dès lors, le plugin propose désormais un modèle simple sous modeles/prochainement.html
. Il récupère un flux iCal et retourne les événements futurs.
Insérez ce modèle comme tout autre (voir http://www.spip.net/fr_article3454.html) en lui passant un paramètre ics
pointant vers l’url d’un flux ical. Par exemple : <prochainement|ics=http://www.demosphere.eu/events.ics>
pour afficher les événements à l’agenda de Démosphère dans un texte. Ou encore [(#MODELE{prochainement}{ics=http://www.demosphere.eu/events.ics})]
dans un squelette.
Discussions par date d’activité
17 discussions
Bonjour. Je n’arrive pas à faire marcher ce merveilleux plugin chez free.fr
- spip 2.1.25
- Itérateurs 1.0.5
- iCalendar 0.4.0
C’est pour inclure un google calendar dont l’adresse est publique.
_*Lien que j’ai mis dans l’appel au modèle « prochainement.html »
- Je me dis que c’est aussi peut-être « Itérateur »s qui flanche, donc j’ai vidé tout le « tmp » ... que néni !
- Peut-être une solution (ou pas) simple ?
- Le site : http://44capitelles.free.fr
Si vous avez le début d’une explication n’hésitez pas ! (Je suis depuis 2003 sur spip, en me soignant car je n’y comprends rien, avec en particulier un squelette merdique : TDT.
Répondre à ce message
Salut,
Il me semble qu’il y a un problème de prise en compte du fuseau horaire dans les dates gérées par la fonction inc_ics_to_array() (dtstart, dtend, dtstamp, lastmodified, created).
Voici une proposition de correctif, qui marche correctement dans mon cas : https://gist.github.com/otetard/6593636/raw. Elle retourne la date dans le même format que précédemment, mais en appliquant le décalage horaire.
Olivier ;
Bonjour,
Je pense aussi qu’il y a un problème de prise en compte des fuseaux horaires.
Les heures de mes événements s’affichent avec une heure d’avance (date de début et de fin).
je ne vois pas comment faire pour intégrer la modification que tu proposes et qui semble résoudre le problème. Peux-tu m’indiquer la marche à suivre ?
Merci
Bonjour,
Je viens d’intégrer le correctif dans le plugin iCalendar.
Olivier ;
Répondre à ce message
bonjour,
est-il prevus une version compatible spip 3, le plugin est pourtant cité dans la doc spip
http://www.spip.net/fr_article5444.html
merci
C’est bien cité dans la documentation mais ça ne semble pas fonctionner avec les données .ics
Salut,
Ce plugin, publié en 2010, fournit le format iCal aux itérateurs. Donc ça fait deux plugins à installer en SPIP 2.1 mais un seul en SPIP 3 (j’ai mis l’article à jour à ce sujet).
Je vais le passer SPIP 3 compatible vu que la démo fonctionne très bien en 3 :-p
++
Merci mille fois ! C’est génial.
Par contre comment pourrais-t-on n’afficher que les événements qui n’ont pas encore eu lieu ?
J’ai pensé à ceci mais ça ne marche pas.
J’obtiens toutes les dates de l’année en cours (et jusqu’à la dernière date du calendrier)
Or je voudrais qu’il ne reprenne qu’à partir de la date d’AUJOURD’HUI
Visiblement la comparaison ne porte que sur les 4 premiers chiffres. Du coup, pour éliminer les dates passées de l’année, il faut tester dans la boucle je crois bien. Et pour le test il vaut mieux filtrer avec |strtotime. Genre (pas testé) :
Merci Suske... C’est exactement ce que je cherchais... Ca fonctionne.
J’ai même un peu compléter le filtre pour que la présentation soit plus correcte (Pas de répétition de la date lorsque la date de fin et la date de début sont identique, etc...). Je joins le code pour ceux que ça intéresse :
Petit correctif pour que ce soit la date du jour qui soit pris en compte et non la date de publication de l’article :
Merci pour le partage. J’ai à peine modifié le code pour en faire un modèle (améliorable certes...) qui est à présent disponible dans le plugin (voir article et http://brubel.net/Demosphere-agenda...).
A+
Merci ça fait plaisir de voir que c’est intégré au Plugin ;-)
Par contre il y a un défaut majeur... c’est que cette contribution ne permet pas encore de récupérer les événements récurrents du calendrier iCal.
S’affiche uniquement le premier événement de la série (qui possède une date de début (dtstart) et une date de fin (dtend) mais pas les récurrences programmées de ce même événement. Je ne vois pas comment récupérer ces dates.
Bonjour et merci pour ce plugin et cette contrib.
Je constate un petit problème. Lorsque l’on cherche à n’afficher que les événements futurs liés à un article dans un spip distant, on se retrouve avec tous les événements du spip en question. Est-ce volontaire et si oui, y a-t-il un moyen de restreindre cet affichage ?
quelques investigations plus tard, il semblerait que lorsque l’adresse est du type
http://www.latp.univ-mrs.fr/spip.php?page=seminaire_ical&id_article=351 (c’est à dire avec quelque chose après le &), toute la partie après le & ne soit pas prise ne compte.
Et je ne vois rien dans la librairie qui bloque à ce niveau là.
Bonjour,
nouveau dans spip je cherche à utiliser icalendar
si mon résultat ics me donne 4 résultats mais qu’ils sont tous filtrés par le test dans la boucle DATA ça m’affiche le « Code optionnel avant » et le « Code optionnel après » plutôt que de m’afficher le « Code alternatif ».
y aurait il un moyen de contourner ce problème
SPIP 3.0.16
iCalendar 0.4.0
S’ils sont filtrés, la boucle principale ne retourne rien. Donc si le code optionnel s’affiche c’est probablement qu’il y a bien un résultat... Faut voir sur pièce et code...
étant au travail je le fait de mémoire (travaillant sur une maquette le site est pas encors en ligne)
j’utilise le code suivant pour créer une noisette sous sarka-spip
et donc dans le cas d’un calendrier non vide mais avec les événement non affiché par le test conditionnel je me retrouve avec un tableau vide (et ses grosse bordures) plutôt que le message « pas de résultat »
Bonjour,
Voici le code que j’utilise
et voici ce que ça donne
j’ai un peu cherche ce problème de critère de date qui ne comparait que les 4 premiers chiffres
j’ai un peu regardé comment était fait le plugin et j’ai modifié une chose en local chez moi
dans le fichier ics_to_array.php ligne 32
j’ai ajouté un nouveau champ de date au format Ymdhis
ce qui dans ma boucle spip donne ensuite
Répondre à ce message
Bonjour,
Je fais un petit up d’un soucis détecté en cours d’une discussion précédente autour du traitement des évènements récurrents.
Je n’ai pu explorer exactement les cas de figures problématiques, ce que j’ai observé :
- un évènement récurrent modifié apparait,
- un évènement récurrent non-modifié n’apparait pas,
- mauvaise prise en compte des horaires sur certains évènements récurrents (pas testé à fond, je subodore un évènement modifié mais je n’ai pas la manipulation de l’auteur)
- affichage d’un évènement récurrent annulé remplacé par 2 évènements, les 3 évènements apparaissent (pas testé à fond idem que précédent)
Cordialement,
Aurélien
Répondre à ce message
Bonjour.
Je cherche exactement cela : installer un plugin Ical.
J’utilise spip 3 avec un squelette eva web.
Ce squelette me va très bien : je ne sais pas utiliser les lignes de code. Ce n’est pas de la mauvaise volonté, mais à chaque essai j’ai passé des jours à réparer mes erreurs et à solliciter la communauté.
Ma requête :
> comment installer simplement ce plugin ?
> Quelle démarche (explicable à un néophyte).
- > nécessite-t-il d’autres plugin (j’ai cru comprendre qu’agenda était nécessaire)
Pourquoi ne pas le publier en plugin « prêt à l’emploi » comme les autres ?
J’ai conscience que ce genre d’intervention de novice peut vous être énervante, j’en suis désolé mais vous en serait aussi reconnaissant de m’expliquer la démarche.
Merci beaucoup,
cordialement,
JM
Sur spip3, pour installer facilement ce plugin il suffit de se servir de SVP (l’outil de gestion des plugins). Une recherche de icalendar, un clic sur installer et c’est fait. Les dépendances sont automatiquement gérées. Icalendar est bien prêt à l’emploi !
Répondre à ce message
Bonjour,
En php, quand on a le résultat issu de la fonction inc_ics_to_array, comment récupère-t-on une donnée de l’événement ?
J’ai trouvé ceci, mais y a-t-il plus simple, avec un XPath par exemple ?
]]
Répondre à ce message
Bonjour,
Merci ( pour les itérateurs en général ), il est noté dans cet article :
Donne une erreur 404, j’ai regardé vite fait le plugin ce serait plutôt :
/demo/iter_icalendar.html
mais ça donne rien non plus.
PS/ La page de démo des itérateurs fonctionne correctement.
Nicolas.
Petite précision, je suis en php 5.2, spip 2.2.0-dev SVN [15979], si je copie/colle le code de la boucle ci-dessus, j’obtiens bien les informations mais le code à l’air « de sauter » vers replace :
extrait.
C’est mon copié/collé qui à déconné ou bien ?
Merci,
Nicolas.
j’ai corrigé le code et le lien vers la démo
merci
Répondre à ce message
Ajouter un commentaire
Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :
Merci d’avance pour les personnes qui vous aideront !
Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.
Suivre les commentaires : |