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:

Records

Archive Date 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
Type

bool

Default

0

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

Define pid of tag records 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

Prepend at copy 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.

Warning

This feature is currently under development and not being expected to work!

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

categoryBeGroupTceFormsRestriction
Type

bool

Default

0

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
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

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

Improved preview of content element relations contentElementPreview

contentElementPreview
Type

bool

Default

1

If set, the preview in the backend is rendered as in the page module.

Enable manual sorting of news records manualSorting

manualSorting
Type

bool

Default

0

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
Type

bool

Default

0

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
Type

bool

Default

false

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

Advanced preview configuration for media files 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
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.

Backend Module

Show administration module 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
Type

bool

Default

0

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.

Import Module

Show importer showImporter

showImporter
Type

bool

Default

0

If set, the backend module "News import" is shown. This is used to import news articles from sources like t3blog, tt_news or custom providers.

UID of storage to use when importing files/images 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
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']['EXT']['extConf']['news'] = serialize([
    'archiveDate' => 'date',
    'rteForTeaser' => 0,
    'tagPid' => 1,
    'prependAtCopy' => 0,
    'categoryRestriction' => 'none',
    'categoryBeGroupTceFormsRestriction' => 0,
    'contentElementRelation' => 1,
    'manualSorting' => 0,
    'dateTimeNotRequired' => 0,
    'showAdministrationModule' => 1,
    'showImporter' => 0,
    'storageUidImporter' => '1',
    'resourceFolderImporter' => '/news_import',
]),