VarianteContribProposer-une-news

Ceci est une ARCHIVE, peut-être périmée. Vérifiez bien les compatibilités !

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","(<span class="base64" title="PGNvZGUgY2xhc3M9InNwaXBfY29kZSBzcGlwX2NvZGVfaW5saW5lIiBkaXI9Imx0ciI+dGl0cmU8L2NvZGU+"></span> ,<span class="base64" title="PGNvZGUgY2xhc3M9InNwaXBfY29kZSBzcGlwX2NvZGVfaW5saW5lIiBkaXI9Imx0ciI+c3RhdHV0PC9jb2RlPg=="></span> , <span class="base64" title="PGNvZGUgY2xhc3M9InNwaXBfY29kZSBzcGlwX2NvZGVfaW5saW5lIiBkaXI9Imx0ciI+aWRfcnVicmlxdWU8L2NvZGU+"></span>, <span class="base64" title="PGNvZGUgY2xhc3M9InNwaXBfY29kZSBzcGlwX2NvZGVfaW5saW5lIiBkaXI9Imx0ciI+bGllbl90aXRyZTwvY29kZT4="></span>, <span class="base64" title="PGNvZGUgY2xhc3M9InNwaXBfY29kZSBzcGlwX2NvZGVfaW5saW5lIiBkaXI9Imx0ciI+bGllbl91cmw8L2NvZGU+"></span>,<span class="base64" title="PGNvZGUgY2xhc3M9InNwaXBfY29kZSBzcGlwX2NvZGVfaW5saW5lIiBkaXI9Imx0ciI+dGV4dGU8L2NvZGU+"></span>,<span class="base64" title="PGNvZGUgY2xhc3M9InNwaXBfY29kZSBzcGlwX2NvZGVfaW5saW5lIiBkaXI9Imx0ciI+ZGF0ZV9oZXVyZTwvY29kZT4="></span>)", "('$titre', 'prop', '$rubrique', '$lien_titre', '$lien_url','$texte','$date_heure')");	
	if ($id_breve>0) spip_query("INSERT INTO <span class="base64" title="PGNvZGUgY2xhc3M9InNwaXBfY29kZSBzcGlwX2NvZGVfaW5saW5lIiBkaXI9Imx0ciI+JnF1b3Q7LiR0YWJsZV9wcmVmaXguJnF1b3Q7X21vdHNfYnJldmVzPC9jb2RlPg=="></span> (<span class="base64" title="PGNvZGUgY2xhc3M9InNwaXBfY29kZSBzcGlwX2NvZGVfaW5saW5lIiBkaXI9Imx0ciI+aWRfbW90PC9jb2RlPg=="></span> ,<span class="base64" title="PGNvZGUgY2xhc3M9InNwaXBfY29kZSBzcGlwX2NvZGVfaW5saW5lIiBkaXI9Imx0ciI+aWRfYnJldmU8L2NvZGU+"></span>) 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)

Discussion

Aucune discussion

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