Files
UNIT3D-Community-Edition/app/Models/Comment.php
HDVinnie 8a03bec818 add: model docblocks
- this resolves some larastan property issues but in return has revealed quite a few issues with our castings and such. baseline has been regenerated so we can work through them. The properties in docblocks are in order and match everything in DB schema wise.
2024-02-07 16:39:43 -05:00

122 lines
3.4 KiB
PHP

<?php
/**
* NOTICE OF LICENSE.
*
* UNIT3D Community Edition is open-sourced software licensed under the GNU Affero General Public License v3.0
* The details is bundled with this project in the file LICENSE.txt.
*
* @project UNIT3D Community Edition
*
* @author HDVinnie <hdinnovations@protonmail.com>
* @license https://www.gnu.org/licenses/agpl-3.0.en.html/ GNU Affero General Public License v3.0
*/
namespace App\Models;
use App\Events\TicketWentStale;
use App\Helpers\Bbcode;
use App\Helpers\Linkify;
use App\Traits\Auditable;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
/**
* App\Models\Comment.
*
* @property int $id
* @property string $content
* @property int $anon
* @property int|null $user_id
* @property int|null $parent_id
* @property \Illuminate\Support\Carbon|null $created_at
* @property \Illuminate\Support\Carbon|null $updated_at
* @property string $commentable_type
* @property int $commentable_id
*/
class Comment extends Model
{
use Auditable;
use HasFactory;
/**
* The attributes that are mass assignable.
*/
protected $fillable = [
'content',
'user_id',
'anon',
];
/**
* Belongs To A User.
*
* @return \Illuminate\Database\Eloquent\Relations\BelongsTo<User, self>
*/
public function user(): \Illuminate\Database\Eloquent\Relations\BelongsTo
{
return $this->belongsTo(User::class)->withDefault([
'username' => 'System',
'id' => '1',
]);
}
/**
* @return \Illuminate\Database\Eloquent\Relations\MorphTo<Model, Comment>
*/
public function commentable(): \Illuminate\Database\Eloquent\Relations\MorphTo
{
return $this->morphTo();
}
/**
* @return \Illuminate\Database\Eloquent\Relations\HasMany<self>
*/
public function children(): \Illuminate\Database\Eloquent\Relations\HasMany
{
return $this->hasMany(__CLASS__, 'parent_id')->oldest();
}
public function isParent(): bool
{
return null === $this->parent_id;
}
public function isChild(): bool
{
return null !== $this->parent_id;
}
/**
* @param Builder<Comment> $builder
*/
public function scopeParent(Builder $builder): void
{
$builder->whereNull('parent_id');
}
/**
* Parse Content And Return Valid HTML.
*/
public function getContentHtml(): string
{
$bbcode = new Bbcode();
return (new Linkify())->linky($bbcode->parse($this->content));
}
/**
* Nootify Staff There Is Stale Tickets.
*/
public static function checkForStale(Ticket $ticket): void
{
if (empty($ticket->reminded_at) || strtotime((string) $ticket->reminded_at) < strtotime('+ 3 days')) {
$last_comment = $ticket->comments()->latest('id')->first();
if (property_exists($last_comment, 'id') && $last_comment->id !== null && !$last_comment->user->group->is_modo && strtotime((string) $last_comment->created_at) < strtotime('- 3 days')) {
event(new TicketWentStale($last_comment->commentable));
}
}
}
}