Extension Configuration

Some general settings can be configured in the Extension Configuration.

  1. Go to Admin Tools > Settings > Extension Configuration
  2. Choose news

The settings are divided into several tabs and described here in detail:

Properties

Records

Archive Date archiveDate

archiveDate

archiveDate
type

string (keyword)

Default

date

Define how the archive date field should be rendered:

date
Render the field as pure date
datetime
Render it as date and time field

Enable a RTE for the teaser field rteForTeaser

rteForTeaser

rteForTeaser
type

bool

Default

If set, the teaser field will be rendered using a RTE.

Define pid of tag records tagPid

tagPid

tagPid
Type
int
Default
0

New tags can be saved directly inside the news record. The given ID is used as page on which the tag records will be saved.

This setting can also be done with TSconfig, see tagPid

If you want to use TsConfig to define the page, set the tagPid to 0 and use the following syntax in TsConfig:

# Save tags on page with UID 123
tx_news.tagPid = 123
Copied!

Prepend at copy prependAtCopy

prependAtCopy

prependAtCopy
type

bool

Default

1

If set and a news record is copied, the news record will be prepended with the string Copy X.

Category restriction categoryRestriction

Category restriction: Restrict the available categories in news records.

PageTsConfig:

TCEFORM.tx_news_domain_model_news.categories.PAGE_TSCONFIG_IDLIST=120.
Copied!

Editor needs to have permissions to all selected categories to save a news item categoryBeGroupTceFormsRestriction

categoryBeGroupTceFormsRestriction

categoryBeGroupTceFormsRestriction
type

bool

Default

If activated, an editor needs to have permissions to all categories added to a news item to be able to edit this record.

Use content element relation contentElementRelation

contentElementRelation

contentElementRelation
type

bool

Default

1

If set, you can add content elements as relation to a news record. This makes it easy to enrich the news article with further images, plugins, ...

If you want to reduce the available options of the content elements, you can use TsConfig in the sysfolder of the news records:

# Hide content element types
TCEFORM.tt_content.CType.removeItems = header,bullets,table,uploads,menu,list,html,login,mailform,search,shortcut,div
# Hide fields
TCEFORM.tt_content.header.disabled = 1
TCEFORM.tt_content.header_layout.disabled = 1
Copied!

More information can be found at http://docs.typo3.org/typo3cms/TSconfigReference/PageTsconfig/TCEform/Index.html.

Enable manual sorting of news records manualSorting

manualSorting

manualSorting
type

bool

Default

If set, news records can be manually sorted in the list view by the well known icons "up" and "down".

Disable required date field dateTimeNotRequired

dateTimeNotRequired

dateTimeNotRequired
type

bool

Default

If set, the date field of the news record is not a required field anymore. Furthermore if creating a new record, it is not filled anymore with the current date.

Be aware that using this feature may lead to unexpected results if using e.g. the date menu if the field is not used anymore.

Show thumbnails in backend list module mediaPreview

mediaPreview

mediaPreview
type

bool

Default

false

If enabled, the list module will show thumbnails of the media items.

This setting is only evaluated for TYPO3 10 as it has been removed for version 11. Use the extension studiomitte/recordlist-thumbnail to get it back in v11.

Advanced preview configuration for media files advancedMediaPreview

advancedMediaPreview

advancedMediaPreview
type

bool

Default

1

If enabled, more options are available for editors defining where an media element should be displayed.

Slug behaviour slugBehaviour

slugBehaviour

slugBehaviour
type

string, keyword

Default

unique

Choose one of the following slug behaviours:

uniqueInSite
The same slug can be used for news in different sites. Use this setting only if no news records are shared between sites.
unique
The same news title in different sites will lead to different slug names.

Page Tree Plugin Preview

pageTreePluginPreview

pageTreePluginPreview
type

bool

Default

1

If set, pages which contain a news plugin will show an additional icon right to the title in the page tree. This makes it easier to identify pages which are related to EXT:news.

This setting is only relevant since TYPO3 13!

Backend Module

Show administration module showAdministrationModule

showAdministrationModule

showAdministrationModule
type

bool

Default

1

If set, the backend module "News" is shown. This view might be easier for editors who use a very limited set of features in the backend.

Hide page tree for Administration module hidePageTreeForAdministrationModule

hidePageTreeForAdministrationModule

hidePageTreeForAdministrationModule
type

bool

Default

If set, the backend module "News" is shown without the page tree. In combination with the TsConfig redirectToPageOnStart you can achieve a very simple workflow for editors if those need only to create news records.

UID of storage to use when importing files/images storageUidImporter

storageUidImporter

storageUidImporter
type

int

Default

1

Define the uid of the storage which is used for importing media elements into FAL relations.

In which folder should the importer save files/images (has to exist) resourceFolderImporter

resourceFolderImporter

resourceFolderImporter
type

string

Default

/news_import

Define the folder which is used for the media elements which are imported.

Alternative configuration instead of Admin Tools

Instead of defining the property in the Admin Tools it is also possible to define the properties in the AdditionalConfiguration.php. This is useful if you want to include the setting in version control.

AdditionalConfiguration.php 
 $GLOBALS['TYPO3_CONF_VARS']['EXTENSIONS']['news'] = [
    'advancedMediaPreview' => '1',
    'archiveDate' => 'date',
    'categoryBeGroupTceFormsRestriction' => '0',
    'categoryRestriction' => 'none',
    'contentElementRelation' => '1',
    'dateTimeNotRequired' => '0',
    'hidePageTreeForAdministrationModule' => '0',
    'manualSorting' => '0',
    'prependAtCopy' => '1',
    'resourceFolderImporter' => '/news_import',
    'rteForTeaser' => '0',
    'showAdministrationModule' => '1',
    'slugBehaviour' => 'unique',
    'storageUidImporter' => '1',
    'tagPid' => '1',
];
Copied!