mirror of
https://github.com/BookStackApp/BookStack.git
synced 2024-10-01 01:36:00 -04:00
f99af807d0
- Added testing to cover warning cases. - Refactored logic to be simpler and move much of the business out of the controller. - Added new message that's more suitable to the case this was handling. - For detecting an outdated draft, checked the draft created_at time instead of updated_at to better fit the scenario being checked. - Updated some method types to align with those potentially being used in the logic of the code. - Added a cache of shown messages on the front-end to prevent them re-showing on every save during the session, even if dismissed.
95 lines
2.1 KiB
PHP
95 lines
2.1 KiB
PHP
<?php
|
|
|
|
namespace BookStack\Entities\Models;
|
|
|
|
use BookStack\Auth\User;
|
|
use BookStack\Model;
|
|
use Carbon\Carbon;
|
|
use Illuminate\Database\Eloquent\Relations\BelongsTo;
|
|
|
|
/**
|
|
* Class PageRevision.
|
|
*
|
|
* @property int $page_id
|
|
* @property string $slug
|
|
* @property string $book_slug
|
|
* @property int $created_by
|
|
* @property Carbon $created_at
|
|
* @property Carbon $updated_at
|
|
* @property string $type
|
|
* @property string $summary
|
|
* @property string $markdown
|
|
* @property string $html
|
|
* @property int $revision_number
|
|
* @property Page $page
|
|
*/
|
|
class PageRevision extends Model
|
|
{
|
|
protected $fillable = ['name', 'html', 'text', 'markdown', 'summary'];
|
|
|
|
/**
|
|
* Get the user that created the page revision.
|
|
*/
|
|
public function createdBy(): BelongsTo
|
|
{
|
|
return $this->belongsTo(User::class, 'created_by');
|
|
}
|
|
|
|
/**
|
|
* Get the page this revision originates from.
|
|
*/
|
|
public function page(): BelongsTo
|
|
{
|
|
return $this->belongsTo(Page::class);
|
|
}
|
|
|
|
/**
|
|
* Get the url for this revision.
|
|
*
|
|
* @param null|string $path
|
|
*
|
|
* @return string
|
|
*/
|
|
public function getUrl($path = null)
|
|
{
|
|
$url = $this->page->getUrl() . '/revisions/' . $this->id;
|
|
if ($path) {
|
|
return $url . '/' . trim($path, '/');
|
|
}
|
|
|
|
return $url;
|
|
}
|
|
|
|
/**
|
|
* Get the previous revision for the same page if existing.
|
|
*
|
|
* @return \BookStack\Entities\PageRevision|null
|
|
*/
|
|
public function getPrevious()
|
|
{
|
|
$id = static::newQuery()->where('page_id', '=', $this->page_id)
|
|
->where('id', '<', $this->id)
|
|
->max('id');
|
|
|
|
if ($id) {
|
|
return static::query()->find($id);
|
|
}
|
|
|
|
return null;
|
|
}
|
|
|
|
/**
|
|
* Allows checking of the exact class, Used to check entity type.
|
|
* Included here to align with entities in similar use cases.
|
|
* (Yup, Bit of an awkward hack).
|
|
*
|
|
* @param $type
|
|
*
|
|
* @return bool
|
|
*/
|
|
public static function isA($type)
|
|
{
|
|
return $type === 'revision';
|
|
}
|
|
}
|