Faire un annuaire

Le squelette auteur est bien utile pour contacter un auteur sans dévoiler son courriel, voir ce qu’il a écrit et tout ça.

Cette contribution ajoute quelques lignes à ce squelette de base pour faire afficher également la liste de tous les auteurs, éventuellement filtrée suivant des critères passés en paramètre ex :

auteur.php3?nom=christian

vous donnera tous les Christian et

auteur.php3?tri=statut

vous triera les auteurs suivant leur statut (qui c’est l’chef ici?!).

Voici par exemple les pilotes de ligne des pédibus de l’Hérault et (plus sophistiquée) la liste des enseignants au département de mathématiques de Montpellier II.

On va faire un tableau donc il faut utiliser un peu de php pour colorer les lignes mais ne vous inquiétez pas, ça ne fait même pas mal. Il s’agit donc de modifier auteur.html. Si vous n’avez pas fait de modifications, il vous faut copier ce fichier depuis le sous-dossier dist/ dans le dossier racine.

Nous allons faire la boucle sur l’auteur principal plus tard et s’il n’y a pas d’auteur, nous afficherons autre chose : l’annuaire proprement dit.

En fait [1] il y a un trou de sécurité dans l’utilisation de #ENV tel quelle dans le critère par : un petit malin pourrait potenitellement forger un critère bien senti qui lui ferait manipuler la base comme il veut. Pour éviter ces déboires [2] il est nécessaire d’ajouter quelques petites lignes dans auteur.php3 pour éliminer les mauvaises surprises :

Voilà, c’est tout. Si vous voulez simplement avoir une liste alphabétique ou autre de vos auteurs, n’allez pas plus loin. Si vous voulez ajouter des informations qui ne sont pas prévues en version dist, il faut un peu plus de travail, expliqué dans la section qui suit :

Enrichissement de l’annuaire

Ceci étant fait, la table des auteurs contient relativement peu d’informations, on est obligé de quicher toutes les informations en vrac dans le champs #BIO, que tout auteur lambda peut modifier (i.e. trifouiller) à sa guise, ce qui ne permet pas d’y stocker des informations permettant un traitement automatique (c’est du vécu).

Personnellement j’ai enrichi la base de données avec d’autres champs spécifiques à mon site : #EQUIPE, #EMPLOI, #BUREAU, #TELEPHONE que j’ai exploité dans ce squelette. On peut préférer utiliser le champs EXTRA, j’ai choisi d’ajouter plutôt des champs à la base. C’est un peu une affaire de religion, le champs extra vous permet d’avoir une interface simple à l’intérieur de spip pour les ajouter et pour les remplir, comme n’importe quel autre champs de la base auteurs.

J’ai préféré laisser ça à un super-administrateur ayant un accès direct à la base. L’administrateur moyen n’a donc pas moyen de modifier les informations dans ces champs. Voici comment j’ai fait pour ajouter ces champs :

J’ail lu cet excellent wiki et j’ai fait ce qu’il y avait marqué :

 J’ai rajouté des champs equipe, emploi, bureau et telephone (évitez les accents) à la table spip_auteurs avec phpMyAdmin (ou autre manipulateur de base), j’ai bien noté le type de chaque champs VARCHAR, ENUM, BIGINT etc. J’ai été ici très directif avec des ENUMérations, c’est-à-dire qu’il n’y a que certains choix très limités dans la valeur des champs. De cette manière je peux utiliser ces valeurs ailleurs dans le site de manière automatique. Mais vous pouvez rajouter simplement des VARCHAR(50) si vous voulez laisser un peu de liberté à vos valeurs si elles ne sont qu’informatives.

 J’ai édité ecrire/inc_serialbase.php3 et j’ai ajouté

Conclusion

Rajouter une fonction d’annuaire de base est donc très simple. L’enrichir en ajoutant des champs à la base auteurs est un peu plus compliqué ; en particulier seul un administrateur mySQL (par opposition à un administrateur spip) peut remplir ces champs (c’est en fait ce que je recherchais). Mais pour l’instant je ne sais pas trop les remplir autrement qu’à la main avec phpMyAdmin (un script php en fait). J’ai entendu des bruits sur des squelettes de formulaires d’édition (quelque-chose comme un ecrire/auteurs_infos.html), que tous les webmestres appellent de leurs voeux pour simplifier (particulariser) la tâche pour leurs rédacteurs malcomprenants, qui seraient dans des cartons, donc ne deséspérons pas...

Petit détail technique : J’avais tout d’abord essayé de rajouter la structure de la base à ecrire/mes_options.php3 et aussi de créer un fichier /auteur_fonctions.php3 où je mettais

mais avec la 1-8 ça ne marche pas encore... Il faudra donc que j’édite une nouvelle fois inc_serialbase.php3 à la prochaine mise à jour, à moins que les ajouts dans auteur_fonctions.php3 soient pris en compte (ça va venir).

Voilà, en vous souhaitant d’exploiter au mieux toutes ces incroyables améliorations qui font de SPIP un CMS vraiment chouette.