Préambule
Dans un SPIP de base, on a accès facilement à un #FORMULAIRE_ECRIRE_AUTEUR, qui permet d’écrire à un auteur précis. On peut donc l’utiliser pour la page de contact du site, par exemple avec l’auteur webmaster.
Cette approche peut paraître limitée. Imaginons donc un formulaire entièrement configurable.
Ce formulaire remplace — et donc supprime — le plugin Formulaire de contact configurable avec lequel il a fusionné. Les utilisateurs migrants de l’un à l’autre devront donc reconfigurer le formulaire. Par ailleurs, et depuis la rédaction de cet article le plugin évolue, nous vous conseillons de lire également « Le formulaire de contact évolue »
Installation
- Télécharger le plugin
Comme pour les autres plugins, vous devez télécharger le paquet ci-joint et placer son contenu dans votre dossier plugins/.
Ensuite il faut aller dans l’interface de gestion des plugins, l’activer et enfin cliquer sur l’icône d’outils pour le configurer. Au préalable vous devrez installer les plugins cfg et spip-bonux.
Alternativement, vous trouverez aussi ce plugin dans la liste d’installation automatique fournie par spip-contrib (il faut pour cela avoir un dossier plugins/auto).
Utilisation
Pour appeler le formulaire, il vous suffit de faire :
Dans un squelette
Dans un contenu
Configuration
Il y a trois principales choses à configurer :
- La liste des auteurs à qui le courrier pourra être envoyé
- La méthode de choix pour le visiteur
- Les éventuelles informations supplémentaires
On peut choisir l’ordre des informations supplémentaires par simple glisser-déplacer à la souris. L’ordre sera gardé en mémoire et repris alors sur le site public.
Personnaliser l’affichage des champs d’informations
Par défaut, le plugin affiche un champ texte basique pour chaque informations supplémentaires demandées. Mais parfois, on veut personnaliser ces champs, par exemple pour restreindre des valeurs. Et bien c’est prévu !
Pour cela, il faut connaitre l’identifiant du champ que l’on veut personnaliser. Il suffit de regarder dans le HTML l’attribut name du champ. Sinon la liste complète des champs par défaut se trouve dans le fichier contact_options.php.
Vous n’avez alors plus qu’à créer un fichier : /formulaires/contact_champ_*nomduchamp*.html, dans votre dossier squelettes ou dans votre plugin.
Par exemple, si vous voulez mettre une liste déroulante pour restreindre les pays, il faut créer un fichier /formulaires/contact_champ_pays.html, dans lequel vous pourrez mettre par exemple :
- <li class="saisie_#ENV{name}[ (#ENV{name}|in_array{#ENV{obligatoires,#ARRAY}}|oui)obligatoire][ (#ENV*{erreurs}|table_valeur{#ENV{name}}|oui)erreur]">
- <label for="info_#ENV{name}">
- #ENV{titre}[ (#ENV{name}|in_array{#ENV{obligatoires,#ARRAY}}|oui)<strong><:info_obligatoire_02:></strong>]
- </label>
- [<span class="erreur_message">
- (#ENV*{erreurs}|table_valeur{#ENV{name}})
- </span>]
- <select name="#ENV{name}" id="info_#ENV{name}">
- <option
- value="England"[
- (#ENV{#ENV{name}}|=={England}|oui)selected="selected"]>
- England
- </option>
- <option
- value="France"[
- (#ENV{#ENV{name}}|=={France}|oui)selected="selected"]>
- France
- </option>
- </select>
- </li>
Dans le fichier, #ENV{name} correspondra à l’identifiant du champ, et #ENV{titre} à son titre dans la langue courante. #ENV{#ENV{name}} correspond donc à la valeur déjà tapée du champ en question.
Ajouter de nouveaux champs
Le plugin prévoit un point d’entrée qui permet, lorsqu’on s’y connecte, d’ajouter autant d’entrées que l’on veut.
Il faut tout d’abord s’inscrire dans le point d’entrée.
Soit dans un plugin
- <pipeline>
- <nom>contact_infos_supplementaires</nom>
- <inclure>un_fichier.php</inclure>
- </pipeline>
Soit dans le mes_options.php de votre site
- $GLOBALS['spip_pipeline']['contact_infos_supplementaires'] .= '|montruc_contact_infos_supplementaires';
Ensuite dans la fonction qui s’est insérée dans le point d’entrée :
- function montruc_contact_infos_supplementaires($champs){
- // Le paramètre contient tous les champs par défaut avec :
- // clé = le "name" du champ
- // valeur = le titre du champ
- $champs['nouveau_truc'] = 'Un titre';
- // Si votre site est multilingue, il faut utiliser une chaine de langue
- $champs['civilite'] = _T('une_chaine_de_langue_pour_civilite');
- return $champs;
- }
Et c’est tout.
Par défaut le champ sera une entrée de texte simple, et vous pouvez le personnaliser comme décrit dans le point précédent.
Télécharger le plugin
RSS 2.0