1 <?php namespace BookStack\Http\Controllers;
3 use BookStack\Exceptions\PermissionsException;
4 use BookStack\Repos\PermissionsRepo;
5 use Illuminate\Http\Request;
7 class PermissionController extends Controller
10 protected $permissionsRepo;
13 * PermissionController constructor.
14 * @param 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 session()->flash('success', 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.
79 * @param Request $request
80 * @return \Illuminate\Http\RedirectResponse|\Illuminate\Routing\Redirector
82 public function updateRole($id, Request $request)
84 $this->checkPermission('user-roles-manage');
85 $this->validate($request, [
86 'display_name' => 'required|min:3|max:200',
87 'description' => 'max:250'
90 $this->permissionsRepo->updateRole($id, $request->all());
91 session()->flash('success', trans('settings.role_update_success'));
92 return redirect('/settings/roles');
96 * Show the view to delete a role.
97 * Offers the chance to migrate users.
99 * @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
101 public function showDeleteRole($id)
103 $this->checkPermission('user-roles-manage');
104 $role = $this->permissionsRepo->getRoleById($id);
105 $roles = $this->permissionsRepo->getAllRolesExcept($role);
106 $blankRole = $role->newInstance(['display_name' => trans('settings.role_delete_no_migration')]);
107 $roles->prepend($blankRole);
108 return view('settings/roles/delete', ['role' => $role, 'roles' => $roles]);
112 * Delete a role from the system,
113 * Migrate from a previous role if set.
115 * @param Request $request
116 * @return \Illuminate\Http\RedirectResponse|\Illuminate\Routing\Redirector
118 public function deleteRole($id, Request $request)
120 $this->checkPermission('user-roles-manage');
123 $this->permissionsRepo->deleteRole($id, $request->get('migrate_role_id'));
124 } catch (PermissionsException $e) {
125 session()->flash('error', $e->getMessage());
126 return redirect()->back();
129 session()->flash('success', trans('settings.role_delete_success'));
130 return redirect('/settings/roles');