2020-11-21 19:17:45 -05:00
|
|
|
<?php namespace BookStack\Entities\Models;
|
2015-07-27 15:17:08 -04:00
|
|
|
|
2019-10-05 07:55:01 -04:00
|
|
|
use Illuminate\Support\Collection;
|
2019-09-19 19:18:28 -04:00
|
|
|
|
2019-10-05 07:55:01 -04:00
|
|
|
/**
|
|
|
|
* Class Chapter
|
|
|
|
* @property Collection<Page> $pages
|
|
|
|
*/
|
2019-09-19 19:18:28 -04:00
|
|
|
class Chapter extends BookChild
|
2015-07-27 15:17:08 -04:00
|
|
|
{
|
2018-03-24 14:46:31 -04:00
|
|
|
public $searchFactor = 1.3;
|
|
|
|
|
2015-07-27 15:17:08 -04:00
|
|
|
protected $fillable = ['name', 'description', 'priority', 'book_id'];
|
2020-11-28 10:21:54 -05:00
|
|
|
protected $hidden = ['restricted', 'pivot', 'deleted_at'];
|
2015-07-27 15:17:08 -04:00
|
|
|
|
2016-05-01 16:20:50 -04:00
|
|
|
/**
|
|
|
|
* Get the pages that this chapter contains.
|
2017-01-02 06:07:27 -05:00
|
|
|
* @param string $dir
|
2016-05-01 16:20:50 -04:00
|
|
|
* @return mixed
|
|
|
|
*/
|
2017-01-02 06:07:27 -05:00
|
|
|
public function pages($dir = 'ASC')
|
2015-07-27 15:17:08 -04:00
|
|
|
{
|
2017-01-02 06:07:27 -05:00
|
|
|
return $this->hasMany(Page::class)->orderBy('priority', $dir);
|
2015-07-27 15:17:08 -04:00
|
|
|
}
|
|
|
|
|
2016-05-01 16:20:50 -04:00
|
|
|
/**
|
|
|
|
* Get the url of this chapter.
|
|
|
|
*/
|
2020-11-21 20:20:38 -05:00
|
|
|
public function getUrl($path = ''): string
|
2015-07-27 15:17:08 -04:00
|
|
|
{
|
2020-11-21 20:20:38 -05:00
|
|
|
$parts = [
|
|
|
|
'books',
|
|
|
|
urlencode($this->getAttribute('bookSlug') ?? $this->book->slug),
|
|
|
|
'chapter',
|
|
|
|
urlencode($this->slug),
|
|
|
|
trim($path, '/'),
|
|
|
|
];
|
|
|
|
|
|
|
|
return url('/' . implode('/', $parts));
|
2015-07-30 17:27:35 -04:00
|
|
|
}
|
|
|
|
|
2017-03-19 08:48:44 -04:00
|
|
|
/**
|
2019-10-05 07:55:01 -04:00
|
|
|
* Check if this chapter has any child pages.
|
|
|
|
* @return bool
|
2017-03-19 08:48:44 -04:00
|
|
|
*/
|
2019-10-05 07:55:01 -04:00
|
|
|
public function hasChildren()
|
2017-03-19 08:48:44 -04:00
|
|
|
{
|
2019-10-05 07:55:01 -04:00
|
|
|
return count($this->pages) > 0;
|
2017-03-19 08:48:44 -04:00
|
|
|
}
|
2019-03-17 11:07:03 -04:00
|
|
|
|
|
|
|
/**
|
2019-10-05 07:55:01 -04:00
|
|
|
* Get the visible pages in this chapter.
|
2019-03-17 11:07:03 -04:00
|
|
|
*/
|
2019-10-05 07:55:01 -04:00
|
|
|
public function getVisiblePages(): Collection
|
2019-03-17 11:07:03 -04:00
|
|
|
{
|
2019-10-05 07:55:01 -04:00
|
|
|
return $this->pages()->visible()
|
|
|
|
->orderBy('draft', 'desc')
|
|
|
|
->orderBy('priority', 'asc')
|
|
|
|
->get();
|
2019-03-17 11:07:03 -04:00
|
|
|
}
|
2015-07-27 15:17:08 -04:00
|
|
|
}
|