.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt =========== EXT: Events =========== :Created: 2010-02-18T17:33:18 :Changed by: Dirk Wenzel :Changed: 2013-02-16T21:50:21 :Classification: t3events :Description: t3events manages events. It provides integrators with the option to display event items in a list or a single view. Each event can contain one or more performances. For each performance, integrators have the option to list as many ticket classes as needed as well as various other information about the events. Performance locations can be accorded the following meta information: address, link, image etc. A teaser view is also available. A quick menu allows users to filter the list view by genre. The extension was built from scratch with extbase and fluid. Originally designed to fulfill the specific requirements of a client project, this extension remains under development. We appreciate any feedback or suggestions for improvement. :Keywords: event, performance, ticket, teaser, forEditors, forIntermediates :Author: Dirk Wenzel :Email: t3events@webfox01.de :Info 4: :Language: en |img-1| |img-2| EXT: Events - t3events .. _EXT-Events: EXT: Events =========== Extension Key: t3events Language: en Version: 0.3.9 Keywords: event, performance, ticket, teaser, forEditors, forIntermediates Copyright 2000-2010, Dirk Wenzel, This document is published under the Open Content License available 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: Event Manager 1 <#__RefHeading__788_84494084>`_ **`Introduction 3 <#__RefHeading__790_84494084>`_** `What does it do? 3 <#__RefHeading__792_84494084>`_ **`Users manual 4 <#__RefHeading__2358_1135034655>`_** `Overview 4 <#__RefHeading__796_84494084>`_ `Auxiliary Records 4 <#__RefHeading__798_84494084>`_ `Events 4 <#__RefHeading__800_84494084>`_ `Insert Plugins 7 <#__RefHeading__802_84494084>`_ **`Configuration 8 <#__RefHeading__804_84494084>`_** `Overview 8 <#__RefHeading__882_84494084>`_ **`To-Do list 9 <#__RefHeading__1046_84494084>`_** **`Credits 10 <#__RefHeading__895_1135034655>`_** .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ t3events manages events. It provides integrators with the option to display event items in a list or a single view. Each event can contain one or more performances. For each performance, integrators have the option to list as many ticket classes as needed as well as various other information about the events. Performance locations can be accorded the following meta information: address, link, image etc. A teaser view is also available. A quick menu allows users to filter the list view by genre. The extension was built from scratch with extbase and fluid. Originally designed to fulfill the specific requirements of a client project, this extension remains under development. We appreciate any feedback or suggestions for improvement. Don't hesitate to write an email to `t3events@webfox01.de `_ or ask in the German or English TYPO3-Mailinglist, which we actively follow. Visit the `project page of t3events `_ on TYPO3 forge for information about new features and current issues. .. _Users-manual: Users manual ------------ .. _Overview: Overview ^^^^^^^^ - Create records for events, performances, locations, genres etc - Insert a plugin at any page and configure it to display teasers, events or a quick menu .. _Auxiliary-Records: Auxiliary Records ^^^^^^^^^^^^^^^^^ .. _Genre: Genre """"" Help to categorize your events. An event may belong to multiple genres (i.e. Classic, Rock, Comedy etc.) .. _Event-Type: Event Type """""""""" Another kind of category. An event can belong to only one event type (i.e. concert, theater, congress). Since this attribute is not being considered anywhere at the moment you may use a standard type or nothing. We will implement a feature for filtering list views by event type later on. .. _Venue: Venue """"" The facility with wich the event is associated. This might be an arena, a hall, congress center, an exhibition ground or any other venue. You should create at least one venue record. Hint: The name of this record type might be misleading – especially for native english speakers. The customer for whom we developed this extension runs a bunch of facilities in different cities (congress centers, stadiums and so on). Each of them has multiple actual venues (rooms, stages etc). All facilities have their own websites mangaged within one TYPO3 instance. Since all teasers for events should be stored in a common sysfolder we needed an attribute to distinguish teasers by 'facility' (and called this 'venues'). So this attribute is useful to manage the visibility of teasers for editors and to select certain teasers for display in frontend. If you don't have to regard multiple facilities just create a standard entry and configure your frontend plugin to show all teasers related with this 'facility/venue'. .. _Event-Location: Event Location """""""""""""" The actual location where the event takes place. This might be a room, a stage, a stand at a trade fair or something similar. .. _Organizer: Organizer """"""""" The person or organization who organizes the event. Contains address, phone, www and so on. .. _Status: Status """""" An indicator which may change during existence of the event. It is related to performances (see below for further information about events and performances). It's intention is to show the status of a performance (i.e. planned, sold out, bookable, few tickets available etc.). We plan to implement an automatic status update mechanism wich for example could change the availabilty of tickets according to current time. All this record types are fairly simple and self explaining. They are created by inserting a new content element and choosing the appropriate type. .. _Events: Events ^^^^^^ Create a new Event by inserting a new record and choosing the type 'event'. .. _General-Tab: General Tab """"""""""" Here you may provide a - headline (mandatory) - subtitle - description - image - event type This information will be shown in the list and detail view of events and may be choosen for display in teasers. |img-3| .. _Extended-Tab: Extended Tab """""""""""" Provide additional information: - Organizer: Select one from list (if there is none available you may create them and select one afterwards) - Genre: Genres are useful to categorize your events. The frontend plugin 'Quick Menu' allows the website user to filter the event list by genres. Genres may be created and edited directly by clicking the appropriate button. - Keywords: may be displayed or included in meta information .. _img-4-Performances-Tab: |img-4| Performances Tab """""""""""""""""""""""" You have to create at least one performance for each event and may add as many as you like. .. _Single-Performance: Single Performance ~~~~~~~~~~~~~~~~~~ **General Tab** - Date (mandatory) - Event location (select field, has to be created before) - Admission, Begin and End time - Status (select field. Status record must be created beforehand to be selectable). The status is displayed as a signal in the list view. Therefore you can assign one or more CSS classes. Since there might be more than one performance related to an event Status records can be priorized. The most crucial status will be displayed in list view then (For example if there are some performances sold out and others not yet you can mark the event with 'bookable' in list view by giving the status 'bookable' the highest priority i.e. lowest number) - Status information: additional information for the selected status. For example: 'online booking not available anymore please order by phone' - Image: Will be shown in list and single view of events and may be choosen to show in teaser view **Links Tab** Provide links to external or internal providers (for tickets or booking) **Tickets Tab** - Plan: an image containing a floor plan or color coded seating plan - Price Notice: additionl information for prices - No handling fee: useful for booking for example when using a shopping cart - Ticket Class: one or more ticket classes. Contains fields for color (for example for seating plan), title, price and type (normal, reduced, special) .. _Insert-Plugins: Insert Plugins ^^^^^^^^^^^^^^ Insert a record of type plugin, in tab 'Plugin' select 'Events' and choose what to display (Teaser, Event List or Quick Menu). In tab 'Behavior' Select the system folder with your records as Record Storage Page. (more detailed description coming soon) .. _Configuration: Configuration ------------- .. _Overview: Overview ^^^^^^^^ - Include static template 'Events' and have a look at default settings in TypoScript Object Browser or Template Analyser in module Template. - There are quite a lot debug view helpers in templates which can be enabled by TypoScript. (more detailed description will come soon) .. _To-Do-list: To-Do list ---------- - Add Documentation - FEATURE: search form - FEATURE: Add more Quick Menu types (Venue, Performance Type) - FEATURE: Enable linking events and/or performances to tt\_address record .. _Credits: Credits ------- Icon set: `http://www.famfamfam.com/lab/icons/silk/ `_ Performance Icon: `http://www.softicons.com/free-icons/object-icons /the-passed-day-icons-by-jj-maxer/stage-icon `_ Ticket Icon: `http://findicons.com/icon/178211/ticket `_ |img-2| 10 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. |img-2| image:: img-2.png .. :border: 0 .. :height: 21 .. :hspace: 9 .. :id: Grafik2 .. :name: Grafik2 .. :width: 87 .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 514 .. :id: Grafik1 .. :name: Grafik1 .. :width: 374 .. |img-4| image:: img-4.png .. :align: left .. :border: 0 .. :height: 429 .. :id: Grafik3 .. :name: Grafik3 .. :width: 577