DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

Extension Manager

Some general settings can be configured in the Extension Manager. If you need to configure those, switch to the module “Extension Manager”, select the extension “news” and press on the configure-icon!

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

Properties

Property Tab Default
removeListActionFromFlexforms basic List only
archiveDate basic date
pageModuleFieldsCategory basic title,description
pageModuleFieldsNews basic  
showMediaDescriptionField records 0
rteForTeaser records 1
tagPid records 1
prependAtCopy records 1
categoryRestriction records  
categoryBeGroupTceFormsRestriction records  
contentElementRelation records 0
manualSorting records 0
useFal records fal
showAdministrationModule backend modules 0
showImporter backend modules 0
storageUidImporter backend modules  
resourceFolderImporter backend modules /news_import

Property details

removeListActionFromFlexforms

This switch enables you to configure the behaviour of the list view if the URL contains the link to a single view. Basically there are 2 possible variants:

  • List only: No matter if a single news is defined in the URL, the plugin will still render the list view. You will need a separate detail view somewhere.
  • List & Detail: If a single news is defined in the URL, the single view will be shown.

Warning

If you have created a plugin and change the setting, you need to reselect the new view in the plugin again!

archiveDate

Define if the archive date field should be rendered as a date field or including the date as well.

pageModuleFieldsCategory

Define the fields which should be shown for category records in the page module. Empty the field if you don’t want to show those records in the page module.

pageModuleFieldsNews

Define the fields which should be shown for news records in the page module. A very simple API makes it possible to render a select box with multiple variants.

The syntax is:

Label1=field1,field2,field3;Label2=field1,field2

showMediaDescriptionField

If set, a description field for media elements is shown.

Note

This is just for non FAL relations!

rteForTeaser

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

Note

This is just for non FAL relations!

tagPid

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.

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

prependAtCopy

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

categoryRestriction

Define an additional constraint for the categories inside a news record. Possible options are:

None

No additional constraint is used.

Page TsConfig

By using TsConfig it is possible to define those pages which contain the available categories:

# Example: Only use categories which are saved in the pages with ID 12 and 34
TCEFORM.tx_news_domain_model_news.categories.PAGE_TSCONFIG_IDLIST = 12,34

Categories from current page

Only those categories are shown in a news record which are located at the same page.

Categories from page which is defined in page properties

Only those categories are shown in a news record which are saved in the page defined in the page properties in the field General Record Storage Page.

Categories from site root

Only those categories are shown which are saved at the root page.

categoryBeGroupTceFormsRestriction

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

contentElementRelation

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.

manualSorting

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

useFal

The following options are available:

  • Yes: Enables usage of FAL relations
  • No: Hides the relations to FAL elements
  • Both: The old and the new media relations are used
  • Fal & Multimedia: Enables usage of FAL relations + the old media relation, limited to type “multimedia”

showAdministrationModule

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.

showImporter

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.

storageUidImporter

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

resourceFolderImporter

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