Présentation
L'action getConfirm du module generictools vous permet de réaliser des écrans de confirmation standards.
Exemple d'utilisation
public function processAConfirmer (){
//... des conditions nous amène à demander confirmation d'un message
return CopixActionGroup::process ('generictools|Messages::getConfirm',
array ('message'=>'Êtes vous sûr de cela ?',
'confirm'=>_url ('module|actionOui'),
'cancel'=>_url ('module|actionNon')));
}
Paramètres de l'action
message
Le paramètre message est le texte qui sera affiché à l'écran.
confirm
Le paramètre confirm corresponds à l'url qui sera appelée si l'utilisateur clique sur oui (s'il confirme l'action)
cancel
Le paramètre cancel corresponds à l'url qui sera appelée si l'utilisateur renonce à l'action qu'il a demandé (s'il clique sur non)
title
Vous pouvez spécifier un titre (de niveau 2) ) votre page. Si vous ne spécifiez aucun titre, aucun titre n'est affiché (pas de valeur par défaut).
TITLE_PAGE
Par défaut, ce paramètre est initialisé grâce à la clef i18n messages.titlePage.confirm (Confirmation).
template
Le paramètre template vous permet de spécifier un template à utiliser plutot que d'utiliser celui par défaut (generictools|confirm.tpl)
Si vous choisissez de spécifier un template personnel, vous devrez prendre en charge les variables suivantes :
- title
- message
- confirm
- cancel
Exemple d'utilisation concret
Cette page, issue du module d'authentification standard de Copix, vous permet de supprimer un utilisateur. Avant de supprimer un utilisateur, ce module demande confirmation à l'internaute.
Pour cette confirmation, c'est l'action getConfirm de generictools qui est utilisée.
public function processDelete (){
if (CopixRequest::getInt ('confirm') == 1){
_ioDAO ('dbuser')->delete (CopixRequest::getInt ('id'));
return _arRedirect (_url ('auth|users|'));
}else{
if (! ($user = _ioDAO ('dbuser')->get (CopixRequest::getInt ('id')))){
throw new Exception ('Utilisateur introuvable');
}
return CopixActionGroup::process ('generictools|Messages::getConfirm',
array ('message'=>'Supprimer '.$user->login_dbuser. '?',
'confirm'=>_url ('auth|users|delete', array ('id'=>$user->id_dbuser, 'confirm'=>1)),
'cancel'=>_url ('auth|users|')));
}
}