Files
UNIT3D/app/Models/Comment.php
Roardom 725d13b0c4 refactor: remove unused ticket/comment events/listeners/notifications
These aren't currently being used. If this functionality is to be completed, it should be easy enough to find the code through the git history again. However, UNIT3D doesn't really use events and it'd be better for most of the notification sending to be inline (except the stale one of course).
2025-06-10 07:28:34 +00:00

110 lines
2.8 KiB
PHP

<?php
declare(strict_types=1);
/**
* 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\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<\Database\Factories\CommentFactory> */
use HasFactory;
/**
* The attributes that aren't mass assignable.
*
* @var string[]
*/
protected $guarded = [];
/**
* Get the attributes that should be cast.
*
* @return array{anon: 'bool'}
*/
protected function casts(): array
{
return [
'anon' => 'bool',
];
}
/**
* Belongs To A User.
*
* @return \Illuminate\Database\Eloquent\Relations\BelongsTo<User, $this>
*/
public function user(): \Illuminate\Database\Eloquent\Relations\BelongsTo
{
return $this->belongsTo(User::class)->withDefault([
'username' => 'System',
'id' => User::SYSTEM_USER_ID,
]);
}
/**
* @return \Illuminate\Database\Eloquent\Relations\MorphTo<Model, $this>
*/
public function commentable(): \Illuminate\Database\Eloquent\Relations\MorphTo
{
return $this->morphTo();
}
/**
* @return \Illuminate\Database\Eloquent\Relations\HasMany<self, $this>
*/
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');
}
}