1 <?php namespace BookStack\Http\Controllers;
4 use BookStack\Entities\Models\Book;
5 use BookStack\Entities\Tools\PermissionsUpdater;
6 use BookStack\Entities\Tools\ShelfContext;
7 use BookStack\Entities\Repos\BookshelfRepo;
8 use BookStack\Exceptions\ImageUploadException;
9 use BookStack\Exceptions\NotFoundException;
10 use BookStack\Uploads\ImageRepo;
12 use Illuminate\Http\Request;
13 use Illuminate\Validation\ValidationException;
16 class BookshelfController extends Controller
19 protected $bookshelfRepo;
20 protected $entityContextManager;
23 public function __construct(BookshelfRepo $bookshelfRepo, ShelfContext $entityContextManager, ImageRepo $imageRepo)
25 $this->bookshelfRepo = $bookshelfRepo;
26 $this->entityContextManager = $entityContextManager;
27 $this->imageRepo = $imageRepo;
31 * Display a listing of the book.
33 public function index()
35 $view = setting()->getForCurrentUser('bookshelves_view_type');
36 $sort = setting()->getForCurrentUser('bookshelves_sort', 'name');
37 $order = setting()->getForCurrentUser('bookshelves_sort_order', 'asc');
39 'name' => trans('common.sort_name'),
40 'created_at' => trans('common.sort_created_at'),
41 'updated_at' => trans('common.sort_updated_at'),
44 $shelves = $this->bookshelfRepo->getAllPaginated(18, $sort, $order);
45 $recents = $this->isSignedIn() ? $this->bookshelfRepo->getRecentlyViewed(4) : false;
46 $popular = $this->bookshelfRepo->getPopular(4);
47 $new = $this->bookshelfRepo->getRecentlyCreated(4);
49 $this->entityContextManager->clearShelfContext();
50 $this->setPageTitle(trans('entities.shelves'));
51 return view('shelves.index', [
52 'shelves' => $shelves,
53 'recents' => $recents,
54 'popular' => $popular,
59 'sortOptions' => $sortOptions,
64 * Show the form for creating a new bookshelf.
66 public function create()
68 $this->checkPermission('bookshelf-create-all');
69 $books = Book::hasPermission('update')->get();
70 $this->setPageTitle(trans('entities.shelves_create'));
71 return view('shelves.create', ['books' => $books]);
75 * Store a newly created bookshelf in storage.
76 * @throws ValidationException
77 * @throws ImageUploadException
79 public function store(Request $request)
81 $this->checkPermission('bookshelf-create-all');
82 $this->validate($request, [
83 'name' => 'required|string|max:255',
84 'description' => 'string|max:1000',
85 'image' => 'nullable|' . $this->getImageValidationRules(),
88 $bookIds = explode(',', $request->get('books', ''));
89 $shelf = $this->bookshelfRepo->create($request->all(), $bookIds);
90 $this->bookshelfRepo->updateCoverImage($shelf, $request->file('image', null));
92 return redirect($shelf->getUrl());
96 * Display the bookshelf of the given slug.
97 * @throws NotFoundException
99 public function show(string $slug)
101 $shelf = $this->bookshelfRepo->getBySlug($slug);
102 $this->checkOwnablePermission('book-view', $shelf);
104 $sort = setting()->getForCurrentUser('shelf_books_sort', 'default');
105 $order = setting()->getForCurrentUser('shelf_books_sort_order', 'asc');
107 $sortedVisibleShelfBooks = $shelf->visibleBooks()->get()
108 ->sortBy($sort === 'default' ? 'pivot.order' : $sort, SORT_REGULAR, $order === 'desc')
113 $this->entityContextManager->setShelfContext($shelf->id);
114 $view = setting()->getForCurrentUser('bookshelf_view_type');
116 $this->setPageTitle($shelf->getShortName());
117 return view('shelves.show', [
119 'sortedVisibleShelfBooks' => $sortedVisibleShelfBooks,
121 'activity' => Activity::entityActivity($shelf, 20, 1),
128 * Show the form for editing the specified bookshelf.
130 public function edit(string $slug)
132 $shelf = $this->bookshelfRepo->getBySlug($slug);
133 $this->checkOwnablePermission('bookshelf-update', $shelf);
135 $shelfBookIds = $shelf->books()->get(['id'])->pluck('id');
136 $books = Book::hasPermission('update')->whereNotIn('id', $shelfBookIds)->get();
138 $this->setPageTitle(trans('entities.shelves_edit_named', ['name' => $shelf->getShortName()]));
139 return view('shelves.edit', [
146 * Update the specified bookshelf in storage.
147 * @throws ValidationException
148 * @throws ImageUploadException
149 * @throws NotFoundException
151 public function update(Request $request, string $slug)
153 $shelf = $this->bookshelfRepo->getBySlug($slug);
154 $this->checkOwnablePermission('bookshelf-update', $shelf);
155 $this->validate($request, [
156 'name' => 'required|string|max:255',
157 'description' => 'string|max:1000',
158 'image' => 'nullable|' . $this->getImageValidationRules(),
162 $bookIds = explode(',', $request->get('books', ''));
163 $shelf = $this->bookshelfRepo->update($shelf, $request->all(), $bookIds);
164 $resetCover = $request->has('image_reset');
165 $this->bookshelfRepo->updateCoverImage($shelf, $request->file('image', null), $resetCover);
167 return redirect($shelf->getUrl());
171 * Shows the page to confirm deletion
173 public function showDelete(string $slug)
175 $shelf = $this->bookshelfRepo->getBySlug($slug);
176 $this->checkOwnablePermission('bookshelf-delete', $shelf);
178 $this->setPageTitle(trans('entities.shelves_delete_named', ['name' => $shelf->getShortName()]));
179 return view('shelves.delete', ['shelf' => $shelf]);
183 * Remove the specified bookshelf from storage.
186 public function destroy(string $slug)
188 $shelf = $this->bookshelfRepo->getBySlug($slug);
189 $this->checkOwnablePermission('bookshelf-delete', $shelf);
191 $this->bookshelfRepo->destroy($shelf);
193 return redirect('/shelves');
197 * Show the permissions view.
199 public function showPermissions(string $slug)
201 $shelf = $this->bookshelfRepo->getBySlug($slug);
202 $this->checkOwnablePermission('restrictions-manage', $shelf);
204 return view('shelves.permissions', [
210 * Set the permissions for this bookshelf.
212 public function permissions(Request $request, PermissionsUpdater $permissionsUpdater, string $slug)
214 $shelf = $this->bookshelfRepo->getBySlug($slug);
215 $this->checkOwnablePermission('restrictions-manage', $shelf);
217 $permissionsUpdater->updateFromPermissionsForm($shelf, $request);
219 $this->showSuccessNotification(trans('entities.shelves_permissions_updated'));
220 return redirect($shelf->getUrl());
224 * Copy the permissions of a bookshelf to the child books.
226 public function copyPermissions(string $slug)
228 $shelf = $this->bookshelfRepo->getBySlug($slug);
229 $this->checkOwnablePermission('restrictions-manage', $shelf);
231 $updateCount = $this->bookshelfRepo->copyDownPermissions($shelf);
232 $this->showSuccessNotification(trans('entities.shelves_copy_permission_success', ['count' => $updateCount]));
233 return redirect($shelf->getUrl());