mirror of
https://github.com/BookStackApp/BookStack.git
synced 2024-10-01 01:36:00 -04:00
fea5630ea4
Changed to be rendered server side along with page content. Changed deletion to fully delete comments from the database. Added 'local_id' to comments for referencing. Updated reply system to be non-nested (Incomplete) Made database comment format entity-agnostic to be more future proof. Updated designs of comment sections.
597 lines
20 KiB
PHP
597 lines
20 KiB
PHP
<?php namespace BookStack\Http\Controllers;
|
|
|
|
use Activity;
|
|
use BookStack\Exceptions\NotFoundException;
|
|
use BookStack\Repos\EntityRepo;
|
|
use BookStack\Repos\UserRepo;
|
|
use BookStack\Services\ExportService;
|
|
use Carbon\Carbon;
|
|
use Illuminate\Http\Request;
|
|
use Illuminate\Http\Response;
|
|
use Views;
|
|
use GatherContent\Htmldiff\Htmldiff;
|
|
|
|
class PageController extends Controller
|
|
{
|
|
|
|
protected $entityRepo;
|
|
protected $exportService;
|
|
protected $userRepo;
|
|
|
|
/**
|
|
* PageController constructor.
|
|
* @param EntityRepo $entityRepo
|
|
* @param ExportService $exportService
|
|
* @param UserRepo $userRepo
|
|
*/
|
|
public function __construct(EntityRepo $entityRepo, ExportService $exportService, UserRepo $userRepo)
|
|
{
|
|
$this->entityRepo = $entityRepo;
|
|
$this->exportService = $exportService;
|
|
$this->userRepo = $userRepo;
|
|
parent::__construct();
|
|
}
|
|
|
|
/**
|
|
* Show the form for creating a new page.
|
|
* @param string $bookSlug
|
|
* @param string $chapterSlug
|
|
* @return Response
|
|
* @internal param bool $pageSlug
|
|
*/
|
|
public function create($bookSlug, $chapterSlug = null)
|
|
{
|
|
$book = $this->entityRepo->getBySlug('book', $bookSlug);
|
|
$chapter = $chapterSlug ? $this->entityRepo->getBySlug('chapter', $chapterSlug, $bookSlug) : null;
|
|
$parent = $chapter ? $chapter : $book;
|
|
$this->checkOwnablePermission('page-create', $parent);
|
|
|
|
// Redirect to draft edit screen if signed in
|
|
if ($this->signedIn) {
|
|
$draft = $this->entityRepo->getDraftPage($book, $chapter);
|
|
return redirect($draft->getUrl());
|
|
}
|
|
|
|
// Otherwise show edit view
|
|
$this->setPageTitle(trans('entities.pages_new'));
|
|
return view('pages/guest-create', ['parent' => $parent]);
|
|
}
|
|
|
|
/**
|
|
* Create a new page as a guest user.
|
|
* @param Request $request
|
|
* @param string $bookSlug
|
|
* @param string|null $chapterSlug
|
|
* @return mixed
|
|
* @throws NotFoundException
|
|
*/
|
|
public function createAsGuest(Request $request, $bookSlug, $chapterSlug = null)
|
|
{
|
|
$this->validate($request, [
|
|
'name' => 'required|string|max:255'
|
|
]);
|
|
|
|
$book = $this->entityRepo->getBySlug('book', $bookSlug);
|
|
$chapter = $chapterSlug ? $this->entityRepo->getBySlug('chapter', $chapterSlug, $bookSlug) : null;
|
|
$parent = $chapter ? $chapter : $book;
|
|
$this->checkOwnablePermission('page-create', $parent);
|
|
|
|
$page = $this->entityRepo->getDraftPage($book, $chapter);
|
|
$this->entityRepo->publishPageDraft($page, [
|
|
'name' => $request->get('name'),
|
|
'html' => ''
|
|
]);
|
|
return redirect($page->getUrl('/edit'));
|
|
}
|
|
|
|
/**
|
|
* Show form to continue editing a draft page.
|
|
* @param string $bookSlug
|
|
* @param int $pageId
|
|
* @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
|
|
*/
|
|
public function editDraft($bookSlug, $pageId)
|
|
{
|
|
$draft = $this->entityRepo->getById('page', $pageId, true);
|
|
$this->checkOwnablePermission('page-create', $draft->book);
|
|
$this->setPageTitle(trans('entities.pages_edit_draft'));
|
|
|
|
$draftsEnabled = $this->signedIn;
|
|
return view('pages/edit', [
|
|
'page' => $draft,
|
|
'book' => $draft->book,
|
|
'isDraft' => true,
|
|
'draftsEnabled' => $draftsEnabled
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* Store a new page by changing a draft into a page.
|
|
* @param Request $request
|
|
* @param string $bookSlug
|
|
* @param int $pageId
|
|
* @return Response
|
|
*/
|
|
public function store(Request $request, $bookSlug, $pageId)
|
|
{
|
|
$this->validate($request, [
|
|
'name' => 'required|string|max:255'
|
|
]);
|
|
|
|
$input = $request->all();
|
|
$book = $this->entityRepo->getBySlug('book', $bookSlug);
|
|
|
|
$draftPage = $this->entityRepo->getById('page', $pageId, true);
|
|
|
|
$chapterId = intval($draftPage->chapter_id);
|
|
$parent = $chapterId !== 0 ? $this->entityRepo->getById('chapter', $chapterId) : $book;
|
|
$this->checkOwnablePermission('page-create', $parent);
|
|
|
|
if ($parent->isA('chapter')) {
|
|
$input['priority'] = $this->entityRepo->getNewChapterPriority($parent);
|
|
} else {
|
|
$input['priority'] = $this->entityRepo->getNewBookPriority($parent);
|
|
}
|
|
|
|
$page = $this->entityRepo->publishPageDraft($draftPage, $input);
|
|
|
|
Activity::add($page, 'page_create', $book->id);
|
|
return redirect($page->getUrl());
|
|
}
|
|
|
|
/**
|
|
* Display the specified page.
|
|
* If the page is not found via the slug the revisions are searched for a match.
|
|
* @param string $bookSlug
|
|
* @param string $pageSlug
|
|
* @return Response
|
|
*/
|
|
public function show($bookSlug, $pageSlug)
|
|
{
|
|
try {
|
|
$page = $this->entityRepo->getBySlug('page', $pageSlug, $bookSlug);
|
|
} catch (NotFoundException $e) {
|
|
$page = $this->entityRepo->getPageByOldSlug($pageSlug, $bookSlug);
|
|
if ($page === null) abort(404);
|
|
return redirect($page->getUrl());
|
|
}
|
|
|
|
$this->checkOwnablePermission('page-view', $page);
|
|
|
|
$pageContent = $this->entityRepo->renderPage($page);
|
|
$sidebarTree = $this->entityRepo->getBookChildren($page->book);
|
|
$pageNav = $this->entityRepo->getPageNav($pageContent);
|
|
$page->load(['comments.createdBy']);
|
|
|
|
Views::add($page);
|
|
$this->setPageTitle($page->getShortName());
|
|
return view('pages/show', [
|
|
'page' => $page,'book' => $page->book,
|
|
'current' => $page, 'sidebarTree' => $sidebarTree,
|
|
'pageNav' => $pageNav]);
|
|
}
|
|
|
|
/**
|
|
* Get page from an ajax request.
|
|
* @param int $pageId
|
|
* @return \Illuminate\Http\JsonResponse
|
|
*/
|
|
public function getPageAjax($pageId)
|
|
{
|
|
$page = $this->entityRepo->getById('page', $pageId);
|
|
return response()->json($page);
|
|
}
|
|
|
|
/**
|
|
* Show the form for editing the specified page.
|
|
* @param string $bookSlug
|
|
* @param string $pageSlug
|
|
* @return Response
|
|
*/
|
|
public function edit($bookSlug, $pageSlug)
|
|
{
|
|
$page = $this->entityRepo->getBySlug('page', $pageSlug, $bookSlug);
|
|
$this->checkOwnablePermission('page-update', $page);
|
|
$this->setPageTitle(trans('entities.pages_editing_named', ['pageName'=>$page->getShortName()]));
|
|
$page->isDraft = false;
|
|
|
|
// Check for active editing
|
|
$warnings = [];
|
|
if ($this->entityRepo->isPageEditingActive($page, 60)) {
|
|
$warnings[] = $this->entityRepo->getPageEditingActiveMessage($page, 60);
|
|
}
|
|
|
|
// Check for a current draft version for this user
|
|
if ($this->entityRepo->hasUserGotPageDraft($page, $this->currentUser->id)) {
|
|
$draft = $this->entityRepo->getUserPageDraft($page, $this->currentUser->id);
|
|
$page->name = $draft->name;
|
|
$page->html = $draft->html;
|
|
$page->markdown = $draft->markdown;
|
|
$page->isDraft = true;
|
|
$warnings [] = $this->entityRepo->getUserPageDraftMessage($draft);
|
|
}
|
|
|
|
if (count($warnings) > 0) session()->flash('warning', implode("\n", $warnings));
|
|
|
|
$draftsEnabled = $this->signedIn;
|
|
return view('pages/edit', [
|
|
'page' => $page,
|
|
'book' => $page->book,
|
|
'current' => $page,
|
|
'draftsEnabled' => $draftsEnabled
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* Update the specified page in storage.
|
|
* @param Request $request
|
|
* @param string $bookSlug
|
|
* @param string $pageSlug
|
|
* @return Response
|
|
*/
|
|
public function update(Request $request, $bookSlug, $pageSlug)
|
|
{
|
|
$this->validate($request, [
|
|
'name' => 'required|string|max:255'
|
|
]);
|
|
$page = $this->entityRepo->getBySlug('page', $pageSlug, $bookSlug);
|
|
$this->checkOwnablePermission('page-update', $page);
|
|
$this->entityRepo->updatePage($page, $page->book->id, $request->all());
|
|
Activity::add($page, 'page_update', $page->book->id);
|
|
return redirect($page->getUrl());
|
|
}
|
|
|
|
/**
|
|
* Save a draft update as a revision.
|
|
* @param Request $request
|
|
* @param int $pageId
|
|
* @return \Illuminate\Http\JsonResponse
|
|
*/
|
|
public function saveDraft(Request $request, $pageId)
|
|
{
|
|
$page = $this->entityRepo->getById('page', $pageId, true);
|
|
$this->checkOwnablePermission('page-update', $page);
|
|
|
|
if (!$this->signedIn) {
|
|
return response()->json([
|
|
'status' => 'error',
|
|
'message' => trans('errors.guests_cannot_save_drafts'),
|
|
], 500);
|
|
}
|
|
|
|
$draft = $this->entityRepo->updatePageDraft($page, $request->only(['name', 'html', 'markdown']));
|
|
|
|
$updateTime = $draft->updated_at->timestamp;
|
|
$utcUpdateTimestamp = $updateTime + Carbon::createFromTimestamp(0)->offset;
|
|
return response()->json([
|
|
'status' => 'success',
|
|
'message' => trans('entities.pages_edit_draft_save_at'),
|
|
'timestamp' => $utcUpdateTimestamp
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* Redirect from a special link url which
|
|
* uses the page id rather than the name.
|
|
* @param int $pageId
|
|
* @return \Illuminate\Http\RedirectResponse|\Illuminate\Routing\Redirector
|
|
*/
|
|
public function redirectFromLink($pageId)
|
|
{
|
|
$page = $this->entityRepo->getById('page', $pageId);
|
|
return redirect($page->getUrl());
|
|
}
|
|
|
|
/**
|
|
* Show the deletion page for the specified page.
|
|
* @param string $bookSlug
|
|
* @param string $pageSlug
|
|
* @return \Illuminate\View\View
|
|
*/
|
|
public function showDelete($bookSlug, $pageSlug)
|
|
{
|
|
$page = $this->entityRepo->getBySlug('page', $pageSlug, $bookSlug);
|
|
$this->checkOwnablePermission('page-delete', $page);
|
|
$this->setPageTitle(trans('entities.pages_delete_named', ['pageName'=>$page->getShortName()]));
|
|
return view('pages/delete', ['book' => $page->book, 'page' => $page, 'current' => $page]);
|
|
}
|
|
|
|
|
|
/**
|
|
* Show the deletion page for the specified page.
|
|
* @param string $bookSlug
|
|
* @param int $pageId
|
|
* @return \Illuminate\View\View
|
|
* @throws NotFoundException
|
|
*/
|
|
public function showDeleteDraft($bookSlug, $pageId)
|
|
{
|
|
$page = $this->entityRepo->getById('page', $pageId, true);
|
|
$this->checkOwnablePermission('page-update', $page);
|
|
$this->setPageTitle(trans('entities.pages_delete_draft_named', ['pageName'=>$page->getShortName()]));
|
|
return view('pages/delete', ['book' => $page->book, 'page' => $page, 'current' => $page]);
|
|
}
|
|
|
|
/**
|
|
* Remove the specified page from storage.
|
|
* @param string $bookSlug
|
|
* @param string $pageSlug
|
|
* @return Response
|
|
* @internal param int $id
|
|
*/
|
|
public function destroy($bookSlug, $pageSlug)
|
|
{
|
|
$page = $this->entityRepo->getBySlug('page', $pageSlug, $bookSlug);
|
|
$book = $page->book;
|
|
$this->checkOwnablePermission('page-delete', $page);
|
|
Activity::addMessage('page_delete', $book->id, $page->name);
|
|
session()->flash('success', trans('entities.pages_delete_success'));
|
|
$this->entityRepo->destroyPage($page);
|
|
return redirect($book->getUrl());
|
|
}
|
|
|
|
/**
|
|
* Remove the specified draft page from storage.
|
|
* @param string $bookSlug
|
|
* @param int $pageId
|
|
* @return Response
|
|
* @throws NotFoundException
|
|
*/
|
|
public function destroyDraft($bookSlug, $pageId)
|
|
{
|
|
$page = $this->entityRepo->getById('page', $pageId, true);
|
|
$book = $page->book;
|
|
$this->checkOwnablePermission('page-update', $page);
|
|
session()->flash('success', trans('entities.pages_delete_draft_success'));
|
|
$this->entityRepo->destroyPage($page);
|
|
return redirect($book->getUrl());
|
|
}
|
|
|
|
/**
|
|
* Shows the last revisions for this page.
|
|
* @param string $bookSlug
|
|
* @param string $pageSlug
|
|
* @return \Illuminate\View\View
|
|
*/
|
|
public function showRevisions($bookSlug, $pageSlug)
|
|
{
|
|
$page = $this->entityRepo->getBySlug('page', $pageSlug, $bookSlug);
|
|
$this->setPageTitle(trans('entities.pages_revisions_named', ['pageName'=>$page->getShortName()]));
|
|
return view('pages/revisions', ['page' => $page, 'book' => $page->book, 'current' => $page]);
|
|
}
|
|
|
|
/**
|
|
* Shows a preview of a single revision
|
|
* @param string $bookSlug
|
|
* @param string $pageSlug
|
|
* @param int $revisionId
|
|
* @return \Illuminate\View\View
|
|
*/
|
|
public function showRevision($bookSlug, $pageSlug, $revisionId)
|
|
{
|
|
$page = $this->entityRepo->getBySlug('page', $pageSlug, $bookSlug);
|
|
$revision = $page->revisions()->where('id', '=', $revisionId)->first();
|
|
if ($revision === null) {
|
|
abort(404);
|
|
}
|
|
|
|
$page->fill($revision->toArray());
|
|
$this->setPageTitle(trans('entities.pages_revision_named', ['pageName' => $page->getShortName()]));
|
|
|
|
return view('pages/revision', [
|
|
'page' => $page,
|
|
'book' => $page->book,
|
|
'revision' => $revision
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* Shows the changes of a single revision
|
|
* @param string $bookSlug
|
|
* @param string $pageSlug
|
|
* @param int $revisionId
|
|
* @return \Illuminate\View\View
|
|
*/
|
|
public function showRevisionChanges($bookSlug, $pageSlug, $revisionId)
|
|
{
|
|
$page = $this->entityRepo->getBySlug('page', $pageSlug, $bookSlug);
|
|
$revision = $page->revisions()->where('id', '=', $revisionId)->first();
|
|
if ($revision === null) {
|
|
abort(404);
|
|
}
|
|
|
|
$prev = $revision->getPrevious();
|
|
$prevContent = ($prev === null) ? '' : $prev->html;
|
|
$diff = (new Htmldiff)->diff($prevContent, $revision->html);
|
|
|
|
$page->fill($revision->toArray());
|
|
$this->setPageTitle(trans('entities.pages_revision_named', ['pageName'=>$page->getShortName()]));
|
|
|
|
return view('pages/revision', [
|
|
'page' => $page,
|
|
'book' => $page->book,
|
|
'diff' => $diff,
|
|
'revision' => $revision
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* Restores a page using the content of the specified revision.
|
|
* @param string $bookSlug
|
|
* @param string $pageSlug
|
|
* @param int $revisionId
|
|
* @return \Illuminate\Http\RedirectResponse|\Illuminate\Routing\Redirector
|
|
*/
|
|
public function restoreRevision($bookSlug, $pageSlug, $revisionId)
|
|
{
|
|
$page = $this->entityRepo->getBySlug('page', $pageSlug, $bookSlug);
|
|
$this->checkOwnablePermission('page-update', $page);
|
|
$page = $this->entityRepo->restorePageRevision($page, $page->book, $revisionId);
|
|
Activity::add($page, 'page_restore', $page->book->id);
|
|
return redirect($page->getUrl());
|
|
}
|
|
|
|
/**
|
|
* Exports a page to a PDF.
|
|
* https://github.com/barryvdh/laravel-dompdf
|
|
* @param string $bookSlug
|
|
* @param string $pageSlug
|
|
* @return \Illuminate\Http\Response
|
|
*/
|
|
public function exportPdf($bookSlug, $pageSlug)
|
|
{
|
|
$page = $this->entityRepo->getBySlug('page', $pageSlug, $bookSlug);
|
|
$pdfContent = $this->exportService->pageToPdf($page);
|
|
return response()->make($pdfContent, 200, [
|
|
'Content-Type' => 'application/octet-stream',
|
|
'Content-Disposition' => 'attachment; filename="' . $pageSlug . '.pdf'
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* Export a page to a self-contained HTML file.
|
|
* @param string $bookSlug
|
|
* @param string $pageSlug
|
|
* @return \Illuminate\Http\Response
|
|
*/
|
|
public function exportHtml($bookSlug, $pageSlug)
|
|
{
|
|
$page = $this->entityRepo->getBySlug('page', $pageSlug, $bookSlug);
|
|
$containedHtml = $this->exportService->pageToContainedHtml($page);
|
|
return response()->make($containedHtml, 200, [
|
|
'Content-Type' => 'application/octet-stream',
|
|
'Content-Disposition' => 'attachment; filename="' . $pageSlug . '.html'
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* Export a page to a simple plaintext .txt file.
|
|
* @param string $bookSlug
|
|
* @param string $pageSlug
|
|
* @return \Illuminate\Http\Response
|
|
*/
|
|
public function exportPlainText($bookSlug, $pageSlug)
|
|
{
|
|
$page = $this->entityRepo->getBySlug('page', $pageSlug, $bookSlug);
|
|
$containedHtml = $this->exportService->pageToPlainText($page);
|
|
return response()->make($containedHtml, 200, [
|
|
'Content-Type' => 'application/octet-stream',
|
|
'Content-Disposition' => 'attachment; filename="' . $pageSlug . '.txt'
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* Show a listing of recently created pages
|
|
* @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
|
|
*/
|
|
public function showRecentlyCreated()
|
|
{
|
|
$pages = $this->entityRepo->getRecentlyCreatedPaginated('page', 20)->setPath(baseUrl('/pages/recently-created'));
|
|
return view('pages/detailed-listing', [
|
|
'title' => trans('entities.recently_created_pages'),
|
|
'pages' => $pages
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* Show a listing of recently created pages
|
|
* @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
|
|
*/
|
|
public function showRecentlyUpdated()
|
|
{
|
|
$pages = $this->entityRepo->getRecentlyUpdatedPaginated('page', 20)->setPath(baseUrl('/pages/recently-updated'));
|
|
return view('pages/detailed-listing', [
|
|
'title' => trans('entities.recently_updated_pages'),
|
|
'pages' => $pages
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* Show the Restrictions view.
|
|
* @param string $bookSlug
|
|
* @param string $pageSlug
|
|
* @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
|
|
*/
|
|
public function showRestrict($bookSlug, $pageSlug)
|
|
{
|
|
$page = $this->entityRepo->getBySlug('page', $pageSlug, $bookSlug);
|
|
$this->checkOwnablePermission('restrictions-manage', $page);
|
|
$roles = $this->userRepo->getRestrictableRoles();
|
|
return view('pages/restrictions', [
|
|
'page' => $page,
|
|
'roles' => $roles
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* Show the view to choose a new parent to move a page into.
|
|
* @param string $bookSlug
|
|
* @param string $pageSlug
|
|
* @return mixed
|
|
* @throws NotFoundException
|
|
*/
|
|
public function showMove($bookSlug, $pageSlug)
|
|
{
|
|
$page = $this->entityRepo->getBySlug('page', $pageSlug, $bookSlug);
|
|
$this->checkOwnablePermission('page-update', $page);
|
|
return view('pages/move', [
|
|
'book' => $page->book,
|
|
'page' => $page
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* Does the action of moving the location of a page
|
|
* @param string $bookSlug
|
|
* @param string $pageSlug
|
|
* @param Request $request
|
|
* @return mixed
|
|
* @throws NotFoundException
|
|
*/
|
|
public function move($bookSlug, $pageSlug, Request $request)
|
|
{
|
|
$page = $this->entityRepo->getBySlug('page', $pageSlug, $bookSlug);
|
|
$this->checkOwnablePermission('page-update', $page);
|
|
|
|
$entitySelection = $request->get('entity_selection', null);
|
|
if ($entitySelection === null || $entitySelection === '') {
|
|
return redirect($page->getUrl());
|
|
}
|
|
|
|
$stringExploded = explode(':', $entitySelection);
|
|
$entityType = $stringExploded[0];
|
|
$entityId = intval($stringExploded[1]);
|
|
|
|
|
|
try {
|
|
$parent = $this->entityRepo->getById($entityType, $entityId);
|
|
} catch (\Exception $e) {
|
|
session()->flash(trans('entities.selected_book_chapter_not_found'));
|
|
return redirect()->back();
|
|
}
|
|
|
|
$this->entityRepo->changePageParent($page, $parent);
|
|
Activity::add($page, 'page_move', $page->book->id);
|
|
session()->flash('success', trans('entities.pages_move_success', ['parentName' => $parent->name]));
|
|
|
|
return redirect($page->getUrl());
|
|
}
|
|
|
|
/**
|
|
* Set the permissions for this page.
|
|
* @param string $bookSlug
|
|
* @param string $pageSlug
|
|
* @param Request $request
|
|
* @return \Illuminate\Http\RedirectResponse|\Illuminate\Routing\Redirector
|
|
*/
|
|
public function restrict($bookSlug, $pageSlug, Request $request)
|
|
{
|
|
$page = $this->entityRepo->getBySlug('page', $pageSlug, $bookSlug);
|
|
$this->checkOwnablePermission('restrictions-manage', $page);
|
|
$this->entityRepo->updateEntityPermissionsFromRequest($request, $page);
|
|
session()->flash('success', trans('entities.pages_permissions_success'));
|
|
return redirect($page->getUrl());
|
|
}
|
|
|
|
}
|