Effectuer des traitements

Lorsque la fonction de vérification ne renvoie aucune erreur, le formulaire passe alors à la fonction traiter(). C’est dans celle-ci qu’il faudra effectuer les opérations voulues avec les données issues du formulaire (envoi par courriel, modification de la base de données, etc.).

La fonction doit renvoyer un tableau associatif :

  1. function formulaires_nom_traiter(){
  2. // Effectuer des traitements
  3.  
  4. // Valeurs de retours
  5. return array(
  6. 'message_ok' => 'Excellent !', // ou bien
  7. 'message_erreur' => 'Et mince, une erreur.'
  8. );
  9. }

Télécharger

Valeurs du retour

La fonction doit retourner au minimum une de ces deux valeurs :

  • message_ok permet de retourner un agréable message à l’utilisateur, lui indiquant que tout s’est bien passé.
  • message_erreur, inversement, permet de renvoyer un message d’erreur, lorsque le traitement n’a pas fonctionné.

D’autres valeurs spécifiques sont possibles :

  • editable, comme au chargement, est utilisée pour afficher ou non la partie éditable du formulaire. Par défaut elle vaut false mais vous pouvez lui indiquer true si votre formulaire peut être utilisé plusieurs fois à la suite.
  • redirect est une URL qui permet d’indiquer à SPIP vers quelle page il redirigera le visiteur après les traitements du formulaire. Par défaut la page boucle sur elle-même.

Pipeline formulaire_traiter

Une fois la fonction formulaires_nom_traiter effectuée, le pipeline formulaire_traiter est exécuté, permettant à d’autres plugins de compléter les traitements de ce formulaire.

Auteur RastaPopoulos Publié le : Mis à jour : 21/09/13

Traductions : English, français