3 namespace BookStack\Http\Controllers;
5 use BookStack\Actions\ActivityType;
6 use BookStack\Auth\Access\SocialAuthService;
7 use BookStack\Auth\Access\UserInviteService;
8 use BookStack\Auth\User;
9 use BookStack\Auth\UserRepo;
10 use BookStack\Exceptions\ImageUploadException;
11 use BookStack\Exceptions\UserUpdateException;
12 use BookStack\Uploads\ImageRepo;
14 use Illuminate\Http\Request;
15 use Illuminate\Support\Facades\DB;
16 use Illuminate\Support\Str;
17 use Illuminate\Validation\Rules\Password;
18 use Illuminate\Validation\ValidationException;
20 class UserController extends Controller
24 protected $inviteService;
28 * UserController constructor.
30 public function __construct(User $user, UserRepo $userRepo, UserInviteService $inviteService, ImageRepo $imageRepo)
33 $this->userRepo = $userRepo;
34 $this->inviteService = $inviteService;
35 $this->imageRepo = $imageRepo;
39 * Display a listing of the users.
41 public function index(Request $request)
43 $this->checkPermission('users-manage');
45 'order' => $request->get('order', 'asc'),
46 'search' => $request->get('search', ''),
47 'sort' => $request->get('sort', 'name'),
49 $users = $this->userRepo->getAllUsersPaginatedAndSorted(20, $listDetails);
51 $this->setPageTitle(trans('settings.users'));
52 $users->appends($listDetails);
54 return view('users.index', ['users' => $users, 'listDetails' => $listDetails]);
58 * Show the form for creating a new user.
60 public function create()
62 $this->checkPermission('users-manage');
63 $authMethod = config('auth.method');
64 $roles = $this->userRepo->getAllRoles();
65 $this->setPageTitle(trans('settings.users_add_new'));
67 return view('users.create', ['authMethod' => $authMethod, 'roles' => $roles]);
71 * Store a newly created user in storage.
73 * @throws UserUpdateException
74 * @throws ValidationException
76 public function store(Request $request)
78 $this->checkPermission('users-manage');
80 'name' => ['required'],
81 'email' => ['required', 'email', 'unique:users,email'],
82 'setting' => ['array'],
85 $authMethod = config('auth.method');
86 $sendInvite = ($request->get('send_invite', 'false') === 'true');
88 if ($authMethod === 'standard' && !$sendInvite) {
89 $validationRules['password'] = ['required', Password::default()];
90 $validationRules['password-confirm'] = ['required', 'same:password'];
91 } elseif ($authMethod === 'ldap' || $authMethod === 'saml2' || $authMethod === 'openid') {
92 $validationRules['external_auth_id'] = ['required'];
94 $this->validate($request, $validationRules);
96 $user = $this->user->fill($request->all());
98 if ($authMethod === 'standard') {
99 $user->password = bcrypt($request->get('password', Str::random(32)));
100 } elseif ($authMethod === 'ldap' || $authMethod === 'saml2' || $authMethod === 'openid') {
101 $user->external_auth_id = $request->get('external_auth_id');
104 $user->refreshSlug();
106 DB::transaction(function () use ($user, $sendInvite, $request) {
109 // Save user-specific settings
110 if ($request->filled('setting')) {
111 foreach ($request->get('setting') as $key => $value) {
112 setting()->putUser($user, $key, $value);
117 $this->inviteService->sendInvitation($user);
120 if ($request->filled('roles')) {
121 $roles = $request->get('roles');
122 $this->userRepo->setUserRoles($user, $roles);
125 $this->userRepo->downloadAndAssignUserAvatar($user);
127 $this->logActivity(ActivityType::USER_CREATE, $user);
130 return redirect('/settings/users');
134 * Show the form for editing the specified user.
136 public function edit(int $id, SocialAuthService $socialAuthService)
138 $this->checkPermissionOrCurrentUser('users-manage', $id);
140 /** @var User $user */
141 $user = $this->user->newQuery()->with(['apiTokens', 'mfaValues'])->findOrFail($id);
143 $authMethod = ($user->system_name) ? 'system' : config('auth.method');
145 $activeSocialDrivers = $socialAuthService->getActiveDrivers();
146 $mfaMethods = $user->mfaValues->groupBy('method');
147 $this->setPageTitle(trans('settings.user_profile'));
148 $roles = $this->userRepo->getAllRoles();
150 return view('users.edit', [
152 'activeSocialDrivers' => $activeSocialDrivers,
153 'mfaMethods' => $mfaMethods,
154 'authMethod' => $authMethod,
160 * Update the specified user in storage.
162 * @throws UserUpdateException
163 * @throws ImageUploadException
164 * @throws ValidationException
166 public function update(Request $request, int $id)
168 $this->preventAccessInDemoMode();
169 $this->checkPermissionOrCurrentUser('users-manage', $id);
171 $this->validate($request, [
173 'email' => ['min:2', 'email', 'unique:users,email,' . $id],
174 'password' => ['required_with:password_confirm', Password::default()],
175 'password-confirm' => ['same:password', 'required_with:password'],
176 'setting' => ['array'],
177 'profile_image' => array_merge(['nullable'], $this->getImageValidationRules()),
180 $user = $this->userRepo->getById($id);
181 $user->fill($request->except(['email']));
184 if (userCan('users-manage') && $request->filled('email')) {
185 $user->email = $request->get('email');
188 // Refresh the slug if the user's name has changed
189 if ($user->isDirty('name')) {
190 $user->refreshSlug();
194 if (userCan('users-manage') && $request->filled('roles')) {
195 $roles = $request->get('roles');
196 $this->userRepo->setUserRoles($user, $roles);
200 if ($request->filled('password')) {
201 $password = $request->get('password');
202 $user->password = bcrypt($password);
205 // External auth id updates
206 if (user()->can('users-manage') && $request->filled('external_auth_id')) {
207 $user->external_auth_id = $request->get('external_auth_id');
210 // Save user-specific settings
211 if ($request->filled('setting')) {
212 foreach ($request->get('setting') as $key => $value) {
213 setting()->putUser($user, $key, $value);
217 // Save profile image if in request
218 if ($request->hasFile('profile_image')) {
219 $imageUpload = $request->file('profile_image');
220 $this->imageRepo->destroyImage($user->avatar);
221 $image = $this->imageRepo->saveNew($imageUpload, 'user', $user->id);
222 $user->image_id = $image->id;
225 // Delete the profile image if reset option is in request
226 if ($request->has('profile_image_reset')) {
227 $this->imageRepo->destroyImage($user->avatar);
231 $this->showSuccessNotification(trans('settings.users_edit_success'));
232 $this->logActivity(ActivityType::USER_UPDATE, $user);
234 $redirectUrl = userCan('users-manage') ? '/settings/users' : ('/settings/users/' . $user->id);
236 return redirect($redirectUrl);
240 * Show the user delete page.
242 public function delete(int $id)
244 $this->checkPermissionOrCurrentUser('users-manage', $id);
246 $user = $this->userRepo->getById($id);
247 $this->setPageTitle(trans('settings.users_delete_named', ['userName' => $user->name]));
249 return view('users.delete', ['user' => $user]);
253 * Remove the specified user from storage.
257 public function destroy(Request $request, int $id)
259 $this->preventAccessInDemoMode();
260 $this->checkPermissionOrCurrentUser('users-manage', $id);
262 $user = $this->userRepo->getById($id);
263 $newOwnerId = $request->get('new_owner_id', null);
265 if ($this->userRepo->isOnlyAdmin($user)) {
266 $this->showErrorNotification(trans('errors.users_cannot_delete_only_admin'));
268 return redirect($user->getEditUrl());
271 if ($user->system_name === 'public') {
272 $this->showErrorNotification(trans('errors.users_cannot_delete_guest'));
274 return redirect($user->getEditUrl());
277 $this->userRepo->destroy($user, $newOwnerId);
278 $this->showSuccessNotification(trans('settings.users_delete_success'));
279 $this->logActivity(ActivityType::USER_DELETE, $user);
281 return redirect('/settings/users');
285 * Update the user's preferred book-list display setting.
287 public function switchBooksView(Request $request, int $id)
289 return $this->switchViewType($id, $request, 'books');
293 * Update the user's preferred shelf-list display setting.
295 public function switchShelvesView(Request $request, int $id)
297 return $this->switchViewType($id, $request, 'bookshelves');
301 * Update the user's preferred shelf-view book list display setting.
303 public function switchShelfView(Request $request, int $id)
305 return $this->switchViewType($id, $request, 'bookshelf');
309 * For a type of list, switch with stored view type for a user.
311 protected function switchViewType(int $userId, Request $request, string $listName)
313 $this->checkPermissionOrCurrentUser('users-manage', $userId);
315 $viewType = $request->get('view_type');
316 if (!in_array($viewType, ['grid', 'list'])) {
320 $user = $this->userRepo->getById($userId);
321 $key = $listName . '_view_type';
322 setting()->putUser($user, $key, $viewType);
324 return redirect()->back(302, [], "/settings/users/$userId");
328 * Change the stored sort type for a particular view.
330 public function changeSort(Request $request, string $id, string $type)
332 $validSortTypes = ['books', 'bookshelves', 'shelf_books'];
333 if (!in_array($type, $validSortTypes)) {
334 return redirect()->back(500);
337 return $this->changeListSort($id, $request, $type);
341 * Toggle dark mode for the current user.
343 public function toggleDarkMode()
345 $enabled = setting()->getForCurrentUser('dark-mode-enabled', false);
346 setting()->putUser(user(), 'dark-mode-enabled', $enabled ? 'false' : 'true');
348 return redirect()->back();
352 * Update the stored section expansion preference for the given user.
354 public function updateExpansionPreference(Request $request, string $id, string $key)
356 $this->checkPermissionOrCurrentUser('users-manage', $id);
357 $keyWhitelist = ['home-details'];
358 if (!in_array($key, $keyWhitelist)) {
359 return response('Invalid key', 500);
362 $newState = $request->get('expand', 'false');
364 $user = $this->user->findOrFail($id);
365 setting()->putUser($user, 'section_expansion#' . $key, $newState);
367 return response('', 204);
371 * Changed the stored preference for a list sort order.
373 protected function changeListSort(int $userId, Request $request, string $listName)
375 $this->checkPermissionOrCurrentUser('users-manage', $userId);
377 $sort = $request->get('sort');
378 if (!in_array($sort, ['name', 'created_at', 'updated_at', 'default'])) {
382 $order = $request->get('order');
383 if (!in_array($order, ['asc', 'desc'])) {
387 $user = $this->user->findOrFail($userId);
388 $sortKey = $listName . '_sort';
389 $orderKey = $listName . '_sort_order';
390 setting()->putUser($user, $sortKey, $sort);
391 setting()->putUser($user, $orderKey, $order);
393 return redirect()->back(302, [], "/settings/users/$userId");