.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ==== Tags ==== :Created: 2014-03-11T09:11:10.440000000 :Changed: 00:00:00 :Classification: form4_tags :Description: This extension provides the possibility to add tags for your pages and offers 3 plugins to display these Information in the front-end. :Keywords: tags, tagcloud, form4 :Author: form4 GmbH & Co. KG :Copyright: 2006-2013 :Email: typo3@form4.de :Language: en .. _img-1-img-2-Tags: |img-1| |img-2| Tags ==================== Extension Key: form4\_tags Language: en Keywords: tags, tagcloud, form4 Copyright 2006-2013, form4 GmbH & Co. KG, This document is published under the Open Content License available from http://www.opencontent.org/opl.shtml The content of this document is related to TYPO3 \- a GNU/GPL CMS/Framework available from www.typo3.org .. _Table-of-Contents: Table of Contents ----------------- **`Tags 1 <#__RefHeading__5708_1738894311>`_** **`Introduction 3 <#__RefHeading__5710_1738894311>`_** `What does it do? 3 <#__RefHeading__463_413120346>`_ **`Users manual 4 <#__RefHeading__467_413120346>`_** `Preparation 4 <#__RefHeading__4785_1591665704>`_ `Assign tags to pages 4 <#__RefHeading__4787_1591665704>`_ `Plugins 5 <#__RefHeading__4789_1591665704>`_ **`Administration 8 <#__RefHeading__31511_818911409>`_** **`Known problems 9 <#__RefHeading__31525_818911409>`_** **`To-Do list 10 <#__RefHeading__477_413120346>`_** **`ChangeLog 11 <#__RefHeading__31623_818911409>`_** .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ This extension adds the ability to add tags on pages. Additionally this extension provides three plug-ins: one plug-in that creates a tag cloud, a plug-in which provides a teaser for the tags and a similar topics plug-in. .. _Users-manual: Users manual ------------ .. _Preparation: Preparation ^^^^^^^^^^^ Create tags in a sysfolder of your choice. |img-3| |img-4| Assign tags to pages ^^^^^^^^^^^^^^^^^^^^ Edit a page go to the “tags” tab and assign tags to your page .. _img-5: |img-5| ^^^^^^^ .. _Plugins: Plugins ^^^^^^^ The extension Provides 3 new plug-ins, which you can select at the plug-in wizard. |img-6| **Plugin: Tag Cloud** With the Tag cloud plugin you display a cloud display of the tagged pages . The bigger the word the more hits have been on pages like this. But the design of all plugins can be modified if you set in the constants the template path to another directory (look up chapter **Administration** for that ). In the plug-in itself, you just enter the amount of tags which should be displayed in the front-end. |img-7| **Plugin: Tag Cloud Teaser** The tag cloud teaser provides the list view of the pages for the tag you selected in the tag cloud. This will show a list with an image ( the field in the page itself can )and the abstract text of the page and a link. ***Important:*** To make the extension with TYPO3 6.x compatible we removed the dependency to dam extension and added support for the file abstraction layer (as from now referred to as fal ) and the possibility to choose any field of the page table for the rendering the image of the tag cloud teaser. Default will be checked for a TypoScript configuration that adjust the handling of the image rendering, which you might adjust in the TypoScript Setup of your template if needed. plugin.tx\_form4tags.settings { teaserImageWidth = {$plugin.tx\_form4tags.settings.teaserImageWidth} teaserImageField = media teaserImageAltField = title teaserImageFieldIsDam = 0 } This **TypoScript settings** will adjust the taken image and the image handling depending on TYPO3 version. - plugin.tx\_form4tags.settings.teaserImageWidth – sets the width of the teaser imageYou can set this also in setting the constant for the width. (used for all TYPO3 versions) - plugin.tx\_form4tags.settings.teaserImageField - defines which field in the pages table will be used for the image – as the dependence for the dam extension is gone – this is per default: media, but can be set to any other field in the pages table (For the case you have defined your own teaser image field and want to reuse it). - plugin.tx\_form4tags.settings.teaserImageAltField – defines where you want to take the content of the alt text. This can be a field of the page table like title or depending on the dam field, or if we are at TYPO3 version 6.x just the fal alt field.So you have to differentiate between the TYPO3 Versions - up to TYPO3 4.x : field could be either e.g. 'title' or 'dam\_field.title'in the first case you use a field from the page table like the page title and in the second you use a field of the dam records like the title of the dam element. Just add “dam\_field.” in front of it and it will be used as the alt text. - Since TYPO3 6.x : as TYPO3 6.x uses fal which comes with an alt field. It will just take this entry and ignore the alt settings coming from the setup. - plugin.tx\_form4tags.settings.teaserImageFieldIsDam – 0 (for false ) or 1 (for true) in TYPO3 versions 4.x this field controls, if the defined field where the image is found should be handled as a typical media file (files will be saved in uploads/media/ ) or as an dam reference ). In TYPO3 6.X this field will be ignored for the support of fal. In the plug-in setting in the back-end you can set the maximal amount of teaser entries that are shown: |img-8| **Plugin: Similiar Topics** This plugin provides in the front-end a number of links to pages which share the same tags as the page the user is currently looking at, to guide the user further through the web-site. |img-9| In the plugin settings you again just set the amount of links that should be shown in the front-end. .. _Administration: Administration -------------- Install the extension Include the static extension template “Tags (form4\_tags)” Go in the constant editor to the “plugin.tx\_form4tags” category and set the UID of the page where the “Tag Cloud Teaser” plug-in is placed.(plugin.tx\_form4tags.settings.relatedTopicPage) Set the default storage pid of the sysfolder, where you manage the tags. (plugin.tx\_form4tags.persistence.storagePid) Here you can also adjust the paths to the template files to another directory to provide your own Templates for the teaser, the similar topics and the tagcloud plug-in. Optional you can the image width of the tag teaser and if the record should be sorted by title. |img-10| Known problems -------------- .. _To-Do-list: To-Do list ---------- .. _ChangeLog: ChangeLog --------- .. ### BEGIN~OF~TABLE ### .. _0-2-1: 0.2.1 ^^^^^ .. container:: table-row Version 0.2.1 Changes Update manual .. _0-2-0: 0.2.0 ^^^^^ .. container:: table-row Version 0.2.0 Changes Support for TYPO3 6.0 and 6.1 .. _0-1-2: 0.1.2 ^^^^^ .. container:: table-row Version 0.1.2 Changes Original version. .. ###### END~OF~TABLE ###### .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. :border: 0 .. :height: 44 .. :id: graphics5 .. :name: graphics5 .. :vspace: 57 .. :width: 161 .. |img-2| image:: img-2.png .. :align: left .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 485 .. :id: Grafik1 .. :name: Grafik1 .. :width: 241 .. |img-4| image:: img-4.png .. :align: left .. :border: 0 .. :height: 168 .. :id: Grafik2 .. :name: Grafik2 .. :width: 518 .. |img-5| image:: img-5.png .. :align: left .. :border: 0 .. :height: 280 .. :id: Grafik3 .. :name: Grafik3 .. :width: 645 .. |img-6| image:: img-6.png .. :align: left .. :border: 0 .. :height: 246 .. :id: Grafik4 .. :name: Grafik4 .. :width: 631 .. |img-7| image:: img-7.png .. :align: left .. :border: 0 .. :height: 251 .. :id: Grafik7 .. :name: Grafik7 .. :width: 631 .. |img-8| image:: img-8.png .. :align: left .. :border: 0 .. :height: 247 .. :id: Grafik8 .. :name: Grafik8 .. :width: 610 .. |img-9| image:: img-9.png .. :align: left .. :border: 0 .. :height: 236 .. :id: Grafik9 .. :name: Grafik9 .. :width: 631 .. |img-10| image:: img-10.png .. :align: left .. :border: 0 .. :height: 546 .. :id: Grafik6 .. :name: Grafik6 .. :width: 478