Уведомления
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