Download the PHP package numero2/contao-tags without Composer
On this page you can find all versions of the php package numero2/contao-tags. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package contao-tags
Contao Tags
About
Adds the possibility to assign tags to individual elements.
System requirements
Installation & Configuration
- Install via Contao Manager or Composer (
composer require numero2/contao-tags)
News
-
Add the following code snippet into your
news_(full|latest|short|simple).html5template -
Configure your
NewslistorNewsreaderfront end modules and set aRedirect page for tags(optional) - Additionally add the
News Tag Cloudmodule anywhere on your page
Events
-
Add the following code snippet into your
event_(full|list|teaser|upcoming).html5template⚠️ Note: Contao does not provide any Hooks for the Eventreader module, therefore we need to add some logic at the beginning of our template to parse the Tags correctly.
-
Configure your
EventlistorEventreaderfront end modules and set aRedirect page for tags(optional) - Additionally add the
Events Tag Cloudmodule anywhere on your page
Insert-Tags
This extensions comes with a couple of Insert-Tags that can be used to link to a page which will only show entries with matching tags.
| Insert-Tag | Description |
|---|---|
| {{tag_link::1::foo}} | Creates a link URL to the page with ID 1 and the tag foo |
| {{tag_link::1::foo::bar}} | Creates a link URL to the page with ID 1 and the tags foo and bar |
| {{tag_link::1::foo|absolute}} | Creates an absolute link URL to the page with ID 1 and the tag foo |
| {{tag_link::1::foo|get}} | Creates a link URL to the page with ID 1 and the tag foo using GET parameters |
| {{tag_link::1::foo|absolute|get}} | Creates an absolute link URL to the page with ID 1 and the tag foo using GET parameters |
| {{tags_active}} | Creates a list of all active tags seperated by ,, e.g. tag1, tag2, tag3 |
| {{tags_active:: + }} | Creates a list of all active tags seperated by the given string +, e.g. tag1 + tag2 + tag3 |
| {{tags_active::, :: and }} | Creates a list of all tags seperated by , but the last tag is added with and, e.g. tag1, tag2, tag3 and tag4 |
A more robust way for the links would be to use the tag's ID instead of its name (which can be changed under System › Tags).
So instead of {{tag_link::1::foo}} you could also write {{tag_link::1::69}} (assuming the ID of foo is 69).
For Developers
Integrating a tags field in your own extension
If you want to use the tags for fields in your own Data Containers you can do so by defining the field as follows:
foreignKey, options_callbackand save_callbackare mandatory.
In the eval section we add a class called tags - this is also needed for the JavaScript handling. There are some more options which can be defined in eval.
If you also want to enable copying tags while copying an entry, you must add following code to your dca
This will copy all tags for the copied entry, except the fields excluded by doNotCopy.
Eval-Options
| Option | Description |
|---|---|
groupTagsByField |
If set to true the user will only be able to select from a list of tags that have been already used on this specific field in the current table. If set to falseor not set at all, the user will be able to choose from all tags available. |
Events
If you want to filter the tags shown in events and/or news, you can use the contao.tags_get_list event to modify the tags that will be used in the templates.
All versions of contao-tags with dependencies
doctrine/dbal Version ^3.6 || ^4.3
psr/log Version ^1.1 || 2.0 || ^3.0
symfony/config Version ^5.4 || ^6.4 || ^7.0
symfony/console Version ^5.4 || ^6.4 || ^7.0
symfony/dependency-injection Version ^5.4 || ^6.4 || ^7.0
symfony/event-dispatcher Version ^5.4 || ^6.4 || ^7.0
symfony/http-foundation Version ^5.4 || ^6.4 || ^7.0
symfony/http-kernel Version ^5.4 || ^6.4 || ^7.0
symfony/security-bundle Version ^5.4 || ^6.4 || ^7.0