Plugin Contacts & Organisations

Published : 4 January 2010 – updated on 5 September 2021 – by Cyril Marion, Matthieu Marcillaud, RastaPopoulos – 279 commentaires

1
2
3
4
5
54 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…).

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

Discussion

5 years 1 year 3 months Without limit
par date
Filter

85 discussions

  • 1
    lebardix

    Bonjour,

    Spip 3
    Comment faire pour inclure, dans un article, le contenu d’une organisation ?
    existe-il un modele
    ou bien modifier article.html avec #INCLURE ??

    Merci
    c’est sans doute une question de débutant ... de l’aide serait bienvenue

    • lebardix

      Bon voilà ma petite coopération, un modele à utiliser dans un article.

      [(#REM)
  Copie du 2021-03-23 17:35:02 par administrateur
  Fichier original tmp/cache/scaffold/contenu/organisation.html
  Modèle «organisation» par défaut : voir schéma complet des données d'une organisation
 
         Utilisation :
        - Dans un squelette : #MODELE{organisation, id_organisation=x, param}
        - Dans un article :     <organisation|id_organisation=x|parametres> 
][(#REM)
        Paramètres :
                id_organisation Identifiant d'une organisation.
                v_tout          Afficher l'ensemble des données de l'organisation
                v_legales       Afficher les données légales
                v_adresse       Afficher l'adresse (gis)
                v_web           Afficher l'adresse du site Web
                v_description	Afficher la description
                v_horaire		Afficher les horaires
                v_tarifs		Afficher les tarifs
                v_telephone		Affficher les téléphones
                v_mail			Afficher les mails
                v_rezo			Afficher les reseaux sociaux
]
<BOUCLE_contenu(spip_organisations){id_organisation}>
<div class='contenu-principal'>
	[(#ENV{v_titre}|ou{#ENV{v_tout}}|oui)<div class='cartouche'><h2 class='#EDIT{nom} nom'>[(#NOM|image_reduire{500,0})]</h2></div>]
	[(#ENV{v_date}|ou{#ENV{v_tout}}|oui)<div class='cartouche'>#OUVERTURES</div>]
	<B_adresses><BOUCLE_adresses(ADRESSES adresses_liens?){id_organisation}>[(#ENV{v_adresse}|ou{#ENV{v_tout}}|oui)#INCLURE{fond=modeles/picto,nom=map-marker,theme=carreVide,taille=1} #VOIE #CODE_POSTAL #VILLE ]</BOUCLE_adresses><br />
	</B_adresses>
[(#REM) #TYPE #NUMERO ]
	<B_telephones><BOUCLE_telephones(NUMEROS numeros_liens?){id_organisation}>[(#ENV{v_phone}|ou{#ENV{v_tout}}|oui)#INCLURE{fond=modeles/picto,nom=#TYPE,theme=carreVide,taille=1} #NUMERO ]</BOUCLE_telephones><br />
	</B_telephones>
	[(#ENV{v_mail}|ou{#ENV{v_tout}}|oui)]<B_emails>
	<BOUCLE_emails(EMAILS emails_liens?){id_organisation}>[(#ENV{v_mail}|ou{#ENV{v_tout}}|oui)
	<a href="mailto:#EMAIL">#INCLURE{fond=modeles/picto,nom=at,theme=carreVide,taille=1}Envoyer un email</a> ]</BOUCLE_emails><br />
	</B_emails>
	[(#ENV{v_web}|ou{#ENV{v_tout}}|oui)<div class='#EDIT{url_site} url_site'>  <a href="#URL_SITE" target="_blank"> #INCLURE{fond=modeles/picto,nom=home,theme=carreVide,taille=1} #URL_SITE </a> </div>]
	<B_socios><BOUCLE_socios(REZOSOCIOS rezosocios_liens?){id_organisation}>#SET{type, #TYPE_REZO|mb_strtolower}
	<a href="https://www.#GET{type}.com/#NOM_COMPTE" target="_blank">[(#ENV{v_rezo}|ou{#ENV{v_tout}}|oui)#INCLURE{fond=modeles/picto,nom=#GET{type},theme=carreVide,taille=1}Rejoindre le réseau</a> ]</BOUCLE_socios><br />
	</B_socios>
</div>
[<div class='notes surlignable'><h2 class='h2 pas_surlignable'><:info_notes:></h2>(#NOTES)</div>]
</BOUCLE_contenu>

      et un exemple https://3w.plandecuques.fr/lou-grihet-dou-plan-dei-cuco

    Reply to this message

  • 1
    Manu

    À la manière de ce que fait le plugin “auteurs partout”, y a-t-il un moyen pour lier un évènement (agenda), un article etc... non pas à un auteur mais à une organisation ?

    • RastaPopoulos

      Oui c’est dans la config du plugin, tu peux dire sur quels objets tu veux lier des Contacts ou des Organisations, et donc après t’as les boites de liaison sur les objets cochés.

    Reply to this message

  • 2
    Thrax

    Tout en abord bravo pour ce plugin que j’utilise avec beaucoup de plaisir.

    Je ne souhaite pas qu’un auteur devenu une Organisation utilise son identifiant et son mot de passe. Cette utilisation au nom d’une Organisation est générique. Or, le RGPD demande à ce que nous puissions avoir une traçabilités des opérateurs et ce mode de connexion me pose problème.
    En d’autres termes, je souhaite que seul les Contacts puissent se connecter en tant qu’Auteur.

    Y-a-t-il une démarche simple que je puisse mettre en œuvre ?

    merci par avance.

    • RastaPopoulos

      vider leur login et leur mot de passe ?

    • Thrax

      Oui, démarche simple et efficace. Merci.
      Et lors de création, ne pas indiquer de login et mot de passe pour ne pas permettre d’accès.

    Reply to this message

  • 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

Add a comment

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite / PostgreSQL
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparait.

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.

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