]> BookStack Code Mirror - bookstack/blobdiff - app/Repos/BookRepo.php
Merge branch 'master' into translations
[bookstack] / app / Repos / BookRepo.php
index 060b6fc49645fd5f9ad191f49c1ee8205a47556d..b14cf0dabc205e24979e911b69df89fc9a000f88 100644 (file)
-<?php namespace Oxbow\Repos;
+<?php namespace BookStack\Repos;
 
-use Oxbow\Book;
+use Alpha\B;
+use BookStack\Exceptions\NotFoundException;
+use Illuminate\Database\Eloquent\Collection;
+use Illuminate\Support\Str;
+use BookStack\Book;
+use Views;
 
-class BookRepo
+class BookRepo extends EntityRepo
 {
-
-    protected $book;
     protected $pageRepo;
+    protected $chapterRepo;
 
     /**
      * BookRepo constructor.
-     * @param Book $book
      * @param PageRepo $pageRepo
+     * @param ChapterRepo $chapterRepo
      */
-    public function __construct(Book $book, PageRepo $pageRepo)
+    public function __construct(PageRepo $pageRepo, ChapterRepo $chapterRepo)
     {
-        $this->book = $book;
         $this->pageRepo = $pageRepo;
+        $this->chapterRepo = $chapterRepo;
+        parent::__construct();
     }
 
+    /**
+     * Base query for getting books.
+     * Takes into account any restrictions.
+     * @return mixed
+     */
+    private function bookQuery()
+    {
+        return $this->permissionService->enforceBookRestrictions($this->book, 'view');
+    }
+
+    /**
+     * Get the book that has the given id.
+     * @param $id
+     * @return mixed
+     */
     public function getById($id)
     {
-        return $this->book->findOrFail($id);
+        return $this->bookQuery()->findOrFail($id);
+    }
+
+    /**
+     * Get all books, Limited by count.
+     * @param int $count
+     * @return mixed
+     */
+    public function getAll($count = 10)
+    {
+        $bookQuery = $this->bookQuery()->orderBy('name', 'asc');
+        if (!$count) return $bookQuery->get();
+        return $bookQuery->take($count)->get();
+    }
+
+    /**
+     * Get all books paginated.
+     * @param int $count
+     * @return mixed
+     */
+    public function getAllPaginated($count = 10)
+    {
+        return $this->bookQuery()
+            ->orderBy('name', 'asc')->paginate($count);
+    }
+
+
+    /**
+     * Get the latest books.
+     * @param int $count
+     * @return mixed
+     */
+    public function getLatest($count = 10)
+    {
+        return $this->bookQuery()->orderBy('created_at', 'desc')->take($count)->get();
     }
 
-    public function getAll()
+    /**
+     * Gets the most recently viewed for a user.
+     * @param int $count
+     * @param int $page
+     * @return mixed
+     */
+    public function getRecentlyViewed($count = 10, $page = 0)
+    {
+        return Views::getUserRecentlyViewed($count, $page, $this->book);
+    }
+
+    /**
+     * Gets the most viewed books.
+     * @param int $count
+     * @param int $page
+     * @return mixed
+     */
+    public function getPopular($count = 10, $page = 0)
     {
-        return $this->book->all();
+        return Views::getPopular($count, $page, $this->book);
     }
 
+    /**
+     * Get a book by slug
+     * @param $slug
+     * @return mixed
+     * @throws NotFoundException
+     */
     public function getBySlug($slug)
     {
-        return $this->book->where('slug', '=', $slug)->first();
+        $book = $this->bookQuery()->where('slug', '=', $slug)->first();
+        if ($book === null) throw new NotFoundException(trans('errors.book_not_found'));
+        return $book;
     }
 
-    public function newFromInput($input)
+    /**
+     * Checks if a book exists.
+     * @param $id
+     * @return bool
+     */
+    public function exists($id)
     {
-        return $this->book->fill($input);
+        return $this->bookQuery()->where('id', '=', $id)->exists();
     }
 
-    public function countBySlug($slug)
+    /**
+     * Get a new book instance from request input.
+     * @param array $input
+     * @return Book
+     */
+    public function createFromInput($input)
     {
-        return $this->book->where('slug', '=', $slug)->count();
+        $book = $this->book->newInstance($input);
+        $book->slug = $this->findSuitableSlug($book->name);
+        $book->created_by = user()->id;
+        $book->updated_by = user()->id;
+        $book->save();
+        $this->permissionService->buildJointPermissionsForEntity($book);
+        return $book;
     }
 
-    public function destroyById($id)
+    /**
+     * Update the given book from user input.
+     * @param Book $book
+     * @param $input
+     * @return Book
+     */
+    public function updateFromInput(Book $book, $input)
     {
-        $book = $this->getById($id);
-        foreach($book->pages as $page) {
-            $this->pageRepo->destroyById($page->id);
+        if ($book->name !== $input['name']) {
+            $book->slug = $this->findSuitableSlug($input['name'], $book->id);
         }
+        $book->fill($input);
+        $book->updated_by = user()->id;
+        $book->save();
+        $this->permissionService->buildJointPermissionsForEntity($book);
+        return $book;
+    }
+
+    /**
+     * Destroy the given book.
+     * @param Book $book
+     * @throws \Exception
+     */
+    public function destroy(Book $book)
+    {
+        foreach ($book->pages as $page) {
+            $this->pageRepo->destroy($page);
+        }
+        foreach ($book->chapters as $chapter) {
+            $this->chapterRepo->destroy($chapter);
+        }
+        $book->views()->delete();
+        $book->permissions()->delete();
+        $this->permissionService->deleteJointPermissionsForEntity($book);
         $book->delete();
     }
 
-    public function getTree($book)
+    /**
+     * Get the next child element priority.
+     * @param Book $book
+     * @return int
+     */
+    public function getNewPriority($book)
+    {
+        $lastElem = $this->getChildren($book)->pop();
+        return $lastElem ? $lastElem->priority + 1 : 0;
+    }
+
+    /**
+     * @param string $slug
+     * @param bool|false $currentId
+     * @return bool
+     */
+    public function doesSlugExist($slug, $currentId = false)
+    {
+        $query = $this->book->where('slug', '=', $slug);
+        if ($currentId) {
+            $query = $query->where('id', '!=', $currentId);
+        }
+        return $query->count() > 0;
+    }
+
+    /**
+     * Provides a suitable slug for the given book name.
+     * Ensures the returned slug is unique in the system.
+     * @param string $name
+     * @param bool|false $currentId
+     * @return string
+     */
+    public function findSuitableSlug($name, $currentId = false)
     {
-        $tree = $book->toArray();
-        $tree['pages'] = $this->pageRepo->getTreeByBookId($book->id);
-        $tree['hasChildren'] = count($tree['pages']) > 0;
-        return $tree;
+        $slug = $this->nameToSlug($name);
+        while ($this->doesSlugExist($slug, $currentId)) {
+            $slug .= '-' . substr(md5(rand(1, 500)), 0, 3);
+        }
+        return $slug;
+    }
+
+    /**
+     * Get all child objects of a book.
+     * Returns a sorted collection of Pages and Chapters.
+     * Loads the book slug onto child elements to prevent access database access for getting the slug.
+     * @param Book $book
+     * @param bool $filterDrafts
+     * @return mixed
+     */
+    public function getChildren(Book $book, $filterDrafts = false)
+    {
+        $pageQuery = $book->pages()->where('chapter_id', '=', 0);
+        $pageQuery = $this->permissionService->enforcePageRestrictions($pageQuery, 'view');
+
+        if ($filterDrafts) {
+            $pageQuery = $pageQuery->where('draft', '=', false);
+        }
+
+        $pages = $pageQuery->get();
+
+        $chapterQuery = $book->chapters()->with(['pages' => function ($query) use ($filterDrafts) {
+            $this->permissionService->enforcePageRestrictions($query, 'view');
+            if ($filterDrafts) $query->where('draft', '=', false);
+        }]);
+        $chapterQuery = $this->permissionService->enforceChapterRestrictions($chapterQuery, 'view');
+        $chapters = $chapterQuery->get();
+        $children = $pages->values();
+        foreach ($chapters as $chapter) {
+            $children->push($chapter);
+        }
+        $bookSlug = $book->slug;
+
+        $children->each(function ($child) use ($bookSlug) {
+            $child->setAttribute('bookSlug', $bookSlug);
+            if ($child->isA('chapter')) {
+                $child->pages->each(function ($page) use ($bookSlug) {
+                    $page->setAttribute('bookSlug', $bookSlug);
+                });
+                $child->pages = $child->pages->sortBy(function ($child, $key) {
+                    $score = $child->priority;
+                    if ($child->draft) $score -= 100;
+                    return $score;
+                });
+            }
+        });
+
+        // Sort items with drafts first then by priority.
+        return $children->sortBy(function ($child, $key) {
+            $score = $child->priority;
+            if ($child->isA('page') && $child->draft) $score -= 100;
+            return $score;
+        });
+    }
+
+    /**
+     * Get books by search term.
+     * @param $term
+     * @param int $count
+     * @param array $paginationAppends
+     * @return mixed
+     */
+    public function getBySearch($term, $count = 20, $paginationAppends = [])
+    {
+        $terms = $this->prepareSearchTerms($term);
+        $bookQuery = $this->permissionService->enforceBookRestrictions($this->book->fullTextSearchQuery(['name', 'description'], $terms));
+        $bookQuery = $this->addAdvancedSearchQueries($bookQuery, $term);
+        $books = $bookQuery->paginate($count)->appends($paginationAppends);
+        $words = join('|', explode(' ', preg_quote(trim($term), '/')));
+        foreach ($books as $book) {
+            //highlight
+            $result = preg_replace('#' . $words . '#iu', "<span class=\"highlight\">\$0</span>", $book->getExcerpt(100));
+            $book->searchSnippet = $result;
+        }
+        return $books;
     }
 
 }
\ No newline at end of file