SPIP-Contrib

SPIP-Contrib

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

290 Plugins, 198 contribs sur SPIP-Zone, 90 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 : https://plugins.spip.net/importateu...

Dernière modification de cette page le 7 novembre 2017

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

  • Albums 3

    8 août 2014 – 289 commentaires

    Le plugin « Albums » évolue dans une version 3 pour SPIP 3. Avant d’effectuer une mise à jour depuis la version 1 ou 2, consultez les notes sur la rétro-compatibilité. Les modèles, notamment, on reçut quelques changements pour la bonne cause. En (...)

  • Module de Paiement Stripe

    17 octobre 2016 – 14 commentaires

    Stripe est un prestataire de paiement externe https://stripe.com/fr qui propose une API moderne et une interface de paiement extrêmement conviviale et efficace. Ce module permet les paiements à l’acte et les paiement récurrents. Configuration (...)

  • Massicot

    7 octobre 2015 – 81 commentaires

    Recadrez et redimensionnez vos images directement dans l’espace privé de SPIP ! Inspiré par le plugin photospip, ce plugin plus minimaliste permet de recadrer et redimensionner les images dans l’espace privé de SPIP. Une fois le plugin installé et (...)

  • Éditorial (HTML5UP)

    27 novembre 2017 – 108 commentaires

    Squelette SPIP pour intégrer le modèle Editorial de HTML5UP https://html5up.net/editorial Configuration La page de configuration permet quelques réglages. On y défini la couleur principale du site, des informations de contact et le contenu de la (...)

  • Docker importe vos documents distants

    25 février 2013 – commentaires

    Un plugin qui permet de recopier localement dans le dossier IMG l’ensemble de vos documents distants. SPIP a un mode de documents qui permet d’indexer dans la base des documents en les laissant sur internet. On peut recopier individuellement (...)