About News & category records¶
The records can be created on any page, however a sysfolder is often preferred.
Category¶
Categories are not required but can be used to structure news records in the frontend (e.g. show only news records which belong to category A and B). Since version 3.0 the core table “System category” is used and enhanced.
TODO
The following table describes the main fields of a category record.
| Field: | Description: |
|---|---|
| Title | Title of the category and required. |
| Parent category | The parent category is used to build a category tree. Therefore select the parent of the current category. If nothing selected, the category is used as a root category. |
| Image | Optional image of the category which can be shown next to a category title. |
| Description | Description of the category |
| Single-view page for news from this category | If a page is defined, it is used as page for displaying the news record. If a news record belongs to more than one category, only the 1 st category is checked for this field. |
| News category shortcut | Optional link of a news category |
News¶
The following table describes the main fields of a news record.
| Field: | Description: |
|---|---|
| Header | Header of a news record. It is a required field. |
| Top news | News records can be marked as top news if it is an important one. This field can be used for filtering and ordering. |
| Type | A news record can belong to one of the following types:
Some fields are depending on the selection. |
| Teaser | A teaser text which is shown in the list view and explains the content of the news record in some sentences. Depending on the configuration it is possible that not complete text is shown in the frontend but just a part of it. |
| Author name | Name of the author |
| Author Email | Email address of the author |
| Date & Time | Date of the news record |
| Archive date | Depending on the configuration this date is used to define if the record is still shown. It is e.g. possible to show only records with an archive date in the past or in the future. |
| Text | Main content of the news record. This field is only shown with the type “News”. |
| Rich Text Editor Disable | If set, the RTE is hidden and the field “Text” is shown as plain textarea. |
| Content Elements | Add content elements to a news records. This field can be hidden by disabling the setting in extension manager’s settings. |
| Link to this Page | Link to a regular page. This field is only shown with the type “Internal Page”. |
| Link to External URL | Link to an external url. This field is only shown with the type “External Page”. |
| Categories | Selection of categories the news record belongs to. |
| Tags | Add tags to the news record. Use the suggest wizard to search for existing tags and to insert new tags. |
| Media Element | Media elements belonging to this news record. Those are described below. |
| Related Files | Related files, described below. |
| Related Links | Related links, described below. |
| Related News | Define news records which are related to the current one. |
| Related News (from) | This field is not editable and shows those news records which are related to the current one. |
| Meta Tags Keywords | Set keywords of this news record, separated with a comma (‘,’) |
| Meta Tags Description | Define an additional description |
| Alternative title | If used, this field is used instead of the default tile. |
| Speaking URL path segment | This field can be used for various scenarios, e.g. in your realurl configuration to set up the URL to the news record. |
Media element FAL¶
Since version 3.0.0, FAL is used for media elements which is consistent with the default core. It is enhanced with the following fields.
| Field: | Description: |
|---|---|
| Show in preview views | It is possible to decide which media can be shown in the list view. If not checked, it will only be displayed in the single view. |
Media element¶
A media element can be one of the following types:
Image
| Field: | Description: |
|---|---|
| Show in preview views | It is possible to decide which media can be shown in the list view. If not checked, it will only be displayed in the single view. |
| Image | The image file |
| Width | Width of image |
| Height | Height of image |
| Caption | Caption |
| Title Text | Text to describe the image which is used for the title attribute |
| Alternative Text | Further description which is used for the alt attribute |