Extension Configuration¶
Some general settings can be configured in the Extension Configuration.
- Go to Admin Tools > Settings > Extension Configuration
- Choose news
The settings are divided into several tabs and described here in detail:
Properties
- Records
- Archive Date archiveDate
- Enable a RTE for the teaser field rteForTeaser
- Define pid of tag records tagPid
- Prepend at copy prependAtCopy
- Category restriction categoryRestriction
- Editor needs to have permissions to all selected categories to save a news item categoryBeGroupTceFormsRestriction
- Use content element relation contentElementRelation
- Improved preview of content element relations contentElementPreview
- Enable manual sorting of news records manualSorting
- Disable required date field dateTimeNotRequired
- Show thumbnails in backend list module mediaPreview
- Advanced preview configuration for media files advancedMediaPreview
- Slug behaviour slugBehaviour
- Backend Module
- Import Module
- Alternative configuration instead of Admin Tools
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
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.
$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',
]),