.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ============== EXT:News Event ============== :Author: Kasper Skårhøj :Created: 2002-11-01T00:32:00 :Changed: 2017-02-17T16:16:15 :Author: Mathias Bolt Lesniak :Email: mathias@lilio.com :Info 3: :Info 4: .. _EXT-News-Event: EXT:News Event ============== Extension Key: **mbl\_newsevent** Copyright 2005-2011, Mathias Bolt Lesniak, Pixelant Powermail integration tutorial by Peter Klein. Sponsored by: `LiliO Design `_ , `hjulstad.no, `_ `OpenGate `_ , `typo3expert.at `_ and `zeitraum gmbh `_ Github: `https://github.com/pixelant/mbl\_newsevent `_ The singleics\_download.gif file comes from the *Silk* icon set by `Mark James `_ (Released under `Creative Commons Attribution 2.5 License `_ ) This document is published under the Open Content Licenseavailable from `http://www.opencontent.org/opl.shtml `_ The content of this document is related to TYPO3– a GNU/GPL CMS/Framework available from `www.typo3.org `_ .. _Table-of-Contents: Table of Contents ----------------- **EXT:News Event 1** **Introduction 1** What does it do? 1 Compatibility with tt\_news 1 Sponsoring this Extension 1 **Installing 2** Extension configurations 2 **Upgrading 2** **Users manual 2** Event Selector 2 New list modes 2 Ordering (IMPORTANT!) 3 ICS 3 **Administration 3** **Configuration 4** Reference 4 **Tutorial 6** How to integrate with the Powermail extension 6 **Frequently asked questions 9** **Known problems 10** **To-Do list 10** Adding your own features 10 Sponsoring additional features 10 **Changelog 10** .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ The News Event extension adds event information to normal News (tt\_news) articles. You can also connect the events with an event registration system of your choice and display price info. It is ideal for you who only want a simple list of events which are also posted as news articles. .. _Compatibility-with-tt-news: Compatibility with tt\_news ^^^^^^^^^^^^^^^^^^^^^^^^^^^ If you use FlexForm for configuration, this extension is not entirely compatible with tt\_news. Due to a missing hook in tt\_news ordering must be configured through TypoScript if you wish to order the listed news by any fields related to News Event. Repeated requests have been made, but at the time of writing, the hook is still missing in tt\_news. .. _Sponsoring-this-Extension: Sponsoring this Extension ^^^^^^^^^^^^^^^^^^^^^^^^^ We encourage our users to donate to help finance bug fixes and new features for this extension. **Feature requests from donors are of course prioritized.** Read more at `http://forge.typo3.org/projects/show/extension- mbl\_newsevent `_ .. _Installing: Installing ---------- You can install the extension through the Extension Manager. .. _Extension-configurations: Extension configurations ^^^^^^^^^^^^^^^^^^^^^^^^ **Display Where field as multi-line:** Check this box if you want the Where field displayed as a multi-line text area. The *where\_stdWrap* TypoScript property is configured by default to insert *
* tags at line endings if found. .. _Upgrading: Upgrading --------- If you are upgrading from a version prior to 1.0.0, you may see the menu item “UPDATE!” when viewing the extension in the Extension Manager. This means you have to update your database to separate Date and Time into their respective fields. Click on the Extension in the Extension Manager. Choose “UPDATE!” from the top left menu. Click on “Update now”. .. _Users-manual: Users manual ------------ Install the extension as usual through the Extensions Manager. In your TypoScript template, make sure to include the “News Event” static template. It should be placed *after* the “News settings” tt\_news static template. Insert the string “###EVENT\_WRAP###” where you want the event information to appear in the News template you are using. You can also insert “###EVENT\_REGISTER\_WRAP###” if you want to use event registration. ::

###NEWS_DATE### ###NEWS_TITLE###

###NEWS_IMAGE### ###EVENT_WRAP### ###EVENT_REGISTER_WRAP### ###NEWS_SUBHEADER### ###CATWRAP_B### ###TEXT_CAT### ###NEWS_CATEGORY### ###NEWS_CATEGORY_IMAGE### ###CATWRAP_E###
###MORE###
News Event uses it's own template file to format the event information. You can use this file or another one (you choose), and you can even insert the template information in the tt\_news template. You'll of course have to change the TypoScript variable plugin.tt\_news.mbl\_newsevent.templateFile to change the name of the template file used. Information about all the available template markers can be found in the default template file: *EXT:mbl\_newsevent/event\_template.tmpl* . .. _Event-Selector: Event Selector ^^^^^^^^^^^^^^ A third marker, which can be added to the template is ###EVENT\_SELECTOR\_LIST###. It will display a list of months/quarters/years much like tt\_news' *AMENU* function, but related to event dates and not posted date. It should be inserted outside of any *list-item* div tag (or equivalent). .. _New-list-modes: New list modes ^^^^^^^^^^^^^^ News Event adds a number of new list modes to News. The can be selected in the News plugin content element. - EVENT\_FUTURE: List future events (start date and time is later than now). - EVENT\_PAST: List past events (start date and time has been). - LATEST\_EVENT\_FUTURE: List of most recently posted events or future events closest to now (default). See Configuration for information about the TypoScript property changing this behavior. - LATEST\_EVENT\_PAST: List of most recently posted events with past event dates or past events closest to now (default). See Configuration for information about the TypoScript property changing this behavior. - EVENT\_CURRENT: List of currently ongoing events (events where the start date and time is in the past, but the end date and time is still in the future). - LATEST\_EVENT\_CURRENT: Depending on the ordering, either the events which have most recently become current or the ones ending next. - EVENT\_REGISTERABLE: List events to which it is possible to register (registration is enabled and the current time is between the registration start and stop date/time). If the event registration from date and time is not set, the registration is open from the instant the news is posted. If the event registration end date and time is not set, the event start date and time is used to determine when the event registration closes. - LATEST\_EVENT\_REGISTERABLE: Events which it is possible to register for, but (depending on the ordering) either the events where the registration start/end date and time is most recent or most distant. If the event registration from date and time is not set, the registration is open from the instant the news is posted. If the event registration end date and time is not set, the event start date and time is used to determine when the event registration closes. - To list the most recently opened registrations, order descending by registration start date and time. (See below.) - To list the upcoming registration end times (“upcoming registration deadlines”), order ascending by end date and time. (See below.) .. _Ordering-IMPORTANT: Ordering (IMPORTANT!) ^^^^^^^^^^^^^^^^^^^^^ When using the new list modes tt\_news must be set to order lists according to the event start dates. This can be done through the tt\_news plugin form or through TypoScript ( *plugin.tt\_news.listOrderBy* ): :: plugin.tt_news.listOrderBy = (tx_mblnewsevent_from + tx_mblnewsevent_fromtime) You may also want to order by the **ending date and time** of the event: :: plugin.tt_news.listOrderBy = (tx_mblnewsevent_to + tx_mblnewsevent_totime) Here's how you order by **registration start** : :: plugin.tt_news.listOrderBy = IF(tx_mblnewsevent_regfrom=0, datetime,(tx_mblnewsevent_regfrom + tx_mblnewsevent_regfromtime)) And registration **end date and time** : :: plugin.tt_news.listOrderBy = IF(tx_mblnewsevent_regto=0, (tx_mblnewsevent_from + tx_mblnewsevent_fromtime),(tx_mblnewsevent_regto + tx_mblnewsevent_regtotime)) Do not use the FlexForm in tt\_news to change this. It won't work, as tt\_news is missing a hook which allows adding new orderings to the menu. .. _ICS: ICS ^^^ The *ICS* or *iCalendar* file format works with many calendar programs. If you want to use the ICS feature, you will have to include the ICS static template in your TypoScript template. .. _ICS-feed-with-all-events: ICS feed with all events """""""""""""""""""""""" Many calendar applications allow you to subscribe to calendar data. Just like an RSS feed, you can keep your calendar up-to-date with all new events automatically. The link to the ICS feed would typically look like this: ` *http://www.example.com/index.php?id=1&type=101&no\_cahce=1* `_ . .. _ICS-for-single-events: ICS for single events """"""""""""""""""""" ICS for single events works in much the same way as the feed with all events. The difference? The generated ICS file contains only one event. When you include the correct static template, a link to “Add to calendar” will automatically be displayed with every event. .. _Important-if-you-don-t-use-TypoScript-constants-to-configure-ICS: Important if you don't use TypoScript constants to configure ICS """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" Unless you use TypoScript constants to set up tt\_news, you should include the TypoScript below as a minimum configuration in your TypoScript template. Otherwise the ICS feature won't work at all. :: icsevents.10 { pid_list < plugin.tt_news.pid_list singlePid < plugin.tt_news.singlePid } The page object for single events is called :code:`singleicsevent` , so you will have to write :code:`singleicsevent.10` instead to configure the single event ICS feature. .. _Administration: Administration -------------- News Event's configuration is done through an addition to the usual tt\_news TypoScript. Please refer to the chapter Configuration for more information. Some TypoScript properties are also available through the Constants Editor. .. _Configuration: Configuration ------------- News Event's configuration is done through an addition to the usual tt\_news TypoScript. All News Event properties reside within this TypoScript path: *plugin.tt\_news.mbl\_newsevent.* .. _Reference: Reference ^^^^^^^^^ .. ### BEGIN~OF~TABLE ### .. _templateFile: templateFile """""""""""" .. container:: table-row Property templateFile Data type resource Description The template file (HTML). Default EXT:mbl\_newsevent/event\_template.tmpl .. _date-stdWrap: date\_stdWrap """"""""""""" .. container:: table-row Property date\_stdWrap Data type ->stdWrap Description Date formatting for event dates :: plugin.tt_news.mbl_newsevent { date_stdWrap.strftime = %x } Default .. _time-stdWrap: time\_stdWrap """"""""""""" .. container:: table-row Property time\_stdWrap Data type ->stdWrap Description Time formatting for event dates :: plugin.tt_news.mbl_newsevent { time_stdWrap.strftime = %H:%M } Default .. _where-stdWrap: where\_stdWrap """""""""""""" .. container:: table-row Property where\_stdWrap Data type ->stdWrap Description Wrap for location. Default .. _organizer-stdWrap: organizer\_stdWrap """""""""""""""""" .. container:: table-row Property organizer\_stdWrap Data type ->stdWrap Description Wrap for organizer information. Default .. _dateLabel-stdWrap: dateLabel\_stdWrap """""""""""""""""" .. container:: table-row Property dateLabel\_stdWrap Data type ->stdWrap Description Wrap for the “Date” text label Default .. _datesLabel-stdWrap: datesLabel\_stdWrap """"""""""""""""""" .. container:: table-row Property datesLabel\_stdWrap Data type ->stdWrap Description Wrap for the “Dates” text label Default .. _toLabel-stdWrap: toLabel\_stdWrap """""""""""""""" .. container:: table-row Property toLabel\_stdWrap Data type ->stdWrap Description Wrap for the “to” text label Default .. _whereLabel-stdWrap: whereLabel\_stdWrap """"""""""""""""""" .. container:: table-row Property whereLabel\_stdWrap Data type ->stdWrap Description Wrap for the “Location” text label Default .. _organizerLabel-stdWrap: organizerLabel\_stdWrap """"""""""""""""""""""" .. container:: table-row Property organizerLabel\_stdWrap Data type ->stdWrap Description Wrap for the “Organizer” text label Default .. _showOrganizerEmail: showOrganizerEmail """""""""""""""""" .. container:: table-row Property showOrganizerEmail Data type boolean Description If true, the organizer's name is linked to the organizer's e-mail (if available). Default 1 .. _dateSelMode: dateSelMode """"""""""" .. container:: table-row Property dateSelMode Data type string Description Period type for the date selector. Values can be: month, quarter or year. Default Month .. _dateSelMenuNoEmpty: dateSelMenuNoEmpty """""""""""""""""" .. container:: table-row Property dateSelMenuNoEmpty Data type boolean Description If true, date selector periods without events are omitted in the list. Default 0 .. _dateSelTypoLink: dateSelTypoLink """"""""""""""" .. container:: table-row Property dateSelTypoLink Data type ->typolink Description Link where the date selector links should point. Default .. _disableCategoriesInDateSelLinks: disableCategoriesInDateSelLinks """"""""""""""""""""""""""""""" .. container:: table-row Property disableCategoriesInDateSelLinks Data type boolean Description If true, category settings are not carried in date selector links. Default 0 .. _dateSelMenuWithCatSelector: dateSelMenuWithCatSelector """""""""""""""""""""""""" .. container:: table-row Property dateSelMenuWithCatSelector Data type boolean Description The same as *plugin.tt\_news.latestWithCatSelector* . See tt\_news manual for more information. Default 0 .. _dateselHeader-stdWrap: dateselHeader\_stdWrap """""""""""""""""""""" .. container:: table-row Property dateselHeader\_stdWrap Data type ->stdWrap Description Wrap for the date selector header Default .. _dateSelTitleCObject: dateSelTitleCObject """"""""""""""""""" .. container:: table-row Property dateSelTitleCObject Data type COA/->stdWrap Description Date selector item title. See tt\_news manual entry for *plugin.tt\_news.archiveTitleCObject* for more infromation. Default .. _LatestShowsNewEvents: LatestShowsNewEvents """""""""""""""""""" .. container:: table-row Property LatestShowsNewEvents Data type boolean Description If true, newly posted events are listed in the LATEST\_EVENT\_FUTURE and LATEST\_EVENT\_PAST list modes. *It may seem funny to list most newly posted events with past event dates. I wonder if anyone will ever use that feature.* Default 0 .. _ics-templateFile: ics.templateFile """""""""""""""" .. container:: table-row Property ics.templateFile Data type resource Description Template for the ICS feed. You will most likely *not* need to change this property. Default EXT:mbl\_newsevent/res/ics\_template.tmpl .. _ics-icsName: ics.icsName """"""""""" .. container:: table-row Property ics.icsName Data type string Description The suggested name of the calendar. Default News Events .. _ics-from: ics.from """""""" .. container:: table-row Property ics.from Data type string Description Start date for ICS feeds. Events starting before this date is omitted. Accepts a time string compatible with PHP's strtotime() function. More info at: `http://www.php.net/manual/en/function.strtotime.php `_ Default 1 year ago .. _ics-to: ics.to """""" .. container:: table-row Property ics.to Data type string Description End date for ICS feeds. See *ics.from* for more information. Default 1 year .. _singleics-templateFile: singleics *.* templateFile """""""""""""""""""""""""" .. container:: table-row Property singleics *.* templateFile Data type resource Description *See ics.templateFile* Default *EXT:mbl\_newsevent/res/ics\_template.tmpl* .. _singleICSLink-stdWrap: singleICSLink\_stdWrap """""""""""""""""""""" .. container:: table-row Property singleICSLink\_stdWrap Data type ->stdWrap Description The rendering of links to single event ICS. Default *(See static/singleics/setup.txt)* .. _automaticAdjustTime: automaticAdjustTime """"""""""""""""""" .. container:: table-row Property automaticAdjustTime Data type boolean Description The extension will attempt to correct incorrect time using time zone and daylight saving information. Default 0 .. _automaticAdjustDate: automaticAdjustDate """"""""""""""""""" .. container:: table-row Property automaticAdjustDate Data type boolean Description The extension will attempt to correct incorrect dates using time zone and daylight saving information. Default 0 .. _adjustTime: adjustTime """""""""" .. container:: table-row Property adjustTime Data type int Description Adjusts time with the given amount of seconds. Default 0 .. _adjustDate: adjustDate """""""""" .. container:: table-row Property adjustDate Data type int Description Adjusts the date with the given number of seconds. One day is usually 86400 seconds. Default 0 .. _displayEventUntilEnd: displayEventUntilEnd """""""""""""""""""" .. container:: table-row Property displayEventUntilEnd Data type boolean Description The extension will use the end date and time of the event when determining wether to display it or not. This will make events visible until they are over. Default 0 .. _enableRegistration: enableRegistration """""""""""""""""" .. container:: table-row Property enableRegistration Data type boolean Description Enable event registration. Default 0 .. _registrationLink-typolink: registrationLink\_typolink """""""""""""""""""""""""" .. container:: table-row Property registrationLink\_typolink Data type ->typolink Description The registration link. Defaults to link to the “Registration URL field”, but can be configured in many advanced ways. Here's an example (insertPIDorURL needs to be replaced with the page ID or URL): :: registrationLink_typolink { parameter.field > parameter = insertPIDorURL ATagParams = rel="lightbox" additionalParams.field = uid additionalParams.wrap = &powermail[tt_news]=| } This will result in a link not much different from this: :: Register Default Loads parameter from *tx\_mblnewsevent\_regurl* .. _replaceWithClosed: replaceWithClosed """"""""""""""""" .. container:: table-row Property replaceWithClosed Data type boolean Description If the event registration is closed, replace the ###EVENT\_REGISTER\_WRAP### marker with the contents of the ###EVENT\_REGISTER\_CLOSED### subpart. Default 1 .. _registrationClosed-stdWrap: registrationClosed\_stdWrap """"""""""""""""""""""""""" .. container:: table-row Property registrationClosed\_stdWrap Data type ->stdWrap Description Wrap for the ###REGISTER\_CLOSED\_LABEL### marker. Default .. _registerAvailableUntilEnd: registerAvailableUntilEnd """"""""""""""""""""""""" .. container:: table-row Property registerAvailableUntilEnd Data type boolean Description If true and no registration end date is set, events will be registrable until the event ends. Default 0 .. _enablePrice: enablePrice """"""""""" .. container:: table-row Property enablePrice Data type boolean Description Enable displaying the price for the event. Default 0 .. _price-stdWrap: price\_stdWrap """""""""""""" .. container:: table-row Property price\_stdWrap Data type ->stdWrap Description Wrap for the price. Default .. _priceDecimals: priceDecimals """"""""""""" .. container:: table-row Property priceDecimals Data type int Description The number of decimals shown in the price. Default 2 .. _zeroPrice-stdWrap: zeroPrice\_stdWrap """""""""""""""""" .. container:: table-row Property zeroPrice\_stdWrap Data type ->stdWrap Description Wrap for the text shown if the price is zero or less. Default .. _pricenote-stdWrap: pricenote\_stdWrap """""""""""""""""" .. container:: table-row Property pricenote\_stdWrap Data type ->stdWrap Description Wrap for the price info text. Default .. _enableRegistrationsTracking: enableRegistrationsTracking """"""""""""""""""""""""""" .. container:: table-row Property enableRegistrationsTracking Data type boolean Description Enable tracking of registration counts. Default 0 .. _registrationsTable: registrationsTable """""""""""""""""" .. container:: table-row Property registrationsTable Data type string / ->stdWrap Description The table from which the registrations count should be requested Default .. _registrationsSelect: registrationsSelect """"""""""""""""""" .. container:: table-row Property registrationsSelect Data type string / ->stdWrap Description How to find the count. - Use “COUNT(\*)” to count the number of rows found. - User a *fieldname* to pick the count from that field. This parameter should only return a single value. Additional values will be ignored. Default COUNT(\*) .. _registrationsWhere: registrationsWhere """""""""""""""""" .. container:: table-row Property registrationsWhere Data type string / ->stdWrap Description Where clause, e.g. to limit the results in case of a “COUNT(\*)”. Default .. _disableIfFull: disableIfFull """"""""""""" .. container:: table-row Property disableIfFull Data type boolean Description Disable registration if the event is full. Default 1 .. _registrationFull-stdWrap: registrationFull\_stdWrap """"""""""""""""""""""""" .. container:: table-row Property registrationFull\_stdWrap Data type ->stdWrap Description Wrap for the ###REGISTER\_FULL\_LABEL### marker. Default .. _displayMaxRegistrations: displayMaxRegistrations """"""""""""""""""""""" .. container:: table-row Property displayMaxRegistrations Data type boolean Description Display the max number of registrations available for the event. Default 1 .. _maxRegistrations-stdWrap: maxRegistrations\_stdWrap """"""""""""""""""""""""" .. container:: table-row Property maxRegistrations\_stdWrap Data type ->stdWrap Description Wrap for the max number of registrations value. Default .. _maxRegistrationsLabel-stdWrap: maxRegistrationsLabel\_stdWrap """""""""""""""""""""""""""""" .. container:: table-row Property maxRegistrationsLabel\_stdWrap Data type ->stdWrap Description Wrap for the max number of registrations label. Default .. _displayPlacesFree: displayPlacesFree """"""""""""""""" .. container:: table-row Property displayPlacesFree Data type boolean Description Display the number of places free for the event. Default 1 .. _placesFree-stdWrap: placesFree\_stdWrap """"""""""""""""""" .. container:: table-row Property placesFree\_stdWrap Data type ->stdWrap Description Wrap for the number of places free value. Default .. _placesFreeLabel-stdWrap: placesFreeLabel\_stdWrap """""""""""""""""""""""" .. container:: table-row Property placesFreeLabel\_stdWrap Data type ->stdWrap Description Wrap for the number of places free label. Default .. _displayCurrentRegistrations: displayCurrentRegistrations """"""""""""""""""""""""""" .. container:: table-row Property displayCurrentRegistrations Data type boolean Description Display the number of currently registered for the event. Default 1 .. _currentRegistrations-stdWrap: currentRegistrations\_stdWrap """"""""""""""""""""""""""""" .. container:: table-row Property currentRegistrations\_stdWrap Data type ->stdWrap Description Wrap for the number of currently registered value. Default .. _currentRegistrationsLabel-stdWrap: currentRegistrationsLabel\_stdWrap """""""""""""""""""""""""""""""""" .. container:: table-row Property currentRegistrationsLabel\_stdWrap Data type ->stdWrap Description Wrap for the number of currently registered label. Default .. _closedFullPriority: closedFullPriority """""""""""""""""" .. container:: table-row Property closedFullPriority Data type “closed” / “full” / “both” Description If the event is both full and registration closed, what should be displayed as a message? - **closed:** Only the message that the event is closed. - **full:** Only the message that the event is full. - **both:** Both messages should be displayed. Default closed .. _hideEvents: hideEvents """""""""" .. container:: table-row Property hideEvents Data type boolean Description Hides news with event data from lists. Convenient if you want to display only news without events. Default 0 .. ###### END~OF~TABLE ###### [plugin.tt\_news.mbl\_newsevent ] .. _Tutorial: Tutorial -------- .. _How-to-integrate-with-the-Powermail-extension: How to integrate with the Powermail extension ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. _Setup-Powermail-part: Setup (Powermail part): """"""""""""""""""""""" Create a page and insert the Powermail plugin. Then create these three fields. (You can create more fields later, but these three are required.) The first field you should create is used to display the name of the event on the powermail form. The field should be of the type “Add typoscript object”, and the “typoscript object” should be set to “lib.eventinfo”, like this: |img-1| The second field is a hidden field that holds the title of the event (So you can see which event the user has signed up to.) The field should be of the type “Hidden field”, like this: |img-2| Remember the value of the field “Name for Templates”, as that is needed later for the TypoScript setup. The third field is similar to the second, but is used to store the UID of the event the user is signing up for. (Useful for reference etc.) The field should look like this: |img-3| Again, remember the value of the field “Name for Templates”, as that is needed later for the TypoScript setup. .. _Setup-TypoScript-Constants-part: Setup (TypoScript Constants part): """""""""""""""""""""""""""""""""" In your Constants field, insert and modify this to match the Powermail fields you just created: :: # Change 62 to the pid of the page/sysfolder where your tt_news records are stored. plugin.tt_news.pid_list = 62 # Change 45 to the pid of the page where you have inserted the powermail plugin. powermail.plugin.pid = 45 # Name of hidden powermail field created to hold the eventtitle. powermail.eventtitle.uid = uid8 # Name of hidden powermail field created to hold the eventuid. powermail.eventuid.uid = uid5 .. _Setup-TypoScript-Setup-part: Setup (TypoScript Setup part): """""""""""""""""""""""""""""" In your Setup field insert this: :: plugin.tt_news { # Here's how you order by registration start: listOrderBy = IF(tx_mblnewsevent_regfrom=0, datetime,(tx_mblnewsevent_regfrom + tx_mblnewsevent_regfromtime)) #And registration end date and time: #listOrderBy = IF(tx_mblnewsevent_regto=0, (tx_mblnewsevent_from + tx_mblnewsevent_fromtime),(tx_mblnewsevent_regto + tx_mblnewsevent_regtotime)) _LOCAL_LANG.default { noNewsToListMsg = There's no events at the moment. backToList = « Back to list of events textRelated = Related events: } mbl_newsevent { enableRegistration = 1 registrationLink_typolink { title.data = LLL:EXT:mbl_newsevent/locallang.xml:registerLinkLabel parameter = {$powermail.plugin.pid} parameter.override.field = tx_mblnewsevent_regurl additionalParams.field = uid additionalParams.intval = 1 additionalParams.wrap = &tx_powermail_pi1[eventUid]=| } replaceWithClosed = 1 registerAvailableUntilEnd = 0 registrationClosed_stdWrap { wrap = | data = LLL:EXT:mbl_newsevent/locallang.xml:registerClosed } } } # Text for the powermail form, describing the event the user is signing up for. lib.eventinfo = COA_INT lib.eventinfo { 10 = CONTENT 10.table = tt_news 10.select { pidInList = {$plugin.tt_news.pid_list} andWhere.data = GPvar:tx_powermail_pi1|eventUid andWhere.intval = 1 andWhere.wrap = uid=| } 10.renderObj = TEXT 10.renderObj.field = title 10.renderObj.wrap =

You are now signing up for the event: |

10.if.isTrue.data = GPvar:tx_powermail_pi1|eventUid } # Powermail prefill fields plugin.tx_powermail_pi1 { prefill { // Prefil field with event title {$powermail.eventtitle.uid} = COA {$powermail.eventtitle.uid} { 10 = CONTENT 10.table = tt_news 10.select { pidInList = {$plugin.tt_news.pid_list} andWhere.data = GPvar:tx_powermail_pi1|eventUid andWhere.intval = 1 andWhere.wrap = uid=| } 10.renderObj = TEXT 10.renderObj.value = Error! No eventUid specified. 10.renderObj.override.field = title } // Prefill field with event uid {$powermail.eventuid.uid} = COA {$powermail.eventuid.uid} { 10 = TEXT 10.data = GPvar:tx_powermail_pi1|eventUid 10.required = 1 } } } .. _Frequently-asked-questions: Frequently asked questions -------------------------- .. _generated: ((generated)) ^^^^^^^^^^^^^ .. _I-have-changed-TypoScript-parameters-for-the-extension-but-I-see-no-change-What-s-up: I have changed TypoScript parameters for the extension, but I see no change. What's up? """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" If you have cleared the cache and haven't misspelled the parameter name, make sure you have inserted the changes under *plugin.tt\_news.mbl\_newsevent* . A common error is to insert the changes under *plugin.tt\_news* . .. _How-do-I-change-language-strings-through-TypoScript: How do I change language strings through TypoScript? """""""""""""""""""""""""""""""""""""""""""""""""""" With tt\_news you can change language strings at *plugin.tt\_news.\_LOCAL\_LANG.* With mbl\_newsevent you have to do it by editing *plugin.tt\_news.mbl\_newsevent.\_LOCAL\_LANG.* .. _How-do-I-make-tt-news-RSS-feature-list-only-events: How do I make tt\_news' RSS feature list only events? """"""""""""""""""""""""""""""""""""""""""""""""""""" You can make tt\_news output RSS (XML) at the same time as mbl\_newsevent handles makes sure only events are output. Here's an example TypoScript, thanks to Vincent Kessels: :: plugin.tt_news { code = XML mbl_newsevent { currentCode = EVENT_FUTURE } } It is important to note that tt\_news' RSS static template has to be included AFTER tt\_news and mbl\_newsevent's static templates. Otherwise, the settings for events won't be carried over to the RSS feed. .. _Known-problems: Known problems -------------- There are currently no known problems except from the mentioned incompatibilities with tt\_news. Please post all bugreports, issues or feature requests on the `TYPO3 Forge `_ . .. _To-Do-list: To-Do list ---------- - Increased ICS compatibility. - Date selector as a drop-down menu. .. _Adding-your-own-features: Adding your own features ^^^^^^^^^^^^^^^^^^^^^^^^ Please feel free to suggest new features to News Event. The best thing is if you implement the new feature yourself (in PHP) and send it over. .. _Sponsoring-additional-features: Sponsoring additional features ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ If you do not know how to program in PHP, you can sponsor the creation of specific features in the extension. `Send an e-mail `_ to discuss pricing and features. .. _Changelog: Changelog --------- .. _generated: ((generated)) ^^^^^^^^^^^^^ .. _Changes-in-version-0-2-0: Changes in version 0.2.0 """""""""""""""""""""""" - Added new field called “EVENT\_SELECTOR”. It lists events for different periods, like the archive menu (“AMENU”). - Added possibility to define the *limit* and *latestLimit* TS properties specificly for the event lists. - Some changes to the manual (corrections and additions). - Changed the icon slightly (added a plus-sign) to indicate that the extension extends tt\_news. - Localizeable template markers for strings like “Event date(s):” and “Location”. .. _Changes-in-version-0-3-0: Changes in version 0.3.0 """""""""""""""""""""""" - ICS calendar download possibility. - Organizer information (can be gathered from fe\_users, be\_users or tt\_address). Introduces the fields ###EVENT\_ORGANIZER### and ###EVENT\_ORGANIZER\_TEXT### (the last for the label) in the template. - Added the field ###EVENT\_TO\_TEXT### in the templates for translated versions of the english word “to” in the template. - An amount of seconds can now be added to or subtracted from the times displayed in listings. - Misc. bugs corrected. .. _Changes-in-version-0-3-2: Changes in version 0.3.2 """""""""""""""""""""""" - It is now possible to make the event selector show either all, future or past events through the TypoScript variable *plugin.tt\_news.mbl\_newsevent.timeperiodSelMode* . Thanks to Stig Færch for this. - New translations included (Norwegian and Finnish). .. _Changes-in-version-0-4-0: Changes in version 0.4.0 """""""""""""""""""""""" - ICS feed available as a static ext template. - TypoScript Constants and Setup files preconfigured. - Divider to tabs implemented. News Event now has it's own tab when you create or edit a news article. (Requires tt\_news 2.0.2 or higher, and Typo3 version 3.7.0 or higher.) - Tested with multilingual news. Work without problems. .. _Changes-in-version-0-4-1: Changes in version 0.4.1 """""""""""""""""""""""" - Static template must be included for News Events to work. - Some bugs corrected. .. _Changes-in-versions-0-4-2-0-4-4: Changes in versions 0.4.2-0.4.4 """"""""""""""""""""""""""""""" - Bugs corrected - Added dateSelOrder TypoScript property to choose ascending or descending sorting of the Event Period Selector. .. _Changes-in-version-0-4-5: Changes in version 0.4.5 """""""""""""""""""""""" - Corrected a bug that made the Event Selector not show in some cases. - German localization (thanks to René Rossi) - Correction to the Norwegian localization (Quarter is “kvartal”, not “kvarter”). - The Extension repository now has the same version number as this manual. How surprising! .. _Changes-in-version-0-4-6: Changes in version 0.4.6 """""""""""""""""""""""" Corrected a bug in the Event Selector where items were shown that shouldn't be visible. (Thanks to Stig Nørgaard Færch for that.) .. _Changes-in-version-1-0-0: Changes in version 1.0.0 """""""""""""""""""""""" - This version is almost 100% rewritten. No new features, but a much nicer code. It will hopefully be much more compatible with tt\_news updates. - This version is **only partially** compatible with previous versions. - This version is waiting for a feature in tt\_news before it becomes 100% compatible with tt\_news. .. _Changes-in-version-1-1-0: Changes in version 1.1.0 """""""""""""""""""""""" - Events can now be displayed until they end (new TS property displayEventUntilEnd). - Fixing bug appearing when events are exactly 7 days long. (Thanks to Sven Homrighausen.) - Fixing bug where ICS news links were wrong. (Thanks to Daniel Minder.) - New “UPDATE” menu item appears if database needs to be updated: Date and Time is kept in separate fields as of v1.0.0. - Updated manual. .. _Changes-in-version-2-0-0: Changes in version 2.0.0 """""""""""""""""""""""" Event registration linking and registration start and end. Sponsored by Redvald Hjulstad, `hjulstad.no `_ . - Backend interface improvements. - extraItemMarkerProcessor() now uses it's own cObj instance with the current tt\_news row as data. - Removing time adjustment from ICS. Since ICS uses UTC time, time adjustment shouldn't be needed. (Thanks to Daniel Minder) - adjustDate in TypoScript is now deprecated. adjustTime is now the only time adjustment property. .. _Changes-in-version-2-0-1: Changes in version 2.0.1 """""""""""""""""""""""" French translation by Edern Appéré. .. _Changes-in-version-2-1-0: Changes in version 2.1.0 """""""""""""""""""""""" - Price and price info field, sponsored by `OpenGate `_ . - Multi-line Where field, sponsored by `OpenGate `_ . Enabled as a configuration option in the Extension Manager. - Danish translation thanks to Peter Klein. - Better backend form layout thanks to Peter Klein. - Tutorial section on integration with Powermail thanks to Peter Klein. - All template markers can be inserted directly into the template (suggested by Kasper Ligaard), but it is still recommended to keep them inside the defined subparts (like *###ONE\_DAY\_EVENT###* ), to make use of the different event type dependent templates. - Added parameters automaticAdjustDate and adjustDate, so dates can be changed independently of times. - Corrected bug where the event selector would not work correctly, thanks to Olaf Jörding. - Changing language labels through TypoScript is now possible, thanks to Rene Rossi. - German backend translation, thanks to Sebastian Wramba. - Now on Forge: `http://forge.typo3.org/projects/show/extension- mbl\_newsevent `_ - Moved all TypoScript configuration into static template, making it easier to correct the issue where ICS would not show if TypoScript for ICS was included before the main extension TypoScript. - Somewhat higher Outlook compatibility. .. _Changes-in-version-2-2-0: Changes in version 2.2.0 """""""""""""""""""""""" - All news with events can be hidden by setting the :code:`hideEvents` TypoScript parameter to TRUE. - Additional German translation, thanks to Igor Reitmair (typo3expert.at). - Fixed addtionalHeaders so it sends correct info for ICS. .. _Changes-in-version-2-3-0: Changes in version 2.3.0 """""""""""""""""""""""" - Download ICS files for individual events (using the list mode ICS\_SINGLE). Link is inserted using the ###EVENT\_SINGLE\_ICS\_LINK### marker. Sponsored by `Igor Reitmair (typo3expert.at) `_ . - Now using tt\_news' :code:`local\_cObj` property correctly in :code:`extraItemMarkerProcessor()` . - If there is no organizer, organizer info is hidden in ICS files. - Removed unused TypoScript parameter :code:`ics.fileName` .. _Changes-in-version-2-4-0: Changes in version 2.4.0 """""""""""""""""""""""" - Displays number of registered / max registrations etc. The registration count is picked from a custom DB table, either as the result of a COUNT(\*) operation or by finding the number of registered in a specific field. What's the right configuration depends on your event registration system's setup. - stdWrap for labels. (Thanks to Christoph Bauer) - Updated manual FAQ with info about XML/RSS handling. (Thanks to Vincent Kessels) - Improved handling of :code:`displayEventUntilEnd` (Thanks to Bernd Braemer) .. _Changes-in-version-2-4-1: Changes in version 2.4.1 """""""""""""""""""""""" Updated manual regarding tt\_news compatibility. .. _Changes-in-version-2-5-0: Changes in version 2.5.0 """""""""""""""""""""""" - Added TYPO3 6.2 compatibility (sponsored by `zeitraum gmbh `_ ) - Improved all day events for ICS. (Changes in the ICS template.) - Fixed bug where the link to the news article would not appear properly in ICS. - Improved compatibility with other tt\_news extensions (thanks to Victor Livakovsky) - ###EVENT\_ORGANIZER\_INFO### inserts the content of the subpart ###EVENT\_ORGANIZER\_WRAP###. This improves the display of events without organizer. - ###EVENT\_LOCATION\_INFO### inserts the content of the subpart ###EVENT\_LOCATION\_WRAP###. This improves the display of events without location. - ###EVENT\_PRICE\_INFO### inserts the content of the subpart ###EVENT\_PRICE\_WRAP###. This improves the display event price. - ###EVENT\_WHERE### is deprecated. Use ###EVENT\_LOCATION### instead. - ###EVENT\_WHERE\_TEXT### is deprecated. Use ###EVENT\_LOCATION\_TEXT### instead. - New tt\_news\_v3\_template\_newsevent.html template file for tt\_news version 3+. .. _Changes-in-version-2-5-1: Changes in version 2.5.1 """""""""""""""""""""""" Fixed bug where ###EVENT\_SELECTOR\_LIST### did not work. .. _Changes-in-version-7-6-0: Changes in version 7.6.0 """""""""""""""""""""""" - Compatibility with tt\_news 7.6 - Compatibility with TYPO3 7 LTS |img-4| EXT:News Event - 14 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. :border: 0 .. :height: 528 .. :id: graphics1 .. :name: graphics1 .. :width: 529 .. |img-2| image:: img-2.png .. :align: left .. :border: 0 .. :height: 427 .. :id: graphics2 .. :name: graphics2 .. :width: 529 .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 460 .. :id: graphics3 .. :name: graphics3 .. :width: 529 .. |img-4| image:: img-4.png .. :align: left .. :border: 0 .. :height: 32 .. :id: Graphic1 .. :name: Graphic1 .. :width: 102