3 namespace BookStack\Http\Controllers;
5 use BookStack\Auth\Access\SocialAuthService;
6 use BookStack\Auth\User;
7 use BookStack\Auth\UserRepo;
8 use BookStack\Exceptions\ImageUploadException;
9 use BookStack\Exceptions\UserUpdateException;
10 use BookStack\Uploads\ImageRepo;
12 use Illuminate\Http\Request;
13 use Illuminate\Support\Facades\DB;
14 use Illuminate\Validation\Rules\Password;
15 use Illuminate\Validation\ValidationException;
17 class UserController extends Controller
23 * UserController constructor.
25 public function __construct(UserRepo $userRepo, ImageRepo $imageRepo)
27 $this->userRepo = $userRepo;
28 $this->imageRepo = $imageRepo;
32 * Display a listing of the users.
34 public function index(Request $request)
36 $this->checkPermission('users-manage');
38 'order' => $request->get('order', 'asc'),
39 'search' => $request->get('search', ''),
40 'sort' => $request->get('sort', 'name'),
42 $users = $this->userRepo->getAllUsersPaginatedAndSorted(20, $listDetails);
44 $this->setPageTitle(trans('settings.users'));
45 $users->appends($listDetails);
47 return view('users.index', ['users' => $users, 'listDetails' => $listDetails]);
51 * Show the form for creating a new user.
53 public function create()
55 $this->checkPermission('users-manage');
56 $authMethod = config('auth.method');
57 $roles = $this->userRepo->getAllRoles();
58 $this->setPageTitle(trans('settings.users_add_new'));
60 return view('users.create', ['authMethod' => $authMethod, 'roles' => $roles]);
64 * Store a new user in storage.
66 * @throws ValidationException
68 public function store(Request $request)
70 $this->checkPermission('users-manage');
72 $authMethod = config('auth.method');
73 $sendInvite = ($request->get('send_invite', 'false') === 'true');
74 $externalAuth = $authMethod === 'ldap' || $authMethod === 'saml2' || $authMethod === 'oidc';
75 $passwordRequired = ($authMethod === 'standard' && !$sendInvite);
78 'name' => ['required'],
79 'email' => ['required', 'email', 'unique:users,email'],
80 'language' => ['string'],
82 'roles.*' => ['integer'],
83 'password' => $passwordRequired ? ['required', Password::default()] : null,
84 'password-confirm' => $passwordRequired ? ['required', 'same:password'] : null,
85 'external_auth_id' => $externalAuth ? ['required'] : null,
88 $validated = $this->validate($request, array_filter($validationRules));
90 DB::transaction(function () use ($validated, $sendInvite) {
91 $this->userRepo->create($validated, $sendInvite);
94 return redirect('/settings/users');
98 * Show the form for editing the specified user.
100 public function edit(int $id, SocialAuthService $socialAuthService)
102 $this->checkPermissionOrCurrentUser('users-manage', $id);
104 /** @var User $user */
105 $user = User::query()->with(['apiTokens', 'mfaValues'])->findOrFail($id);
107 $authMethod = ($user->system_name) ? 'system' : config('auth.method');
109 $activeSocialDrivers = $socialAuthService->getActiveDrivers();
110 $mfaMethods = $user->mfaValues->groupBy('method');
111 $this->setPageTitle(trans('settings.user_profile'));
112 $roles = $this->userRepo->getAllRoles();
114 return view('users.edit', [
116 'activeSocialDrivers' => $activeSocialDrivers,
117 'mfaMethods' => $mfaMethods,
118 'authMethod' => $authMethod,
124 * Update the specified user in storage.
126 * @throws UserUpdateException
127 * @throws ImageUploadException
128 * @throws ValidationException
130 public function update(Request $request, int $id)
132 $this->preventAccessInDemoMode();
133 $this->checkPermissionOrCurrentUser('users-manage', $id);
135 $validated = $this->validate($request, [
137 'email' => ['min:2', 'email', 'unique:users,email,' . $id],
138 'password' => ['required_with:password_confirm', Password::default()],
139 'password-confirm' => ['same:password', 'required_with:password'],
140 'language' => ['string'],
141 'roles' => ['array'],
142 'roles.*' => ['integer'],
143 'external_auth_id' => ['string'],
144 'profile_image' => array_merge(['nullable'], $this->getImageValidationRules()),
147 $user = $this->userRepo->getById($id);
148 $this->userRepo->update($user, $validated, userCan('users-manage'));
150 // Save profile image if in request
151 if ($request->hasFile('profile_image')) {
152 $imageUpload = $request->file('profile_image');
153 $this->imageRepo->destroyImage($user->avatar);
154 $image = $this->imageRepo->saveNew($imageUpload, 'user', $user->id);
155 $user->image_id = $image->id;
159 // Delete the profile image if reset option is in request
160 if ($request->has('profile_image_reset')) {
161 $this->imageRepo->destroyImage($user->avatar);
164 $redirectUrl = userCan('users-manage') ? '/settings/users' : "/settings/users/{$user->id}";
166 return redirect($redirectUrl);
170 * Show the user delete page.
172 public function delete(int $id)
174 $this->checkPermissionOrCurrentUser('users-manage', $id);
176 $user = $this->userRepo->getById($id);
177 $this->setPageTitle(trans('settings.users_delete_named', ['userName' => $user->name]));
179 return view('users.delete', ['user' => $user]);
183 * Remove the specified user from storage.
187 public function destroy(Request $request, int $id)
189 $this->preventAccessInDemoMode();
190 $this->checkPermissionOrCurrentUser('users-manage', $id);
192 $user = $this->userRepo->getById($id);
193 $newOwnerId = $request->get('new_owner_id', null);
195 $this->userRepo->destroy($user, $newOwnerId);
197 return redirect('/settings/users');
201 * Update the user's preferred book-list display setting.
203 public function switchBooksView(Request $request, int $id)
205 return $this->switchViewType($id, $request, 'books');
209 * Update the user's preferred shelf-list display setting.
211 public function switchShelvesView(Request $request, int $id)
213 return $this->switchViewType($id, $request, 'bookshelves');
217 * Update the user's preferred shelf-view book list display setting.
219 public function switchShelfView(Request $request, int $id)
221 return $this->switchViewType($id, $request, 'bookshelf');
225 * For a type of list, switch with stored view type for a user.
227 protected function switchViewType(int $userId, Request $request, string $listName)
229 $this->checkPermissionOrCurrentUser('users-manage', $userId);
231 $viewType = $request->get('view_type');
232 if (!in_array($viewType, ['grid', 'list'])) {
236 $user = $this->userRepo->getById($userId);
237 $key = $listName . '_view_type';
238 setting()->putUser($user, $key, $viewType);
240 return redirect()->back(302, [], "/settings/users/$userId");
244 * Change the stored sort type for a particular view.
246 public function changeSort(Request $request, string $id, string $type)
248 $validSortTypes = ['books', 'bookshelves', 'shelf_books'];
249 if (!in_array($type, $validSortTypes)) {
250 return redirect()->back(500);
253 return $this->changeListSort($id, $request, $type);
257 * Toggle dark mode for the current user.
259 public function toggleDarkMode()
261 $enabled = setting()->getForCurrentUser('dark-mode-enabled', false);
262 setting()->putUser(user(), 'dark-mode-enabled', $enabled ? 'false' : 'true');
264 return redirect()->back();
268 * Update the stored section expansion preference for the given user.
270 public function updateExpansionPreference(Request $request, string $id, string $key)
272 $this->checkPermissionOrCurrentUser('users-manage', $id);
273 $keyWhitelist = ['home-details'];
274 if (!in_array($key, $keyWhitelist)) {
275 return response('Invalid key', 500);
278 $newState = $request->get('expand', 'false');
280 $user = $this->userRepo->getById($id);
281 setting()->putUser($user, 'section_expansion#' . $key, $newState);
283 return response('', 204);
287 * Changed the stored preference for a list sort order.
289 protected function changeListSort(int $userId, Request $request, string $listName)
291 $this->checkPermissionOrCurrentUser('users-manage', $userId);
293 $sort = $request->get('sort');
294 if (!in_array($sort, ['name', 'created_at', 'updated_at', 'default'])) {
298 $order = $request->get('order');
299 if (!in_array($order, ['asc', 'desc'])) {
303 $user = $this->userRepo->getById($userId);
304 $sortKey = $listName . '_sort';
305 $orderKey = $listName . '_sort_order';
306 setting()->putUser($user, $sortKey, $sort);
307 setting()->putUser($user, $orderKey, $order);
309 return redirect()->back(302, [], "/settings/users/$userId");