Objet
Ce plugin facilite l’interaction entre le site et les internautes en permettant de mettre à disposition un contact ou un rendez-vous afin de les intégrer dans ses carnets d’adresses ou dans ses calendriers personnels.
Installation
Le plugin s’installe comme n’importe quel plugin SPIP.
Fonctionnement
Le plugin met à disposition différents outils :
- des modèles qui affichent un lien de téléchargement ou de remplissage d’un rendez-vous ou de la carte de visite ;
- un traitement automatique pour insérer la vCard d’un auteur dans sa boite d’infos.
- un traitement automatique pour insérer le rendez-vous iCal d’un évènement du plugin Agenda dans sa boite d’infos.
Les modèles
Les modèles vous permettent de faire apparaitre dans vos textes des boutons de téléchargement.
icône par défaut | nom du modèle | effet |
---|---|---|
bouton_rdv | permet de télécharger le fichier .ics correspondant au rendez-vous défini. | |
bouton_rdv_google | permet d’ouvrir un formulaire Google pour saisir un rendez-vous qui sera ajouter l’agenda de son choix (API Google) | |
bouton_vcard | permet de télécharger le fichier .vcf correspondant à la vCard définie | |
bouton_vcard_auteur | permet de télécharger le fichier .vcf correspondant à la vCard de l’auteur spip choisi | |
bouton_rdv_evenement | permet de télécharger le fichier .ics correspondant au rendez-vous de l’évènement du plugin Agenda choisi |
Les exemples qui suivent permettent d’identifier l’ensemble des paramètres utilisables dans les modèles, donc le périmètre strictement utilisé par le plugin pour les vCard et les rendez-vous. A cet égard, le plugin n’autorise aujourd’hui que les mails, adresses et numéros de téléphone dont le type est personnel (home) et professionnel (work).
Les paramètres label et icone ne sont pas liés au rendez-vous ou à la carte de visite mais permettent de choisir le libellé ou l’icone affiché. Ces paramètres ne sont pas obligatoires, le plugin pouvant afficher un icone et un label par défaut.
<bouton_rdv
|debut=9/3/2022 10:00
|fin=9/3/2022 11:00
|titre=Mon beau RDV
|lieu=Chez mon pote Roger
|description=je suis une description sur
plusieurs lignes. Cette ligne doit dépasser les 75 caractères pour tester la découpe. Et même pire cette ligne va être plus grande que deux fois afin de tester encore mieux.
Encore une petite pour la route.
|label=Mon RDV
|icone=agenda-xx.svg
>
<bouton_rdv_google
|debut=9/3/2022 10:00
|fin=9/3/2022 11:00
|titre=Mon beau RDV
|lieu=Chez mon pote Roger
|description=je suis une description sur
plusieurs lignes. Cette ligne doit dépasser les 75 caractères pour tester la découpe. Et même pire cette ligne va être plus grande que deux fois afin de tester encore mieux.
Encore une petite pour la route.
|label=Mon RDV Google
|icone=agenda-xx.svg
>
<bouton_vcard
|nom=Martin
|prenom=Jean-Charles
|employeur=Alstom
|fonction=Directeur technique
|telhome=+33142729663
|telwork=+33612345678
|mailwork=jcmartin@alstom.com
|adrhome=13 rue Charles Vincennes;75015;PARIS;;France
|site=http://blog.martin.net/
|naissance=12/3/1998
|note=je suis une note sur
plusieurs lignes.
Encore une petite pour la route.
|label=Ma belle vCard
|icone=article-xx.svg
>
<bouton_vcard_auteur
|id_auteur=10
>
<bouton_rdv_evenement
|id_evenement=11
>
Ajout de la vCard dans la boite d’infos d’un auteur
Pour un auteur affichant sa propre fiche, le plugin insère le lien de téléchargement de sa vCard dans la boite d’infos. Il n’est donc pas possible pour un auteur donné de télécharger dans le privé la vCard d’un autre auteur (RGPD).
Cependant, rien n’empêche un auteur donné de publier sa propre carte de visite en utilisant les modèles précités dans une page de son site.
Utilisation des plugins Contacts et Organisations et Coordonnées
Les plugins Contacts & Organisations et Coordonnées sont compatibles avec le plugin Boutons Contacts & Rendez-vous. En effet, si un auteur est configuré comme un contact, les données du contact sont utilisées en priorité pour créer la vCard.
De même pour Coordonnées, les mails, téléphones et adresses postales de type personnel et professionnel sont utilisées en priorité pour compléter la vCard de l’auteur concerné.
Ces plugins ne sont opérationnels que pour la vCard liée à un auteur. Ils fonctionnent avec le modèle bouton_vcard_auteur
et le lien automatique vCard de la page auteur uniquement.
Ajout du rdv iCal dans la boite d’infos d’un évènement d’Agenda
Pour un évènement du plugin Agedna affichant sa propre fiche, le plugin insère le lien de téléchargement de son iCal dans la boite d’infos si l’autorisation voir est accordée.
Principes de développement
Le plugin aurait pu utiliser des librairies en javascript ou des class PHP pour gérer les normes ICS, vCard ou GoogleAgenda, mais l’idée est de rester simple et léger en ne proposant que les options principales de ces normes.
Aucune discussion
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 : |