---
title: "General configuration"
manual: "News system"
version: "main"
permalink: "https://docs.typo3.org/permalink/georgringer/news:tsconfiggeneral@main"
source: "Reference/TsConfig/General.rst"
rendered: "2026-09-23T19:24:09+00:00"
---

# General configuration {#tsconfiggeneral}

The general configuration covers options available during the creation
and editing of news records.

**Properties**

## templateLayouts {#tsconfigtemplatelayouts}

-   **templateLayouts**

    -   *Type:* array
    -   *Path:* tx_news

    The select box **Template Layout** inside a plugin can be extended by
    using TSconfig. Contains an array with key-value pairs. It is possible to
    define Groups using the `--div--` keyword.

    -   **allowedColPos**

        Limit a layout to a list of colPos values.

### Examples: Add template layouts {#examples-add-template-layouts}

Show 3 layout options with the specified key / value pairs.

```typoscript
tx_news.templateLayouts {
      1 = Foobar
      2 = Another one
      3 =  --div--,Group 2
      4 = Blub
}
```

You can use this setting within the Fluid template by checking
`{settings.templateLayout}`. See a complete example:
[Template selector tutorial](https://docs.typo3.org/permalink/georgringer/news:templatesselector@main).

By using the configuration `allowedColPos` it is possible to restrict a
template layout to a specific list of colPos values.

```typoscript
tx_news.templateLayouts {
   1 = Foobar
   2 = Another one
   2.allowedColPos = 1,2,3
   3 =  --div--,Group 2
   4 = Blub
   4.allowedColPos = 0,1
}
```

## slugPrefix {#tsconfigslugprefix}

-   **slugPrefix**

    -   *Type:* string
    -   *Path:* tx_news

    Configure the prefix shown before the slug field of the news record.
    The following options are available:

    > -   `none`: No prefix is shown
    > -   `default`: Default behaviour of the slug prefix which is the domain
    > -   An integer: URL to the detail page

### Example: Show url to a detail page {#example-show-url-to-a-detail-page}

The shown prefix will be a link to the provided detail page (uid 123).

```typoscript
# Example:
tx_news.slugPrefix = 123
```

## archive {#tsconfigarchive}

-   **archive**

    -   *Type:* string
    -   *Path:* tx_news

    Use strtotime (see [http://www.php.net/strtotime](http://www.php.net/strtotime) )
    to predefine the archive date

### Example: Set the archive date {#example-set-the-archive-date}

Set the archive date on the the next friday:

```typoscript
# Example:
tx_news.predefine.archive = next friday
```

## tagPid {#tsconfigtagpid}

-   **tagPid**

    -   *Type:* integer
    -   *Path:* tx_news

    Besides the configuration in the
    [Extension Configuration](https://docs.typo3.org/permalink/georgringer/news:extensionconfigurationtagpid@main) it is also
    possible to define the pid of tags created directly in the news record by
    using TSconfig:

### Example: store new tags on page 123 {#example-store-new-tags-on-page-123}

Store new tags on page 123.

```typoscript
# Example:
tx_news.tagPid = 123
```

## categoryRestrictionForFlexForms {#tsconfigcategoryrestrictionforflexforms}

-   **categoryRestrictionForFlexForms**

    -   *Type:* bool
    -   *Path:* tx_news

    After defining the category restriction in the
    [Extension Configuration](https://docs.typo3.org/permalink/georgringer/news:extensionconfigurationcategoryrestriction@main)
    it is also possible to restrict the categories in the news plugin.
    This needs to enabled by TsConfig:

    ```typoscript
    # Example:
    tx_news.categoryRestrictionForFlexForms = 1
    ```

## showContentElementsInNewsSysFolder {#tsconfigshowcontentelementsinnewssysfolder}

-   **showContentElementsInNewsSysFolder**

    -   *Type:* bool
    -   *Path:* tx_news

If a sys folder is configured with **Contains Plugin:** `News`,
content elements are hidden on those pages in the page and list module.
If the content elements should be shown, use the Page TsConfig.

```typoscript
# Example:
tx_news.showContentElementsInNewsSysFolder = 1
```