The news system consists of two main parts - the news records and the plugin.
News records should be placed in one central place e.g. the data folder. The records can be organized in subfolders to differentiate between news, press releases etc. Each news can be categorized and later on be filtered by that category.
If you want every news record to work with all templates the following fields should be filled: Title, Date, Abstract, Image
The news plugin, is the element add to the page you would like to show news records. There are different views the plugin can show the news.
- List view
- Detail view
- Category menu
The list view is the entry point for showing an overview of your news. You can apply filter to the plugin and select between two template to show the news records in the frontend. The default template is a regular list which shows the title and the date of the news.
The other template shows the overview of the news in tiles. The tiles template shows the title, abstract and image of the news record.
In the details view the content of the news record is rendered to the frontend. The structure is the following:
News date > News title > News abstract > News image > News bodytext > News content elements
In the images tab of a news record it is possible to upload multiple images. Each image can be configured to only show up in certain views. It is possible to show one image in the list view (if the template supports images, e.g the explore template) and use a second image for the details view.
Possible use cases are:
- Different aspect ratios for list view and details view
- No image in Details view
- Different images for list view and details view.
- If the list view requires an image and no image is set to be used in this view a fallback image will be used.
- The first image in the backend is always the one for the list view.
The category menu generates a menu which can be used as a filter for the list view.
How all parts work together
The figure show above shows the Principle operating mode for the following setups.
Operation mode: List > Detail
For this setup two news systems are necessary. One plugin with the list view and one plugin with the detail view. The list view needs to be told where to find the detail view plugin.
- The list view fetches all news records that match its filter
- Each list item has a link to the detail view. When the user clicks that link the list view sends the selected news record to the details view.
Operation mode: Category | Menu List > Detail
This setup needs three news systems. On one page the plugin with the category menu and on with the list view. In the list view the setting disable overwrite demand must be unchecked. This allows the category menu to overwrite all settings in the list view. On a second page a news plugin with the detail view which can display the news record handed over by the list view. This setup is an extension to the previous one.
- The list view is loaded with its settings.
- Once a filter from the category menu is clicked, the page reloads and the list view's settings are overwritten by the category menu, now showing only the news records that apply to the filter.
- If clicked on a news record, the list view hands over the news record to the details view.
The market and language strategy for news-contents works slightly different than for normal pages.
In contrast to the pages where one page is created and then translated into different versions, news are seperated into different folders for each market/language version.
The use cases for news are similar to pages:
Case 1: All markets in all languages
For each language a news is created in the corresponding folder (e.g. english news in (All markets) english or polish news in (All markets) polish).
The news itself is created in the language All.
These news are then shown on all news pages.
Case 2 and Case 3: Only in a specific language
To achieve these use cases, the news just have to be created in the corresponding folders; no other settings are needed.
Case 4: Only in markets using the fallback for news
Too complex to explain...
Case 5: Only in one specific market
Too complex to explain
Case 6: One news in all markets but a different content for one specific content
This is not immediately supported. Multiple news are needed to achieve this use case:
One news has to be entered into the all markets but NOT with the All language.
Another news has to be entered into the specific market.
On top of that for all markets which do not use the fallback language a seperate news has to be created in the specific market.
For which section do you want to add a news entry? Explore, Press or Investor Relations?
In which language and in which markets should the news be shown?
Optionally add additional content elements in the "Content Elements" tab of the news
Upload or select an image in the Media tab.
Use the Image Editor if the image is no in the correct aspect ratio or 7:3.
Without a category, the news won't be shown.
Select the most explicit (deepest) category matching the folder the news are saved in (i.e. only use Explore-Categories in the Explore Folder)
In most cases "[All] [-1]" should be used.
Use the "(All Markets) XXX" Language in the matching "All Markets XXX" folder if the news should not displayed for markets which have dedicated folder for that language.