Plugin Contacts & Organisations

4 January 2010 – by Cyril Marion, Matthieu Marcillaud, RastaPopoulos – 272 commentaires

1
2
3
4
5
52 Votes

Ce plugin ajoute à SPIP des fonctionnalités de gestionnaire de contacts. Distingue les personnes morales (organisations) des personnes physiques (contacts) en conservant tous les attributs des auteurs SPIP.

En conjonction avec le plugin Coordonnées, il permet d’étendre à la fois les champs unitaires (prénom, date de naissance…) et les champs multiples (numéros de téléphone, adresses mail…).

Table of contents

Principe

Comme un certain nombre d’autres plugins jusque là, “Contacts & Organisations” ajoute des champs indispensables à la table spip_auteurs, dès lors qu’il s’agit de gérer des personnes d’une manière un peu poussée. La table spip_auteurs est par nature, et historiquement sans doute, limitée aux champs nécessaires pour la rédaction d’articles. Dès que cette table doit être utilisée pour d’autres fonctions (inscription, transaction, etc.) certaines caractéristiques lui font défaut, et parmi elles :

-  prénom, date de naissance, autres informations personnelles
-  notion de “groupes d’auteurs”
-  plus de une adresse mail, plusieurs numéros de téléphone ou ID communautaires (ICQ, MSN)
-  autres informations spécifiques à l’utilisation

Objectif

Lors du développement du plugin nous avons veillé à ce que la notion d’auteur SPIP soit conservée. Nous avons par exemple choisi de ne pas modifier l’intégrité de la table spip_auteurs, ce qui permet de conserver possibilités de gestion déjà développées, telles que celles fournies par les plugins acces_restreint ou spip_liste. Ainsi, nous avons seulement ajouté les tables nécessaires à l’ajout de propriétés aux auteurs et les avons liées à la table spip_auteurs.

Ce plugin est déjà utilisé par le plugin Catalogue, et le plugin SPIPMine.

Fonctionnement

Une fois le plugin installé, une nouvelle boîte de dialogue apparait dans l’interface privée sur la page d’un auteur :

Tous les auteurs SPIP du site peuvent désormais acquérir un statut de “contact” ou d’“organisation”.

Exemple 1 : ajouter un contact

Prenons l’exemple d’un auteur SPIP dont on veuille gérer distinctement le nom, le prénom et l’activité (fonction). Si on attribue à cet auteur le statut de contact, les champs nom, prénom, et activité seront disponibles dans les boucles #AUTEUR. Pour conférer le statut de “contact” à un auteur SPIP, dépliez la boîte et cliquez sur “devenir contact” :

Dès lors, les champs supplémentaires de la fiche contact sont disponibles sur la fiche auteur sur la page d’édition d’un auteur. Pour ajouter les informations correspondant à ces champs, cliquez sur “modifier cet auteur”, puis descendez jusqu’à “détails du contact” :

Si le plugin coordonnées est aussi installé, il est possible d’ajouter des numéros de téléphone, adresses mail ou adresses postales à ce contact :

Exemple 2 : ajouter une organisation

De la même manière, on peut attribuer à un auteur SPIP le statut “organisation” (une société, une association...) afin de gérer par exemple une liste de fournisseurs ou de clients.

Choisissez l’auteur SPIP à qui attribuer le statut d’organisation, puis dépliez la boite de dialogue “Contacts & Organisations” et cliquez sur “Devenir une organisation”. Modifiez l’auteur (maintenant devenu une organisation) et ajoutez lui les informations nécessaires. Ce qui donnera, par exemple :

Exemple 3 : lier un contact à une organisation

Le plugin permet de lier un ou plusieurs contacts, à une ou plusieurs organisations. Cette fonctionnalité (en cours de test) est inspirée des logiciels CRM de gestion de contacts.

On peut lier un contact avec une organisation, soit depuis une fiche contact, soit depuis une fiche organisation. Voici un exemple de liaison d’un contact avec une organisation à partir d’une fiche organisation.

Depuis la fiche “auteur” de l’organisation, dépliez la la boite de dialogue; un champ de saisie apparait et permet de rechercher un contact [1] à lier à l’organisation.

Une fois le(s) contact(s) trouvé(s) par SPIP affiché(s), cliquez sur le “+” pour lier ce contact à l’organisation. Pour “délier” le contact de l’organisation, il suffit de cliquer sur le bouton “délier” (icône en forme de maillon de chaine rompu).

Dépendances

Le plugin “Contacts & organisations” nécessite le plugin saisies en version 1.7.7 minimum (pour la saisie du champ date).

Nouvelles tables / nouveaux champs

Le plugin installe 3 nouvelles tables, et permet d’utiliser de nouveaux champs dans les boucles #AUTEURS :

  • table spip_contacts :
    • #CIVILITE
    • #NOM
    • #PRENOM
    • #FONCTION
    • #DATE_NAISSANCE
    • #DESCRIPTIF
  • table spip_organisations :
    • #NOM
    • #STATUT_JURIDIQUE (anciennement “type”)
    • #IDENTIFICATION (anciennement “siret”)
    • #ACTIVITE
    • #DATE_CREATION
    • #DESCRIPTIF
  • table spip_contacts_organisations
    • pas de champ nouveau, mais permet de déterminer des liaisons entre contacts et organisations

Annuaires

Il est possible de regrouper des organisations et/ou des contacts, en les séparant dans des annuaires différents. Chaque fiche ne peut appartenir qu’à un seul annuaire.

Partie expérimentale

Rq: les pages présentées ici ont bien évolué depuis la création de cette documentation.

Deux pages de gestion des contact et des organisations sont en cours d’élaboration et présentes dans le plugin :

Les fonctionnalités sont à imaginer à partir de ces pages (imports, transformations en masse, etc.). N’hésitez pas à faire des suggestions.

Footnotes

[1] un spip_auteur ayant le statut de contact

Portfolio

updated on 2 October 2019

Discussion

5 ans 1 an 3 mois Sans limite
Last published
Filtrer

82 discussions

  • 1
    ygornet

    Salut à tous

    je crée un auteur
    je l’associe à un contact
    en rééditant l’auteur, je sélectionne l’annuaire “Boulanger” pour ce contact

    dans la page contacts et organisation
    il y a 3 onglets : Répertoire, Organisations, Contacts

    dans Répertoire, s’affichent les annuaires
    je sélectionne l’annuaire “Boulanger”
    et je ne vois pas le nouveau contact
    pour le voir dans cette liste,
    il faudrait que j’ajoute le contact à cet annuaire
    ce qui ajouterait une entrée dans spip_contacts_liens

    dans Contacts, là je retrouve aussitôt mon auteur
    dans l’onglet de l’annuaire “Boulanger” à partir du champ id_annuaire de spip_contacts

    ce n’est pas un peu tordu ce truc ?
    pourquoi donc ces deux fonctionnement ?
    c’est très déroutant

    • RastaPopoulos

      Salut, je pige pas pourquoi tu parles de table de lien. L’annuaire est unique pour une fiche (contact ou orga), soit il n’est nulle part, soit il est dans un annuaire, avec son champ id_annuaire rempli. Ya pas plusieurs fonctionnements.

    Reply to this message

  • 3
    Jam

    Bonjour,

    Je n’arrive pas afficher une organisation suivant un mot clef dans un squelette, par exemple :

    <BOUCLE_organisation(ORGANISATIONS){id_mot=17}>
      #NOM
</BOUCLE_organisation>

    Si l’auteur n’est pas une organisation, il est bien affiché par la boucle

    <BOUCLE_auteur(AUTEURS){id_mot=17}>
      #NOM
</BOUCLE_auteur>

    Merci pour vos lumières !

    • Jam

      Bon, à priori, il faut ajouter l’organisation au mot clef et non le mot clef à l’organisation pour que cela fonctionne.

    • RastaPopoulos

      Bah non, ça ne veut plus dire la même chose, c’est pas du tout pareil.

      Quand deux objets ont des tables de liens, il faut spécifier explicitement la liaison que tu cherches à faire sinon il utilise la première table de lien qu’il trouve, celle de l’objet principal de la boucle.

      Il faut mettre {mots_liens.id_mot}

    • Jam

      Oh ! Je te remercie beaucoup pour ta réponse :) et évidemment cela fonctionne parfaitement.

    Reply to this message

  • 1
    Safari

    Avec Spip 3.1.1 j’ai un problème que je n’ai pas avec Spip 3.1.0, à savoir l’impossibilité d’afficher une page ’annuaire.html’ dans la partie publique du site, avec l’erreur suivante:

    Fatal error: Call to undefined function type_du_logo() in /home/.../ecrire/public/composer.php on line 548

    Ceci, quelque soit le réglage de la fonction ’Activer les squelettes publics pour ZPIP en version 1, permettant le parcourir les contacts et organisations dans l’espace public ?’.

    D’autres rencontrent le meme problème?

    • RastaPopoulos

      Je ne vois pas trop le rapport avec cette erreur. Car c’est surtout une erreur 404 que tu devrais avoir, vu qu’il n’existe pas du tout de squelette “annuaire” par défaut. À moins que tu n’en ais toi-même ajouter un perso.

    Reply to this message

  • 1
    FdM

    Tout à coup mon merveilleux petit plugin me fait des siennes?

    Erreur SQL 1064
    You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near ’)) AS titre_rang FROM `xxxxxxxxx`.spip_contacts AS `contacts` WHERE (contacts’ at line 1
    SELECT contacts.prenom, contacts.nom, contacts.id_contact, nom)) AS titre_rang FROM spip_contacts AS `contacts` WHERE (contacts.id_contact = xxxxx)
    /home/xxxxx/www/ecrire/public/composer.php

    Boucle: calculer_select() sql_select();
    Ligne: 1005

    A l’aide !

    • RastaPopoulos

      Oui, il faut avoir SPIP à jour pour cette mise à jour du plugin :(

      Un bug dans la balise #RANG a été corrigé récemment, et il y a besoin de cette correction pour l’amélioration apportée dans la déclaration du titre des contacts.

      Soit avec SVN, soit avec le ZIP de la branche stable (pas de telle version précise, mais de la branche).

    Reply to this message

  • 4
    Stéphane Santon

    Bonjour,

    Oui, bravo pour ce plugin.

    Nouvelle suggestion :
    Lorsque le champ #NOM n’est utilisé qu’avec des initiales, exemple “D.”, conjointement avec un prénom complet, l’URL résultante est de la forme contact2.html car #NOM trop court.

    Pourrait-on proposer, si le #PRENOM existe, de l’utiliser pour allonger l’URL, qui deviendrait de la forme louis-d.html ?

    Merci

    Reply to this message

  • 2
    pascal

    Hello

    re-merci pour cet excellent plugin (on le ne dit jamais assez)
    Juste pour signaler un truc pas grave du tout mais que mes admins n’ont pas manqué de souligner (ils ont le don pour trouver tout de suite ce qui ne fonctionne pas ,-) ) : depuis peu on dispose d’un menu abc pour naviguer dans les organisations. Très bonne idée. Cependant sur notre site (en 3.0) il est inopérant : on voit qu’il se passe quelque chose, la petite roue indique un rechargement ajax de la liste, mais elle reste identque quelle que soit la lettre sur laquelle on clique.

    Voilà. Comme je le disais c’est pas bloquant.
    Peut-être est-ce un conflit avec un autre plugin ou un truc manquant chez nous ? Mais si jamais c’est un bug du plugin et que ça peut être fixé dans une prochaine version ça fera des heureux.
    Merci !

    • RastaPopoulos

      chez-moi-ça-marche ©

      ça reste évidemment identique si la lettre sur laquelle tu cliques commence sur la page sur laquelle tu es déjà

      par contre il manquait les ancres, qui étaient dans les URL mais pas dans le HTML, je viens de les rajouter :
      http://zone.spip.org/trac/spip-zone/changeset/95729

    • pascal

      Toujours pas chez moi.
      Je vais regarder ça d’un peu plus près voir si je trouve un début de piste, conflit de plugins ou autre.
      J’ai eu un espoir en me disant “ben oui les ancres !” heu. Mais non. Je vais dégainer firebug ;-)

    Reply to this message

  • Stéphane Santon

    Bonjour,

    Un bug à signaler sur V2.13.0 et qui était déjà sur 2.12.z, Spip 3.1.0

    * Edition | Contacts et organisations
    * Créer une organisation
    * Saisie :
    -  Nom : 1ère-SI
    -  Organisation parente : sélection d’une autre organisation
    -  Enregistrer
    * Redirigé vers ecrire/?exec=organisation&id_organisation=0

    donc message :

    Accès interdit
    Vous n’avez pas le droit d’accéder à la page organisation.

    Mais l’organisation est bien créée

    Merci

    Reply to this message

  • 1
    Stéphane Santon

    Bonjour,

    Est-ce qu’a été implémenté un critère {branche} qui permettrait de lister tous les contacts d’une organisation ET de ses sous-organisations ?

    Merci

    Reply to this message

  • 2
    Boris

    Bonjour,

    merci pour ce plugin.

    Je me demande comment référencer au mieux quand une organisation à de nombreux services.

    Un service n’est pas forcement une personne “physique” à référencer (pas de civilité, prénom, nom, etc).
    Et un service n’est pas non plus une organisation (pas de statut juridique, siren, etc).

    Par contre un service a bien des coordonnées dédiées : adresse, téléphone ou courriel, parfois un contact (personne physique).

    Qu’en pensez vous ?

    • RastaPopoulos

      Ben c’est clairement une sous-organisation. T’es pas obligé de remplir tous les champs hein. Il faut activer l’arborescence d’orgas dans la config du plugin.

    • Boris

      ok merci j’étais passé à côté de cette option dans la config du plugin.

      Donc pour résumé mon cas, chaque service aura une fiche light “Organisation” et la filiation sera gérée avec l’arborescence d’organisation.
      Merci encore !

    Reply to this message

  • 2
    Stéphane Santon

    Bonjour,

    J’ai lié un auteur à un contact, je place un logo (avatar) sur le contact. Ce logo n’est-il pas reporté sur l’auteur ?? Si non peut-on le faire automatiquement ?

    Merci

    • RastaPopoulos

      Non il n’y a rien de prévu pour ça désolé. C’est juste lié entre eux, mais chacun a ses champs (même le nom peut être différent), et pareil pour le logo et aussi pour les documents joints par exemple, chacun ses trucs.

    • Stéphane Santon

      Merci pour la précision, et pour le plugin.

    Reply to this message

Comment on this article

Who are you?
  • [Log in]

To show your avatar with your message, register it first on gravatar.com (free et painless) and don’t forget to indicate your Email addresse here.

Enter your comment here

This form accepts SPIP shortcuts {{bold}} {italic} -*list [text->url] <quote> <code> and HTML code <q> <del> <ins>. To create paragraphs, just leave empty lines.

Add a document

Follow the comments: RSS 2.0 | Atom