digitlimit/alert

An easy way of flashing messages in Laravel Application

v2.0.0 2023-05-21 10:42 UTC

Requires

• php: ^7.4|^8.0
• ext-json: *
• illuminate/contracts: ^7.20|^8.19|^9.0|^10.0
• illuminate/support: ^7.20|^8.19|^9.0|^10.0

Requires (Dev)

• guzzlehttp/guzzle: ^7.3
• laravel/framework: ^7.20|^8.19|^9.0|^10.0
• nunomaduro/collision: ^7.5
• orchestra/testbench: ^8.5
• pestphp/pest: ^2.5
• phpunit/phpunit: ^10.0

MIT

• Emeka Mbah

• errors
• validation
• flash
• laravel
• views
• messages
• error bags

README

Version 2.0

Alert is a Laravel package for displaying different types of messages in Laravel application views. It's designed to make flashing messages in Laravel Applications a breeze, with a lot of easy-to-use and fluent methods.

The alert is pretty easy to use, customize and extend. There are 6 out-of-box alert types, which include

Message Alert
Sticky Alert
Field Alert
FieldBag Alert
Modal Alert
Notify Alert

Fortunately, you can easily create custom types. The package can be easily extended with macros.

Quick Start

1. Install Alert with composer:

composer require digitlimit/alert

2. Somewhere in the blade template

<x-alert-message />

Example:

@extends('layouts.default')

@section('content')
  <div class="container-xxl flex-grow-1 container-p-y">
    <div class="row">
      <div class="col-md-12">
        <x-alert-message />
      </div>
    </div>

    <div class="row">
      @include('form.profile')
    </div>        
  </div>

  @include('partials.footer')
@endsection

NB: At the moment the alert components are built with Twitter Bootstrap 5, and can be customized to use other CSS classes. Need to ensure bootstrap is included on the page.

3. Somewhere in the application

<?php

namespace App\Http\Controllers;

use Alert;

class DashboardController extends Controller
{
    public function index()
    {
        Alert::message('Welcome! Please complete your profile')
            ->info()
            ->flash();

        return view('home');
    }
}

4. Result

Documentation

Learn how to get started with Alert and then dive deeper into other and advanced topics:

Complete documentation

Change log

Coming soon

Code of conduct

We will behave ourselves if you behave yourselves. For more details see our CODE_OF_CONDUCT.md.

Contributing

Please read through our contributing guidelines. Included are directions for opening issues.

Maintainers

The alert package is currently maintained by Emeka Mbah. If you have any questions please don't hesitate to create an issue on this repo.

Versioning

Alert will be maintained under the Semantic Versioning guidelines as much as possible. Releases will be numbered with the following format:

<major>.<minor>.<patch>

For more information on SemVer, please visit https://semver.org.

• Any release may update the design, look-and-feel, or branding of an existing icon
• We will never intentionally release a patch version update that breaks backward compatibility
• A minor release may include backward-incompatible changes but we will write clear upgrading instructions in UPGRADING.md
• A minor or patch release will never remove icons
• Bug fixes will be addressed as patch releases unless they include backward incompatibility then they will be minor releases

License

Alert Free is free, open source, and GPL friendly. You can use it for commercial projects, open source projects, or really almost whatever you want.

• Code — MIT License
  • In the Alert Free download, the MIT license applies all PHP files.

We've kept attribution comments terse, so we ask that you do not actively work to remove them from files, especially code. They're a great way for folks to learn about Alert.