3 namespace BookStack\Http\Controllers;
5 use BookStack\Auth\UserRepo;
6 use BookStack\Settings\UserShortcutMap;
7 use Illuminate\Http\Request;
9 class UserPreferencesController extends Controller
11 protected UserRepo $userRepo;
13 public function __construct(UserRepo $userRepo)
15 $this->userRepo = $userRepo;
19 * Show the user-specific interface shortcuts.
21 public function showShortcuts()
23 $shortcuts = UserShortcutMap::fromUserPreferences();
24 $enabled = setting()->getForCurrentUser('ui-shortcuts-enabled', false);
26 return view('users.preferences.shortcuts', [
27 'shortcuts' => $shortcuts,
28 'enabled' => $enabled,
33 * Update the user-specific interface shortcuts.
35 public function updateShortcuts(Request $request)
37 $enabled = $request->get('enabled') === 'true';
38 $providedShortcuts = $request->get('shortcuts', []);
39 $shortcuts = new UserShortcutMap($providedShortcuts);
41 setting()->putUser(user(), 'ui-shortcuts', $shortcuts->toJson());
42 setting()->putUser(user(), 'ui-shortcuts-enabled', $enabled);
44 $this->showSuccessNotification('Shortcuts preferences have been updated!');
46 return redirect('/preferences/shortcuts');
50 * Update the user's preferred book-list display setting.
52 public function switchBooksView(Request $request, int $id)
54 return $this->switchViewType($id, $request, 'books');
58 * Update the user's preferred shelf-list display setting.
60 public function switchShelvesView(Request $request, int $id)
62 return $this->switchViewType($id, $request, 'bookshelves');
66 * Update the user's preferred shelf-view book list display setting.
68 public function switchShelfView(Request $request, int $id)
70 return $this->switchViewType($id, $request, 'bookshelf');
74 * For a type of list, switch with stored view type for a user.
76 protected function switchViewType(int $userId, Request $request, string $listName)
78 $this->checkPermissionOrCurrentUser('users-manage', $userId);
80 $viewType = $request->get('view_type');
81 if (!in_array($viewType, ['grid', 'list'])) {
85 $user = $this->userRepo->getById($userId);
86 $key = $listName . '_view_type';
87 setting()->putUser($user, $key, $viewType);
89 return redirect()->back(302, [], "/settings/users/$userId");
93 * Change the stored sort type for a particular view.
95 public function changeSort(Request $request, string $id, string $type)
97 $validSortTypes = ['books', 'bookshelves', 'shelf_books', 'users', 'roles', 'webhooks', 'tags', 'page_revisions'];
98 if (!in_array($type, $validSortTypes)) {
99 return redirect()->back(500);
102 $this->checkPermissionOrCurrentUser('users-manage', $id);
104 $sort = substr($request->get('sort') ?: 'name', 0, 50);
105 $order = $request->get('order') === 'desc' ? 'desc' : 'asc';
107 $user = $this->userRepo->getById($id);
108 $sortKey = $type . '_sort';
109 $orderKey = $type . '_sort_order';
110 setting()->putUser($user, $sortKey, $sort);
111 setting()->putUser($user, $orderKey, $order);
113 return redirect()->back(302, [], "/settings/users/{$id}");
117 * Toggle dark mode for the current user.
119 public function toggleDarkMode()
121 $enabled = setting()->getForCurrentUser('dark-mode-enabled', false);
122 setting()->putUser(user(), 'dark-mode-enabled', $enabled ? 'false' : 'true');
124 return redirect()->back();
128 * Update the stored section expansion preference for the given user.
130 public function updateExpansionPreference(Request $request, string $id, string $key)
132 $this->checkPermissionOrCurrentUser('users-manage', $id);
133 $keyWhitelist = ['home-details'];
134 if (!in_array($key, $keyWhitelist)) {
135 return response('Invalid key', 500);
138 $newState = $request->get('expand', 'false');
140 $user = $this->userRepo->getById($id);
141 setting()->putUser($user, 'section_expansion#' . $key, $newState);
143 return response('', 204);
146 public function updateCodeLanguageFavourite(Request $request)
148 $validated = $this->validate($request, [
149 'language' => ['required', 'string', 'max:20'],
150 'active' => ['required', 'bool'],
153 $currentFavoritesStr = setting()->getForCurrentUser('code-language-favourites', '');
154 $currentFavorites = array_filter(explode(',', $currentFavoritesStr));
156 $isFav = in_array($validated['language'], $currentFavorites);
157 if (!$isFav && $validated['active']) {
158 $currentFavorites[] = $validated['language'];
159 } elseif ($isFav && !$validated['active']) {
160 $index = array_search($validated['language'], $currentFavorites);
161 array_splice($currentFavorites, $index, 1);
164 setting()->putUser(user(), 'code-language-favourites', implode(',', $currentFavorites));