New translations activities.php (Portuguese)

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

diff --git a/app/Http/Controllers/Api/BookApiController.php b/app/Http/Controllers/Api/BookApiController.php
index 1b9bddbb166321d33c7ae4c65dd931f46141365b..15565c361f2ed6f3076a6dae6da92650c27f9901 100644 (file)
--- a/app/Http/Controllers/Api/BookApiController.php
+++ b/app/Http/Controllers/Api/BookApiController.php
@@ -1,30 +1,16 @@
-<?php namespace BookStack\Http\Controllers\Api;
+<?php
+
+namespace BookStack\Http\Controllers\Api;

 
 use BookStack\Entities\Models\Book;
 use BookStack\Entities\Repos\BookRepo;
 
 use BookStack\Entities\Models\Book;
 use BookStack\Entities\Repos\BookRepo;

-use BookStack\Exceptions\NotifyException;
-use Illuminate\Contracts\Container\BindingResolutionException;

 use Illuminate\Http\Request;
 use Illuminate\Validation\ValidationException;
 
 class BookApiController extends ApiController
 {
 use Illuminate\Http\Request;
 use Illuminate\Validation\ValidationException;
 
 class BookApiController extends ApiController
 {

-

     protected $bookRepo;
 
     protected $bookRepo;
 

-    protected $rules = [
-        'create' => [
-            'name' => 'required|string|max:255',
-            'description' => 'string|max:1000',
-            'tags' => 'array',
-        ],
-        'update' => [
-            'name' => 'string|min:1|max:255',
-            'description' => 'string|max:1000',
-            'tags' => 'array',
-        ],
-    ];
-

     public function __construct(BookRepo $bookRepo)
     {
         $this->bookRepo = $bookRepo;
     public function __construct(BookRepo $bookRepo)
     {
         $this->bookRepo = $bookRepo;


@@ -36,21 +22,26 @@ class BookApiController extends ApiController
     public function list()
     {
         $books = Book::visible();
     public function list()
     {
         $books = Book::visible();

+

         return $this->apiListingResponse($books, [
         return $this->apiListingResponse($books, [

-            'id', 'name', 'slug', 'description', 'created_at', 'updated_at', 'created_by', 'updated_by', 'owned_by', 'image_id',
+            'id', 'name', 'slug', 'description', 'created_at', 'updated_at', 'created_by', 'updated_by', 'owned_by',

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

+     * The cover image of a book can be set by sending a file via an 'image' property within a 'multipart/form-data' request.
+     * If the 'image' property is null then the book cover image will be removed.
+     *

      * @throws ValidationException
      */
     public function create(Request $request)
     {
         $this->checkPermission('book-create-all');
      * @throws ValidationException
      */
     public function create(Request $request)
     {
         $this->checkPermission('book-create-all');

-        $requestData = $this->validate($request, $this->rules['create']);
+        $requestData = $this->validate($request, $this->rules()['create']);

 
         $book = $this->bookRepo->create($requestData);
 
         $book = $this->bookRepo->create($requestData);

+

         return response()->json($book);
     }
 
         return response()->json($book);
     }
 


@@ -60,11 +51,15 @@ class BookApiController extends ApiController
     public function read(string $id)
     {
         $book = Book::visible()->with(['tags', 'cover', 'createdBy', 'updatedBy', 'ownedBy'])->findOrFail($id);
     public function read(string $id)
     {
         $book = Book::visible()->with(['tags', 'cover', 'createdBy', 'updatedBy', 'ownedBy'])->findOrFail($id);

+

         return response()->json($book);
     }
 
     /**
      * Update the details of a single book.
         return response()->json($book);
     }
 
     /**
      * Update the details of a single book.

+     * The cover image of a book can be set by sending a file via an 'image' property within a 'multipart/form-data' request.
+     * If the 'image' property is null then the book cover image will be removed.
+     *

      * @throws ValidationException
      */
     public function update(Request $request, string $id)
      * @throws ValidationException
      */
     public function update(Request $request, string $id)


@@ -72,7 +67,7 @@ class BookApiController extends ApiController
         $book = Book::visible()->findOrFail($id);
         $this->checkOwnablePermission('book-update', $book);
 
         $book = Book::visible()->findOrFail($id);
         $this->checkOwnablePermission('book-update', $book);
 

-        $requestData = $this->validate($request, $this->rules['update']);
+        $requestData = $this->validate($request, $this->rules()['update']);

         $book = $this->bookRepo->update($book, $requestData);
 
         return response()->json($book);
         $book = $this->bookRepo->update($book, $requestData);
 
         return response()->json($book);


@@ -81,6 +76,7 @@ class BookApiController extends ApiController
     /**
      * Delete a single book.
      * This will typically send the book to the recycle bin.
     /**
      * Delete a single book.
      * This will typically send the book to the recycle bin.

+     *

      * @throws \Exception
      */
     public function delete(string $id)
      * @throws \Exception
      */
     public function delete(string $id)


@@ -89,6 +85,25 @@ class BookApiController extends ApiController
         $this->checkOwnablePermission('book-delete', $book);
 
         $this->bookRepo->destroy($book);
         $this->checkOwnablePermission('book-delete', $book);
 
         $this->bookRepo->destroy($book);

+

         return response('', 204);
     }
         return response('', 204);
     }

-}
\ No newline at end of file
+
+    protected function rules(): array
+    {
+        return [
+            'create' => [
+                'name'        => ['required', 'string', 'max:255'],
+                'description' => ['string', 'max:1000'],
+                'tags'        => ['array'],
+                'image'       => array_merge(['nullable'], $this->getImageValidationRules()),
+            ],
+            'update' => [
+                'name'        => ['string', 'min:1', 'max:255'],
+                'description' => ['string', 'max:1000'],
+                'tags'        => ['array'],
+                'image'       => array_merge(['nullable'], $this->getImageValidationRules()),
+            ],
+        ];
+    }
+}