kartik-v/yii2-widget-alert A widget to generate alert based notifications using bootstrap-alert plugin (sub repo split from yii2-widgets)

extensionwidgetbootstrapjqueryalertpluginnotificationflashblock

Krajee Logo
yii2-widget-alert Donate       kartikv

[![Stable Version](https://poser.pugx.org/kartik-v/yii2-widget-alert/v/stable)](https://packagist.org/packages/kartik-v/yii2-widget-alert) [![Unstable Version](https://poser.pugx.org/kartik-v/yii2-widget-alert/v/unstable)](https://packagist.org/packages/kartik-v/yii2-widget-alert) [![License](https://poser.pugx.org/kartik-v/yii2-widget-alert/license)](https://packagist.org/packages/kartik-v/yii2-widget-alert) [![Total Downloads](https://poser.pugx.org/kartik-v/yii2-widget-alert/downloads)](https://packagist.org/packages/kartik-v/yii2-widget-alert) [![Monthly Downloads](https://poser.pugx.org/kartik-v/yii2-widget-alert/d/monthly)](https://packagist.org/packages/kartik-v/yii2-widget-alert) [![Daily Downloads](https://poser.pugx.org/kartik-v/yii2-widget-alert/d/daily)](https://packagist.org/packages/kartik-v/yii2-widget-alert)

This extension contains a couple of useful widgets. The Alert widget extends the \yii\bootstrap\Alert widget with more easy styling and auto fade out options. In addition, it includes a AlertBlock widget that groups multiple \kartik\widget\Alert or kartik\widget\Growl widgets in one single block and renders them stacked vertically on the current page. You can choose the TYPE_ALERT style or the TYPE_GROWL style for your notifications. You can also set the widget to automatically read and display session flash messages (which is the default setting). Alternatively, you can setup and configure your own block of custom alerts.

NOTE: This extension is a sub repo split of yii2-widgets. The split has been done since 08-Nov-2014 to allow developers to install this specific widget in isolation if needed. One can also use the extension the previous way with the whole suite of yii2-widgets.

Installation

The preferred way to install this extension is through composer. Check the composer.json for this extension's requirements and dependencies. Read this web tip /wiki on setting the minimum-stability settings for your application's composer.json.

To install, either run

$ php composer.phar require kartik-v/yii2-widget-alert "*"

or add

"kartik-v/yii2-widget-alert": "*"

to the require section of your composer.json file.

NOTE: Using Growl is optional and it is not automatically installed with this extension. If you want to use it in your project, you need to either run

$ php composer.phar require kartik-v/yii2-widget-growl "*"

or add

"kartik-v/yii2-widget-growl": "*"

to the require section of your composer.json file.

Refer the CHANGE LOG for details on changes to various releases.

Demo

You can refer detailed documentation and demos for Alert and AlertBlock widgets on usage of the extension.

Usage

Alert

use kartik\alert\Alert;

echo Alert::widget([
    'type' => Alert::TYPE_INFO,
    'title' => 'Note',
    'titleOptions' => ['icon' => 'info-sign'],
    'body' => 'This is an informative alert'
]);

AlertBlock

use kartik\alert\AlertBlock;

echo AlertBlock::widget([
    'type' => AlertBlock::TYPE_ALERT,
    'useSessionFlash' => true
]);

License

yii2-widget-alert is released under the BSD-3-Clause License. See the bundled LICENSE.md for details.

Changelog

Change Log: yii2-widget-alert

Version 1.1.5

Date: 16-Oct-2021

  • Enhancements for Bootstrap 5.x support.

Version 1.1.4

Date: 02-Jun-2020

  • (bug #23, #24): Correct AlertBlock base widget class.
  • (bug #21): Correct yii2-widget-growl dependency.

Version 1.1.3

Date: 09-Mar-2020

  • Eliminate redundant class BaseAlert.

Version 1.1.2

Date: 29-Jan-2020

  • Enhancements to support both Bootstrap 4.x & 3.x.
  • Move all source code to src directory.

Version 1.1.1

Date: 10-Mar-2017

  • enh #2, #8, #11, #12: Allow multiple messages of same type.
  • Add github contribution and PR templates.
  • Add composer branch alias to allow getting latest dev-master updates.

Version 1.1.0

Date: 19-Nov-2014

  • bug #1: Fix dependency on \kartik\growl\Growl

Version 1.0.0

Date: 08-Nov-2014

Statistics

Downloads
GitHub Stars
GitHub Forks

Releases

Comments



v1.1.5 is the latest of 7 releases



BSD-3-Clause license
Stats
28 github stars & 14 github forks
872 downloads in the last day
44477 downloads in the last 30 days
3206208 total downloads