Added a "skip to content" link.

[bookstack] / app / Http / Controllers / Api / PageApiController.php

diff --git a/app/Http/Controllers/Api/PageApiController.php b/app/Http/Controllers/Api/PageApiController.php
index 2fc4e3b36d3f246b4364b04a409c95626680ae44..fd4a16effeb56dce464f9ebeef2a427eb6ecce3e 100644 (file)
--- a/app/Http/Controllers/Api/PageApiController.php
+++ b/app/Http/Controllers/Api/PageApiController.php
@@ -16,8 +16,8 @@ class PageApiController extends ApiController
 
     protected $rules = [
         'create' => [
 
     protected $rules = [
         'create' => [

-            'book_id' => 'required_unless:chapter_id|integer',
-            'chapter_id' => 'required_unless:book_id|integer',
+            'book_id' => 'required_without:chapter_id|integer',
+            'chapter_id' => 'required_without:book_id|integer',

             'name' => 'required|string|max:255',
             'html' => 'required_without:markdown|string',
             'markdown' => 'required_without:html|string',
             'name' => 'required|string|max:255',
             'html' => 'required_without:markdown|string',
             'markdown' => 'required_without:html|string',


@@ -47,12 +47,21 @@ class PageApiController extends ApiController
         return $this->apiListingResponse($pages, [
             'id', 'book_id', 'chapter_id', 'name', 'slug', 'priority',
             'draft', 'template',
         return $this->apiListingResponse($pages, [
             'id', 'book_id', 'chapter_id', 'name', 'slug', 'priority',
             'draft', 'template',

-            'created_at', 'updated_at', 'created_by', 'updated_by',
+            'created_at', 'updated_at',
+            'created_by', 'updated_by', 'owned_by',

         ]);
     }
 
     /**
      * Create a new page in the system.
         ]);
     }
 
     /**
      * Create a new page in the system.

+     *
+     * The ID of a parent book or chapter is required to indicate
+     * where this page should be located.
+     *
+     * Any HTML content provided should be kept to a single-block depth of plain HTML
+     * elements to remain compatible with the BookStack front-end and editors.
+     * Any images included via base64 data URIs will be extracted and saved as gallery
+     * images against the page during upload.

      */
     public function create(Request $request)
     {
      */
     public function create(Request $request)
     {


@@ -68,20 +77,27 @@ class PageApiController extends ApiController
         $draft = $this->pageRepo->getNewDraftPage($parent);
         $this->pageRepo->publishDraft($draft, $request->only(array_keys($this->rules['create'])));
 
         $draft = $this->pageRepo->getNewDraftPage($parent);
         $this->pageRepo->publishDraft($draft, $request->only(array_keys($this->rules['create'])));
 

-        return response()->json($draft->load(['tags']));
+        return response()->json($draft->forJsonDisplay());

     }
 
     /**
      * View the details of a single page.
     }
 
     /**
      * View the details of a single page.

+     *
+     * Pages will always have HTML content. They may have markdown content
+     * if the markdown editor was used to last update the page.

      */
     public function read(string $id)
     {
      */
     public function read(string $id)
     {

-        $page = $this->pageRepo->getById($id, ['tags', 'createdBy', 'updatedBy']);
-        return response()->json($page);
+        $page = $this->pageRepo->getById($id, []);
+        return response()->json($page->forJsonDisplay());

     }
 
     /**
      * Update the details of a single page.
     }
 
     /**
      * Update the details of a single page.

+     *
+     * See the 'create' action for details on the provided HTML/Markdown.
+     * Providing a 'book_id' or 'chapter_id' property will essentially move
+     * the page into that parent element if you have permissions to do so.

      */
     public function update(Request $request, string $id)
     {
      */
     public function update(Request $request, string $id)
     {


@@ -109,11 +125,12 @@ class PageApiController extends ApiController
         }
 
         $updatedPage = $this->pageRepo->update($page, $request->all());
         }
 
         $updatedPage = $this->pageRepo->update($page, $request->all());

-        return response()->json($updatedPage->load(['tags']));
+        return response()->json($updatedPage->forJsonDisplay());

     }
 
     /**
     }
 
     /**

-     * Delete a page from the system.
+     * Delete a page.
+     * This will typically send the page to the recycle bin.

      */
     public function delete(string $id)
     {
      */
     public function delete(string $id)
     {