mb-tec/zf-super-messenger

ZF3 module v1.1 - Boost your FlashMessenger !

ZF2 SuperMessenger module

Version 1.1 Created by Matthias Büsing, _(*1)

/!\ This module is now a PR to Zend Framework 3 : https://github.com/zendframework/zf2/pull/3502. Give me your feedback !, _(*2)

Introduction

ZF3 SuperMessenger module provide new features for plugin FlashMessenger. Now, you can add directly 3 level of messages : success message, error message or info message., _(*3)

Usage

• Usage in controller :, _(*4)

$this->flashMessenger()->addInfoMessage('bar-info');
$this->flashMessenger()->addSuccessMessage('bar-success');
$this->flashMessenger()->addErrorMessage('bar-error');

Just active the module and the FlashMessenger will have features without BC ! You can use SuperMessenger by the identifier "FlashMessenger" with the alias. You could use the identifier "SuperMessenger" to pilot the plugin., _(*5)

• Usage in view :, _(*6)

And to be complete, there is a view helper. Usage in a view to get list of messages :, _(*7)

<?php
    $infoMessages = $this->flashMessenger('info');
?>

You can directly have a render of the messages :, _(*8)

<?php
    echo $this->flashMessenger()->render('info');
?>

By default, the format is :, _(*9)

<ul class="info">
    <li>first message</li>
    <li>second message</li>
</ul>

You can change the format, like this :, _(*10)

<?php
    echo $this->flashMessenger()
                ->setMessageOpenFormat('<div%s><p>')
                ->setMessageSeparatorString('</p><p>')
                ->setMessageCloseString('</p></div>')
                ->render('info');
?>

Format could be changed in supermessenger.local.php which will be moved in "/config/autoload" :, _(*11)

'view_helper' => array(
    'supermessenger' => array(
        'message_open_format' => '<div%s><ul><li>',
        'message_separator_string' => '</li><li>',
        'message_close_string' => '</li></ul></div>',
    ),
),

You can change easily the class CSS with :, _(*12)

<?php
    echo $this->flashMessenger()->render('info', array('foo-baz', 'foo-bar'));
?>

<ul class="foo-baz foo-bar">
    <li>first message</li>
    <li>second message</li>
</ul>