You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
pixelfed/app/Models/QuoteAuthorization.php

98 lines
2.4 KiB
PHP

<?php
namespace App\Models;
use App\HasSnowflakePrimary;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
/**
* FEP-044f approval stamp issued by a local author for a remote quote post.
*
* @property-read Profile|null $actor
* @property-read Profile|null $profile
* @property-read Status|null $status
*
* @method static \Illuminate\Database\Eloquent\Builder<static>|QuoteAuthorization approved()
* @method static \Illuminate\Database\Eloquent\Builder<static>|QuoteAuthorization newModelQuery()
* @method static \Illuminate\Database\Eloquent\Builder<static>|QuoteAuthorization newQuery()
* @method static \Illuminate\Database\Eloquent\Builder<static>|QuoteAuthorization query()
* @method static \Illuminate\Database\Eloquent\Builder<static>|QuoteAuthorization revoked()
*
* @mixin \Eloquent
*/
class QuoteAuthorization extends Model
{
use HasSnowflakePrimary;
public const STATE_APPROVED = 'approved';
public const STATE_REVOKED = 'revoked';
public $incrementing = false;
protected $keyType = 'int';
protected $guarded = [];
protected function casts(): array
{
return [
'revoked_at' => 'datetime',
];
}
/**
* The local profile whose post was quoted.
*/
public function profile(): BelongsTo
{
return $this->belongsTo(Profile::class, 'profile_id');
}
/**
* The local post that was quoted.
*/
public function status(): BelongsTo
{
return $this->belongsTo(Status::class, 'status_id');
}
/**
* The remote profile that authored the quote post.
*/
public function actor(): BelongsTo
{
return $this->belongsTo(Profile::class, 'actor_id');
}
public function isApproved(): bool
{
return $this->state === self::STATE_APPROVED;
}
public function isRevoked(): bool
{
return $this->state === self::STATE_REVOKED;
}
/**
* Public URL of the stamp. Must share a host with the quoted author's
* actor id, which remote servers check during verification.
*/
public function permalink(): string
{
return $this->profile->permalink('/quote_authorizations/'.$this->id);
}
public function scopeApproved($query)
{
return $query->where('state', self::STATE_APPROVED);
}
public function scopeRevoked($query)
{
return $query->where('state', self::STATE_REVOKED);
}
}