Annuaire avec Forms & Tables

Exemple concret de création d’un annuaire style « page jaune », qui peut servir aussi de pas à pas pour le plugin Forms & Tables

Cette mini doc est tirée de ma propre expérience de débutant avec SPIP, et n’est peut-être pas la meilleure façon de faire, mais au moins cela fonctionne.

Nota SPIP-Contrib : une contribution qui affiche clairement sa nature de témoignage de mise en oeuvre pouvant être améliorée de Forms & Tables, mais justement intéressante pour cela

Un annuaire en trois pages

L’annuaire est composé de trois pages
-  La première est la liste des catégories (métier, ou autre), la page entreprise.html
-  La seconde liste les fiches qui appartiennent à la catégorie choisie, la page fichecat.html
-  La dernière est la fiche détaillée du sujet, la page ficheent.html

Aperçu de l’annuaire
Montage de prises d’écran

Utilisation de Forms & Tables

Tout d’abord, il vous faut créer deux tables, dans la partie privée. Appelons-les « Entreprises » et « Catégorie » :
-  « Entreprise » correspond à votre table principale. Elle contient des champs comme « Nom », « Adresse », « Téléphone », etc.
-  « Catégorie » n’a qu’un seul champ, le champ « NomCat »

L’idée est d’utiliser le champ de table liée pour simuler une contrainte hiérarchique et générer ainsi un arbre hiérarchique. En réalité, tout est factice, mais le résultat correspond à ce que l’on cherche.

La page entreprise.html

J’ai choisi d’afficher les catégories par 2, mais vous pouvez simplifier le code en supprimant tout ce qui est html+la boucle _suite.

Cette page est simple, on liste toutes les catégories de notre table « catégorie » et on y colle un lien qui prend en paramètre le nom de la catégorie. (Et non l’id). Petit point interessant, pour trier les données, on utilise "tri_donnee NomChampSpecifiant". Ainsi il faut que le champ soit déclaré "spécifiant" et que l’on releve son nom de champ spécifiant en regardant dans la base de donnée, ou dans les URL servant à trier les données depuis la page d’administration. Ils sont de la forme "ligne_X"

Son code de squelette est le suivant

<div>
	<BOUCLE_champs(FORMS_CHAMPS){titre=NomCat}{tri_donnee ligne_1}>
	<table width="100%" border="0">
	<B_reponses>
	<tr>
		<BOUCLE_reponses(FORMS_DONNEES){id_form=1}{doublons}{0,2}>
			<td width="50%">
				<a href="spip.php?page=fichecat&nom_cat=#VALEUR"><b>#VALEUR</b></a>
			</td>
		</BOUCLE_reponses>
	</tr>

	<BOUCLE_reponses_suite (BOUCLE_reponses)></BOUCLE_reponses_suite>

</B_reponses>
</table>
</BOUCLE_champs>
</div>

La page fichecat.html

Cette page n’est absolument pas optimisée, mais elle est tout de même la page qui posait problème à beaucoup de personnes. La liaison de table étant factice, comment réalisé les boucles ? Je ne sais pas comment Cédric fait, mais voici ma façon de faire.

D’abord, je vais chercher dans la table « FORMS_DONNES_CHAMPS » l’id qui correspond au nom de ma catégorie.

Ensuite je crée un tableau ’tab’ et j’y imbrique trois boucles (voir le code plus bas) :
-  la première sélectionne l’id_form de votre table « Entreprise »
-  la seconde sélectionne uniquement les id_donnee qui ont une correspondance à votre id de catégorie dans la table « FORMS_DONNEES_DONNEES. »
-  enfin la dernière choisit de n’afficher que le nom de l’entreprise et la range dans le tableau.

Si j’ai utilisé un tableau c’est parce que cet enchainement de boucles a un soucis que je n’ai su résoudre, des doublons. Alors grâce au tableau
je passe une petite fonction array_unique pour les balayer.

Enfin, je mets en lien ma ficheent.html avec en paramètre mon id_donnee (et accessoirement le nom de la catégorie si je veux l’afficher dans la fiche de mon entreprise)

<table width="100%">
	
<BOUCLE_cat(FORMS_DONNEES_CHAMPS){valeur=#ENV{nom_cat}}>
        #SET{id_cat,#ID_DONNEE}
</BOUCLE_cat>

    #SET{tab,#ARRAY{0,0}}
    
    <BOUCLE_reponses(FORMS_DONNEES){id_form=2}>
        <BOUCLE_lie(SPIP_FORMS_DONNEES_DONNEES){id_donnee_liee=#GET{id_cat}}>
            <BOUCLE_champs(FORMS_CHAMPS){titre=Nom}{tri_donnee ligne_1}>
            [<tr><td><div class="bordureCat2"><a href="spip.php?page=ficheent&nom_cat=#ENV{nom_cat}&id_donnee=#ID_DONNEE"><img src="images/puceCat.gif" border="0" />&nbsp;&nbsp;<b>(#VALEUR|in_array{[(#GET**{tab})]}|?{'',#VALEUR})]
            [(#GET{tab}|array_push{#VALEUR}|?{''})</b></a></div></td></tr>]                      
			</BOUCLE_champs>
        </BOUCLE_lie>	

    </BOUCLE_reponses>
</table>

La page ficheent.html

J’ai laissé exprès la mise en page pour montrer l’utilisation des différents type de champs, notamment les images.

Mon astuce pour afficher une image est d’utiliser un champ ligne de texte, d’utiliser l’uploader de SPIP (pour cela pensez a cocher « permettre l’ajout de fichiers » a la création de la table), puis en glisser/deposer, l’URL de mon image se retrouve dans ma ligne de texte.

Je traite a la suite mon champ dans une balise par un #SET puis un #GET qui prend en sus un filtre de création de vignette. (L’encapsulation de f&t doit pouvoir être utilisée mais je ne sais pas comment)

Bon sinon cette page est aussi simple que la première, on affiche nos différents champs (soit avec #LESVALEURS si on ne désire pas de mise en page, soit un par un grâce au critère {titre})

<BOUCLE_reponses(FORMS_DONNEES){id_form=2}{id_donnee}>
	<div class="bordureAnnuaire">
	<table border="0" width="100%">
	<tr>
		<BOUCLE_nom(FORMS_CHAMPS){titre=Nom}>
			<td width="30%"><b>Nom : </b></td><td width="60%">#VALEUR</td>
		</BOUCLE_nom>
	</tr>
	<tr>
		<BOUCLE_adresse(FORMS_CHAMPS){titre=Adresse}>
			<td><b>Adresse : </b></td><td>#VALEUR</td>
		</BOUCLE_adresse>
	</tr>
	<tr>
		<BOUCLE_cp(FORMS_CHAMPS){champ=ligne_5}>
			<td><b>Code Postal : </b></td><td>#VALEUR</td>
		</BOUCLE_cp>
	</tr>
	<tr>
		<BOUCLE_ville(FORMS_CHAMPS){titre=Ville}>
			<td><b>Ville : </b></td><td>#VALEUR</td>
		</BOUCLE_ville>
	</tr>
	</table>
	</div>
	<br />
	<div class="bordureAnnuaire">
	<table border="0" width="100%">
	<tr>
		<BOUCLE_courriel(FORMS_CHAMPS){titre=Courriel}>
			<td width="30%"><b>Courriel :</b></td><td width="60%"><a href="mailto:#VALEUR">#VALEUR</a></td>
		</BOUCLE_courriel>
	</tr>
	<tr>
		<BOUCLE_telfixe(FORMS_CHAMPS){titre=Telephone fixe}>
			<td><b>Tel fixe :</b></td><td>#VALEUR</td>
		</BOUCLE_telfixe>
	</tr>
	<tr>
		<BOUCLE_telport(FORMS_CHAMPS){titre=telephone portable}>
			<td><b>Tel portable :</b></td><td>#VALEUR</td>
		</BOUCLE_telport>
	</tr>
	<tr>
		<BOUCLE_fax(FORMS_CHAMPS){titre=Fax}>
			<td><b>Fax :</b></td><td>#VALEUR</td>
		</BOUCLE_fax>
	</tr>
	</table>
	</div>
	<br />
	<div class="bordureAnnuaire">
	<table border="0" width="100%">
	<tr>
		
			<td width="30%"><b>Cat&eacute;gorie :</b></td><td width="60%">#ENV{nom_cat}</td>
		
	</tr>
        <tr>
		<BOUCLE_web(FORMS_CHAMPS){titre=SiteWeb}>
			<td><b>Site internet :</b></td><td><a href="#VALEUR" target="_blank">#VALEUR</a></td>
		</BOUCLE_web>
	</tr>
	<tr>
		<BOUCLE_pres(FORMS_CHAMPS){titre=Présentation}>
			<td><b>Pr&eacute;sentation :</b></td><td>#VALEUR</td>
		</BOUCLE_pres>
	</tr>
	</table>
	</div>
	<br />
	<div class="bordureAnnuaire">
	<table border="0" width="100%">
	<tr>
<BOUCLE_imgint(FORMS_CHAMPS){titre=Photo Interieur}>
#SET{imgint,<td><center><a href="#VALEUR"><img src="#VALEUR" border="0" /></a></center></td>}

[(#GET{imgint}|image_reduire{200})]
</BOUCLE_imgint>
		

		
	
<BOUCLE_imgext(FORMS_CHAMPS){titre=Photo Exterieur}>
#SET{imgext,<td><center><a href="#VALEUR"><img src="#VALEUR" border="0" /></a></center></td>}
[(#GET{imgext}|image_reduire{200})]
</BOUCLE_imgext>
		</tr>
	</table>
	</div>
	</BOUCLE_reponses>

Conclusion

Si vous voulez voir le résultat final :
http://www.coutras-calic.fr/spip.php?page=entreprise. ou regardez le document joint.

Merci à tout les gens qui m’ont aidé sur la liste spip-zone, sur SPIP-Contrib et surtout le canal irc #spip@freenodes !

Si vous avez des questions ou des réponses aux choses que je n’ai su faire proprement n’hésitez pas ...

Autres exemples d’annuaire avec Forms & Tables

Ajout SPIP-Contrib

Voir cet intéressant article sur Spip Ô Toulouse : Premières solutions pour l’annuaire de personnes avec un exemple très parlant et qui décrit l’importation de données via le le plugin « import csv ».

Discussion

35 discussions

  • tarentaise

    Bonjour,

    j’ai créé plusieurs tables qui utilise toutes des champs mots clés. Je cherche à récupérer dans une boucle le numéro du mot clé associé à une réponse pour le passer dans un lien. J’arrive à afficher la valeur ou le titre du mot clé sélectionné mais pas son numéro
    D’avance merci

    Répondre à ce message

  • marabbeh

    Selon moi ceci est un contre-exemple. J’ai créé aussi un annuaire en utilisant des tables non Spip. Je l’ai fait fonctionner à l’aide de boucles beaucoup plus simples que dans cet exemple, mais sur mon serveur local où Forms & Tables n’est pas installé. J’ai voulu faire fonctionner cet annuaire sur mon site en ligne, où Forms & Tables est installé, et les tables ne sont plus reconnues. Donc je suis venu voir pourquoi. Et cet exemple ne m’encourage pas à utiliser le technique présentée, bien que je tienne à conserver Forms & Tables pour cause de formulaires.

    Répondre à ce message

  • 1
    Guillaume M

    Bonjour,

    j’ai du mal à comprendre la liaison entre les deux tables :

    pour la page fichecat.html, cette étape m’échappe :

    - la seconde sélectionne uniquement les id_donnee qui ont une correspondance à votre id de catégorie dans la table « FORMS_DONNEES_DONNEES. »

    car je n’ai rien comme données dans la table "forms_donnees_donnees" sous PHPMyadmin après avoir créer les deux tables "catégorie" et "entreprise" sous l’interface privée SPIP avec le plugin.

    par conséquent la partie de code suivant de cette page ne donne rien :

    BOUCLE_lie(SPIP_FORMS_DONNEES_DONNEES)id_donnee_liee=#GETid_cat

    Quelque chose m’échappe, merci de m’éclairer.

    • Guillaume M

      Je me réponds en partie sur mon problème après avoir relu tous les commentaires depuis le début, je suis tombé sur un du 12 juillet 2007 de Pietrus :

      merci pour ta rapidité,
      il n’y a pas un probleme d’affichage avec ta réponse ?
      Dans la documentation tu dis qu’il est nécessaire d’utiliser un champ de table lié. mais où cela ? dans la table « entreprises » ? je créé un champ categorie dont la nature est « jointure » je suppose.
      puisqu’il n’y a pas qu’un champ dans la table catégorie.

      Après plusieurs essais, je crois comprendre qu’il faut créer dans les DEUX tables « entreprise » ET « catégorie », un champs qui aura pour type « jointure avec une autre table » (leur nom n’a pas besoin d’être identique mais c’est plus simple pour s’y retrouver je pense).

      Une fois créés, lorsque l’on rentre les infos à partir du formulaire « entreprise » dans l’interface privée, on peut sélectionner une catégorie pour une entreprise donnée . Ainsi la jointure est faite, cela créé automatiquement un lien dans la table « forms_donnees_donnees » visible sous PHPMyadmin.

      Maintenant, je bloque sur la page listing.html qui ne veut pas s’afficher à partir des liens de la page catégorie ! Affaire à suivre...

    Répondre à ce message

  • 1

    Bonjour,

    JE débute avec spip, je dois réaliser un annuaire de personne. je me suis donc servis du tuto ci-dessus en essayant de l’adapter à mon projet mais je n’arrive pas a afficher les images. seul le nom « nom.jpg » de l’image apparait. Là je comprend pas comme je pourrais faire.

    Voici ce que j’ai fait :
    Au lieu d’avoir 3 pages, j’ai une page « liste_cartégorie » et une page« details » : qui affiche les personnes composant la categorie (photo + non + tel +adresse..)
    "
    J’ai donc 2 tables : la premier « categorie » avec un champ : nom_cat et la second : service, qui dispose de plusieurs champ text avec commme champ spécifiant le champ : nom.
    le codes de la page « détail » est joind en fichier image

    A l’affichage j’ai :

    catégorie 1
    photo.jpg <= le problème est donc ici
    M. Dupond
    Technicien
    Tel.
    etc

    Ps je précise que j’ai bien autoriser l’ajout de fichier à la création de la table
    Merci pour votre aide

    • Bonjour, c’est exactement que j’aimerais faire !! Mais les fichiers ne sont plus disponibles ? je ne les vois pas sur la page.. sniiiff !
      Merci

    Répondre à ce message

  • compatibilité avec forms 2.0 ?
    savez vous comment faire ?

    Répondre à ce message

  • J’ai réussi à faire un annuaire des associations mais j’ai eu un problème que j’ai fininalement réussi à résoudre.
    Je ne sais si c’est lié à Spip 2 mais je me suis retrouvé avec, dans la liste des associations d’une catégorie, trois fois chaque association ... Pour le clic sur l’un des trois liens identiques j’avais dans la fiche de l’asso, deux fois chaque donnée.

    Il s’avère que par une mauvaise manip en supprimant un formulaire des données sont restées existantes dans FORM_CHAMPS. Une fois enlevée à la main mes fiches sont bien présentées

    Une petite erreur dans le squelette, par contre, était dûe aux doublons dans la listes des associations d’une certaine catégorie.

    Voici donc ma version :

    <BOUCLE_categorie(SPIP_FORMS_DONNEES_CHAMPS)valeur=#ENVnom_cat>
    #SETid_cat,#ID_DONNEE
    </BOUCLE_categorie>

    #SETtab,#ARRAY0,0

    <BOUCLE_reponses(FORMS)id_form=2>
    <BOUCLE_lie(SPIP_FORMS_DONNEES_DONNEES)id_donnee_liee=#GETid_cat>
    <BOUCLE_champs(FORMS_CHAMPS)titre=Nomtri_donnee ligne_1>
    [<div class="bordureCat2"><a href="spip.php ?page=annuaire_fiche&nom_cat=#ENVnom_cat&id_donnee=#ID_DONNEE"><b>(#VALEUR|in_array[(#GET**tab)]| ?’’,#VALEUR)]
    </b></a></div>
    </BOUCLE_champs>
    </BOUCLE_lie>

    </BOUCLE_reponses>

    Bon en gros j’ai juste mis

    <BOUCLE_reponses(FORMS)id_form=2>

    Au lieu de

    <BOUCLE_reponses(FORMS_DONNEES)id_form=2>

    Et désormais ça marche NICKEL :)

    Répondre à ce message

  • 1

    Excuse mon manque de vocabulaire technique mais qu’entends-tu par « en SVN sur le serveur »

    • BOnjour

      En fait tu ne le trouveras pas sous format ziper comme pour plein d’autre. Contact moi en priver je te ferais un zip mais sache que comme il existe pas en ziper cela veut dire qu’il n’est pas opérationnel totalement (je m’en sers quand même)

    Répondre à ce message

  • 1

    Bonjour,
    Existe-t’il une version de Forms & Tables pour SPIP 2 ?

    Répondre à ce message

  • Bonjour,

    J’ai suivi étape par étape le tutorial ci-dessus et tout fonctionne nickel. Seulement j’aimerai faire une petite variante mais je m’en sort pas du tout. Dans l’éxemple nous avons le cheminement suivant : Les entreprises (par catégorie) -> Les noms d’entreprises (liste) -> Les informations de l’entreprise.

    Moi j’aimerai pourvoir avant toutes ces étapes séléctionner le Pays. Cheminement :
    Les Pays -> Les entreprises (par catégorie) -> Les noms d’entreprises (liste) -> Les informations de l’entreprise.

    J’ai bien essayé d’ajouter un troisième table de référence mais cela mélange les informations. Je n’arrive vraiment à rien. Quelqu’un peut-il m’aider ?

    Merci pour votre attention,

    Julien

    Répondre à ce message

  • l’ancien code proposé sur ce forum pour integrer la recherche sur les tables de « forms et table » au moteur de recherche de spip ne fonctionne plus,

    quelqu’un a t’il une proposition ?

    un code à ajouter dans recherche.html pour permettre la recherche sur des tables

    Répondre à ce message

Ajouter un commentaire

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
  • 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 apparaît.

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.

Qui êtes-vous ?
[Se connecter]

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

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom