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.
 
 
 
 
 
 
datatable.directory/app/Models/Table.php

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']);
}
}