PHPackages tdanandeh/sweet-alert - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. tdanandeh/sweet-alert ActiveLibrary[Utility & Helpers](/categories/utility) tdanandeh/sweet-alert ===================== A simple PHP package to show Sweet Alerts with the Laravel Framework 1.0.0(3y ago)14.9k↑86.6%MITPHPPHP >=8.1 Since Feb 26Pushed 3y ago1 watchersCompare [ Source](https://github.com/tdanandeh/sweet-alert)[ Packagist](https://packagist.org/packages/tdanandeh/sweet-alert)[ RSS](/packages/tdanandeh-sweet-alert/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (1)Dependencies (5)Versions (2)Used By (0) Easy Sweet Alert Messages for Laravel ===================================== [](#easy-sweet-alert-messages-for-laravel) [![A success alert](demos/1XySJiz.png)](demos/1XySJiz.png) \###This is New version Of Uxweb Sweet Alert For Laravel 10 Installation ------------ [](#installation) Require the package using Composer. ``` composer require tdanandeh/sweet-alert ``` If using laravel < 5.5 include the service provider and alias within `config/app.php`. ``` 'providers' => [ Tdanandeh\SweetAlert\SweetAlertServiceProvider::class, ]; 'aliases' => [ 'Alert' => Tdanandeh\SweetAlert\SweetAlert::class, ]; ``` Installing Frontend Dependency ------------------------------ [](#installing-frontend-dependency) This package works only by using the [BEAUTIFUL REPLACEMENT FOR JAVASCRIPT'S "ALERT"](https://sweetalert.js.org/). ### Using a CDN [](#using-a-cdn) ``` > @include('sweet::alert') ``` ### Using Laravel Mix [](#using-laravel-mix) Install using Yarn ``` yarn add sweetalert --dev ``` Install using NPM ``` npm install sweetalert --save-dev ``` Require sweetalert within your `resources/js/bootstrap.js` file. ``` // ... require("sweetalert"); // ... ``` Then make sure to include your scripts in your blade layout. Remove the `defer` attribute if your script tag contains it, `defer` will delay the execution of the script which will cause an error as the `sweet::alert` blade template is rendered first by the browser as html. ``` > @include('sweet::alert') ``` Finally compile your assets with Mix ``` npm run dev ``` Usage ----- [](#usage) ### Using the Facade [](#using-the-facade) First import the SweetAlert facade in your controller. ``` use SweetAlert; ``` Within your controllers, before you perform a redirect... ``` public function store() { SweetAlert::message('Robots are working!'); return Redirect::home(); } ``` Here are some examples on how you can use the facade: ``` SweetAlert::message('Message', 'Optional Title'); SweetAlert::basic('Basic Message', 'Mandatory Title'); SweetAlert::info('Info Message', 'Optional Title'); SweetAlert::success('Success Message', 'Optional Title'); SweetAlert::error('Error Message', 'Optional Title'); SweetAlert::warning('Warning Message', 'Optional Title'); ``` ### Using the helper function [](#using-the-helper-function) `alert($message = null, $title = '')` In addition to the previous listed methods you can also just use the helper function without specifying any message type. Doing so is similar to: `alert()->message('Message', 'Optional Title')` Like with the Facade we can use the helper with the same methods: ``` alert()->message('Message', 'Optional Title'); alert()->basic('Basic Message', 'Mandatory Title'); alert()->info('Info Message', 'Optional Title'); alert()->success('Success Message', 'Optional Title'); alert()->error('Error Message', 'Optional Title'); alert()->warning('Warning Message', 'Optional Title'); alert()->basic('Basic Message', 'Mandatory Title')->autoclose(3500); alert()->error('Error Message', 'Optional Title')->persistent('Close'); ``` Within your controllers, before you perform a redirect... ``` /** * Destroy the user's session (logout). * * @return Response */ public function destroy() { Auth::logout(); alert()->success('You have been logged out.', 'Good bye!'); return home(); } ``` For a general information alert, just do: `alert('Some message');` (same as `alert()->message('Some message');`). ### Using the Middleware [](#using-the-middleware) #### Middleware Groups [](#middleware-groups) First register the middleware in web middleware groups by simply adding the middleware class `Tdanandeh\SweetAlert\ConvertMessagesIntoSweetAlert::class` into the $middlewareGroups of your app/Http/Kernel.php class: ``` protected $middlewareGroups = [ 'web' => [ \App\Http\Middleware\EncryptCookies::class, ... \Tdanandeh\SweetAlert\ConvertMessagesIntoSweetAlert::class, ], 'api' => [ 'throttle:60,1', ], ]; ``` > Make sure you register the middleware within the 'web' group only. #### Route Middleware [](#route-middleware) Or if you would like to assign the middleware to specific routes only, you should add the middleware to `$routeMiddleware` in `app/Http/Kernel.php` file: ``` protected $routeMiddleware = [ 'auth' => \App\Http\Middleware\Authenticate::class, .... 'sweetalert' => \Tdanandeh\SweetAlert\ConvertMessagesIntoSweetAlert::class, ]; ``` Next step: within your controllers, set your return message (using `with()`) and send the proper message and proper type. ``` return redirect('dashboard')->with('success', 'Profile updated!'); ``` or ``` return redirect()->back()->with('error', 'Profile updated!'); ``` > **NOTE**: When using the middleware it will make an alert to display if it detects any of the following keys flashed into the session: `error`, `success`, `warning`, `info`, `message`, `basic`. ### Final Considerations [](#final-considerations) By default, all alerts will dismiss after a sensible default number of seconds. But not to worry, if you need to specify a different time you can: ``` // -> Remember!, the number is set in milliseconds alert('Hello World!')->autoclose(3000); ``` Also, if you need the alert to be persistent on the page until the user dismiss it by pressing the alert confirmation button: ``` // -> The text will appear in the button alert('Hello World!')->persistent("Close this"); ``` You can render html in your message with the html() method like this: ``` // -> html will be evaluated alert('Click me')->html()->persistent("No, thanks"); ``` Customize --------- [](#customize) ### Config [](#config) If you need to customize the default configuration options for this package just export the configuration file: ``` php artisan vendor:publish --provider "Tdanandeh\SweetAlert\SweetAlertServiceProvider" --tag=config ``` A `sweet-alert.php` configuration file will be published to your `config` directory. By now, the only configuration that can be changed is the timer for all autoclose alerts. ### View [](#view) If you need to customize the included alert message view, run: ``` php artisan vendor:publish --provider "Tdanandeh\SweetAlert\SweetAlertServiceProvider" --tag=views ``` The package view is located in the `resources/views/vendor/sweet/` directory. You can customize this view to fit your needs. #### Configuration Options [](#configuration-options) You have access to the following configuration options to build a custom view: ``` Session::get('sweet_alert.text') Session::get('sweet_alert.title') Session::get('sweet_alert.icon') Session::get('sweet_alert.closeOnClickOutside') Session::get('sweet_alert.buttons') Session::get('sweet_alert.timer') ``` Please check the CONFIGURATION section in the [website](https://sweetalert.js.org/docs/#configuration) for all other options available. ### Default View [](#default-view) The `sweet_alert.alert` session key contains a JSON configuration object to pass it directly to Sweet Alert. ``` @if (Session::has('sweet_alert.alert')) swal({!! Session::get('sweet_alert.alert') !!}); @endif ``` Note that `{!! !!}` are used to output the json configuration object unescaped, it will not work with `{{ }}` escaped output tags. ### Custom View [](#custom-view) This is an example of how you can customize your view to fit your needs: ``` @if (Session::has('sweet_alert.alert')) swal({ text: "{!! Session::get('sweet_alert.text') !!}", title: "{!! Session::get('sweet_alert.title') !!}", timer: {!! Session::get('sweet_alert.timer') !!}, icon: "{!! Session::get('sweet_alert.type') !!}", buttons: "{!! Session::get('sweet_alert.buttons') !!}", // more options }); @endif ``` Note that you must use `""` (double quotes) to wrap the values except for the timer option. Tests ----- [](#tests) To run the included test suite: ``` vendor/bin/phpunit ``` Demo ---- [](#demo) ``` SweetAlert::message('Welcome back!'); return Redirect::home(); ``` [![A simple alert](demos/4bvuJx9.png)](demos/4bvuJx9.png) ``` SweetAlert::message('Your profile is up to date', 'Wonderful!'); return Redirect::home(); ``` [![A simple alert with title](demos/GsGOtOq.png)](demos/GsGOtOq.png) ``` SweetAlert::message('Thanks for comment!')->persistent('Close'); return Redirect::home(); ``` [![A simple alert with title and button](demos/AnRGDY2.png)](demos/AnRGDY2.png) ``` SweetAlert::info('Email was sent!'); return Redirect::home(); ``` [![A info alert](demos/DxKh3Yx.png)](demos/DxKh3Yx.png) ``` SweetAlert::error('Something went wrong', 'Oops!'); return Redirect::home(); ``` [![A error alert](demos/pIeTEYz.png)](demos/pIeTEYz.png) ``` SweetAlert::success('Good job!'); return Redirect::home(); ``` [![A success alert](demos/pQz3ijJ.png)](demos/pQz3ijJ.png) ``` SweetAlert::info('Random lorempixel.com : ')->html(); return Redirect::home(); ``` [![HTML in message](demos/x44c12a.png)](demos/x44c12a.png) ``` SweetAlert::success('Good job!')->persistent("Close"); return Redirect::home(); ``` [![A persistent alert](demos/dj3y95K.png)](demos/dj3y95K.png) License ------- [](#license) Sweet Alert for Laravel is open-sourced software licensed under the [MIT license](LICENSE). "# sweet-alert" ### Health Score 29 — LowBetter than 60% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity24 Limited adoption so far Community7 Small or concentrated contributor base Maturity54 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 1171d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/6b70809d87e6a284786bb80d8e8ad26842b75a18fbf3ded0efbd2a68c011a0de?d=identicon)[tdanandeh](/maintainers/tdanandeh) --- Top Contributors [![tdanandeh](https://avatars.githubusercontent.com/u/42702634?v=4)](https://github.com/tdanandeh "tdanandeh (7 commits)") --- Tags laravelnotifieralertsweet ### Code Quality TestsPHPUnit Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/tdanandeh-sweet-alert/health.svg) ``` [![Health](https://phpackages.com/badges/tdanandeh-sweet-alert/health.svg)](https://phpackages.com/packages/tdanandeh-sweet-alert) ``` ### Alternatives [uxweb/sweet-alert A simple PHP package to show Sweet Alerts with the Laravel Framework 8251.3M6](/packages/uxweb-sweet-alert)[realrashid/sweet-alert Laravel Sweet Alert Is A Package For Laravel Provides An Easy Way To Display Alert Messages Using The SweetAlert2 Library. 1.2k2.9M21](/packages/realrashid-sweet-alert)[prologue/alerts Prologue Alerts is a package that handles global site messages. 3486.1M30](/packages/prologue-alerts)[masmerise/livewire-toaster Beautiful toast notifications for Laravel / Livewire. 505550.3k6](/packages/masmerise-livewire-toaster) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)