Platinum sponsors
The News Event (mbl_newsevent) extension can only be configured through the TypoScript setup. As it is an extension of (and thus in theoretical forms a part of) tt_news, configuration settings are stored within tt_news' TS setup.
As with the 2.x version of tt_news mbl_newsevent all configuration of default TS values happen through static templates, which must be included through the templates:
It is important to include the News Event static templates after the static templates from tt_news, because of certain limitations in the tt_news TypoScript.
News Event introduces a number of extra template markers to tt_news' template parser. These can be used to add event information to news listings.
The fastest way to show event information is to add the ###EVENT_WRAP### and ###EVENT_WHERE_WRAP### markers where you want the event and location information to appear in the news lists and single view. You can also use a more advanced approach, by using the specific event markers. For an example, please see the default extension file at EXT:mbl_newsevent/event_template.tmpl.
If you make a new template file, you can actually put what you need into the news template (to have everything in the same place). You'll just have to set the plugin.tt_news.mbl_newsevent.templateFile property to the same as the news template (sorry, FlexForms won't work with this – yet).
plugin.tt_news.mbl_newsevent properties:
Property | Data type | Description | Default |
dateCorrect | integer | The number of seconds to put the dates shown into the future or the past. Corrects date changes that happen on certain servers (it seemes). Example: #Adds one hour to the displayed timeplugin.tt_news.mbl_newsevent.dateCorrect = 3600 | 0 |
dateSelItem_stdWrap | ->stdWrap | StdWrap for items in the Event Selector. | |
dateSelOrder | string | Sorting ascending (ASC) or descending (DESC). Insert values “ASC” or “DESC” | ASC |
eventPeriodPID | Integer | The page ID (PID) to link EventPeriod Selector links to. Set to zero for same page | 0 |
eventPeriodTarget | String | Target for Event Period Selector liniks | _self |
eventSelector | String | For the EVENT_SELECTOR option. Possible values are “list” or “menu”. Makes the Event Period Selector show either as a list or as a menu. | menu |
latestLimit | integer | Same as plugin.tt_news.latestLimit Defines the max numner of listed articles on one page for LATEST_EVENT_FUTURE and LATEST_EVENT_PAST. Set to 0 to use the value from plugin.tt_news.latestLimit | 0 |
latestShowsNewEvents | boolean | If true, LATEST_EVENT_FUTURE and LATEST_EVENT_PAST shows the newest events, and not the ucomming events. | 0 |
limit | integer | Same as plugin.tt_news.limit. Defines the max number of listed news articles on one page for EVENT_FUTURE and EVENT_PAST. Set to 0 to use the value from plugin.tt_news.limit | 0 |
showEventPeriodCount | Boolean | Show a count of articles in the periods listed by the Event Period Selector (“EVENT_SELECTOR”) | 1 |
showOrganizerEmail | boolean | If true, an event organizer's e-mail address is shown. | 1 |
templateFile | resource | The template file containing the few extra template items for News Event. Example: plugin.tt_news.mbl_newsevent.templateFile = EXT:mbl_newsevent/event_template.tmpl | EXT:mbl_newsevent/event_template.tmpl |
timeperiodSelMode | integer | For the event shown in the event selector: 0=all, 1=future events, 2=past events | 0 |
Plugin.tt_news.mbl_newsevent.ics properties:
Property | Data type | Description | Default |
fileName | string | The name of the downloaded ICS file. | Event Calendar.ics |
from | string | Older events than this date is not loaded into the ICS file. For info about the date formats, see: http://www.gnu.org/software/tar/manual/html_chapter/tar_7.html | 1 year ago |
templateFile | resource | The template file for the ICS generator. This file does normallly not need any changes, so the best is to let this setting stay at it's default. | EXT:mbl_newsevent/res/ics_template.tmpl |
to | string | Events further in the future than this is not loaded into the ICS file. For info about the date formats, see: http://www.gnu.org/software/tar/manual/html_chapter/tar_7.html | 1 year |
The following properties give the same results as in tt_news, but limited to event listings, when put into plugin.tt_news.mbl_newsevent: limit, latestLimit
Properties within the display settings for "LIST" and "LATEST", for example within plugin.tt_news.dispalyList.mbl_newsevent:
Property | Data type | Description | Default |
date_stdWrap | ->stdWrap | stdWrap for display of the event dates | |
organizer_stdWrap | ->stdWrap | stdWrap for display of the event organizer | |
time_stdWrap | ->stdWrap | stdWrap for display of the event times | |
where_stdWrap | ->stdWrap | stdWrap for display of the where field (event location). |
The ICS feature makes it possible to download a .ics (also called iCalendar) file with events. This feature closely resembles the RSS feed feature in tt_news. It can be configured either by including the static template “ICS feed (type=101)”
or with normal TypoScript like this:
icsevents = PAGE icsevents {typeNum = 10110 >10 < plugin.tt_news 10.pid_list >10.pid_list = {$plugin.tt_news.pid_list}10.singlePid = {$plugin.tt_news.singlePid}10.defaultCode = ICSconfig {disableAllHeaderCode = 1 #additionalHeaders = Content-type:text/calendarno_cache = 1xhtml_cleaning = 0 } }
The lines that are different from the RSS example in the tt_news manual have been colored red. One line has been commented out. That is additionalHeaders = Content-type:text/calendar, which value has been internalized.
The ICS feature has only been tested in Apple's iCal, but should work most places. An exceptioin may be Microsoft Outlook. Please give feedback ifyou can give me reports on other applications that the ICS is compatibe or incompatible with. In case of an incompatbility I'd be very happy if you could send me the error message you get (if any). I'd be over-enthusiastic if you could tell me why it doesn't work!
