zf-hipsters/bootstrap-flash-messenger

Simple implementation of ZF2 flash messengers using bootstrap. Contains easy helpers that will save you a LOT of time.

Installs: 1 241

Dependents: 2

Stars: 14

Watchers: 4

Forks: 4

Open Issues: 2

Language: PHP

1.02 2013-11-10 09:23 UTC

README

A simple module that makes flash messengers as simple as they are in CakePHP. And the best part is it generates beautifully formatted Bootstrap alerts!

Installation

1) Add the following requirement to your projects composer.json file.

Within the "require" section:

"zf-hipsters/bootstrap-flash-messenger": ">=1.0"

2) Open up your command line and run

php ./composer.phar update

2) Add 'FlashMessenger' to your /config/application.config.php modules

Controller Plugin Examples

Simple success (this is the default namespace)

$this->fm('You have been logged in.');
return $this->redirect()->toRoute('dashboard');

Error

$this->fm('Your username and/or password were incorrect.', 'error');
return $this->redirect()->toRoute('authorize/login');

Info

$this->fm('Something cool happened!', 'info');
return $this->redirect()->toRoute('home');

Warning

$this->fm('Careful! Something bad could happen!', 'warning');
return $this->redirect()->toRoute('dashboard');

View Helper Example

Default usage

<?=$this->fm()?>

Custom Namespace(s)

<?=$this->fm('exciting_namespace')?>
<?=$this->fm(array('mynamespace1', 'mynamespace2'))?>

Customising templates

Customising templates and changing the titles is super easy! Ensure that FlashMessenger is somewhere at the top of your list in application.config.php Now, copy the vendor/zf-hipsters/bootstrap-flash-messenger/view/flash-messenger folder to your eg module/application/view folder.

That's it, customise to your hearts content and they will overload the default files!