Configuration with Site-Sets
New in version TYPO3 v13.4.15 / news v13.0
Use at least EXT:news 13.0.0 to get the full features of site sets.
The extension ships sets which can are used to configure various features.
See also
Read more about Site Sets in the general documentation: Site sets!
- Got to backend module Site Management > Sites.
- Edit the configuration of your site.
- On the first tab go to Sets for this Site.
- Choose the sets you need. For the basic setup choose site set EXT:news :: Basic Setup.
-
After saving, you can switch to the backend module Site Management > Settings to adopt the configurations.
-
Click on Edit settings to open the settings module. Each selected site set can provide its own settings.
- All settings are persisted in
/config/
.sites/<your- site- identifier>/ settings. yaml
Available Site Sets
Note
Depending on your setup, it is possible that not all site sets are available!
EXT:news :: Basic Setup
This is the basic site set. It is loaded automatically by all other site sets of this extension.
Available settings
Name | Type | Required |
---|---|---|
string | ||
string | ||
string | ||
page | ||
page | ||
enum |
news.view.templateRootPath
-
- Type
- string
- Default
- EXT:news/Resources/Private/Templates/
Path to the templates
news.view.partialRootPath
-
- Type
- string
- Default
- EXT:news/Resources/Private/Partials/
Path to the partials
news.view.layoutRootPath
-
- Type
- string
- Default
- EXT:news/Resources/Private/Layouts/
Path to the layouts
news.pages.detail
-
- Type
- page
- Default
- 0
Page with detail view. This can be used as a site wide configuration for the detail view, used for all links to news records.
news.preview.page
-
- Type
- page
- Default
- 0
Page with detail plugin used for previews. Allow editors to "save & view" a news record by providing the detail page
news.preview.mode
-
- Type
- enum
- Default
- news
Either select "news" or "news_preview" as used argument name. The latter is required if preview should also work for hidden or restricted records.
See also
Read more about the required additional configuration at Allow preview of hidden records previewHiddenRecords.
EXT:news :: Twitter Bootstrap 5 Styles
Load the default template variants using Twitter Bootstrap v5 styles.
EXT:news :: Twitter Bootstrap 4 Styles
Load the default template variants using Twitter Bootstrap v4 styles.
EXT:news :: Record Links
Record links (or historically known as linkhandler) allow editors to link to news records by selecting the record without needing to know on which page the record will be rendered.
Warning
Never link to records by using an external url. Always use the record links!
More information can be found at LinkHandler.
Available settings
Name | Type | Required |
---|---|---|
string | true | |
page | ||
bool | ||
page | true |
news.recordLinks.label
-
- Type
- string
- Required
true
- Default
- LLL:EXT:news/Resources/Private/Language/locallang_be.xlf:recordLinks.label
The label used in the Link Browser. Use either a localizable string starting with LLL:EXT or directly a label
news.recordLinks.storagePid
-
- Type
- page
- Default
- 0
The link browser starts with the given page. Ease the workflow by preselecting the news article storage page.
news.recordLinks.hidePageTree
-
- Type
- bool
- Default
- false
Hide the page tree in the link browser. If only one storage page is used, the page tree can be hidden with this setting.
news.recordLinks.detail
-
- Type
- page
- Required
true
- Default
- 0
Detail page. Select the page used for the detail view of the link.
EXT:news :: Sitemap
This site sets provides a configuration to generate a sitemap for news records.
Note
This sitemap requires the core extension seo
to be installed!
Available settings
Name | Type | Required |
---|---|---|
page | true | |
page | true | |
int | ||
string |
news.sitemap.detail
-
- Type
- page
- Required
true
- Default
- 0
Select the page used to link the sitemap entries to.
news.sitemap.startingpoint
-
- Type
- page
- Required
true
- Default
- 0
Select the page containing the news records (Starting point)
news.sitemap.recursive
-
- Type
- int
- Default
- 0
Levels used to fetch pages containing the news records
news.sitemap.additionalWhere
-
- Type
- string
- Default
- 1
Optional constraint to limit news records used in the sitemap