VarianteContribProposer-une-news

All contributions published for previous SPIP versions

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)

updated on 7 March 2007

Discussion

Aucune discussion

Comment on this article

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