3 namespace BookStack\Users\Controllers;
5 use BookStack\Access\SocialDriverManager;
6 use BookStack\Access\UserInviteException;
7 use BookStack\Exceptions\ImageUploadException;
8 use BookStack\Exceptions\UserUpdateException;
9 use BookStack\Http\Controller;
10 use BookStack\Permissions\Permission;
11 use BookStack\Uploads\ImageRepo;
12 use BookStack\Users\Models\Role;
13 use BookStack\Users\Queries\UsersAllPaginatedAndSorted;
14 use BookStack\Users\UserRepo;
15 use BookStack\Util\SimpleListOptions;
17 use Illuminate\Http\Request;
18 use Illuminate\Support\Facades\DB;
19 use Illuminate\Support\Facades\Log;
20 use Illuminate\Validation\Rules\Password;
21 use Illuminate\Validation\ValidationException;
23 class UserController extends Controller
25 public function __construct(
26 protected UserRepo $userRepo,
27 protected ImageRepo $imageRepo
32 * Display a listing of the users.
34 public function index(Request $request)
36 $this->checkPermission(Permission::UsersManage);
38 $listOptions = SimpleListOptions::fromRequest($request, 'users')->withSortOptions([
39 'name' => trans('common.sort_name'),
40 'email' => trans('auth.email'),
41 'created_at' => trans('common.sort_created_at'),
42 'updated_at' => trans('common.sort_updated_at'),
43 'last_activity_at' => trans('settings.users_latest_activity'),
46 $users = (new UsersAllPaginatedAndSorted())->run(20, $listOptions);
48 $this->setPageTitle(trans('settings.users'));
49 $users->appends($listOptions->getPaginationAppends());
51 return view('users.index', [
53 'listOptions' => $listOptions,
58 * Show the form for creating a new user.
60 public function create()
62 $this->checkPermission(Permission::UsersManage);
63 $authMethod = config('auth.method');
64 $roles = Role::query()->orderBy('display_name', 'asc')->get();
65 $this->setPageTitle(trans('settings.users_add_new'));
67 return view('users.create', ['authMethod' => $authMethod, 'roles' => $roles]);
71 * Store a new user in storage.
73 * @throws ValidationException
75 public function store(Request $request)
77 $this->checkPermission(Permission::UsersManage);
79 $authMethod = config('auth.method');
80 $sendInvite = ($request->get('send_invite', 'false') === 'true');
81 $externalAuth = $authMethod === 'ldap' || $authMethod === 'saml2' || $authMethod === 'oidc';
82 $passwordRequired = ($authMethod === 'standard' && !$sendInvite);
85 'name' => ['required', 'max:100'],
86 'email' => ['required', 'email', 'unique:users,email'],
87 'language' => ['string', 'max:15', 'alpha_dash'],
89 'roles.*' => ['integer'],
90 'password' => $passwordRequired ? ['required', Password::default()] : null,
91 'password-confirm' => $passwordRequired ? ['required', 'same:password'] : null,
92 'external_auth_id' => $externalAuth ? ['required'] : null,
95 $validated = $this->validate($request, array_filter($validationRules));
98 DB::transaction(function () use ($validated, $sendInvite) {
99 $this->userRepo->create($validated, $sendInvite);
101 } catch (UserInviteException $e) {
102 Log::error("Failed to send user invite with error: {$e->getMessage()}");
103 $this->showErrorNotification(trans('errors.users_could_not_send_invite'));
104 return redirect('/settings/users/create')->withInput();
107 return redirect('/settings/users');
111 * Show the form for editing the specified user.
113 public function edit(int $id, SocialDriverManager $socialDriverManager)
115 $this->checkPermission(Permission::UsersManage);
117 $user = $this->userRepo->getById($id);
118 $user->load(['apiTokens', 'mfaValues']);
119 $authMethod = ($user->system_name) ? 'system' : config('auth.method');
121 $activeSocialDrivers = $socialDriverManager->getActive();
122 $mfaMethods = $user->mfaValues->groupBy('method');
123 $this->setPageTitle(trans('settings.user_profile'));
124 $roles = Role::query()->orderBy('display_name', 'asc')->get();
126 return view('users.edit', [
128 'activeSocialDrivers' => $activeSocialDrivers,
129 'mfaMethods' => $mfaMethods,
130 'authMethod' => $authMethod,
136 * Update the specified user in storage.
138 * @throws UserUpdateException
139 * @throws ImageUploadException
140 * @throws ValidationException
142 public function update(Request $request, int $id)
144 $this->preventAccessInDemoMode();
145 $this->checkPermission(Permission::UsersManage);
147 $validated = $this->validate($request, [
148 'name' => ['min:1', 'max:100'],
149 'email' => ['min:2', 'email', 'unique:users,email,' . $id],
150 'password' => ['required_with:password_confirm', Password::default()],
151 'password-confirm' => ['same:password', 'required_with:password'],
152 'language' => ['string', 'max:15', 'alpha_dash'],
153 'roles' => ['array'],
154 'roles.*' => ['integer'],
155 'external_auth_id' => ['string'],
156 'profile_image' => array_merge(['nullable'], $this->getImageValidationRules()),
159 $user = $this->userRepo->getById($id);
160 $this->userRepo->update($user, $validated, true);
162 // Save profile image if in request
163 if ($request->hasFile('profile_image')) {
164 $imageUpload = $request->file('profile_image');
165 $this->imageRepo->destroyImage($user->avatar);
166 $image = $this->imageRepo->saveNew($imageUpload, 'user', $user->id);
167 $user->image_id = $image->id;
171 // Delete the profile image if reset option is in request
172 if ($request->has('profile_image_reset')) {
173 $this->imageRepo->destroyImage($user->avatar);
178 return redirect('/settings/users');
182 * Show the user delete page.
184 public function delete(int $id)
186 $this->checkPermission(Permission::UsersManage);
188 $user = $this->userRepo->getById($id);
189 $this->setPageTitle(trans('settings.users_delete_named', ['userName' => $user->name]));
191 return view('users.delete', ['user' => $user]);
195 * Remove the specified user from storage.
199 public function destroy(Request $request, int $id)
201 $this->preventAccessInDemoMode();
202 $this->checkPermission(Permission::UsersManage);
204 $user = $this->userRepo->getById($id);
205 $newOwnerId = intval($request->get('new_owner_id')) ?: null;
207 $this->userRepo->destroy($user, $newOwnerId);
209 return redirect('/settings/users');