3 namespace BookStack\Sorting;
5 use BookStack\Activity\ActivityType;
6 use BookStack\Entities\Queries\BookQueries;
7 use BookStack\Entities\Tools\BookContents;
8 use BookStack\Facades\Activity;
9 use BookStack\Http\Controller;
10 use BookStack\Util\DatabaseTransaction;
11 use Illuminate\Http\Request;
13 class BookSortController extends Controller
15 public function __construct(
16 protected BookQueries $queries,
21 * Shows the view which allows pages to be re-ordered and sorted.
23 public function show(string $bookSlug)
25 $book = $this->queries->findVisibleBySlugOrFail($bookSlug);
26 $this->checkOwnablePermission('book-update', $book);
28 $bookChildren = (new BookContents($book))->getTree(false);
30 $this->setPageTitle(trans('entities.books_sort_named', ['bookName' => $book->getShortName()]));
32 return view('books.sort', ['book' => $book, 'current' => $book, 'bookChildren' => $bookChildren]);
36 * Shows the sort box for a single book.
37 * Used via AJAX when loading in extra books to a sort.
39 public function showItem(string $bookSlug)
41 $book = $this->queries->findVisibleBySlugOrFail($bookSlug);
42 $bookChildren = (new BookContents($book))->getTree();
44 return view('books.parts.sort-box', ['book' => $book, 'bookChildren' => $bookChildren]);
48 * Update the sort options of a book, setting the auto-sort and/or updating
49 * child order via mapping.
51 public function update(Request $request, BookSorter $sorter, string $bookSlug)
53 $book = $this->queries->findVisibleBySlugOrFail($bookSlug);
54 $this->checkOwnablePermission('book-update', $book);
55 $loggedActivityForBook = false;
58 if ($request->filled('sort-tree')) {
59 (new DatabaseTransaction(function () use ($book, $request, $sorter, &$loggedActivityForBook) {
60 $sortMap = BookSortMap::fromJson($request->get('sort-tree'));
61 $booksInvolved = $sorter->sortUsingMap($sortMap);
63 // Add activity for involved books.
64 foreach ($booksInvolved as $bookInvolved) {
65 Activity::add(ActivityType::BOOK_SORT, $bookInvolved);
66 if ($bookInvolved->id === $book->id) {
67 $loggedActivityForBook = true;
73 if ($request->filled('auto-sort')) {
74 $sortSetId = intval($request->get('auto-sort')) ?: null;
75 if ($sortSetId && SortRule::query()->find($sortSetId) === null) {
78 $book->sort_rule_id = $sortSetId;
80 $sorter->runBookAutoSort($book);
81 if (!$loggedActivityForBook) {
82 Activity::add(ActivityType::BOOK_SORT, $book);
86 return redirect($book->getUrl());