mirror of
https://github.com/BookStackApp/BookStack.git
synced 2024-12-13 22:43:39 +08:00
b77ab6f3af
Also ran auto-removal of unused imports across app folder.
471 lines
16 KiB
PHP
471 lines
16 KiB
PHP
<?php
|
|
|
|
namespace BookStack\Entities\Controllers;
|
|
|
|
use BookStack\Activity\Models\View;
|
|
use BookStack\Activity\Tools\CommentTree;
|
|
use BookStack\Activity\Tools\UserEntityWatchOptions;
|
|
use BookStack\Entities\Models\Book;
|
|
use BookStack\Entities\Models\Chapter;
|
|
use BookStack\Entities\Queries\EntityQueries;
|
|
use BookStack\Entities\Queries\PageQueries;
|
|
use BookStack\Entities\Repos\PageRepo;
|
|
use BookStack\Entities\Tools\BookContents;
|
|
use BookStack\Entities\Tools\Cloner;
|
|
use BookStack\Entities\Tools\NextPreviousContentLocator;
|
|
use BookStack\Entities\Tools\PageContent;
|
|
use BookStack\Entities\Tools\PageEditActivity;
|
|
use BookStack\Entities\Tools\PageEditorData;
|
|
use BookStack\Exceptions\NotFoundException;
|
|
use BookStack\Exceptions\PermissionsException;
|
|
use BookStack\Http\Controller;
|
|
use BookStack\References\ReferenceFetcher;
|
|
use Exception;
|
|
use Illuminate\Database\Eloquent\Relations\BelongsTo;
|
|
use Illuminate\Http\Request;
|
|
use Illuminate\Validation\ValidationException;
|
|
use Throwable;
|
|
|
|
class PageController extends Controller
|
|
{
|
|
public function __construct(
|
|
protected PageRepo $pageRepo,
|
|
protected PageQueries $queries,
|
|
protected EntityQueries $entityQueries,
|
|
protected ReferenceFetcher $referenceFetcher
|
|
) {
|
|
}
|
|
|
|
/**
|
|
* Show the form for creating a new page.
|
|
*
|
|
* @throws Throwable
|
|
*/
|
|
public function create(string $bookSlug, string $chapterSlug = null)
|
|
{
|
|
if ($chapterSlug) {
|
|
$parent = $this->entityQueries->chapters->findVisibleBySlugsOrFail($bookSlug, $chapterSlug);
|
|
} else {
|
|
$parent = $this->entityQueries->books->findVisibleBySlugOrFail($bookSlug);
|
|
}
|
|
|
|
$this->checkOwnablePermission('page-create', $parent);
|
|
|
|
// Redirect to draft edit screen if signed in
|
|
if ($this->isSignedIn()) {
|
|
$draft = $this->pageRepo->getNewDraftPage($parent);
|
|
|
|
return redirect($draft->getUrl());
|
|
}
|
|
|
|
// Otherwise show the edit view if they're a guest
|
|
$this->setPageTitle(trans('entities.pages_new'));
|
|
|
|
return view('pages.guest-create', ['parent' => $parent]);
|
|
}
|
|
|
|
/**
|
|
* Create a new page as a guest user.
|
|
*
|
|
* @throws ValidationException
|
|
*/
|
|
public function createAsGuest(Request $request, string $bookSlug, string $chapterSlug = null)
|
|
{
|
|
$this->validate($request, [
|
|
'name' => ['required', 'string', 'max:255'],
|
|
]);
|
|
|
|
if ($chapterSlug) {
|
|
$parent = $this->entityQueries->chapters->findVisibleBySlugsOrFail($bookSlug, $chapterSlug);
|
|
} else {
|
|
$parent = $this->entityQueries->books->findVisibleBySlugOrFail($bookSlug);
|
|
}
|
|
|
|
$this->checkOwnablePermission('page-create', $parent);
|
|
|
|
$page = $this->pageRepo->getNewDraftPage($parent);
|
|
$this->pageRepo->publishDraft($page, [
|
|
'name' => $request->get('name'),
|
|
]);
|
|
|
|
return redirect($page->getUrl('/edit'));
|
|
}
|
|
|
|
/**
|
|
* Show form to continue editing a draft page.
|
|
*
|
|
* @throws NotFoundException
|
|
*/
|
|
public function editDraft(Request $request, string $bookSlug, int $pageId)
|
|
{
|
|
$draft = $this->queries->findVisibleByIdOrFail($pageId);
|
|
$this->checkOwnablePermission('page-create', $draft->getParent());
|
|
|
|
$editorData = new PageEditorData($draft, $this->entityQueries, $request->query('editor', ''));
|
|
$this->setPageTitle(trans('entities.pages_edit_draft'));
|
|
|
|
return view('pages.edit', $editorData->getViewData());
|
|
}
|
|
|
|
/**
|
|
* Store a new page by changing a draft into a page.
|
|
*
|
|
* @throws NotFoundException
|
|
* @throws ValidationException
|
|
*/
|
|
public function store(Request $request, string $bookSlug, int $pageId)
|
|
{
|
|
$this->validate($request, [
|
|
'name' => ['required', 'string', 'max:255'],
|
|
]);
|
|
$draftPage = $this->queries->findVisibleByIdOrFail($pageId);
|
|
$this->checkOwnablePermission('page-create', $draftPage->getParent());
|
|
|
|
$page = $this->pageRepo->publishDraft($draftPage, $request->all());
|
|
|
|
return redirect($page->getUrl());
|
|
}
|
|
|
|
/**
|
|
* Display the specified page.
|
|
* If the page is not found via the slug the revisions are searched for a match.
|
|
*
|
|
* @throws NotFoundException
|
|
*/
|
|
public function show(string $bookSlug, string $pageSlug)
|
|
{
|
|
try {
|
|
$page = $this->queries->findVisibleBySlugsOrFail($bookSlug, $pageSlug);
|
|
} catch (NotFoundException $e) {
|
|
$revision = $this->entityQueries->revisions->findLatestVersionBySlugs($bookSlug, $pageSlug);
|
|
$page = $revision->page ?? null;
|
|
|
|
if (is_null($page)) {
|
|
throw $e;
|
|
}
|
|
|
|
return redirect($page->getUrl());
|
|
}
|
|
|
|
$this->checkOwnablePermission('page-view', $page);
|
|
|
|
$pageContent = (new PageContent($page));
|
|
$page->html = $pageContent->render();
|
|
$pageNav = $pageContent->getNavigation($page->html);
|
|
|
|
$sidebarTree = (new BookContents($page->book))->getTree();
|
|
$commentTree = (new CommentTree($page));
|
|
$nextPreviousLocator = new NextPreviousContentLocator($page, $sidebarTree);
|
|
|
|
View::incrementFor($page);
|
|
$this->setPageTitle($page->getShortName());
|
|
|
|
return view('pages.show', [
|
|
'page' => $page,
|
|
'book' => $page->book,
|
|
'current' => $page,
|
|
'sidebarTree' => $sidebarTree,
|
|
'commentTree' => $commentTree,
|
|
'pageNav' => $pageNav,
|
|
'watchOptions' => new UserEntityWatchOptions(user(), $page),
|
|
'next' => $nextPreviousLocator->getNext(),
|
|
'previous' => $nextPreviousLocator->getPrevious(),
|
|
'referenceCount' => $this->referenceFetcher->getReferenceCountToEntity($page),
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* Get page from an ajax request.
|
|
*
|
|
* @throws NotFoundException
|
|
*/
|
|
public function getPageAjax(int $pageId)
|
|
{
|
|
$page = $this->queries->findVisibleByIdOrFail($pageId);
|
|
$page->setHidden(array_diff($page->getHidden(), ['html', 'markdown']));
|
|
$page->makeHidden(['book']);
|
|
|
|
return response()->json($page);
|
|
}
|
|
|
|
/**
|
|
* Show the form for editing the specified page.
|
|
*
|
|
* @throws NotFoundException
|
|
*/
|
|
public function edit(Request $request, string $bookSlug, string $pageSlug)
|
|
{
|
|
$page = $this->queries->findVisibleBySlugsOrFail($bookSlug, $pageSlug);
|
|
$this->checkOwnablePermission('page-update', $page);
|
|
|
|
$editorData = new PageEditorData($page, $this->entityQueries, $request->query('editor', ''));
|
|
if ($editorData->getWarnings()) {
|
|
$this->showWarningNotification(implode("\n", $editorData->getWarnings()));
|
|
}
|
|
|
|
$this->setPageTitle(trans('entities.pages_editing_named', ['pageName' => $page->getShortName()]));
|
|
|
|
return view('pages.edit', $editorData->getViewData());
|
|
}
|
|
|
|
/**
|
|
* Update the specified page in storage.
|
|
*
|
|
* @throws ValidationException
|
|
* @throws NotFoundException
|
|
*/
|
|
public function update(Request $request, string $bookSlug, string $pageSlug)
|
|
{
|
|
$this->validate($request, [
|
|
'name' => ['required', 'string', 'max:255'],
|
|
]);
|
|
$page = $this->queries->findVisibleBySlugsOrFail($bookSlug, $pageSlug);
|
|
$this->checkOwnablePermission('page-update', $page);
|
|
|
|
$this->pageRepo->update($page, $request->all());
|
|
|
|
return redirect($page->getUrl());
|
|
}
|
|
|
|
/**
|
|
* Save a draft update as a revision.
|
|
*
|
|
* @throws NotFoundException
|
|
*/
|
|
public function saveDraft(Request $request, int $pageId)
|
|
{
|
|
$page = $this->queries->findVisibleByIdOrFail($pageId);
|
|
$this->checkOwnablePermission('page-update', $page);
|
|
|
|
if (!$this->isSignedIn()) {
|
|
return $this->jsonError(trans('errors.guests_cannot_save_drafts'), 500);
|
|
}
|
|
|
|
$draft = $this->pageRepo->updatePageDraft($page, $request->only(['name', 'html', 'markdown']));
|
|
$warnings = (new PageEditActivity($page))->getWarningMessagesForDraft($draft);
|
|
|
|
return response()->json([
|
|
'status' => 'success',
|
|
'message' => trans('entities.pages_edit_draft_save_at'),
|
|
'warning' => implode("\n", $warnings),
|
|
'timestamp' => $draft->updated_at->timestamp,
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* Redirect from a special link url which uses the page id rather than the name.
|
|
*
|
|
* @throws NotFoundException
|
|
*/
|
|
public function redirectFromLink(int $pageId)
|
|
{
|
|
$page = $this->queries->findVisibleByIdOrFail($pageId);
|
|
|
|
return redirect($page->getUrl());
|
|
}
|
|
|
|
/**
|
|
* Show the deletion page for the specified page.
|
|
*
|
|
* @throws NotFoundException
|
|
*/
|
|
public function showDelete(string $bookSlug, string $pageSlug)
|
|
{
|
|
$page = $this->queries->findVisibleBySlugsOrFail($bookSlug, $pageSlug);
|
|
$this->checkOwnablePermission('page-delete', $page);
|
|
$this->setPageTitle(trans('entities.pages_delete_named', ['pageName' => $page->getShortName()]));
|
|
$usedAsTemplate =
|
|
$this->entityQueries->books->start()->where('default_template_id', '=', $page->id)->count() > 0 ||
|
|
$this->entityQueries->chapters->start()->where('default_template_id', '=', $page->id)->count() > 0;
|
|
|
|
return view('pages.delete', [
|
|
'book' => $page->book,
|
|
'page' => $page,
|
|
'current' => $page,
|
|
'usedAsTemplate' => $usedAsTemplate,
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* Show the deletion page for the specified page.
|
|
*
|
|
* @throws NotFoundException
|
|
*/
|
|
public function showDeleteDraft(string $bookSlug, int $pageId)
|
|
{
|
|
$page = $this->queries->findVisibleByIdOrFail($pageId);
|
|
$this->checkOwnablePermission('page-update', $page);
|
|
$this->setPageTitle(trans('entities.pages_delete_draft_named', ['pageName' => $page->getShortName()]));
|
|
$usedAsTemplate =
|
|
$this->entityQueries->books->start()->where('default_template_id', '=', $page->id)->count() > 0 ||
|
|
$this->entityQueries->chapters->start()->where('default_template_id', '=', $page->id)->count() > 0;
|
|
|
|
return view('pages.delete', [
|
|
'book' => $page->book,
|
|
'page' => $page,
|
|
'current' => $page,
|
|
'usedAsTemplate' => $usedAsTemplate,
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* Remove the specified page from storage.
|
|
*
|
|
* @throws NotFoundException
|
|
* @throws Throwable
|
|
*/
|
|
public function destroy(string $bookSlug, string $pageSlug)
|
|
{
|
|
$page = $this->queries->findVisibleBySlugsOrFail($bookSlug, $pageSlug);
|
|
$this->checkOwnablePermission('page-delete', $page);
|
|
$parent = $page->getParent();
|
|
|
|
$this->pageRepo->destroy($page);
|
|
|
|
return redirect($parent->getUrl());
|
|
}
|
|
|
|
/**
|
|
* Remove the specified draft page from storage.
|
|
*
|
|
* @throws NotFoundException
|
|
* @throws Throwable
|
|
*/
|
|
public function destroyDraft(string $bookSlug, int $pageId)
|
|
{
|
|
$page = $this->queries->findVisibleByIdOrFail($pageId);
|
|
$book = $page->book;
|
|
$chapter = $page->chapter;
|
|
$this->checkOwnablePermission('page-update', $page);
|
|
|
|
$this->pageRepo->destroy($page);
|
|
|
|
$this->showSuccessNotification(trans('entities.pages_delete_draft_success'));
|
|
|
|
if ($chapter && userCan('view', $chapter)) {
|
|
return redirect($chapter->getUrl());
|
|
}
|
|
|
|
return redirect($book->getUrl());
|
|
}
|
|
|
|
/**
|
|
* Show a listing of recently created pages.
|
|
*/
|
|
public function showRecentlyUpdated()
|
|
{
|
|
$visibleBelongsScope = function (BelongsTo $query) {
|
|
$query->scopes('visible');
|
|
};
|
|
|
|
$pages = $this->queries->visibleForList()
|
|
->addSelect('updated_by')
|
|
->with(['updatedBy', 'book' => $visibleBelongsScope, 'chapter' => $visibleBelongsScope])
|
|
->orderBy('updated_at', 'desc')
|
|
->paginate(20)
|
|
->setPath(url('/pages/recently-updated'));
|
|
|
|
$this->setPageTitle(trans('entities.recently_updated_pages'));
|
|
|
|
return view('common.detailed-listing-paginated', [
|
|
'title' => trans('entities.recently_updated_pages'),
|
|
'entities' => $pages,
|
|
'showUpdatedBy' => true,
|
|
'showPath' => true,
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* Show the view to choose a new parent to move a page into.
|
|
*
|
|
* @throws NotFoundException
|
|
*/
|
|
public function showMove(string $bookSlug, string $pageSlug)
|
|
{
|
|
$page = $this->queries->findVisibleBySlugsOrFail($bookSlug, $pageSlug);
|
|
$this->checkOwnablePermission('page-update', $page);
|
|
$this->checkOwnablePermission('page-delete', $page);
|
|
|
|
return view('pages.move', [
|
|
'book' => $page->book,
|
|
'page' => $page,
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* Does the action of moving the location of a page.
|
|
*
|
|
* @throws NotFoundException
|
|
* @throws Throwable
|
|
*/
|
|
public function move(Request $request, string $bookSlug, string $pageSlug)
|
|
{
|
|
$page = $this->queries->findVisibleBySlugsOrFail($bookSlug, $pageSlug);
|
|
$this->checkOwnablePermission('page-update', $page);
|
|
$this->checkOwnablePermission('page-delete', $page);
|
|
|
|
$entitySelection = $request->get('entity_selection', null);
|
|
if ($entitySelection === null || $entitySelection === '') {
|
|
return redirect($page->getUrl());
|
|
}
|
|
|
|
try {
|
|
$this->pageRepo->move($page, $entitySelection);
|
|
} catch (PermissionsException $exception) {
|
|
$this->showPermissionError();
|
|
} catch (Exception $exception) {
|
|
$this->showErrorNotification(trans('errors.selected_book_chapter_not_found'));
|
|
|
|
return redirect($page->getUrl('/move'));
|
|
}
|
|
|
|
return redirect($page->getUrl());
|
|
}
|
|
|
|
/**
|
|
* Show the view to copy a page.
|
|
*
|
|
* @throws NotFoundException
|
|
*/
|
|
public function showCopy(string $bookSlug, string $pageSlug)
|
|
{
|
|
$page = $this->queries->findVisibleBySlugsOrFail($bookSlug, $pageSlug);
|
|
$this->checkOwnablePermission('page-view', $page);
|
|
session()->flashInput(['name' => $page->name]);
|
|
|
|
return view('pages.copy', [
|
|
'book' => $page->book,
|
|
'page' => $page,
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* Create a copy of a page within the requested target destination.
|
|
*
|
|
* @throws NotFoundException
|
|
* @throws Throwable
|
|
*/
|
|
public function copy(Request $request, Cloner $cloner, string $bookSlug, string $pageSlug)
|
|
{
|
|
$page = $this->queries->findVisibleBySlugsOrFail($bookSlug, $pageSlug);
|
|
$this->checkOwnablePermission('page-view', $page);
|
|
|
|
$entitySelection = $request->get('entity_selection') ?: null;
|
|
$newParent = $entitySelection ? $this->entityQueries->findVisibleByStringIdentifier($entitySelection) : $page->getParent();
|
|
|
|
if (!$newParent instanceof Book && !$newParent instanceof Chapter) {
|
|
$this->showErrorNotification(trans('errors.selected_book_chapter_not_found'));
|
|
|
|
return redirect($page->getUrl('/copy'));
|
|
}
|
|
|
|
$this->checkOwnablePermission('page-create', $newParent);
|
|
|
|
$newName = $request->get('name') ?: $page->name;
|
|
$pageCopy = $cloner->clonePage($page, $newParent, $newName);
|
|
$this->showSuccessNotification(trans('entities.pages_copy_success'));
|
|
|
|
return redirect($pageCopy->getUrl());
|
|
}
|
|
}
|