SPIP-Contrib

SPIP-Contrib

عربي | Deutsch | English | Español | français | italiano | Nederlands

286 Plugins, 197 contribs sur SPIP-Zone, 198 visiteurs en ce moment

Accueil > Interactivité, échanges > Importation de contacts > Importateur de contacts > Importateur de contacts

Importateur de contacts

6 novembre 2011 – par kent1, RastaPopoulos

6 votes

Un plugin générique pour importer des contacts.

Description

Ce plugin est un outil pour développeurs, qui fournit un formulaire configurable d’importation de contacts.

Le plugin en lui-même ne propose aucun service web chez qui récupérer les contacts. Il offre un API (interface de programmation) que d’autres plugins doivent implémenter afin de fournir tel ou tel service d’importation.

De la même façon, ce plugin ne fait aucun traitement. À la fin de l’importation, la liste des contacts est enregistrées dans une variable de session « contacts », et une fonction de rappel peut également être appelée (voir plus bas).

Configuration du formulaire

Lorsqu’au moins une implémentation est installée, vous pouvez aller configurer le plugin dans l’espace privé. La page liste alors l’ensemble des services possibles, et c’est à vous de choisir lesquels vous désirez activer.

Les implémentations connues que vous pouvez installer :

Utilisation du formulaire

Le formulaire est appelé par #FORMULAIRE_IMPORTER_CONTACTS.

Deux arguments optionnels sont acceptés : #FORMULAIRE_IMPORTER_CONTACTS{URL de retour, fonction de rappel}

  • URL de retour : comme dans la majorité des formulaires SPIP, vous pouvez définir vers quelle page le formulaire renverra à la fin du traitement.
  • La fonction de rappel correspond au nom d’une fonction existante dans votre application, qui sera alors appelée à la fin de l’importation, avec en paramètre le tableau des contacts importés. Par exemple : function mon_traitement($contacts).

La liste des contacts, que ce soit en session ou pour la fonction de rappel, est un tableau constitué d’une liste de tableaux ayant « nom » et « email » comme clés :

  1. array('nom' => 'Georges', 'email' => 'gigi@lamoroso.org'),
  2. array(...),
  3. )

Télécharger

API pour ajouter des services

Un plugin voulant implémenter cette fonctionnalité, doit :

  • utiliser le pipeline importateur_contacts_moteurs pour déclarer le moteur et ses fournisseurs ;
  • avoir une fonction formulaires_importer_contacts_charger_NOMDUMOTEUR($fournisseur) qui déclare les champs nécessaires à ce moteur ou au fournisseur précis choisi (que l’on a en paramètre) ;
  • avoir un squelette formulaires/importer_contacts_NOMDUMOTEUR.html avec le HTML de ces champs ;
  • avoir une fonction formulaires_importer_contacts_verifier_NOMDUMOTEUR($fournisseur) qui vérifie la validité de ces champs ET qui va chercher les contacts en utilisant le fournisseur choisir ET qui place ces contacts dans set_request('contacts', $contacts).

Pour les détails, il faudra pour l’instant étudier le code du plugin OpenInviter.

Voir en ligne : http://plugins.spip.net/importateur...

Dernière modification de cette page le 31 mai 2013

Retour en haut de la page

Répondre à cet article

Qui êtes-vous ?

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici Les choses à faire avant de poser une question (Prolégomènes aux rapports de bugs. )
Ajouter un document

Retour en haut de la page

Ça discute par ici

  • Formidable, le générateur de formulaires

    23 janvier 2012 – 2141 commentaires

    Un générateur de formulaires facilement configurable pour les non-informaticiens et facilement extensible pour les développeurs. Introduction L’objectif était de créer un plugin permettant de générer des formulaires. Historiquement, 2 plugins (...)

  • Facteur

    21 janvier 2010 – 375 commentaires

    Un plugin pour regrouper toutes les fonctions avancées autour de l’envoi de courriels. Introduction SPIP propose une fonction générique envoyer_mail() pour envoyer un courriel. Elle est assez simple d’utilisation mais peut paraître limitée (...)

  • Sélections éditoriales

    19 mars 2015 – 66 commentaires

    Faites des listes de choses intéressantes. Ce plugin permet de gérer des listes de contenus quelconques de manière éditoriale. Chaque sélection est donc entièrement libre, et peut renvoyer aussi bien vers des contenus internes au SPIP quels qu’ils (...)

  • En onglets dans le texte de SPIP, ou ailleurs...

    18 décembre 2006 – 132 commentaires

    Une mise en page en blocs superposés, très pratique pour des fiches techniques par exemple, toutes versions SPIP !

  • Des blocs dépliables

    6 janvier 2008 – 473 commentaires

    Cet outil vous permet de créer des blocs dont le titre cliquable peut rendre un contenu visible ou invisible, voire de les munir d’une adresse pour que le bloc visible soit récupéré en AJAX. Ces blocs sont disponibles dans tous vos contenus SPIP (...)