.. include:: /Includes.rst.txt

.. _recordTag:

===
Tag
===

Tags are not mandatory but make it easier to structure news records.

|img-record-tag|

Add a tag
=========

Tags can be added in the :ref:`News administration <newsModuleCreateTag>`
or :ref:`List <listAddFirstRecord>` module.

Properties
==========

.. t3-field-list-table::
 :header-rows: 1

 - :Field:
         Field:
   :Description:
             Description:

     - :Field:
             Title
       :Description:
             Title of the tag. This field is required!

     - :Field:
             Hidden
       :Description:
             Hide a tag.

     - :Field:
             SEO: <title>-Tag
       :Description:
             Can be used to set a special <title>-Tag for category pages.
             This must be enabled in the template:

             .. code-block:: html

                <f:if condition="{tags.0.title}">
                   <n:titleTag>
                      <f:format.htmlentitiesDecode>{tags.0.title}</f:format.htmlentitiesDecode>
                   </n:titleTag>
                </f:if>

 - :Field:
         SEO: Meta-Description
   :Description:
             Can be used to set a special meta description for category pages.
             This must be enabled in the template:

             .. code-block:: html

                <f:if condition="{tags.0.description}">
                   <n:metaTag name="description" content="{tags.0.description -> f:format.stripTags()}" />
                </f:if>

 - :Field:
         SEO: Headline
   :Description:
             Can be used to set a special headline for category pages, e.g. for H1 tag
             This must be enabled in the template:

             .. code-block:: html

                <f:if condition="{tags.0.headline}">
                   <f:then>
                      <h1>{tags.0.headline}</h1>
                   </f:then>
                   <f:else>
                      <h1>News Category</h1>
                   </f:else>
                </f:if>

 - :Field:
         SEO: Text
   :Description:
             Can be used to add additional content text for category pages
             This must be enabled in the template:

             .. code-block:: html

                <f:if condition="{tags.0.text}">
                   <f:format.html>{tags.0.text}</f:format.html>
                </f:if>