Уведомления

Suggest Edit

Простой способ уведомить пользователя о состоянии вашего приложения. Например, они могут информировать пользователя о завершении длительного процесса или приходе нового сообщения. В этом разделе мы покажем вам, как заставить их работать в вашем приложении.

Одноразовые сообщения

Flash-уведомление — это одноразовое сообщение, которое будет удалено при следующем обращении. Уведомления призваны информировать о непосредственно произошедшим событием, например сообщение о сохранении данных.

ORCHID имеет удобный вызов и отображение уведомлений поверх одноразовых flash-данных.

use Orchid\Support\Facades\Alert;

Alert::message('Welcome Aboard!');

или использовать более короткую запись:

alert('Message');

Сообщения могут визуально отображать статус с помощью цветовой гаммы, для этого предназначены методы:

Alert::info('Message')
Alert::success('Message')
Alert::error('Message')
Alert::warning('Message')

Для вставки собственного шаблона с использованием переменных, тегов используется метод view:

Alert::view('alert', Alert::info, [
    'name' => 'Alexandr'
]);

Первый аргумент метода это путь/имя Blade шаблона:

// resources/views/alert.blade.php

Hello <strong>{{ $name }}</strong>

При использовании, будет установлено несколько ключей в сессии:

  • 'flash_notification.message’ – Сообщение для отображения
  • 'flash_notification.level’ – Строка, представляющая тип уведомления

Отображение по умолчанию уже встроено в шаблон, но вы можете вызывать его явно в blade шаблоне с помощью Для отображения в необходимом месте требуется:

@include('platform::partials.alert')

Тост сообщения

Это маленькое всплывающее сообщение в правом верхнем углу экрана, для краткого уведомления пользователя резульатете. Он полностью соответствует одноразовым сообщениям Alert, но имеет другой внешний вид и несколько дополнительных методов:

use Orchid\Support\Facades\Toast;

Toast::warning('Lorem ipsum dolor sit amet, consectetur adipiscing elit.')

Вы можете указать необходимость автоматического скрытия и времени до этого:

Toast::warning('Lorem ipsum dolor sit amet.')
    ->autoHide(false);

Toast::warning('Lorem ipsum dolor sit amet.')
    ->delay(2000);

Уведомления в панели администрирования

Уведомление в панели администрирование отличается от flash-сообщений, тем, что не удаляются после просмотра и могут быть добавлены любым пользователям даже когда они находятся не в сети. Это ещё один отличный способ информирования, например для приложение “менеджера задач” уведомлять сотрудника о новой задаче.

Для создания уведомления требуется:

$user = User::find(1);

$user->notify(new \Orchid\Platform\Notifications\DashboardNotification([
    'title'   => 'Hello Word',
    'message' => 'New post!',
    'action'  => 'http://orchid.software/',
    'type'    =>  DashboardNotification::INFO,
]));

Поддерживаемые типы:

  • DashboardNotification::INFO (По умолчанию)
  • DashboardNotification::SUCCESS
  • DashboardNotification::WARNING
  • DashboardNotification::ERROR