This pipeline is called in ecrire/public/aiguiller.php after the processes have been run for a CVT form. It is used to supplement the response table or to perform any additional processes.
It accepts the same arguments as the formulaire_charger or formulaire_verifier pipelines. It returns the table of data that are the results of processing (error message, success message, redirection, editable form refresh...).
$rev = pipeline(
'formulaire_traiter',
array(
'args' => array('form'=>$form, 'args'=>$args),
'data' => $rev)
);
Example
The "Licence" plugin, which offers the opportunity to assign a usage licence to articles, uses this pipeline to save the default licence value in the configuration details whenever a new article is created:
function licence_formulaire_traiter($flux){
// if creating a new article, assign it the configured default licence
if ($flux['args']['form'] == 'editer_article' AND $flux['args']['args'][0] == 'new') {
$id_article = $flux['data']['id_article'];
$licence_defaut = lire_config('licence/licence_defaut');
sql_updateq('spip_articles', array('id_licence' => $licence_defaut), 'id_article=' . intval($id_article));
}
return $flux;
}
Notes:
- the
lire_config() PHP function belongs to the configuration plugin "CFG". - in SPIP 2.1, it will be more relevant to use the pre_insertion pipeline for this specific example.