Search by

jambtc / yii2-toastr-widget

jambtc

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

Statistics

Installs: 2 324

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

v1.2.0 2026-11-13 12:56 UTC

This package is auto-updated.

Last update: 2026-11-13 12:58:04 UTC


README

Latest Stable Version Total Downloads License

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 toastr anche 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 toastr da script inline nel corpo della pagina prima del caricamento (non in POS_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/toastr 2.1.4 invece di bower-asset/toastr 2.1.3: niente più blocco su jQuery < 3.
  • I flash di tipo danger vengono mostrati come error (prima chiamavano toastr.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