jambtc / yii2-toastr-widget
Un widget Yii2 per flash messages usando Toastr
Package info
github.com/jambtc/yii2-toastr-widget
Type:yii2-extension
pkg:composer/jambtc/yii2-toastr-widget
v1.2.0
2026-11-13 12:56 UTC
Requires
- php: >=8.1
- npm-asset/toastr: ^2.1.4
- yiisoft/yii2: ~2.0.0
Requires (Dev)
- phpunit/phpunit: ^10.5
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Un semplice widget Yii2 che integra Toastr.js per mostrare notifiche eleganti basate su messaggi flash.
📦 Installazione
Puoi installarlo facilmente tramite Composer:
composer require jambtc/yii2-toastr-widget
Toastr arriva come pacchetto npm-asset/toastr (versione 2.1.4, compatibile con jQuery 3).
Il progetto Yii2 deve poter installare i pacchetti npm-asset/*: con il template base
di Yii2 basta il repository asset-packagist nel composer.json:
"repositories": [ { "type": "composer", "url": "https://asset-packagist.org" } ]
Novità 1.2.0
- Richiede PHP >= 8.1.
- I messaggi sono codificati HTML (
Html::encode()) prima di arrivare a toastr, che di default li inserisce come HTML: un flash con dati dell'utente o di un servizio esterno non può più iniettare markup. Per HTML voluto:'encode' => false. - JSON con UTF-8 leggibile (
èrestaè). - Messaggi vuoti o non testuali (array, oggetti,
null,bool) vengono saltati. - Opzioni toastr configurabili con
clientOptions; senza configurazione l'aspetto è quello di prima. - Script e asset vengono registrati solo se ci sono messaggi da mostrare.
ToastrAssetè caricato in fondo alla pagina (POS_END): jQuery non viene più spostato nell'<head>.
Aggiornando dalla 1.1:
- se usi
toastranche da JavaScript tuo (es. risposte AJAX), registra l'asset nel layout:\jambtc\ToastrWidget\assets\ToastrAsset::register($this);(prima lo faceva il widget su ogni pagina); - se chiami
toastrda script inline nel corpo della pagina prima del caricamento (non inPOS_READY/POS_LOAD), riporta l'asset nell'<head>da configurazione:
'components' => [ 'assetManager' => [ 'bundles' => [ \jambtc\ToastrWidget\assets\ToastrAsset::class => [ 'jsOptions' => ['position' => \yii\web\View::POS_HEAD], ], ], ], ],
Novità 1.1.0
- Toastr da
npm-asset/toastr2.1.4 invece dibower-asset/toastr2.1.3: niente più blocco su jQuery < 3. - I flash di tipo
dangervengono mostrati comeerror(prima chiamavanotoastr.danger, che non esiste).
Configurazione
Nel layout principale (es: views/layouts/main.php), inserisci il widget:
\jambtc\ToastrWidget\Toast::widget();
Opzioni
\jambtc\ToastrWidget\Toast::widget([ // opzioni toastr, unite ai default (closeButton, progressBar, toast-bottom-right, 15s, ...) 'clientOptions' => [ 'positionClass' => 'toast-top-center', 'timeOut' => 5000, ], // true (default): ogni messaggio passa da Html::encode(). // false solo per messaggi con HTML voluto e senza dati esterni. 'encode' => true, ]);
| Proprietà | Default | Descrizione |
|---|---|---|
clientOptions |
[] |
Opzioni toastr; i default sono in Toast::DEFAULT_CLIENT_OPTIONS |
encode |
true |
Codifica HTML dei messaggi |
toastTypes |
error, danger, success, info, warning |
Tipo di flash Yii => metodo toastr |
Test
composer install
composer test