Fixed OIDC Logout

[bookstack] / app / Entities / Models / Page.php

diff --git a/app/Entities/Models/Page.php b/app/Entities/Models/Page.php
index 8ad05e7aa7393ee1fcb3dafee9f12bc71a437ffa..7e2c12c2048d94f93745f803a8927942b79ad120 100644 (file)
--- a/app/Entities/Models/Page.php
+++ b/app/Entities/Models/Page.php
@@ -1,56 +1,64 @@
-<?php namespace BookStack\Entities;
+<?php

 
 

+namespace BookStack\Entities\Models;
+
+use BookStack\Entities\Tools\PageContent;
+use BookStack\Permissions\PermissionApplicator;

 use BookStack\Uploads\Attachment;
 use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Collection;
 use BookStack\Uploads\Attachment;
 use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Collection;

+use Illuminate\Database\Eloquent\Factories\HasFactory;

 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;

-use Permissions;
+use Illuminate\Database\Eloquent\Relations\HasOne;

 
 /**
 
 /**

- * Class Page
- * @property int $chapter_id
- * @property string $html
- * @property string $markdown
- * @property string $text
- * @property bool $template
- * @property bool $draft
- * @property int $revision_count
- * @property Chapter $chapter
- * @property Collection $attachments
+ * Class Page.
+ *
+ * @property int          $chapter_id
+ * @property string       $html
+ * @property string       $markdown
+ * @property string       $text
+ * @property bool         $template
+ * @property bool         $draft
+ * @property int          $revision_count
+ * @property string       $editor
+ * @property Chapter      $chapter
+ * @property Collection   $attachments
+ * @property Collection   $revisions
+ * @property PageRevision $currentRevision

  */
 class Page extends BookChild
 {
  */
 class Page extends BookChild
 {

-    protected $fillable = ['name', 'priority', 'markdown'];
+    use HasFactory;
+
+    public static $listAttributes = ['name', 'id', 'slug', 'book_id', 'chapter_id', 'draft', 'template', 'text', 'created_at', 'updated_at', 'priority'];
+    public static $contentAttributes = ['name', 'id', 'slug', 'book_id', 'chapter_id', 'draft', 'template', 'html', 'text', 'created_at', 'updated_at', 'priority'];

 
 

-    protected $simpleAttributes = ['name', 'id', 'slug'];
+    protected $fillable = ['name', 'priority'];

 
     public $textField = 'text';
 
 
     public $textField = 'text';
 

-    protected $hidden = ['html', 'markdown', 'text', 'restricted', 'pivot'];
+    protected $hidden = ['html', 'markdown', 'text', 'pivot', 'deleted_at'];
+
+    protected $casts = [
+        'draft'    => 'boolean',
+        'template' => 'boolean',
+    ];

 
     /**
      * Get the entities that are visible to the current user.
      */
 
     /**
      * Get the entities that are visible to the current user.
      */

-    public function scopeVisible(Builder $query)
+    public function scopeVisible(Builder $query): Builder

     {
     {

-        $query = Permissions::enforceDraftVisiblityOnQuery($query);
-        return parent::scopeVisible($query);
-    }
+        $query = app()->make(PermissionApplicator::class)->restrictDraftsOnPageQuery($query);

 
 

-    /**
-     * Converts this page into a simplified array.
-     * @return mixed
-     */
-    public function toSimpleArray()
-    {
-        $array = array_intersect_key($this->toArray(), array_flip($this->simpleAttributes));
-        $array['url'] = $this->getUrl();
-        return $array;
+        return parent::scopeVisible($query);

     }
 
     /**
      * Get the chapter that this page is in, If applicable.
     }
 
     /**
      * Get the chapter that this page is in, If applicable.

+     *

      * @return BelongsTo
      */
     public function chapter()
      * @return BelongsTo
      */
     public function chapter()


@@ -60,24 +68,47 @@ class Page extends BookChild
 
     /**
      * Check if this page has a chapter.
 
     /**
      * Check if this page has a chapter.

-     * @return bool

      */
      */

-    public function hasChapter()
+    public function hasChapter(): bool

     {
         return $this->chapter()->count() > 0;
     }
 
     /**
      * Get the associated page revisions, ordered by created date.
     {
         return $this->chapter()->count() > 0;
     }
 
     /**
      * Get the associated page revisions, ordered by created date.

-     * @return mixed
+     * Only provides actual saved page revision instances, Not drafts.
+     */
+    public function revisions(): HasMany
+    {
+        return $this->allRevisions()
+            ->where('type', '=', 'version')
+            ->orderBy('created_at', 'desc')
+            ->orderBy('id', 'desc');
+    }
+
+    /**
+     * Get the current revision for the page if existing.
+     */
+    public function currentRevision(): HasOne
+    {
+        return $this->hasOne(PageRevision::class)
+            ->where('type', '=', 'version')
+            ->orderBy('created_at', 'desc')
+            ->orderBy('id', 'desc');
+    }
+
+    /**
+     * Get all revision instances assigned to this page.
+     * Includes all types of revisions.

      */
      */

-    public function revisions()
+    public function allRevisions(): HasMany

     {
     {

-        return $this->hasMany(PageRevision::class)->where('type', '=', 'version')->orderBy('created_at', 'desc')->orderBy('id', 'desc');
+        return $this->hasMany(PageRevision::class);

     }
 
     /**
      * Get the attachments assigned to this page.
     }
 
     /**
      * Get the attachments assigned to this page.

+     *

      * @return HasMany
      */
     public function attachments()
      * @return HasMany
      */
     public function attachments()


@@ -86,30 +117,40 @@ class Page extends BookChild
     }
 
     /**
     }
 
     /**

-     * Get the url for this page.
-     * @param string|bool $path
-     * @return string
+     * Get the url of this page.

      */
      */

-    public function getUrl($path = false)
+    public function getUrl(string $path = ''): string

     {
     {

-        $bookSlug = $this->getAttribute('bookSlug') ? $this->getAttribute('bookSlug') : $this->book->slug;
-        $midText = $this->draft ? '/draft/' : '/page/';
-        $idComponent = $this->draft ? $this->id : urlencode($this->slug);
+        $parts = [
+            'books',
+            urlencode($this->book_slug ?? $this->book->slug),
+            $this->draft ? 'draft' : 'page',
+            $this->draft ? $this->id : urlencode($this->slug),
+            trim($path, '/'),
+        ];
+
+        return url('/' . implode('/', $parts));
+    }

 
 

-        $url = '/books/' . urlencode($bookSlug) . $midText . $idComponent;
-        if ($path !== false) {
-            $url .= '/' . trim($path, '/');
-        }
+    /**
+     * Get this page for JSON display.
+     */
+    public function forJsonDisplay(): self
+    {
+        $refreshed = $this->refresh()->unsetRelations()->load(['tags', 'createdBy', 'updatedBy', 'ownedBy']);
+        $refreshed->setHidden(array_diff($refreshed->getHidden(), ['html', 'markdown']));
+        $refreshed->setAttribute('raw_html', $refreshed->html);
+        $refreshed->html = (new PageContent($refreshed))->render();

 
 

-        return url($url);
+        return $refreshed;

     }
 
     /**
     }
 
     /**

-     * Get the current revision for the page if existing
-     * @return PageRevision|null
+     * Get a visible page by its book and page slugs.
+     * @throws \Illuminate\Database\Eloquent\ModelNotFoundException

      */
      */

-    public function getCurrentRevision()
+    public static function getBySlugs(string $bookSlug, string $pageSlug): self

     {
     {

-        return $this->revisions()->first();
+        return static::visible()->whereSlugs($bookSlug, $pageSlug)->firstOrFail();

     }
 }
     }
 }