Adds the possibility to assign tags to individual elements.
composer require numero2/contao-tags
)Add the following code snippet into your news_(full|latest|short|simple).html5
template
<?php if( $this->tags ): ?>
<div class="tags">
<?php foreach( $this->tags as $tag ): ?>
<?= $tag; ?>
<?php endforeach; ?>
</div>
<?php endif; ?>
Configure your Newslist
or Newsreader
front end modules and set a Redirect page for tags
(optional)
Additionally add the News Tag Cloud
module anywhere on your page
Add the following code snippet into your event_(full|list|teaser|upcoming).html5
template
<?php if( $this->tags ): ?>
<div class="tags">
<?php foreach( $this->tags as $tag ): ?>
<?= $tag; ?>
<?php endforeach; ?>
</div>
<?php endif; ?>
⚠️ 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.
<?php
use Contao\ModuleEventReader;
use Contao\ModuleModel;
use Contao\System;
$moduleModel = ModuleModel::findOneById(69); // replace with the ID of your actual EventReader module
$module = new ModuleEventReader($moduleModel);
$tagListener = System::getContainer()->get('numero2_tags.listener.events');
$event = $tagListener->parseEvent($this->arrData, $module);
$this->tags = $event['tags'];
$this->tagsRaw = $event['tagsRaw'];
?>
Configure your Eventlist
or Eventreader
front end modules and set a Redirect page for tags
(optional)
Additionally add the Events Tag Cloud
module anywhere on your page
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).
If you want to use the tags for fields in your own Data Containers you can do so by defining the field as follows:
$GLOBALS['TL_DCA']['tl_my_extension']['fields']['my_tags'] = [
'exclude' => true
, 'inputType' => 'select'
, 'foreignKey' => 'tl_tags.tag'
, 'options_callback' => ['numero2_tags.listener.data_container.tags', 'getTagOptions']
, 'load_callback' => [['numero2_tags.listener.data_container.tags', 'loadTags']]
, 'save_callback' => [['numero2_tags.listener.data_container.tags', 'saveTags']]
, 'eval' => ['multiple'=>true, 'size'=>8, 'tl_class'=>'clr long tags', 'chosen'=>true]
, 'sql' => "blob NULL"
, 'relation' => ['type'=>'hasMany', 'load'=>'eager']
];
foreignKey
, options_callback
and save_callback
are 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
.
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 false or not set at all, the user will be able to choose from all tags available. |