3 namespace BookStack\Http\Controllers;
5 use BookStack\Entities\Models\Entity;
6 use BookStack\Entities\Queries\TopFavourites;
7 use BookStack\Interfaces\Favouritable;
9 use Illuminate\Http\Request;
11 class FavouriteController extends Controller
14 * Show a listing of all favourite items for the current user.
16 public function index(Request $request)
19 $page = intval($request->get('page', 1));
20 $favourites = (new TopFavourites())->run($viewCount + 1, (($page - 1) * $viewCount));
22 $hasMoreLink = ($favourites->count() > $viewCount) ? url('/favourites?page=' . ($page + 1)) : null;
24 $this->setPageTitle(trans('entities.my_favourites'));
26 return view('common.detailed-listing-with-more', [
27 'title' => trans('entities.my_favourites'),
28 'entities' => $favourites->slice(0, $viewCount),
29 'hasMoreLink' => $hasMoreLink,
34 * Add a new item as a favourite.
36 public function add(Request $request)
38 $favouritable = $this->getValidatedModelFromRequest($request);
39 $favouritable->favourites()->firstOrCreate([
40 'user_id' => user()->id,
43 $this->showSuccessNotification(trans('activities.favourite_add_notification', [
44 'name' => $favouritable->name,
47 return redirect()->back();
51 * Remove an item as a favourite.
53 public function remove(Request $request)
55 $favouritable = $this->getValidatedModelFromRequest($request);
56 $favouritable->favourites()->where([
57 'user_id' => user()->id,
60 $this->showSuccessNotification(trans('activities.favourite_remove_notification', [
61 'name' => $favouritable->name,
64 return redirect()->back();
68 * @throws \Illuminate\Validation\ValidationException
71 protected function getValidatedModelFromRequest(Request $request): Entity
73 $modelInfo = $this->validate($request, [
74 'type' => ['required', 'string'],
75 'id' => ['required', 'integer'],
78 if (!class_exists($modelInfo['type'])) {
79 throw new \Exception('Model not found');
82 /** @var Model $model */
83 $model = new $modelInfo['type']();
84 if (!$model instanceof Favouritable) {
85 throw new \Exception('Model not favouritable');
88 $modelInstance = $model->newQuery()
89 ->where('id', '=', $modelInfo['id'])
90 ->first(['id', 'name', 'owned_by']);
92 $inaccessibleEntity = ($modelInstance instanceof Entity && !userCan('view', $modelInstance));
93 if (is_null($modelInstance) || $inaccessibleEntity) {
94 throw new \Exception('Model instance not found');
97 return $modelInstance;