datatable.directory codebase
https://datatable.directory/
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
137 lines
3.5 KiB
137 lines
3.5 KiB
<?php
|
|
|
|
namespace App\Models;
|
|
|
|
use App\Models\Concerns\Reportable;
|
|
use Illuminate\Database\Eloquent\Builder;
|
|
use Illuminate\Database\Eloquent\Collection;
|
|
use Illuminate\Database\Eloquent\Model;
|
|
|
|
/**
|
|
* 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 int $visits
|
|
* @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 = [];
|
|
|
|
protected $touches = ['owner'];
|
|
|
|
public function countVisit()
|
|
{
|
|
// Temporarily disable timestamps to avoid touching updated_at
|
|
$oldt = $this->touches;
|
|
$this->touches = [];
|
|
$this->timestamps = false;
|
|
|
|
$this->increment('visits');
|
|
|
|
$this->timestamps = true;
|
|
$this->touches = $oldt;
|
|
}
|
|
|
|
/** 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');
|
|
}
|
|
|
|
/**
|
|
* Relation to the pivot table, for favourite counting
|
|
*/
|
|
public function favourites()
|
|
{
|
|
return $this->hasMany(TableFavouritePivot::class);
|
|
}
|
|
|
|
/** 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);
|
|
}
|
|
|
|
public function scopeForList(Builder $query)
|
|
{
|
|
return $query->with('revision:id,row_count')->withCount(['favourites', 'forks', 'revisions']);
|
|
}
|
|
}
|
|
|