Weave Code
Tags Laravel Package
capell-app/tags
Laravel tagging package for Capell applications. Add reusable tags to any model via polymorphic relationships, manage tag records, and filter or search tagged content. Ideal for organizing articles, pages, and other Capell resources with a flexible, lightweight tagging layer.
Shared multilingual tagging and taxonomy for Capell content packages.
Frequently asked questions about Tags
- How do I install capell-app/tags in a Laravel application?
- Install the package with Composer using composer require capell-app/tags, then run your database migrations so the tag tables are created. Review the package README for any publishable configuration or migration steps. Once installed, you can start attaching tags to models through the package's polymorphic relationship.
- Can I tag any Eloquent model, or only Capell resources?
- You can tag any Eloquent model because tagging is implemented with polymorphic relationships rather than being limited to one model type. That makes the package usable for articles, pages, and other Capell resources as well as your own application models. Capell resources get the added benefit of seamless integration.
- How do I filter records by one or more tags?
- The package provides query scopes for filtering content by a single tag or multiple tags. You apply the scope to your Eloquent query, so tagged models can be retrieved with the same fluent syntax you use elsewhere in Laravel. This keeps tag-based filtering logic out of your controllers and models.
- How do I attach or detach tags from a model?
- Sync helpers are included for attaching and detaching tags, so you can update a model's tags in one call. This is useful when saving forms where editors choose a set of tags. You can also work with the underlying polymorphic relationship directly if you need finer control.
- Do tags have slugs and extra metadata?
- Yes. Tags are reusable entities that carry slugs and metadata, so the same tag record can be shared across many models. Slugs give you stable identifiers for URLs and lookups, while metadata lets you store additional details on the tag itself.
- Is capell-app/tags only for Capell, or can I use it in a standard Laravel app?
- It is built for Laravel applications and the Capell ecosystem, and its core tagging features work through standard Eloquent polymorphic relationships. That means a regular Laravel app can use it for organizing content without adopting the rest of Capell. Capell users additionally get resource integration.
- Which Laravel versions does this package support?
- Support depends on the package's Composer constraints and its release history. Check the composer.json file and the repository README for the currently supported PHP and Laravel versions before installing. Pinning to a tagged release that matches your application's Laravel version is the safest approach.
- How can I test tagging in my Laravel test suite?
- Use Laravel's database testing tools, such as RefreshDatabase, and attach tags to a model in your test before asserting the relationship or query scope results. Because tags are polymorphic, you can test tagging on a small representative model. Keep assertions focused on attached tag slugs or IDs and on the filtered query output.
- Is capell-app/tags actively maintained and safe for production?
- Review the GitHub repository for recent commits, tagged releases, and open issues to judge maintenance activity. Because tagging is a lightweight layer over Eloquent relationships, it is straightforward to audit and test in your own application. Pin a specific version in composer.json so updates are deliberate.
- What alternatives exist for tagging in Laravel?
- Widely used options include spatie/laravel-tags and custom polymorphic tag tables. capell-app/tags is a good fit when you want reusable tag entities with slugs and metadata plus clean query scopes, especially in Capell projects. Compare migration structure and query API against your needs before choosing.
Weaver
How can I help you explore Laravel packages today?