Skip to content

Configuration ​

Merge global settings under Tags in the application's configuration. The behavior and Tag helper read these defaults when constructed; per-instance options take precedence.

KeyDefaultEffect
fieldtag_listForm field containing labels
strategystringString or array form output
delimiter,String input delimiter
namespacenullStored default namespace
separatornullNamespace prefix separator
finderFieldnullFinder uses slug unless overridden
andSeparator+AND tag filter separator
orSeparator,OR tag filter separator
tagsCounter['counter']Tag counter-cache configuration
taggedCounter['tag_count']Host counter fields; false disables
fkModelAliasnullPer-collection discriminator; use a unique value for each collection
fkModelFieldfk_modelDiscriminator column
tagsAliasTagsTag association name
taggedAliasTaggedPivot association name
inlineColorEditingfalseParse a trailing @color
colorMapnullReplacement named-color map
slugnullCustom label-to-slug callable

tagsAssoc and taggedAssoc configure the ORM associations. See multiple collections for coordinated aliases and properties. Changes to schema field names need matching table overrides; configuration alone does not rewrite the bundled tables and migrations.

Admin keys are standalone, accessCheck, adminLayout, adminBackUrl and adminBackLabel. See admin access and layout.

Polymorphic.type and Migrations.unsigned_primary_keys are separate application keys used during initial migrations. See installation.

There is no slugBehavior option. Use slug for custom generation. A literal taggedCounter => true is not a field configuration; use a field name, list of names or false.

Released under the MIT License.