---
title: "Constants"
version: "3.1"
permalink: "https://docs.typo3.org/permalink/erhaweb/feed-display:configuration-typoscript-constants@3.1"
source: "Configuration/TypoScriptReference/Constants.rst"
rendered: "2026-11-08T23:07:41+00:00"
---

# Constants {#configuration-typoscript-constants}

## View {#configuration-typoscript-constants-view}

The following options are located under the following path:
`plugin.tx_feeddisplay_pi1.view`

### Template root path {#configuration-typoscript-constants-view-templaterootpath}

-   **templateRootPath**

    -   *type:* string
    -   *Default:* empty
    -   *Path:* plugin.tx_feeddisplay_pi1.view

    In addition to the default path `EXT:feed_display/Resources/Private/Templates/`,
    this constant can be used to define a custom template root path to overwrite
    individual fluid files as needed.

### Partial root path {#configuration-typoscript-constants-view-partialrootpath}

-   **partialRootPath**

    -   *type:* string
    -   *Default:* empty
    -   *Path:* plugin.tx_feeddisplay_pi1.view

    In addition to the default path `EXT:feed_display/Resources/Private/Partials/`,
    this constant can be used to define a custom partial root path to overwrite
    individual fluid files as needed.

### Layout root path {#configuration-typoscript-constants-view-layoutrootpath}

-   **layoutRootPath**

    -   *type:* string
    -   *Default:* empty
    -   *Path:* plugin.tx_feeddisplay_pi1.view

    In addition to the default path `EXT:feed_display/Resources/Private/Layouts/`,
    this constant can be used to define a custom layout root path to overwrite
    individual fluid files as needed.

## Settings {#configuration-typoscript-constants-settings}

The following options are located under the following path:
`plugin.tx_feeddisplay_pi1.settings`

Use these settings if you want to define values globally for all Feed
Display Plugin content elements.

### Feed URL {#configuration-typoscript-constants-settings-feedurl}

-   **feedUrl**

    -   *type:* string
    -   *Default:* [https://typo3.org/rss](https://typo3.org/rss)
    -   *Path:* plugin.tx_feeddisplay_pi1.settings

    URL that is fetched by the service.

    Remote `http` and `https` feeds are requested via TYPO3's HTTP client
    stack, so TYPO3 proxy and related outbound HTTP settings apply
    automatically. Local file paths use SimplePie's default
    transport.

### Maximum items {#configuration-typoscript-constants-settings-maxfeedcount}

-   **maxFeedCount**

    -   *type:* int
    -   *Default:* 10
    -   *Path:* plugin.tx_feeddisplay_pi1.settings

    Maximum feed items to show

### Maximum content length {#configuration-typoscript-constants-settings-maxcontentlength}

-   **maxContentLength**

    -   *type:* int
    -   *Default:* 500
    -   *Path:* plugin.tx_feeddisplay_pi1.settings

    Crop the characters of the feed content to the configured length

### Maximum header length {#configuration-typoscript-constants-settings-maxheaderlength}

-   **maxHeaderLength**

    -   *type:* int
    -   *Default:* 80
    -   *Path:* plugin.tx_feeddisplay_pi1.settings

    Crop the characters of the feed header to the configured length

### Maximum logo width {#configuration-typoscript-constants-settings-logomaxwidth}

-   **logoMaxWidth**

    -   *type:* int
    -   *Default:* empty
    -   *Path:* plugin.tx_feeddisplay_pi1.settings

    Maximum width of the feeds logo image

### Maximum logo height {#configuration-typoscript-constants-settings-logomaxheight}

-   **logoMaxHeight**

    -   *type:* int
    -   *Default:* empty
    -   *Path:* plugin.tx_feeddisplay_pi1.settings

    Maximum height of the feeds logo image

### Maximum feed icon width {#configuration-typoscript-constants-settings-feediconmaxwidth}

-   **feedIconMaxWidth**

    -   *type:* int
    -   *Default:* 26
    -   *Path:* plugin.tx_feeddisplay_pi1.settings

    Maximum width of the feeds icon image

### Maximum feed icon height {#configuration-typoscript-constants-settings-feediconmaxheight}

-   **feedIconMaxHeight**

    -   *type:* int
    -   *Default:* 26
    -   *Path:* plugin.tx_feeddisplay_pi1.settings

    Maximum height of the feeds icon image

### Date format {#configuration-typoscript-constants-settings-dateformat}

-   **dateFormat**

    -   *type:* string
    -   *Default:* 1.  F Y
    -   *Path:* plugin.tx_feeddisplay_pi1.settings

    Use a PHP date format compatible with
    [DateTimeInterface::format()](https://www.php.net/manual/en/datetime.format.php)
    to define the format for dates.

### Strip tags {#configuration-typoscript-constants-settings-striptags}

-   **stripTags**

    -   *type:* boolean
    -   *Default:* 1
    -   *Path:* plugin.tx_feeddisplay_pi1.settings

    Remove HTML tags from the feed content

### Link target {#configuration-typoscript-constants-settings-linktarget}

-   **linkTarget**

    -   *type:* string
    -   *Default:* \_blank
    -   *Path:* plugin.tx_feeddisplay_pi1.settings

    Target attribute to define the feed link behavior

    **Possible values:**

    -   **\_blank**

        Opens in a new window or tab

    -   **\_self**

        Opens in the same frame as it was clicked

    -   **\_parent**

        Opens in the parent frame

    -   **\_top**

        Opens in the full body of the window

### Error message {#configuration-typoscript-constants-settings-errormessage}

-   **errorMessage**

    -   *type:* string
    -   *Default:* empty
    -   *Path:* plugin.tx_feeddisplay_pi1.settings

    This message is displayed if no feed items could be fetched

### Cache duration {#configuration-typoscript-constants-settings-cacheduration}

-   **cacheDuration**

    -   *type:* int
    -   *Default:* 3600
    -   *Path:* plugin.tx_feeddisplay_pi1.settings

    In live mode, the minimum interval between source refresh attempts and the
    lifetime of prepared display arrays. Zero and negative values attempt a
    refresh on every plugin execution. Successful responses remain stored
    permanently even when this value is zero. In scheduler mode this value
    affects prepared arrays only. TYPO3's page cache is independent.

### Fetch mode {#configuration-typoscript-constants-settings-fetchmode}

-   **fetchMode**

    -   *type:* string
    -   *Default:* live
    -   *Path:* plugin.tx_feeddisplay_pi1.settings

    `live` refreshes during page rendering as needed. `scheduler` fetches a
    missing source once, then displays its last successful response until a job
    refreshes it. Unknown or empty values use live mode. See
    [Persistent feeds and scheduled refresh](https://docs.typo3.org/permalink/erhaweb/feed-display:configuration-scheduler@3.1) for first-fetch retries and job setup.

### Get Fields {#configuration-typoscript-constants-settings-getfields}

-   **getFields**

    -   *type:* Array
    -   *Default:* empty
    -   *Path:* plugin.tx_feeddisplay_pi1.settings

    Fields to get from feed and feed items.

    Please see the options below.

#### Get Fields: Feed {#configuration-typoscript-constants-settings-getfields-feed}

-   **getFields.feed**

    -   *type:* list of strings, separated by comma
    -   *Default:* author, authors, contributor, contributors, copyright, description, encoding, items, item_quantity, language, link, links, permalink, title, type, subscribe_url, latitude, longitude, image_height, image_link, image_title, image_url, image_width, all_discovered_feeds, base
    -   *Path:* plugin.tx_feeddisplay_pi1.settings

    Comma-separated list of fields to be read from the feed by SimplePie
    and made available as variables in Fluid.

    Please see the [SimplePie feed reference](http://simplepie.org/api/class-SimplePie.html)
    to find out which values can be used here. The Feed Display Extension
    transforms each entry of the list into a getter function name.

    For example `item_quantity` internally becomes `get_item_quantity()`.

    Some SimplePie methods expect parameters. For this reason, up to three
    parameters can be passed via a special syntax. Use the "|" symbol to
    append the parameters to the element name.

    **Example:**

    ```typoscript
    plugin.tx_feeddisplay_pi1.settings.getFields.feed := addToList(channel_tags | http://www.itunes.com/dtds/podcast-1.0.dtd | image)
    ```

    This leads to the following SimplePid function call:

    ```php
    get_channel_tags("http://www.itunes.com/dtds/podcast-1.0.dtd", "image");
    ```

#### Get Fields: Items {#configuration-typoscript-constants-settings-getfields-items}

-   **getFields.items**

    -   *type:* list of strings, separated by comma
    -   *Default:* author, authors, categories, category, content, contributor, contributors, copyright, date|U, description, enclosure, enclosures, feed, id, link, links, local_date|, permalink, source, title, latitude, longitude, base
    -   *Path:* plugin.tx_feeddisplay_pi1.settings

    Comma-separated list of fields to be read from the feed items by

    Please see the [SimplePie feed item reference](http://simplepie.org/api/class-SimplePie_Item.html)
    to find out which values can be used here. The Feed Display Extension
    transforms each entry of the list into a getter function name.

    For example `author` internally becomes `get_author()`.

    As in [getFields.feed](https://docs.typo3.org/permalink/erhaweb/feed-display:configuration-typoscript-constants-settings-getfields-feed@3.1)
    up to three parameters are supported.

## Ignore Flexform Settings if empty {#configuration-typoscript-constants-ignoreflexformsettingsifempty}

-   **ignoreFlexFormSettingsIfEmpty**

    -   *type:* list of strings, separated by comma
    -   *Default:* feedUrl, maxFeedCount, maxContentLength, maxHeaderLength, logoMaxWidth, logoMaxHeight, feedIconMaxWidth, feedIconMaxHeight, dateFormat, stripTags, linkTarget, errorMessage, cacheDuration, fetchMode, getFields.feed, getFields.items
    -   *Path:* plugin.tx_feeddisplay_pi1

    Comma separated list of settings to be overridden by TypoScript if the
    plugin settings value is either empty or 0.

    > [!WARNING]
    > **Attention**
    >
    > This is the native Extbase property for frontend plugins in TYPO3 v13
    > and v14. It replaces the previous custom property
    > `plugin.tx_feeddisplay_pi1.settings.overrideFlexformSettingsIfEmpty`.
    >
    > See also [ignoreFlexFormSettingsIfEmpty](https://docs.typo3.org/m/typo3/reference-typoscript/14.3/en-us/TopLevelObjects/Plugin.html#setup-plugin-configuration-ignoreflexformsettingsifempty).