1 <?php namespace BookStack\Http\Controllers;
4 use BookStack\Exceptions\NotFoundException;
5 use BookStack\Repos\UserRepo;
6 use BookStack\Services\ExportService;
8 use Illuminate\Http\Request;
9 use BookStack\Http\Requests;
10 use BookStack\Repos\BookRepo;
11 use BookStack\Repos\ChapterRepo;
12 use BookStack\Repos\PageRepo;
13 use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
16 class PageController extends Controller
21 protected $chapterRepo;
22 protected $exportService;
26 * PageController constructor.
27 * @param PageRepo $pageRepo
28 * @param BookRepo $bookRepo
29 * @param ChapterRepo $chapterRepo
30 * @param ExportService $exportService
31 * @param UserRepo $userRepo
33 public function __construct(PageRepo $pageRepo, BookRepo $bookRepo, ChapterRepo $chapterRepo, ExportService $exportService, UserRepo $userRepo)
35 $this->pageRepo = $pageRepo;
36 $this->bookRepo = $bookRepo;
37 $this->chapterRepo = $chapterRepo;
38 $this->exportService = $exportService;
39 $this->userRepo = $userRepo;
40 parent::__construct();
44 * Show the form for creating a new page.
46 * @param bool $chapterSlug
48 * @internal param bool $pageSlug
50 public function create($bookSlug, $chapterSlug = false)
52 $book = $this->bookRepo->getBySlug($bookSlug);
53 $chapter = $chapterSlug ? $this->chapterRepo->getBySlug($chapterSlug, $book->id) : null;
54 $parent = $chapter ? $chapter : $book;
55 $this->checkOwnablePermission('page-create', $parent);
56 $this->setPageTitle('Create New Page');
58 $draft = $this->pageRepo->getDraftPage($book, $chapter);
59 return redirect($draft->getUrl());
63 * Show form to continue editing a draft page.
66 * @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
68 public function editDraft($bookSlug, $pageId)
70 $book = $this->bookRepo->getBySlug($bookSlug);
71 $draft = $this->pageRepo->getById($pageId, true);
72 $this->checkOwnablePermission('page-create', $draft);
73 $this->setPageTitle('Edit Page Draft');
75 return view('pages/create', ['draft' => $draft, 'book' => $book]);
79 * Store a new page by changing a draft into a page.
80 * @param Request $request
81 * @param string $bookSlug
84 public function store(Request $request, $bookSlug, $pageId)
86 $this->validate($request, [
87 'name' => 'required|string|max:255'
90 $input = $request->all();
91 $book = $this->bookRepo->getBySlug($bookSlug);
93 $draftPage = $this->pageRepo->getById($pageId, true);
95 $chapterId = $draftPage->chapter_id;
96 $parent = $chapterId !== 0 ? $this->chapterRepo->getById($chapterId) : $book;
97 $this->checkOwnablePermission('page-create', $parent);
99 if ($parent->isA('chapter')) {
100 $input['priority'] = $this->chapterRepo->getNewPriority($parent);
102 $input['priority'] = $this->bookRepo->getNewPriority($parent);
105 $page = $this->pageRepo->publishDraft($draftPage, $input);
107 Activity::add($page, 'page_create', $book->id);
108 return redirect($page->getUrl());
112 * Display the specified page.
113 * If the page is not found via the slug the
114 * revisions are searched for a match.
119 public function show($bookSlug, $pageSlug)
121 $book = $this->bookRepo->getBySlug($bookSlug);
124 $page = $this->pageRepo->getBySlug($pageSlug, $book->id);
125 } catch (NotFoundException $e) {
126 $page = $this->pageRepo->findPageUsingOldSlug($pageSlug, $bookSlug);
127 if ($page === null) abort(404);
128 return redirect($page->getUrl());
131 $this->checkOwnablePermission('page-view', $page);
133 $sidebarTree = $this->bookRepo->getChildren($book);
135 $this->setPageTitle($page->getShortName());
136 return view('pages/show', ['page' => $page, 'book' => $book, 'current' => $page, 'sidebarTree' => $sidebarTree]);
140 * Get page from an ajax request.
142 * @return \Illuminate\Http\JsonResponse
144 public function getPageAjax($pageId)
146 $page = $this->pageRepo->getById($pageId);
147 return response()->json($page);
151 * Show the form for editing the specified page.
156 public function edit($bookSlug, $pageSlug)
158 $book = $this->bookRepo->getBySlug($bookSlug);
159 $page = $this->pageRepo->getBySlug($pageSlug, $book->id);
160 $this->checkOwnablePermission('page-update', $page);
161 $this->setPageTitle('Editing Page ' . $page->getShortName());
162 $page->isDraft = false;
164 // Check for active editing
166 if ($this->pageRepo->isPageEditingActive($page, 60)) {
167 $warnings[] = $this->pageRepo->getPageEditingActiveMessage($page, 60);
170 // Check for a current draft version for this user
171 if ($this->pageRepo->hasUserGotPageDraft($page, $this->currentUser->id)) {
172 $draft = $this->pageRepo->getUserPageDraft($page, $this->currentUser->id);
173 $page->name = $draft->name;
174 $page->html = $draft->html;
175 $page->markdown = $draft->markdown;
176 $page->isDraft = true;
177 $warnings [] = $this->pageRepo->getUserPageDraftMessage($draft);
180 if (count($warnings) > 0) session()->flash('warning', implode("\n", $warnings));
182 return view('pages/edit', ['page' => $page, 'book' => $book, 'current' => $page]);
186 * Update the specified page in storage.
187 * @param Request $request
192 public function update(Request $request, $bookSlug, $pageSlug)
194 $this->validate($request, [
195 'name' => 'required|string|max:255'
197 $book = $this->bookRepo->getBySlug($bookSlug);
198 $page = $this->pageRepo->getBySlug($pageSlug, $book->id);
199 $this->checkOwnablePermission('page-update', $page);
200 $this->pageRepo->updatePage($page, $book->id, $request->all());
201 Activity::add($page, 'page_update', $book->id);
202 return redirect($page->getUrl());
206 * Save a draft update as a revision.
207 * @param Request $request
209 * @return \Illuminate\Http\JsonResponse
211 public function saveDraft(Request $request, $pageId)
213 $page = $this->pageRepo->getById($pageId, true);
214 $this->checkOwnablePermission('page-update', $page);
216 $draft = $this->pageRepo->updateDraftPage($page, $request->only(['name', 'html', 'markdown']));
218 $draft = $this->pageRepo->saveUpdateDraft($page, $request->only(['name', 'html', 'markdown']));
221 $updateTime = $draft->updated_at->timestamp;
222 $utcUpdateTimestamp = $updateTime + Carbon::createFromTimestamp(0)->offset;
223 return response()->json([
224 'status' => 'success',
225 'message' => 'Draft saved at ',
226 'timestamp' => $utcUpdateTimestamp
231 * Redirect from a special link url which
232 * uses the page id rather than the name.
234 * @return \Illuminate\Http\RedirectResponse|\Illuminate\Routing\Redirector
236 public function redirectFromLink($pageId)
238 $page = $this->pageRepo->getById($pageId);
239 return redirect($page->getUrl());
243 * Show the deletion page for the specified page.
246 * @return \Illuminate\View\View
248 public function showDelete($bookSlug, $pageSlug)
250 $book = $this->bookRepo->getBySlug($bookSlug);
251 $page = $this->pageRepo->getBySlug($pageSlug, $book->id);
252 $this->checkOwnablePermission('page-delete', $page);
253 $this->setPageTitle('Delete Page ' . $page->getShortName());
254 return view('pages/delete', ['book' => $book, 'page' => $page, 'current' => $page]);
259 * Show the deletion page for the specified page.
262 * @return \Illuminate\View\View
263 * @throws NotFoundException
265 public function showDeleteDraft($bookSlug, $pageId)
267 $book = $this->bookRepo->getBySlug($bookSlug);
268 $page = $this->pageRepo->getById($pageId, true);
269 $this->checkOwnablePermission('page-update', $page);
270 $this->setPageTitle('Delete Draft Page ' . $page->getShortName());
271 return view('pages/delete', ['book' => $book, 'page' => $page, 'current' => $page]);
275 * Remove the specified page from storage.
279 * @internal param int $id
281 public function destroy($bookSlug, $pageSlug)
283 $book = $this->bookRepo->getBySlug($bookSlug);
284 $page = $this->pageRepo->getBySlug($pageSlug, $book->id);
285 $this->checkOwnablePermission('page-delete', $page);
286 Activity::addMessage('page_delete', $book->id, $page->name);
287 session()->flash('success', 'Page deleted');
288 $this->pageRepo->destroy($page);
289 return redirect($book->getUrl());
293 * Remove the specified draft page from storage.
297 * @throws NotFoundException
299 public function destroyDraft($bookSlug, $pageId)
301 $book = $this->bookRepo->getBySlug($bookSlug);
302 $page = $this->pageRepo->getById($pageId, true);
303 $this->checkOwnablePermission('page-update', $page);
304 session()->flash('success', 'Draft deleted');
305 $this->pageRepo->destroy($page);
306 return redirect($book->getUrl());
310 * Shows the last revisions for this page.
313 * @return \Illuminate\View\View
315 public function showRevisions($bookSlug, $pageSlug)
317 $book = $this->bookRepo->getBySlug($bookSlug);
318 $page = $this->pageRepo->getBySlug($pageSlug, $book->id);
319 $this->setPageTitle('Revisions For ' . $page->getShortName());
320 return view('pages/revisions', ['page' => $page, 'book' => $book, 'current' => $page]);
324 * Shows a preview of a single revision
328 * @return \Illuminate\View\View
330 public function showRevision($bookSlug, $pageSlug, $revisionId)
332 $book = $this->bookRepo->getBySlug($bookSlug);
333 $page = $this->pageRepo->getBySlug($pageSlug, $book->id);
334 $revision = $this->pageRepo->getRevisionById($revisionId);
335 $page->fill($revision->toArray());
336 $this->setPageTitle('Page Revision For ' . $page->getShortName());
337 return view('pages/revision', ['page' => $page, 'book' => $book]);
341 * Restores a page using the content of the specified revision.
345 * @return \Illuminate\Http\RedirectResponse|\Illuminate\Routing\Redirector
347 public function restoreRevision($bookSlug, $pageSlug, $revisionId)
349 $book = $this->bookRepo->getBySlug($bookSlug);
350 $page = $this->pageRepo->getBySlug($pageSlug, $book->id);
351 $this->checkOwnablePermission('page-update', $page);
352 $page = $this->pageRepo->restoreRevision($page, $book, $revisionId);
353 Activity::add($page, 'page_restore', $book->id);
354 return redirect($page->getUrl());
358 * Exports a page to pdf format using barryvdh/laravel-dompdf wrapper.
359 * https://github.com/barryvdh/laravel-dompdf
362 * @return \Illuminate\Http\Response
364 public function exportPdf($bookSlug, $pageSlug)
366 $book = $this->bookRepo->getBySlug($bookSlug);
367 $page = $this->pageRepo->getBySlug($pageSlug, $book->id);
368 $pdfContent = $this->exportService->pageToPdf($page);
369 return response()->make($pdfContent, 200, [
370 'Content-Type' => 'application/octet-stream',
371 'Content-Disposition' => 'attachment; filename="' . $pageSlug . '.pdf'
376 * Export a page to a self-contained HTML file.
379 * @return \Illuminate\Http\Response
381 public function exportHtml($bookSlug, $pageSlug)
383 $book = $this->bookRepo->getBySlug($bookSlug);
384 $page = $this->pageRepo->getBySlug($pageSlug, $book->id);
385 $containedHtml = $this->exportService->pageToContainedHtml($page);
386 return response()->make($containedHtml, 200, [
387 'Content-Type' => 'application/octet-stream',
388 'Content-Disposition' => 'attachment; filename="' . $pageSlug . '.html'
393 * Export a page to a simple plaintext .txt file.
396 * @return \Illuminate\Http\Response
398 public function exportPlainText($bookSlug, $pageSlug)
400 $book = $this->bookRepo->getBySlug($bookSlug);
401 $page = $this->pageRepo->getBySlug($pageSlug, $book->id);
402 $containedHtml = $this->exportService->pageToPlainText($page);
403 return response()->make($containedHtml, 200, [
404 'Content-Type' => 'application/octet-stream',
405 'Content-Disposition' => 'attachment; filename="' . $pageSlug . '.txt'
410 * Show a listing of recently created pages
411 * @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
413 public function showRecentlyCreated()
415 $pages = $this->pageRepo->getRecentlyCreatedPaginated(20);
416 return view('pages/detailed-listing', [
417 'title' => 'Recently Created Pages',
423 * Show a listing of recently created pages
424 * @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
426 public function showRecentlyUpdated()
428 $pages = $this->pageRepo->getRecentlyUpdatedPaginated(20);
429 return view('pages/detailed-listing', [
430 'title' => 'Recently Updated Pages',
436 * Show the Restrictions view.
439 * @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
441 public function showRestrict($bookSlug, $pageSlug)
443 $book = $this->bookRepo->getBySlug($bookSlug);
444 $page = $this->pageRepo->getBySlug($pageSlug, $book->id);
445 $this->checkOwnablePermission('restrictions-manage', $page);
446 $roles = $this->userRepo->getRestrictableRoles();
447 return view('pages/restrictions', [
454 * Set the restrictions for this page.
457 * @param Request $request
458 * @return \Illuminate\Http\RedirectResponse|\Illuminate\Routing\Redirector
460 public function restrict($bookSlug, $pageSlug, Request $request)
462 $book = $this->bookRepo->getBySlug($bookSlug);
463 $page = $this->pageRepo->getBySlug($pageSlug, $book->id);
464 $this->checkOwnablePermission('restrictions-manage', $page);
465 $this->pageRepo->updateRestrictionsFromRequest($request, $page);
466 session()->flash('success', 'Page Restrictions Updated');
467 return redirect($page->getUrl());