2021-06-26 17:23:15 +02:00
|
|
|
<?php
|
|
|
|
|
|
|
|
namespace BookStack\Entities\Models;
|
2015-07-27 21:17:08 +02:00
|
|
|
|
2024-01-01 21:58:49 +01:00
|
|
|
use Illuminate\Database\Eloquent\Relations\BelongsTo;
|
2021-10-30 22:29:59 +02:00
|
|
|
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
2021-11-06 01:32:01 +01:00
|
|
|
use Illuminate\Database\Eloquent\Relations\HasMany;
|
2019-10-05 13:55:01 +02:00
|
|
|
use Illuminate\Support\Collection;
|
2019-09-20 01:18:28 +02:00
|
|
|
|
2019-10-05 13:55:01 +02:00
|
|
|
/**
|
2021-06-26 17:23:15 +02:00
|
|
|
* Class Chapter.
|
|
|
|
*
|
2019-10-05 13:55:01 +02:00
|
|
|
* @property Collection<Page> $pages
|
2024-01-01 21:58:49 +01:00
|
|
|
* @property ?int $default_template_id
|
|
|
|
* @property ?Page $defaultTemplate
|
2019-10-05 13:55:01 +02:00
|
|
|
*/
|
2019-09-20 01:18:28 +02:00
|
|
|
class Chapter extends BookChild
|
2015-07-27 21:17:08 +02:00
|
|
|
{
|
2021-10-30 22:29:59 +02:00
|
|
|
use HasFactory;
|
2023-12-17 16:02:15 +01:00
|
|
|
use HasHtmlDescription;
|
2021-10-30 22:29:59 +02:00
|
|
|
|
2023-12-18 17:23:40 +01:00
|
|
|
public float $searchFactor = 1.2;
|
2018-03-24 19:46:31 +01:00
|
|
|
|
2021-12-19 16:40:52 +01:00
|
|
|
protected $fillable = ['name', 'description', 'priority'];
|
2023-12-21 14:23:52 +01:00
|
|
|
protected $hidden = ['pivot', 'deleted_at', 'description_html'];
|
2015-07-27 21:17:08 +02:00
|
|
|
|
2016-05-01 22:20:50 +02:00
|
|
|
/**
|
|
|
|
* Get the pages that this chapter contains.
|
2021-11-23 21:41:12 +01:00
|
|
|
*
|
2021-11-23 00:33:55 +01:00
|
|
|
* @return HasMany<Page>
|
2016-05-01 22:20:50 +02:00
|
|
|
*/
|
2021-11-06 01:32:01 +01:00
|
|
|
public function pages(string $dir = 'ASC'): HasMany
|
2015-07-27 21:17:08 +02:00
|
|
|
{
|
2017-01-02 12:07:27 +01:00
|
|
|
return $this->hasMany(Page::class)->orderBy('priority', $dir);
|
2015-07-27 21:17:08 +02:00
|
|
|
}
|
|
|
|
|
2016-05-01 22:20:50 +02:00
|
|
|
/**
|
|
|
|
* Get the url of this chapter.
|
|
|
|
*/
|
2021-11-06 01:32:01 +01:00
|
|
|
public function getUrl(string $path = ''): string
|
2015-07-27 21:17:08 +02:00
|
|
|
{
|
2020-11-22 02:20:38 +01:00
|
|
|
$parts = [
|
|
|
|
'books',
|
2021-08-21 20:58:19 +02:00
|
|
|
urlencode($this->book_slug ?? $this->book->slug),
|
2020-11-22 02:20:38 +01:00
|
|
|
'chapter',
|
|
|
|
urlencode($this->slug),
|
|
|
|
trim($path, '/'),
|
|
|
|
];
|
|
|
|
|
|
|
|
return url('/' . implode('/', $parts));
|
2015-07-30 23:27:35 +02:00
|
|
|
}
|
|
|
|
|
2024-01-01 21:58:49 +01:00
|
|
|
/**
|
|
|
|
* Get the Page that is used as default template for newly created pages within this Chapter.
|
|
|
|
*/
|
|
|
|
public function defaultTemplate(): BelongsTo
|
|
|
|
{
|
|
|
|
return $this->belongsTo(Page::class, 'default_template_id');
|
|
|
|
}
|
|
|
|
|
2019-03-17 16:07:03 +01:00
|
|
|
/**
|
2019-10-05 13:55:01 +02:00
|
|
|
* Get the visible pages in this chapter.
|
2019-03-17 16:07:03 +01:00
|
|
|
*/
|
2019-10-05 13:55:01 +02:00
|
|
|
public function getVisiblePages(): Collection
|
2019-03-17 16:07:03 +01:00
|
|
|
{
|
2021-11-23 00:33:55 +01:00
|
|
|
return $this->pages()
|
|
|
|
->scopes('visible')
|
2019-10-05 13:55:01 +02:00
|
|
|
->orderBy('draft', 'desc')
|
|
|
|
->orderBy('priority', 'asc')
|
|
|
|
->get();
|
2019-03-17 16:07:03 +01:00
|
|
|
}
|
2015-07-27 21:17:08 +02:00
|
|
|
}
|