mirror of
https://github.com/BookStackApp/BookStack.git
synced 2024-08-28 21:22:30 +00:00
71 lines
1.7 KiB
PHP
71 lines
1.7 KiB
PHP
<?php
|
|
|
|
namespace BookStack\Entities\Models;
|
|
|
|
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
|
use Illuminate\Database\Eloquent\Relations\HasMany;
|
|
use Illuminate\Support\Collection;
|
|
|
|
/**
|
|
* Class Chapter.
|
|
*
|
|
* @property Collection<Page> $pages
|
|
* @property string $description
|
|
*/
|
|
class Chapter extends BookChild
|
|
{
|
|
use HasFactory;
|
|
|
|
public $searchFactor = 1.2;
|
|
|
|
protected $fillable = ['name', 'description', 'priority'];
|
|
protected $hidden = ['restricted', 'pivot', 'deleted_at'];
|
|
|
|
/**
|
|
* Get the pages that this chapter contains.
|
|
*
|
|
* @return HasMany<Page>
|
|
*/
|
|
public function pages(string $dir = 'ASC'): HasMany
|
|
{
|
|
return $this->hasMany(Page::class)->orderBy('priority', $dir);
|
|
}
|
|
|
|
/**
|
|
* Get the url of this chapter.
|
|
*/
|
|
public function getUrl(string $path = ''): string
|
|
{
|
|
$parts = [
|
|
'books',
|
|
urlencode($this->book_slug ?? $this->book->slug),
|
|
'chapter',
|
|
urlencode($this->slug),
|
|
trim($path, '/'),
|
|
];
|
|
|
|
return url('/' . implode('/', $parts));
|
|
}
|
|
|
|
/**
|
|
* Get the visible pages in this chapter.
|
|
*/
|
|
public function getVisiblePages(): Collection
|
|
{
|
|
return $this->pages()
|
|
->scopes('visible')
|
|
->orderBy('draft', 'desc')
|
|
->orderBy('priority', 'asc')
|
|
->get();
|
|
}
|
|
|
|
/**
|
|
* Get a visible chapter by its book and page slugs.
|
|
* @throws \Illuminate\Database\Eloquent\ModelNotFoundException
|
|
*/
|
|
public static function getBySlugs(string $bookSlug, string $chapterSlug): self
|
|
{
|
|
return static::visible()->whereSlugs($bookSlug, $chapterSlug)->firstOrFail();
|
|
}
|
|
}
|