Handling von Meldungen

Aus MAXcms

Zwingende Voraussetzung für die Verwendung dieser Funktionalität ist das inkludieren folgender Datei und die Verwendung des CMS-Tags 'messages_ouput':

include_once(thCMS_root.'/classes/class.Util.php');

Über die folgende statische Methode können eigene Meldungen recht einfach erzeugt werden:

// Ist der übergebene String ein Block im Tag-Template des CMS-Tags 'messages_ouput', wird der Block getoucht und der darin enthaltene Text ausgegeben.
Util::_sendMessage('daten_erfolgreich_gespeichert');

// Wird zusätzlich zum übergebenenen Block-Namen ein Array wie im folgenden Beispiel übergeben (PLATZHALTER => WERT), so können auch Platzhalter im Block ersetzt werden.
Util::_sendMessage('folgende_daten_waren_fehlerhaft', array('LOGINNAME' => 'Testuser', 'PLZ' => 520[, ...]));

// Ist der übergebene String kein Block im Tag-Template, wird dieser einfach in den Platzhalter {MESSAGE} gesetzt.
Util::_sendMessage('Fehler! Zu diesem String gibt es keinen Block im Tag-Template.');

Das Tag-Template 'tpl.messages_output.html' muss wie folgt aufgebaut sein (die <div>-Tags können weggelassen werden):

<div id="message">
<!-- BEGIN message -->{MESSAGE}<!-- END message -->
<!-- BEGIN message_blocks -->
<!-- BEGIN ihre_beispiel_fehlermeldung -->Fehler! Dies ist eine Beispielfehlermeldung.<!-- END ihre_beispiel_fehlermeldung -->
<!-- END message_blocks -->
</div>

Dem CMS-Tag können die folgenden Parameter übergeben werden:

// Es wird nur die erste Meldung angezeigt, egal wie oft 'Util::_sendMessage(...)' aufgerufen wurde.
<cms tag="messages_ouput" mode="single">

// Gibt alle Nachrichten aus, die mit 'Util::_sendMessage(...)' gesendet wurden, wird das Attribut 'mode' nicht gesetzt, wird automatisch der Modus 'multiple' verwendet.
<cms tag="messages_ouput" mode="multiple">