check(); } /** * Stops the application and shows a permission error if * the application is in demo mode. */ protected function preventAccessInDemoMode() { if (config('app.env') === 'demo') { $this->showPermissionError(); } } /** * Adds the page title into the view. */ public function setPageTitle(string $title) { view()->share('pageTitle', $title); } /** * On a permission error redirect to home and display. * the error as a notification. * * @return never */ protected function showPermissionError() { $message = request()->wantsJson() ? trans('errors.permissionJson') : trans('errors.permission'); throw new NotifyException($message, '/', 403); } /** * Checks that the current user has the given permission otherwise throw an exception. */ protected function checkPermission(string $permission): void { if (!user() || !user()->can($permission)) { $this->showPermissionError(); } } /** * Prevent access for guest users beyond this point. */ protected function preventGuestAccess(): void { if (user()->isGuest()) { $this->showPermissionError(); } } /** * Check the current user's permissions against an ownable item otherwise throw an exception. */ protected function checkOwnablePermission(string $permission, Model $ownable): void { if (!userCan($permission, $ownable)) { $this->showPermissionError(); } } /** * Check if a user has a permission or bypass the permission * check if the given callback resolves true. */ protected function checkPermissionOr(string $permission, callable $callback): void { if ($callback() !== true) { $this->checkPermission($permission); } } /** * Check if the current user has a permission or bypass if the provided user * id matches the current user. */ protected function checkPermissionOrCurrentUser(string $permission, int $userId): void { $this->checkPermissionOr($permission, function () use ($userId) { return $userId === user()->id; }); } /** * Send back a json error message. */ protected function jsonError(string $messageText = '', int $statusCode = 500): JsonResponse { return response()->json(['message' => $messageText, 'status' => 'error'], $statusCode); } /** * Create and return a new download response factory using the current request. */ protected function download(): DownloadResponseFactory { return new DownloadResponseFactory(request()); } /** * Show a positive, successful notification to the user on next view load. */ protected function showSuccessNotification(string $message): void { session()->flash('success', $message); } /** * Show a warning notification to the user on next view load. */ protected function showWarningNotification(string $message): void { session()->flash('warning', $message); } /** * Show an error notification to the user on next view load. */ protected function showErrorNotification(string $message): void { session()->flash('error', $message); } /** * Log an activity in the system. * * @param string|Loggable $detail */ protected function logActivity(string $type, $detail = ''): void { Activity::add($type, $detail); } /** * Get the validation rules for image files. */ protected function getImageValidationRules(): array { return ['image_extension', 'mimes:jpeg,png,gif,webp', 'max:' . (config('app.upload_limit') * 1000)]; } }