https://github.com/bastinald/laravel-livewire-toasts

Dynamic Laravel Livewire Bootstrap toasts.
https://github.com/bastinald/laravel-livewire-toasts

bootstrap bootstrap-toasts laravel laravel-livewire livewire php toasts

Last synced: 4 days ago
JSON representation

Dynamic Laravel Livewire Bootstrap toasts.

• Host: GitHub
• URL: https://github.com/bastinald/laravel-livewire-toasts
• Owner: bastinald
• Created: 2021-07-14T00:49:18.000Z (about 3 years ago)
• Default Branch: master
• Last Pushed: 2022-02-15T16:55:19.000Z (over 2 years ago)
• Last Synced: 2024-09-25T20:32:03.190Z (8 days ago)
• Topics: bootstrap, bootstrap-toasts, laravel, laravel-livewire, livewire, php, toasts
• Language: PHP
• Homepage:
• Size: 7.81 KB
• Stars: 16
• Watchers: 1
• Forks: 9
• Open Issues: 1
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

README

        
# Laravel Livewire Toasts

This package allows you to dynamically show Bootstrap toasts via Laravel Livewire components.

## Documentation

- [Requirements](#requirements)

- [Installation](#installation)

- [Usage](#usage)

    - [Showing Toasts](#showing-toasts)

    - [Emitting Events](#emitting-events)

- [Publishing Assets](#publishing-assets)

    - [Custom Config](#custom-config)

    - [Custom View](#custom-view)

## Requirements

- Bootstrap 5 must be installed via webpack first

## Installation

Require the package:

```console

composer require bastinald/laravel-livewire-toasts

```

Add the `livewire:toasts` component to your app layout view:

```html

```

Require `../../vendor/bastinald/laravel-livewire-toasts/resources/js/toasts` in your app javascript file:

```javascript

require('@popperjs/core');

require('bootstrap');

require('../../vendor/bastinald/laravel-livewire-toasts/resources/js/toasts');

```

## Usage

### Showing Toasts

Show a toast by emitting the `showToast` event with the color & message:

```php

public function save()

{

    $this->validate();

    $this->user->update([

        'name' => $this->name,

        'email' => $this->email,

    ]);

    $this->emit('showToast', 'success', __('User updated!'));

}

```

The color should be a Bootstrap color name e.g. `success`, `danger`, `info`.

### Emitting Events

You can emit events inside your views:

```html

    {{ __('Close') }}

```

Or inside your components, just like any normal Livewire event:

```php

public function save()

{

    $this->validate();

    // save the record

    $this->emit('showToast', 'info', __('Record saved!'));

}

```

## Publishing Assets

### Custom Config

Customize the toasts configuration by publishing the config file:

```console

php artisan vendor:publish --tag=laravel-livewire-toasts:config

```

Now you can easily change things like the hide delay and error message.

### Custom View

Use your own toasts view by publishing the view file:

```console

php artisan vendor:publish --tag=laravel-livewire-toasts:views

```

Now edit the view file inside `resources/views/vendor/laravel-livewire-toasts`. The package will use this view to render the component.