1 <?php namespace BookStack\Http\Controllers;
3 use BookStack\Auth\Permissions\PermissionsRepo;
4 use BookStack\Exceptions\PermissionsException;
5 use Illuminate\Http\Request;
7 class PermissionController extends Controller
10 protected $permissionsRepo;
13 * PermissionController constructor.
14 * @param \BookStack\Auth\Permissions\PermissionsRepo $permissionsRepo
16 public function __construct(PermissionsRepo $permissionsRepo)
18 $this->permissionsRepo = $permissionsRepo;
19 parent::__construct();
23 * Show a listing of the roles in the system.
25 public function listRoles()
27 $this->checkPermission('user-roles-manage');
28 $roles = $this->permissionsRepo->getAllRoles();
29 return view('settings.roles.index', ['roles' => $roles]);
33 * Show the form to create a new role
34 * @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
36 public function createRole()
38 $this->checkPermission('user-roles-manage');
39 return view('settings.roles.create');
43 * Store a new role in the system.
44 * @param Request $request
45 * @return \Illuminate\Http\RedirectResponse|\Illuminate\Routing\Redirector
47 public function storeRole(Request $request)
49 $this->checkPermission('user-roles-manage');
50 $this->validate($request, [
51 'display_name' => 'required|min:3|max:200',
52 'description' => 'max:250'
55 $this->permissionsRepo->saveNewRole($request->all());
56 $this->showSuccessNotification(trans('settings.role_create_success'));
57 return redirect('/settings/roles');
61 * Show the form for editing a user role.
63 * @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
64 * @throws PermissionsException
66 public function editRole($id)
68 $this->checkPermission('user-roles-manage');
69 $role = $this->permissionsRepo->getRoleById($id);
71 throw new PermissionsException(trans('errors.role_cannot_be_edited'));
73 return view('settings.roles.edit', ['role' => $role]);
77 * Updates a user role.
78 * @param Request $request
80 * @return \Illuminate\Http\RedirectResponse|\Illuminate\Routing\Redirector
81 * @throws PermissionsException
82 * @throws \Illuminate\Validation\ValidationException
84 public function updateRole(Request $request, $id)
86 $this->checkPermission('user-roles-manage');
87 $this->validate($request, [
88 'display_name' => 'required|min:3|max:200',
89 'description' => 'max:250'
92 $this->permissionsRepo->updateRole($id, $request->all());
93 $this->showSuccessNotification(trans('settings.role_update_success'));
94 return redirect('/settings/roles');
98 * Show the view to delete a role.
99 * Offers the chance to migrate users.
101 * @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
103 public function showDeleteRole($id)
105 $this->checkPermission('user-roles-manage');
106 $role = $this->permissionsRepo->getRoleById($id);
107 $roles = $this->permissionsRepo->getAllRolesExcept($role);
108 $blankRole = $role->newInstance(['display_name' => trans('settings.role_delete_no_migration')]);
109 $roles->prepend($blankRole);
110 return view('settings.roles.delete', ['role' => $role, 'roles' => $roles]);
114 * Delete a role from the system,
115 * Migrate from a previous role if set.
116 * @param Request $request
118 * @return \Illuminate\Http\RedirectResponse|\Illuminate\Routing\Redirector
120 public function deleteRole(Request $request, $id)
122 $this->checkPermission('user-roles-manage');
125 $this->permissionsRepo->deleteRole($id, $request->get('migrate_role_id'));
126 } catch (PermissionsException $e) {
127 $this->showErrorNotification($e->getMessage());
128 return redirect()->back();
131 $this->showSuccessNotification(trans('settings.role_delete_success'));
132 return redirect('/settings/roles');