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.

Configuration

Plugin

The news event extension adds three additional views. Next to these views, some other settings will work a bit differently comparing to the news system. See the table below for an explanation of these settings:

Property: View: Description: Key:
What to display All

Selection of view:

  • Event List view: List of all news event records which fit the configuration
  • Event Detail view: Shows the complete news event record
  • Event Date menu: Date menu based on the dates (by default years) of news event records
-
Sort by None

Define the sorting of displayed news records.

This field will be ignored. This setting can only be configured by using TypoScript configuration, see the TypoScript reference for more information.

 orderBy
Sort direction None
Define the sorting direction which can either be ascending or descending.

This field will be ignored. Sorting will be handled by the 'Sort by' setting, which can be overridden by using Typoscript configuration, see the TypoScript reference for more information.
 orderDirection
Archive
Event List view,
Event Date menu
Next to 'No constraint', two modes are available:

Only active (non archived)
All current and future news event records (based on event dates and time) are shown.

Archived
All news event records with event dates in the past are shown.

Note: News (event) records can hold an optional archive date. This archive date in news event records will be ignored, and only the archive restriction as described above will be used.
 archiveRestriction
Date field to use Date menu The date menu builds a menu by year and month and the given news records. This field will be ignored. By default the field 'EventStartdate' will be used as dateField, and can be overridden by using TypoScript configuration, see the TypoScript reference for more information. dateField

TypoScript reference

This section describes additional news system TypoScript settings, which are available for news events. A simple way to get to know the default settings is to look at the file EXT:roq_newsevent/Configuration/TypoScript/setup.txt

News settings (iCal support)

See the table below for the general news settings, used by news event, which are defined by using:

plugin.tx_news.settings.<property>.
Property: View: Description: Key:
format string Set a different format for the output. Use e.g. “ics” for iCalendar “xml” or for RSS feeds. html

News event settings

See the table below for the specific news event settings, which are defined by using:

plugin.tx_news.settings.event.<property>.
Property: View: Description: Key:
templateRootPath dir

Root path for the fluid templates for news event. The plugin has one controller with three actions (named “eventDateMenu”, “eventList” and “eventDetail”). Accordingly there have to be at least three fluid templates at the following locations (relative to the template root path):

  • News/EventList.html
  • News/EventDetail.html
  • News/EventDateMenu.html

Additionally for ICS and RSS/XML support three additional templates also have to at the following locations (also relative to the template root path):

  • News/EventList.ics
  • News/EventDetail.ics
  • News/EventList.xml
 EXT:roq_newsevent/Resources/Private/Templates
partialRootPath dir Root path for the fluid partials of the plugin. The default Fluid templates use several default partials. If you override the default templates this might become irrelevant. EXT:roq_newsevent/Resources/Private/Partials
layoutRootPath dir Root path for the fluid layouts of the plugin (not used by default) undefined

Database reference

This section describes the news event database fields, which are added to the news table 'tx_news_domain_model_news' to store all event data.

Additional database columns

Property: View: Description:
tx_roqnewsevent_is_event tinyint(1), unsigned Determines if a news record is of type news event
tx_roqnewsevent_startdate int(1) The event start date
tx_roqnewsevent_starttime int(1) The event start time
tx_roqnewsevent_enddate int(1) The event end date (for multiple day events)
tx_roqnewsevent_endtime int(1) The event end time
tx_roqnewsevent_location varchar(255) The location of the event