3 namespace BookStack\Users\Controllers;
5 use BookStack\Http\Controller;
6 use BookStack\Permissions\PermissionApplicator;
7 use BookStack\Settings\UserNotificationPreferences;
8 use BookStack\Settings\UserShortcutMap;
9 use BookStack\Users\UserRepo;
10 use Illuminate\Http\Request;
12 class UserPreferencesController extends Controller
14 public function __construct(
15 protected UserRepo $userRepo
20 * Show the overview for user preferences.
22 public function index()
24 return view('users.preferences.index');
28 * Show the user-specific interface shortcuts.
30 public function showShortcuts()
32 $shortcuts = UserShortcutMap::fromUserPreferences();
33 $enabled = setting()->getForCurrentUser('ui-shortcuts-enabled', false);
35 $this->setPageTitle(trans('preferences.shortcuts_interface'));
37 return view('users.preferences.shortcuts', [
38 'shortcuts' => $shortcuts,
39 'enabled' => $enabled,
44 * Update the user-specific interface shortcuts.
46 public function updateShortcuts(Request $request)
48 $enabled = $request->get('enabled') === 'true';
49 $providedShortcuts = $request->get('shortcut', []);
50 $shortcuts = new UserShortcutMap($providedShortcuts);
52 setting()->putForCurrentUser('ui-shortcuts', $shortcuts->toJson());
53 setting()->putForCurrentUser('ui-shortcuts-enabled', $enabled);
55 $this->showSuccessNotification(trans('preferences.shortcuts_update_success'));
57 return redirect('/preferences/shortcuts');
61 * Show the notification preferences for the current user.
63 public function showNotifications(PermissionApplicator $permissions)
65 $this->checkPermission('receive-notifications');
66 $this->preventGuestAccess();
68 $preferences = (new UserNotificationPreferences(user()));
70 $query = user()->watches()->getQuery();
71 $query = $permissions->restrictEntityRelationQuery($query, 'watches', 'watchable_id', 'watchable_type');
72 $query = $permissions->filterDeletedFromEntityRelationQuery($query, 'watches', 'watchable_id', 'watchable_type');
73 $watches = $query->with('watchable')->paginate(20);
75 $this->setPageTitle(trans('preferences.notifications'));
76 return view('users.preferences.notifications', [
77 'preferences' => $preferences,
78 'watches' => $watches,
83 * Update the notification preferences for the current user.
85 public function updateNotifications(Request $request)
87 $this->checkPermission('receive-notifications');
88 $this->preventGuestAccess();
89 $data = $this->validate($request, [
90 'preferences' => ['required', 'array'],
91 'preferences.*' => ['required', 'string'],
94 $preferences = (new UserNotificationPreferences(user()));
95 $preferences->updateFromSettingsArray($data['preferences']);
96 $this->showSuccessNotification(trans('preferences.notifications_update_success'));
98 return redirect('/preferences/notifications');
102 * Update the preferred view format for a list view of the given type.
104 public function changeView(Request $request, string $type)
106 $valueViewTypes = ['books', 'bookshelves', 'bookshelf'];
107 if (!in_array($type, $valueViewTypes)) {
108 return redirect()->back(500);
111 $view = $request->get('view');
112 if (!in_array($view, ['grid', 'list'])) {
116 $key = $type . '_view_type';
117 setting()->putForCurrentUser($key, $view);
119 return redirect()->back(302, [], "/");
123 * Change the stored sort type for a particular view.
125 public function changeSort(Request $request, string $type)
127 $validSortTypes = ['books', 'bookshelves', 'shelf_books', 'users', 'roles', 'webhooks', 'tags', 'page_revisions'];
128 if (!in_array($type, $validSortTypes)) {
129 return redirect()->back(500);
132 $sort = substr($request->get('sort') ?: 'name', 0, 50);
133 $order = $request->get('order') === 'desc' ? 'desc' : 'asc';
135 $sortKey = $type . '_sort';
136 $orderKey = $type . '_sort_order';
137 setting()->putForCurrentUser($sortKey, $sort);
138 setting()->putForCurrentUser($orderKey, $order);
140 return redirect()->back(302, [], "/");
144 * Toggle dark mode for the current user.
146 public function toggleDarkMode()
148 $enabled = setting()->getForCurrentUser('dark-mode-enabled');
149 setting()->putForCurrentUser('dark-mode-enabled', $enabled ? 'false' : 'true');
151 return redirect()->back();
155 * Update the stored section expansion preference for the given user.
157 public function changeExpansion(Request $request, string $type)
159 $typeWhitelist = ['home-details'];
160 if (!in_array($type, $typeWhitelist)) {
161 return response('Invalid key', 500);
164 $newState = $request->get('expand', 'false');
165 setting()->putForCurrentUser('section_expansion#' . $type, $newState);
167 return response('', 204);
171 * Update the favorite status for a code language.
173 public function updateCodeLanguageFavourite(Request $request)
175 $validated = $this->validate($request, [
176 'language' => ['required', 'string', 'max:20'],
177 'active' => ['required', 'bool'],
180 $currentFavoritesStr = setting()->getForCurrentUser('code-language-favourites', '');
181 $currentFavorites = array_filter(explode(',', $currentFavoritesStr));
183 $isFav = in_array($validated['language'], $currentFavorites);
184 if (!$isFav && $validated['active']) {
185 $currentFavorites[] = $validated['language'];
186 } elseif ($isFav && !$validated['active']) {
187 $index = array_search($validated['language'], $currentFavorites);
188 array_splice($currentFavorites, $index, 1);
191 setting()->putForCurrentUser('code-language-favourites', implode(',', $currentFavorites));
192 return response('', 204);