|
|
|
<?php
|
|
|
|
|
|
|
|
namespace App\Models;
|
|
|
|
|
|
|
|
use App\Models\Concerns\ManyManyThrough;
|
|
|
|
use App\Models\Concerns\Reportable;
|
|
|
|
use Illuminate\Database\Eloquent\Collection;
|
|
|
|
use Illuminate\Database\Eloquent\Model;
|
|
|
|
use Riesjart\Relaquent\Model\Concerns\HasRelaquentRelationships;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* A data table object (referencing revisions)
|
|
|
|
*
|
|
|
|
* @property int $id
|
|
|
|
* @property \Carbon\Carbon $created_at
|
|
|
|
* @property \Carbon\Carbon $updated_at
|
|
|
|
* @property int $owner_id
|
|
|
|
* @property int $ancestor_id
|
|
|
|
* @property int $revision_id
|
|
|
|
* @property string $name
|
|
|
|
* @property string $title
|
|
|
|
* @property string $description
|
|
|
|
* @property string $license
|
|
|
|
* @property string $origin
|
|
|
|
* @property-read string $viewPage
|
|
|
|
* @property-read User $owner
|
|
|
|
* @property-read Table $parentTable
|
|
|
|
* @property-read Table[]|Collection $forks
|
|
|
|
* @property-read Revision[]|Collection $revisions
|
|
|
|
* @property-read Revision $revision
|
|
|
|
* @property-read Proposal[]|Collection $proposal
|
|
|
|
* @property-read TableComment[]|Collection $comments
|
|
|
|
* @property-read User[]|Collection $favouritingUsers
|
|
|
|
* @property-read User[]|Collection $discussionFollowers
|
|
|
|
*/
|
|
|
|
class Table extends Model
|
|
|
|
{
|
|
|
|
use Reportable;
|
|
|
|
protected $guarded = [];
|
|
|
|
|
|
|
|
/** Get owner from the instance cache (use when building table lists) */
|
|
|
|
public function cachedOwner()
|
|
|
|
{
|
|
|
|
return User::getCached($this->owner_id);
|
|
|
|
}
|
|
|
|
|
|
|
|
/** Owning user */
|
|
|
|
public function owner()
|
|
|
|
{
|
|
|
|
return $this->belongsTo(User::class, 'owner_id');
|
|
|
|
}
|
|
|
|
|
|
|
|
/** Fork precursor */
|
|
|
|
public function parentTable()
|
|
|
|
{
|
|
|
|
return $this->belongsTo(Table::class, 'ancestor_id');
|
|
|
|
}
|
|
|
|
|
|
|
|
/** Fork descendants */
|
|
|
|
public function forks()
|
|
|
|
{
|
|
|
|
return $this->hasMany(Table::class, 'ancestor_id');
|
|
|
|
}
|
|
|
|
|
|
|
|
/** All related revisions (this may include merged revisions) */
|
|
|
|
public function revisions()
|
|
|
|
{
|
|
|
|
return $this->belongsToMany(Revision::class, 'table_revision_pivot');
|
|
|
|
}
|
|
|
|
|
|
|
|
/** Active revision */
|
|
|
|
public function revision()
|
|
|
|
{
|
|
|
|
return $this->belongsTo(Revision::class, 'revision_id');
|
|
|
|
}
|
|
|
|
|
|
|
|
/** Proposals submitted to this table */
|
|
|
|
public function proposals()
|
|
|
|
{
|
|
|
|
return $this->hasMany(Proposal::class);
|
|
|
|
}
|
|
|
|
|
|
|
|
/** User-submitted comments */
|
|
|
|
public function comments()
|
|
|
|
{
|
|
|
|
return $this->hasMany(TableComment::class);
|
|
|
|
}
|
|
|
|
|
|
|
|
/** Users favouriting this table */
|
|
|
|
public function favouritingUsers()
|
|
|
|
{
|
|
|
|
return $this->belongsToMany(User::class, 'table_favourites');
|
|
|
|
}
|
|
|
|
|
|
|
|
/** Users to notify about comments */
|
|
|
|
public function discussionFollowers()
|
|
|
|
{
|
|
|
|
return $this->belongsToMany(User::class, 'discussion_follows');
|
|
|
|
}
|
|
|
|
|
|
|
|
public function __get($name)
|
|
|
|
{
|
|
|
|
if ($name == 'viewPage') {
|
|
|
|
return route('table.view', ['user' => $this->cachedOwner()->name, 'table' => $this->name]);
|
|
|
|
}
|
|
|
|
|
|
|
|
return parent::__get($name);
|
|
|
|
}
|
|
|
|
}
|