wp-kit/flash

A wp-kit component that handles frontend and admin flash notifications

wp-kit/flash

This is a wp-kit component that handles both frontend and admin flash notifications., _(*1)

This component was built to run within an Illuminate\Container\Container so is perfect for frameworks such as Themosis, Assely and wp-kit/theme., _(*2)

Often, Wordpress developers want to be able to use a single component the handle flashes stored in the session and their output to the client, usually after a redirect., _(*3)

In Wordpress we do have the ability to forge admin notices via some hooks but there a few hoops to jump through in that you have to write quite a bit of code to handle the session storage and the output, and currently there are no hooks for front-end flashes., _(*4)

Installation

If you're using Themosis, install via Composer in the Themosis route folder, otherwise install in your Composer driven theme folder:, _(*5)

composer require "wp-kit/flash"

Setup

Add Service Provider

Just register the service provider and facade in your providers config:, _(*6)

//inside theme/resources/config/providers.config.php

return [
    //
    WPKit\Config\ConfigServiceProvider::class, // we need this too,
    Illuminate\Filesystem\FilesystemServiceProvider::class, // specify the driver provider
    Illuminate\Session\SessionServiceProvider::class, // we need this too
    WPKit\Flash\FlashServiceProvider::class
];

Add Facade

If you are using Themosis or another Iluminate driven framework, you may want to add Facades, simply add them to your aliases:, _(*7)

//inside theme/resource/config/theme.config.php

'aliases' => [
    //
    'AdminFlash' => WPKit\Flash\Facades\AdminFlash::class,
    'FrontendFlash' => WPKit\Flash\Facades\FrontendFlash::class
    //
]

Add Config & View File(s)

Although a config file is not required for wp-kit/flash, we do need to publish view files and a config is needed for your SessionProvider., _(*8)

The recommended method of installing config files for wp-kit components is via wp kit vendor:publish command., _(*9)

First, install WP CLI, and then install this component, wp kit vendor:publish will automatically be installed with wp-kit/utils, once installed you can run:, _(*10)

wp kit vendor:publish, _(*11)

For more information, please visit wp-kit/utils., _(*12)

Alternatively, you can place the config file(s) and view file(s) in your theme/resources/config and theme/resources/views directories manually., _(*13)

Usage

Note: AdminFlash automatically outputs notices in admin area using the hook admin_notices., _(*14)

Important Don't forget to use the Illuminate\Session\Middleware\StartSession middleware to ensure flashes persist., _(*15)

use Themosis\Facades\Route;
use Illuminate\Session\Middleware\StartSession;

Route::group([
    'namespace' => 'Theme\Controllers',
    'middleware' => [
    StartSession::class, 
    'auth.form'
    ]
], function () {
    require themosis_path('theme.resources').'routes.php';
}); 

Using Facades

// Just in case you need to include the Facade in a custom namespace

use WPKit\Flash\Facades\AdminFlash;
use WPKit\Flash\Facades\FrontendFlash;

// Frontend

FrontendFlash::success('Well done!');
FrontendFlash::warning('Hmm, not sure about that...');
FrontendFlash::error('What on earth are you doing?');

$messages = FrontendFlash::all();

$html = FrontendFlash::render();

$chained = FrontendFlash::success('Well done!')->render();

FrontendFlash::clear();

FrontendFlash::display([
    'message' => 'Ooh, living dangerously are we?'
    'class' => 'some-classname'
]);

// Admin

AdminFlash::success('Well done!');
AdminFlash::warning('Hmm, not sure about that...');
AdminFlash::error('What on earth are you doing?');

$messages = AdminFlash::all();

$html = AdminFlash::render();

$chained = AdminFlash::success('Well done!')->render();

AdminFlash::clear();

AdminFlash::display([
    'message' => 'Ooh, living dangerously are we?'
    'class' => 'some-classname'
]);

Using Helper Function

// Frontend

flash('frontend')->success('Well done!');
flash('frontend')->warning('Hmm, not sure about that...');
flash('frontend')->error('What on earth are you doing?');

$messages = flash('frontend')->all();

$html = flash('frontend')->render();

$chained = flash('frontend')->success('Well done!')->render();

flash('frontend')->clear();

flash('frontend')->display([
    'message' => 'Ooh, living dangerously are we?'
    'class' => 'some-classname'
]);

// Admin

flash('admin')->success('Well done!');
flash('admin')->warning('Hmm, not sure about that...');
flash('admin')->error('What on earth are you doing?');

$messages = flash('admin')->all();

$html = flash('admin')->render();

$chained = flash('admin')->success('Well done!')->render();

flash('admin')->clear();

flash('admin')->display([
    'message' => 'Ooh, living dangerously are we?'
    'class' => 'some-classname'
]);

Looping through messages

This is just a guide of how you use use wp-kit/flash when looping through a load of flashes where you need to output markup around each flash:, _(*16)

// within theme/resources/views/some-view.php





    all() as $message ) : ?>
    
        

        
            display( $message ); ?>
            
        
        
    
    

Get Involved

To learn more about how to use wp-kit check out the docs:, _(*17)

View the Docs, _(*18)

Any help is appreciated. The project is open-source and we encourage you to participate. You can contribute to the project in multiple ways by:, _(*19)

• Reporting a bug issue
• Suggesting features
• Sending a pull request with code fix or feature
• Following the project on GitHub
• Sharing the project around your community

For details about contributing to the framework, please check the contribution guide., _(*20)

Requirements

Wordpress 4+, _(*21)

PHP 5.6+, _(*22)

License

wp-kit/flash is open-sourced software licensed under the MIT License., _(*23)