87 lines
2.5 KiB
PHP
87 lines
2.5 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace App\Models;
|
|
|
|
use Illuminate\Database\Eloquent\Model;
|
|
use Illuminate\Database\Eloquent\Relations\BelongsToMany;
|
|
|
|
/**
|
|
* App\Models\Tag.
|
|
*
|
|
* @property int $id
|
|
* @property string $tag
|
|
* @property \Illuminate\Support\Carbon|null $created_at
|
|
* @property \Illuminate\Support\Carbon|null $updated_at
|
|
* @property-read \Illuminate\Database\Eloquent\Collection|\App\Models\Bookmark[] $bookmarks
|
|
* @property-read int|null $bookmarks_count
|
|
* @property-read \Illuminate\Database\Eloquent\Collection|\App\Models\Note[] $notes
|
|
* @property-read int|null $notes_count
|
|
* @method static \Illuminate\Database\Eloquent\Builder|\App\Models\Tag newModelQuery()
|
|
* @method static \Illuminate\Database\Eloquent\Builder|\App\Models\Tag newQuery()
|
|
* @method static \Illuminate\Database\Eloquent\Builder|\App\Models\Tag query()
|
|
* @method static \Illuminate\Database\Eloquent\Builder|\App\Models\Tag whereCreatedAt($value)
|
|
* @method static \Illuminate\Database\Eloquent\Builder|\App\Models\Tag whereId($value)
|
|
* @method static \Illuminate\Database\Eloquent\Builder|\App\Models\Tag whereTag($value)
|
|
* @method static \Illuminate\Database\Eloquent\Builder|\App\Models\Tag whereUpdatedAt($value)
|
|
* @mixin \Eloquent
|
|
*/
|
|
class Tag extends Model
|
|
{
|
|
/**
|
|
* We shall set a blacklist of non-modifiable model attributes.
|
|
*
|
|
* @var array
|
|
*/
|
|
protected $guarded = ['id'];
|
|
|
|
/**
|
|
* Define the relationship with notes.
|
|
*
|
|
* @return BelongsToMany
|
|
*/
|
|
public function notes()
|
|
{
|
|
return $this->belongsToMany('App\Models\Note');
|
|
}
|
|
|
|
/**
|
|
* The bookmarks that belong to the tag.
|
|
*
|
|
* @return BelongsToMany
|
|
*/
|
|
public function bookmarks()
|
|
{
|
|
return $this->belongsToMany('App\Models\Bookmark');
|
|
}
|
|
|
|
/**
|
|
* When creating a Tag model instance, invoke the nomralize method on the tag.
|
|
*
|
|
* @param string $value
|
|
*/
|
|
public function setTagAttribute(string $value)
|
|
{
|
|
$this->attributes['tag'] = $this->normalize($value);
|
|
}
|
|
|
|
/**
|
|
* This method actually normalizes a tag. That means lowercase-ing and
|
|
* removing fancy diatric characters.
|
|
*
|
|
* @param string $tag
|
|
* @return string
|
|
*/
|
|
public static function normalize(string $tag): string
|
|
{
|
|
return mb_strtolower(
|
|
preg_replace(
|
|
'/&([a-z]{1,2})(acute|cedil|circ|grave|lig|orn|ring|slash|th|tilde|uml|caron);/i',
|
|
'$1',
|
|
htmlentities($tag)
|
|
),
|
|
'UTF-8'
|
|
);
|
|
}
|
|
}
|