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\Str;
16 use Illuminate\Validation\ValidationException;
18 class UserController extends Controller
22 protected $inviteService;
26 * UserController constructor.
28 public function __construct(User $user, UserRepo $userRepo, UserInviteService $inviteService, ImageRepo $imageRepo)
31 $this->userRepo = $userRepo;
32 $this->inviteService = $inviteService;
33 $this->imageRepo = $imageRepo;
37 * Display a listing of the users.
39 public function index(Request $request)
41 $this->checkPermission('users-manage');
43 'order' => $request->get('order', 'asc'),
44 'search' => $request->get('search', ''),
45 'sort' => $request->get('sort', 'name'),
47 $users = $this->userRepo->getAllUsersPaginatedAndSorted(20, $listDetails);
49 $this->setPageTitle(trans('settings.users'));
50 $users->appends($listDetails);
52 return view('users.index', ['users' => $users, 'listDetails' => $listDetails]);
56 * Show the form for creating a new user.
58 public function create()
60 $this->checkPermission('users-manage');
61 $authMethod = config('auth.method');
62 $roles = $this->userRepo->getAllRoles();
64 return view('users.create', ['authMethod' => $authMethod, 'roles' => $roles]);
68 * Store a newly created user in storage.
70 * @throws UserUpdateException
71 * @throws ValidationException
73 public function store(Request $request)
75 $this->checkPermission('users-manage');
78 'email' => 'required|email|unique:users,email',
81 $authMethod = config('auth.method');
82 $sendInvite = ($request->get('send_invite', 'false') === 'true');
84 if ($authMethod === 'standard' && !$sendInvite) {
85 $validationRules['password'] = 'required|min:6';
86 $validationRules['password-confirm'] = 'required|same:password';
87 } elseif ($authMethod === 'ldap' || $authMethod === 'saml2') {
88 $validationRules['external_auth_id'] = 'required';
90 $this->validate($request, $validationRules);
92 $user = $this->user->fill($request->all());
94 if ($authMethod === 'standard') {
95 $user->password = bcrypt($request->get('password', Str::random(32)));
96 } elseif ($authMethod === 'ldap' || $authMethod === 'saml2') {
97 $user->external_auth_id = $request->get('external_auth_id');
100 $user->refreshSlug();
104 $this->inviteService->sendInvitation($user);
107 if ($request->filled('roles')) {
108 $roles = $request->get('roles');
109 $this->userRepo->setUserRoles($user, $roles);
112 $this->userRepo->downloadAndAssignUserAvatar($user);
114 $this->logActivity(ActivityType::USER_CREATE, $user);
116 return redirect('/settings/users');
120 * Show the form for editing the specified user.
122 public function edit(int $id, SocialAuthService $socialAuthService)
124 $this->checkPermissionOrCurrentUser('users-manage', $id);
126 /** @var User $user */
127 $user = $this->user->newQuery()->with(['apiTokens', 'mfaValues'])->findOrFail($id);
129 $authMethod = ($user->system_name) ? 'system' : config('auth.method');
131 $activeSocialDrivers = $socialAuthService->getActiveDrivers();
132 $mfaMethods = $user->mfaValues->groupBy('method');
133 $this->setPageTitle(trans('settings.user_profile'));
134 $roles = $this->userRepo->getAllRoles();
136 return view('users.edit', [
138 'activeSocialDrivers' => $activeSocialDrivers,
139 'mfaMethods' => $mfaMethods,
140 'authMethod' => $authMethod,
146 * Update the specified user in storage.
148 * @throws UserUpdateException
149 * @throws ImageUploadException
150 * @throws ValidationException
152 public function update(Request $request, int $id)
154 $this->preventAccessInDemoMode();
155 $this->checkPermissionOrCurrentUser('users-manage', $id);
157 $this->validate($request, [
159 'email' => 'min:2|email|unique:users,email,' . $id,
160 'password' => 'min:6|required_with:password_confirm',
161 'password-confirm' => 'same:password|required_with:password',
162 'setting' => 'array',
163 'profile_image' => 'nullable|' . $this->getImageValidationRules(),
166 $user = $this->userRepo->getById($id);
167 $user->fill($request->except(['email']));
170 if (userCan('users-manage') && $request->filled('email')) {
171 $user->email = $request->get('email');
174 // Refresh the slug if the user's name has changed
175 if ($user->isDirty('name')) {
176 $user->refreshSlug();
180 if (userCan('users-manage') && $request->filled('roles')) {
181 $roles = $request->get('roles');
182 $this->userRepo->setUserRoles($user, $roles);
186 if ($request->filled('password')) {
187 $password = $request->get('password');
188 $user->password = bcrypt($password);
191 // External auth id updates
192 if (user()->can('users-manage') && $request->filled('external_auth_id')) {
193 $user->external_auth_id = $request->get('external_auth_id');
196 // Save an user-specific settings
197 if ($request->filled('setting')) {
198 foreach ($request->get('setting') as $key => $value) {
199 setting()->putUser($user, $key, $value);
203 // Save profile image if in request
204 if ($request->hasFile('profile_image')) {
205 $imageUpload = $request->file('profile_image');
206 $this->imageRepo->destroyImage($user->avatar);
207 $image = $this->imageRepo->saveNew($imageUpload, 'user', $user->id);
208 $user->image_id = $image->id;
211 // Delete the profile image if reset option is in request
212 if ($request->has('profile_image_reset')) {
213 $this->imageRepo->destroyImage($user->avatar);
217 $this->showSuccessNotification(trans('settings.users_edit_success'));
218 $this->logActivity(ActivityType::USER_UPDATE, $user);
220 $redirectUrl = userCan('users-manage') ? '/settings/users' : ('/settings/users/' . $user->id);
222 return redirect($redirectUrl);
226 * Show the user delete page.
228 public function delete(int $id)
230 $this->checkPermissionOrCurrentUser('users-manage', $id);
232 $user = $this->userRepo->getById($id);
233 $this->setPageTitle(trans('settings.users_delete_named', ['userName' => $user->name]));
235 return view('users.delete', ['user' => $user]);
239 * Remove the specified user from storage.
243 public function destroy(Request $request, int $id)
245 $this->preventAccessInDemoMode();
246 $this->checkPermissionOrCurrentUser('users-manage', $id);
248 $user = $this->userRepo->getById($id);
249 $newOwnerId = $request->get('new_owner_id', null);
251 if ($this->userRepo->isOnlyAdmin($user)) {
252 $this->showErrorNotification(trans('errors.users_cannot_delete_only_admin'));
254 return redirect($user->getEditUrl());
257 if ($user->system_name === 'public') {
258 $this->showErrorNotification(trans('errors.users_cannot_delete_guest'));
260 return redirect($user->getEditUrl());
263 $this->userRepo->destroy($user, $newOwnerId);
264 $this->showSuccessNotification(trans('settings.users_delete_success'));
265 $this->logActivity(ActivityType::USER_DELETE, $user);
267 return redirect('/settings/users');
271 * Update the user's preferred book-list display setting.
273 public function switchBooksView(Request $request, int $id)
275 return $this->switchViewType($id, $request, 'books');
279 * Update the user's preferred shelf-list display setting.
281 public function switchShelvesView(Request $request, int $id)
283 return $this->switchViewType($id, $request, 'bookshelves');
287 * Update the user's preferred shelf-view book list display setting.
289 public function switchShelfView(Request $request, int $id)
291 return $this->switchViewType($id, $request, 'bookshelf');
295 * For a type of list, switch with stored view type for a user.
297 protected function switchViewType(int $userId, Request $request, string $listName)
299 $this->checkPermissionOrCurrentUser('users-manage', $userId);
301 $viewType = $request->get('view_type');
302 if (!in_array($viewType, ['grid', 'list'])) {
306 $user = $this->userRepo->getById($userId);
307 $key = $listName . '_view_type';
308 setting()->putUser($user, $key, $viewType);
310 return redirect()->back(302, [], "/settings/users/$userId");
314 * Change the stored sort type for a particular view.
316 public function changeSort(Request $request, string $id, string $type)
318 $validSortTypes = ['books', 'bookshelves', 'shelf_books'];
319 if (!in_array($type, $validSortTypes)) {
320 return redirect()->back(500);
323 return $this->changeListSort($id, $request, $type);
327 * Toggle dark mode for the current user.
329 public function toggleDarkMode()
331 $enabled = setting()->getForCurrentUser('dark-mode-enabled', false);
332 setting()->putUser(user(), 'dark-mode-enabled', $enabled ? 'false' : 'true');
334 return redirect()->back();
338 * Update the stored section expansion preference for the given user.
340 public function updateExpansionPreference(Request $request, string $id, string $key)
342 $this->checkPermissionOrCurrentUser('users-manage', $id);
343 $keyWhitelist = ['home-details'];
344 if (!in_array($key, $keyWhitelist)) {
345 return response('Invalid key', 500);
348 $newState = $request->get('expand', 'false');
350 $user = $this->user->findOrFail($id);
351 setting()->putUser($user, 'section_expansion#' . $key, $newState);
353 return response('', 204);
357 * Changed the stored preference for a list sort order.
359 protected function changeListSort(int $userId, Request $request, string $listName)
361 $this->checkPermissionOrCurrentUser('users-manage', $userId);
363 $sort = $request->get('sort');
364 if (!in_array($sort, ['name', 'created_at', 'updated_at', 'default'])) {
368 $order = $request->get('order');
369 if (!in_array($order, ['asc', 'desc'])) {
373 $user = $this->user->findOrFail($userId);
374 $sortKey = $listName . '_sort';
375 $orderKey = $listName . '_sort_order';
376 setting()->putUser($user, $sortKey, $sort);
377 setting()->putUser($user, $orderKey, $order);
379 return redirect()->back(302, [], "/settings/users/$userId");