Adding tags on entities
Your entity needs to implement the
In order for your entity to satisfy this interface it needs to use the following traits:
Tags are organised by namespace. This is used in order to get the tags for a specific namespace on the display of the field. It also creates tags for that namespace if tags need to be created.
By default the
TaggableTrait will use the full namespace of your entity. However, you can specify a nicer / shorter namespace to use by using the static
$entityNamespace property on your entity.
protected static $entityNamespace = 'asgardcms/media';
In your module Service Provider,
boot() method, you now need to add the namespace it's going to use. This can be done using the
And with this, the Tag Module is aware of the new namespace.
By using a custom blade directive you can include the tags field on your views.
The first argument is the namespace to get the tags for.
(optional) Second argument is the entity to fetch the tags for (pre-filling the input if tags are present for given entity).
(optional) Third argument can be a view to use. This will override the default tags view with its input field.
(optional) Fourth and last argument can be a name to use. This will override the default name for the input field.
In your repositories you need to call the
setTags() method to persist the tags on your entity.
And that's all on how to use tags for your entities.
When you delete the entity to which there are tags linked to, you might want to delete the relation between your entity and the tags (the morph relationship). This relationship can be viewed in the
To delete this link when deleting your entity, you can call the following method in your repository, for instance the destroy method:
public function destroy($page)
untag() methods gets no argument, it will remove all links for the entity.