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;
15 use GatherContent\Htmldiff\Htmldiff;
17 class PageController extends Controller
22 protected $chapterRepo;
23 protected $exportService;
27 * PageController constructor.
28 * @param PageRepo $pageRepo
29 * @param BookRepo $bookRepo
30 * @param ChapterRepo $chapterRepo
31 * @param ExportService $exportService
32 * @param UserRepo $userRepo
34 public function __construct(PageRepo $pageRepo, BookRepo $bookRepo, ChapterRepo $chapterRepo, ExportService $exportService, UserRepo $userRepo)
36 $this->pageRepo = $pageRepo;
37 $this->bookRepo = $bookRepo;
38 $this->chapterRepo = $chapterRepo;
39 $this->exportService = $exportService;
40 $this->userRepo = $userRepo;
41 parent::__construct();
45 * Show the form for creating a new page.
47 * @param bool $chapterSlug
49 * @internal param bool $pageSlug
51 public function create($bookSlug, $chapterSlug = false)
53 $book = $this->bookRepo->getBySlug($bookSlug);
54 $chapter = $chapterSlug ? $this->chapterRepo->getBySlug($chapterSlug, $book->id) : null;
55 $parent = $chapter ? $chapter : $book;
56 $this->checkOwnablePermission('page-create', $parent);
57 $this->setPageTitle('Create New Page');
59 $draft = $this->pageRepo->getDraftPage($book, $chapter);
60 return redirect($draft->getUrl());
64 * Show form to continue editing a draft page.
67 * @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
69 public function editDraft($bookSlug, $pageId)
71 $book = $this->bookRepo->getBySlug($bookSlug);
72 $draft = $this->pageRepo->getById($pageId, true);
73 $this->checkOwnablePermission('page-create', $book);
74 $this->setPageTitle('Edit Page Draft');
76 return view('pages/edit', ['page' => $draft, 'book' => $book, 'isDraft' => true]);
80 * Store a new page by changing a draft into a page.
81 * @param Request $request
82 * @param string $bookSlug
85 public function store(Request $request, $bookSlug, $pageId)
87 $this->validate($request, [
88 'name' => 'required|string|max:255'
91 $input = $request->all();
92 $book = $this->bookRepo->getBySlug($bookSlug);
94 $draftPage = $this->pageRepo->getById($pageId, true);
96 $chapterId = intval($draftPage->chapter_id);
97 $parent = $chapterId !== 0 ? $this->chapterRepo->getById($chapterId) : $book;
98 $this->checkOwnablePermission('page-create', $parent);
100 if ($parent->isA('chapter')) {
101 $input['priority'] = $this->chapterRepo->getNewPriority($parent);
103 $input['priority'] = $this->bookRepo->getNewPriority($parent);
106 $page = $this->pageRepo->publishDraft($draftPage, $input);
108 Activity::add($page, 'page_create', $book->id);
109 return redirect($page->getUrl());
113 * Display the specified page.
114 * If the page is not found via the slug the
115 * revisions are searched for a match.
120 public function show($bookSlug, $pageSlug)
122 $book = $this->bookRepo->getBySlug($bookSlug);
125 $page = $this->pageRepo->getBySlug($pageSlug, $book->id);
126 } catch (NotFoundException $e) {
127 $page = $this->pageRepo->findPageUsingOldSlug($pageSlug, $bookSlug);
128 if ($page === null) abort(404);
129 return redirect($page->getUrl());
132 $this->checkOwnablePermission('page-view', $page);
134 $sidebarTree = $this->bookRepo->getChildren($book);
136 $this->setPageTitle($page->getShortName());
137 return view('pages/show', ['page' => $page, 'book' => $book, 'current' => $page, 'sidebarTree' => $sidebarTree]);
141 * Get page from an ajax request.
143 * @return \Illuminate\Http\JsonResponse
145 public function getPageAjax($pageId)
147 $page = $this->pageRepo->getById($pageId);
148 return response()->json($page);
152 * Show the form for editing the specified page.
157 public function edit($bookSlug, $pageSlug)
159 $book = $this->bookRepo->getBySlug($bookSlug);
160 $page = $this->pageRepo->getBySlug($pageSlug, $book->id);
161 $this->checkOwnablePermission('page-update', $page);
162 $this->setPageTitle('Editing Page ' . $page->getShortName());
163 $page->isDraft = false;
165 // Check for active editing
167 if ($this->pageRepo->isPageEditingActive($page, 60)) {
168 $warnings[] = $this->pageRepo->getPageEditingActiveMessage($page, 60);
171 // Check for a current draft version for this user
172 if ($this->pageRepo->hasUserGotPageDraft($page, $this->currentUser->id)) {
173 $draft = $this->pageRepo->getUserPageDraft($page, $this->currentUser->id);
174 $page->name = $draft->name;
175 $page->html = $draft->html;
176 $page->markdown = $draft->markdown;
177 $page->isDraft = true;
178 $warnings [] = $this->pageRepo->getUserPageDraftMessage($draft);
181 if (count($warnings) > 0) session()->flash('warning', implode("\n", $warnings));
183 return view('pages/edit', ['page' => $page, 'book' => $book, 'current' => $page]);
187 * Update the specified page in storage.
188 * @param Request $request
193 public function update(Request $request, $bookSlug, $pageSlug)
195 $this->validate($request, [
196 'name' => 'required|string|max:255'
198 $book = $this->bookRepo->getBySlug($bookSlug);
199 $page = $this->pageRepo->getBySlug($pageSlug, $book->id);
200 $this->checkOwnablePermission('page-update', $page);
201 $this->pageRepo->updatePage($page, $book->id, $request->all());
202 Activity::add($page, 'page_update', $book->id);
203 return redirect($page->getUrl());
207 * Save a draft update as a revision.
208 * @param Request $request
210 * @return \Illuminate\Http\JsonResponse
212 public function saveDraft(Request $request, $pageId)
214 $page = $this->pageRepo->getById($pageId, true);
215 $this->checkOwnablePermission('page-update', $page);
217 $draft = $this->pageRepo->updateDraftPage($page, $request->only(['name', 'html', 'markdown']));
219 $draft = $this->pageRepo->saveUpdateDraft($page, $request->only(['name', 'html', 'markdown']));
222 $updateTime = $draft->updated_at->timestamp;
223 $utcUpdateTimestamp = $updateTime + Carbon::createFromTimestamp(0)->offset;
224 return response()->json([
225 'status' => 'success',
226 'message' => 'Draft saved at ',
227 'timestamp' => $utcUpdateTimestamp
232 * Redirect from a special link url which
233 * uses the page id rather than the name.
235 * @return \Illuminate\Http\RedirectResponse|\Illuminate\Routing\Redirector
237 public function redirectFromLink($pageId)
239 $page = $this->pageRepo->getById($pageId);
240 return redirect($page->getUrl());
244 * Show the deletion page for the specified page.
247 * @return \Illuminate\View\View
249 public function showDelete($bookSlug, $pageSlug)
251 $book = $this->bookRepo->getBySlug($bookSlug);
252 $page = $this->pageRepo->getBySlug($pageSlug, $book->id);
253 $this->checkOwnablePermission('page-delete', $page);
254 $this->setPageTitle('Delete Page ' . $page->getShortName());
255 return view('pages/delete', ['book' => $book, 'page' => $page, 'current' => $page]);
260 * Show the deletion page for the specified page.
263 * @return \Illuminate\View\View
264 * @throws NotFoundException
266 public function showDeleteDraft($bookSlug, $pageId)
268 $book = $this->bookRepo->getBySlug($bookSlug);
269 $page = $this->pageRepo->getById($pageId, true);
270 $this->checkOwnablePermission('page-update', $page);
271 $this->setPageTitle('Delete Draft Page ' . $page->getShortName());
272 return view('pages/delete', ['book' => $book, 'page' => $page, 'current' => $page]);
276 * Remove the specified page from storage.
280 * @internal param int $id
282 public function destroy($bookSlug, $pageSlug)
284 $book = $this->bookRepo->getBySlug($bookSlug);
285 $page = $this->pageRepo->getBySlug($pageSlug, $book->id);
286 $this->checkOwnablePermission('page-delete', $page);
287 Activity::addMessage('page_delete', $book->id, $page->name);
288 session()->flash('success', 'Page deleted');
289 $this->pageRepo->destroy($page);
290 return redirect($book->getUrl());
294 * Remove the specified draft page from storage.
298 * @throws NotFoundException
300 public function destroyDraft($bookSlug, $pageId)
302 $book = $this->bookRepo->getBySlug($bookSlug);
303 $page = $this->pageRepo->getById($pageId, true);
304 $this->checkOwnablePermission('page-update', $page);
305 session()->flash('success', 'Draft deleted');
306 $this->pageRepo->destroy($page);
307 return redirect($book->getUrl());
311 * Shows the last revisions for this page.
314 * @return \Illuminate\View\View
316 public function showRevisions($bookSlug, $pageSlug)
318 $book = $this->bookRepo->getBySlug($bookSlug);
319 $page = $this->pageRepo->getBySlug($pageSlug, $book->id);
320 $this->setPageTitle('Revisions For ' . $page->getShortName());
321 return view('pages/revisions', ['page' => $page, 'book' => $book, 'current' => $page]);
325 * Shows a preview of a single revision
329 * @return \Illuminate\View\View
331 public function showRevision($bookSlug, $pageSlug, $revisionId)
333 $book = $this->bookRepo->getBySlug($bookSlug);
334 $page = $this->pageRepo->getBySlug($pageSlug, $book->id);
335 $revision = $this->pageRepo->getRevisionById($revisionId);
337 $next = $revision->getNext() ?: $page;
338 $diff = (new Htmldiff)->diff($revision->html, $next->html);
340 $page->fill($revision->toArray());
341 $this->setPageTitle('Page Revision For ' . $page->getShortName());
343 return view('pages/revision', [
351 * Restores a page using the content of the specified revision.
355 * @return \Illuminate\Http\RedirectResponse|\Illuminate\Routing\Redirector
357 public function restoreRevision($bookSlug, $pageSlug, $revisionId)
359 $book = $this->bookRepo->getBySlug($bookSlug);
360 $page = $this->pageRepo->getBySlug($pageSlug, $book->id);
361 $this->checkOwnablePermission('page-update', $page);
362 $page = $this->pageRepo->restoreRevision($page, $book, $revisionId);
363 Activity::add($page, 'page_restore', $book->id);
364 return redirect($page->getUrl());
368 * Exports a page to pdf format using barryvdh/laravel-dompdf wrapper.
369 * https://github.com/barryvdh/laravel-dompdf
372 * @return \Illuminate\Http\Response
374 public function exportPdf($bookSlug, $pageSlug)
376 $book = $this->bookRepo->getBySlug($bookSlug);
377 $page = $this->pageRepo->getBySlug($pageSlug, $book->id);
378 $pdfContent = $this->exportService->pageToPdf($page);
379 return response()->make($pdfContent, 200, [
380 'Content-Type' => 'application/octet-stream',
381 'Content-Disposition' => 'attachment; filename="' . $pageSlug . '.pdf'
386 * Export a page to a self-contained HTML file.
389 * @return \Illuminate\Http\Response
391 public function exportHtml($bookSlug, $pageSlug)
393 $book = $this->bookRepo->getBySlug($bookSlug);
394 $page = $this->pageRepo->getBySlug($pageSlug, $book->id);
395 $containedHtml = $this->exportService->pageToContainedHtml($page);
396 return response()->make($containedHtml, 200, [
397 'Content-Type' => 'application/octet-stream',
398 'Content-Disposition' => 'attachment; filename="' . $pageSlug . '.html'
403 * Export a page to a simple plaintext .txt file.
406 * @return \Illuminate\Http\Response
408 public function exportPlainText($bookSlug, $pageSlug)
410 $book = $this->bookRepo->getBySlug($bookSlug);
411 $page = $this->pageRepo->getBySlug($pageSlug, $book->id);
412 $containedHtml = $this->exportService->pageToPlainText($page);
413 return response()->make($containedHtml, 200, [
414 'Content-Type' => 'application/octet-stream',
415 'Content-Disposition' => 'attachment; filename="' . $pageSlug . '.txt'
420 * Show a listing of recently created pages
421 * @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
423 public function showRecentlyCreated()
425 $pages = $this->pageRepo->getRecentlyCreatedPaginated(20);
426 return view('pages/detailed-listing', [
427 'title' => 'Recently Created Pages',
433 * Show a listing of recently created pages
434 * @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
436 public function showRecentlyUpdated()
438 $pages = $this->pageRepo->getRecentlyUpdatedPaginated(20);
439 return view('pages/detailed-listing', [
440 'title' => 'Recently Updated Pages',
446 * Show the Restrictions view.
449 * @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
451 public function showRestrict($bookSlug, $pageSlug)
453 $book = $this->bookRepo->getBySlug($bookSlug);
454 $page = $this->pageRepo->getBySlug($pageSlug, $book->id);
455 $this->checkOwnablePermission('restrictions-manage', $page);
456 $roles = $this->userRepo->getRestrictableRoles();
457 return view('pages/restrictions', [
464 * Show the view to choose a new parent to move a page into.
468 * @throws NotFoundException
470 public function showMove($bookSlug, $pageSlug)
472 $book = $this->bookRepo->getBySlug($bookSlug);
473 $page = $this->pageRepo->getBySlug($pageSlug, $book->id);
474 $this->checkOwnablePermission('page-update', $page);
475 return view('pages/move', [
482 * Does the action of moving the location of a page
485 * @param Request $request
487 * @throws NotFoundException
489 public function move($bookSlug, $pageSlug, Request $request)
491 $book = $this->bookRepo->getBySlug($bookSlug);
492 $page = $this->pageRepo->getBySlug($pageSlug, $book->id);
493 $this->checkOwnablePermission('page-update', $page);
495 $entitySelection = $request->get('entity_selection', null);
496 if ($entitySelection === null || $entitySelection === '') {
497 return redirect($page->getUrl());
500 $stringExploded = explode(':', $entitySelection);
501 $entityType = $stringExploded[0];
502 $entityId = intval($stringExploded[1]);
506 if ($entityType == 'chapter') {
507 $parent = $this->chapterRepo->getById($entityId);
508 } else if ($entityType == 'book') {
509 $parent = $this->bookRepo->getById($entityId);
512 if ($parent === false || $parent === null) {
513 session()->flash('The selected Book or Chapter was not found');
514 return redirect()->back();
517 $this->pageRepo->changePageParent($page, $parent);
518 Activity::add($page, 'page_move', $page->book->id);
519 session()->flash('success', sprintf('Page moved to "%s"', $parent->name));
521 return redirect($page->getUrl());
525 * Set the permissions for this page.
528 * @param Request $request
529 * @return \Illuminate\Http\RedirectResponse|\Illuminate\Routing\Redirector
531 public function restrict($bookSlug, $pageSlug, Request $request)
533 $book = $this->bookRepo->getBySlug($bookSlug);
534 $page = $this->pageRepo->getBySlug($pageSlug, $book->id);
535 $this->checkOwnablePermission('restrictions-manage', $page);
536 $this->pageRepo->updateEntityPermissionsFromRequest($request, $page);
537 session()->flash('success', 'Page Permissions Updated');
538 return redirect($page->getUrl());