Utilisation de HTML_QuickForm pour la vérification du formulaire + catégorisation des brèves par mots-clefs
Cette variante à la contribution Proposer une news consite aux deux points suivants :
- Utilisation de la librairie PEAR HTML_QuickForm pour vérifier la saisie du formulaire (vérification des champs obligatoire et vérification syntaxique de l’email du contributeur et de l’URL de référence de la brève) ;
- Etant donné qu’il n’est pas forcément souhaitable qu’un contributeur puisse proposer des news dans toutes les rubriques racines et du fait que spip ne permette la publication de brèves que dans les rubriques racines, l’approche optée consiste à créer une rubrique racine spécialement destinée aux brèves et à catégoriser les brèves par mots-clefs.
Les brèves sont placées dans une rubrique racine spécifique (id_rubrique=15 dans l’exemple) et les différentes catégories de brèves sont distinguées à partir de mots-clefs appartenant tous à un mot groupe (id_groupe=1 dans l’exemple).
Avec HTML_QuickForm l’affichage, la vérification et le traitement du formulaire s’effectue sur la même page. Un seul squelette est donc nécessaire pour cette variante au lieu de 2 sur la contrib initiale.
propose_news.php3 (identique) :
<?php
$fond = "propose_news";
$delais = 0;
include ("inc-public.php3");
?>propose_news.html (variante) :
<?php
require_once('HTML/QuickForm.php');
// Numéro de la rubrique où placer les brèves
$rubrique=15;
// Génération du tableau de la liste des mots-clefs
$listeMotsClefs=array();
?>
<BOUCLE_mots(MOTS){id_groupe=1}>
<? $listeMotsClefs["#ID_MOT"]="#TITRE"; ?>
</BOUCLE_mots>
<?php
$form = new HTML_QuickForm();
$form->addElement('text','auteur','Auteur :');
$form->addRule('auteur', 'Vous devez préciser votre prénom et nom', 'required', '', 'server');
$form->addElement('text','mail','E-mail :');
$form->addRule('mail', 'Vous devez saisir une adresse électronique', 'required', '', 'server');
$form->addRule('mail', 'Vous devez saisir une adresse email valide ', 'email', '', 'server');
$form->addElement('text','titre','Titre de la news :');
$el =& $form->createElement('select','motcle','Pays concerné :');
$el->loadArray($listeMotsClefs);
$form->addElement($el);
$form->addElement('textarea','texte','Texte de la news :');
$form->addElement('static','aide','Référence associée à la news');
$form->addElement('text','lien_titre','Titre du site :');
$form->addElement('text','lien_url','URL du site : </b> http://');
$form->addRule('lien_url', "L'URL doit être syntaxiquement correcte (chiffres, lettres minuscules, symboles - et .)", 'regex', '/^[a-z0-9](([a-z0-9]-{0,1})+.)+[a-z]{2,4}$/');
$form->addElement('submit','send','Soumettre');
$valid = $form->validate();
if ($valid) {
// Récupération des variables
$texte= $form->exportValue('texte');
$titre= $form->exportValue('titre');
$auteur= $form->exportValue('auteur');
$mail= $form->exportValue('mail');
$lien_titre = $form->exportValue('lien_titre');
$lien_url = $form->exportValue('lien_url');
// Ajout de l'auteur + affectation date
$texte="Par [".$auteur."->".$mail."] $texte";
$time=time();
$date_heure=date('Y-m-d H:i:s',$time);
// Ajout de la news dans la BD
include_ecrire('inc_connect.php3');
$id_breve=spip_mysql_insert($table_prefix."_breves","(`titre` ,`statut` , `id_rubrique`, `lien_titre`, `lien_url`,`texte`,`date_heure`)", "('$titre', 'prop', '$rubrique', '$lien_titre', '$lien_url','$texte','$date_heure')");
if ($id_breve>0) spip_query("INSERT INTO `".$table_prefix."_mots_breves` (`id_mot` ,`id_breve`) VALUES ('$motcle', '$id_breve')");
// Placer ici le texte à afficher pour indiquer au contributeur que sa brève a bien été prise en compte
echo "Votre news a bien été enregistrée. Nous allons l'étudier dans les plus brefs délais<br>";
echo "Merci pour votre contribution";
}
else $form->display();
?>Améliorer la mise en forme :
En utilisant un squelette entete et piedepage centralisé pour tous les squelettes du site, il suffit de les inclure en début et fin de propose_news.html pour disposer d’une interface cohérente et uniforme
Au niveau du formulaire, l’utilisation de la fonction HTML_QuickForm customizeForm permet de personnaliser le formulaire. En mentionnant :
$form = new HTML_QuickForm();
customizeForm('Proposer une news');et en définissant customizeForm, on peut entièrement personnaliser l’apparence du formilaire et ajouter des traitements génériques tels que par exemple la suppression automatique des espaces inutiles en début et fin de champs ($form->applyFilter('__ALL__','trim')) et par exemple françiser le message denotes required field.
Vous trouverez ci-apès à titre d’exemple une fonction customizeForm :
function customizeForm($title) {
global $form;
global $action;
$form->addElement('header','[->MonEnTete]',$title);
$renderer =& $form->defaultRenderer();
$renderer->setHeaderTemplate("nt<tr>ntt<td class='maclasse' colspan="2"><b>{header}</b></td>nt</tr>");
$renderer->setFormTemplate("n<form{attributes}>n<table class='vhffs' cellspacing='0' cellpadding='5' border="0">n{content}n</table>n</form>");
$form->applyFilter('__ALL__','trim');
$form->setRequiredNote('<span style="font-size:80%; color:#ff0000;">*</span><span style="font-size:80%;"> indique un champ requis</span>');
$form->setJsWarnings('Erreur de saisie ','Veuillez corriger');
}Pour en savoir plus sur l’utilisation de HTML_QuickForm, je vous recommande les excellents slides de David Sklar.
Philippe - (phil [at] africacomputing.org)
Répondre à cet article