MMessenger

Présentation

MMessenger est une classe PHP qui permet d'afficher des messages à l'utilisateur de manière simple et efficace. Elle est particulièrement utile pour afficher des retours d'information après des actions utilisateur, comme des messages de confirmation, ou d'erreur. Elle est surtout utile pour séparer la logique de l'affichage, en permettant de générer les messages d'un coté et les afficher là où il faut.

Fonctionnalités

• Affichage de différents types de messages (succès, erreur, avertissement, information)
• Gestion des messages par groupes pour un affichage contextuel
• Stockage des messages en session pour un affichage sur la page suivante
• Style CSS intégré pour un affichage immédiat
• Support des options personnalisées pour chaque message

Utilisation de base

Attention

MMessenger utilise les sessions PHP pour stocker les messages.
Une session doit obligatoirement avoir été démarrée avant d'utiliser la classe.

Envoyer des messages

Méthode générique

MMessenger::send('type_du_message', 'Votre message ici', 'groupe_facultatif', $options);

Méthodes spécifiques par type de message

// Message de succès
MMessenger::sendSuccess('Opération réussie avec succès !');

// Message d'erreur
MMessenger::sendError('Une erreur est survenue lors du traitement.');

// Message d'avertissement
MMessenger::sendWarning('Veuillez vérifier vos informations.');

// Message d'information
MMessenger::sendInfo('Votre demande a été enregistrée.');

Afficher les messages

Pour afficher les messages, appelez la méthode displayMessages() à l'endroit où vous souhaitez qu'ils apparaissent dans votre mise en page :

// Afficher les messages du groupe par défaut
MMessenger::displayMessages();

// Afficher les messages d'un groupe spécifique
MMessenger::displayMessages('mon_groupe');

Utilisation avancée

Groupes de messages

Les groupes permettent d'organiser les messages par contexte et de les afficher à différents endroits de votre application :

// Envoyer un message dans un groupe spécifique
MMessenger::sendSuccess('Article sauvegardé avec succès', 'admin_articles');

// Afficher uniquement les messages de ce groupe
MMessenger::displayMessages('admin_articles');

Options personnalisées

Vous pouvez associer des données supplémentaires à vos messages :

// Envoyer un message avec des options
$options = [
    'id_article' => 42,
    'action' => 'suppression',
    'timestamp' => time()
];

MMessenger::sendInfo('Article modifié', 'admin_articles', $options);

// Récupérer les messages avec leurs options
$messages = MMessenger::getMessages('admin_articles');
foreach ($messages as $message) {
    echo $message['message']; // Le message
    print_r($message['options']); // Les options associées
}

Attention

Si vous ajoutez des options à vos messages, ces options ne seront pas affichées par l'usage de la methode displayMessages(). Vous devrez, comme dans l'exemple ci-dessus, récupérer vos messages par la méthode getMessages(), puis gérer vous même l'affichage de ces options.