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.
EXT: kb_eventboard¶
Author: | Kasper Skårhøj |
---|---|
Created: | 2002-11-01T00:32:00 |
Changed: | 2015-03-10T13:06:22.650000000 |
Author: | Klaus Biedermann |
Email: | klaus.biedermann@gmx.de |
Info 3: | |
Info 4: |
EXT: kb_eventboard¶
Extension Key: kb_eventboard
Copyright 2007, Klaus Biedermann, <klaus.biedermann@gmx.de>
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.com
Table of Contents¶
EXT: kb_eventboard 1
Introduction 1
What does it do? 1
Screenshots 2
Users manual 5
FAQ 6
Adminstration 6
FAQ 6
Configuration 6
Configuration for realURL 6
Extending kb_eventboard 7
Update hint 7
FAQ 8
Known problems 8
To-Do list 8
Changelog 8
Introduction¶
What does it do?¶
- This Extension is a simple FE Plugin showing your events.
- It is possible to define locations, categories and events by database entries.
- You can configure the number of events per page.
- 3 view modes:1. with category selector and navigation buttons2. single view of event3. without category selector nor navigation buttons4. for presentation at context column (left or right column)
- Each view can serve as a teaser with “read more” link. Exept single view mode!
- To include the extension into your specific design you just have to modify the HTML template and css classes to your wishes.
- Users can browse the events by categories. The page navigation is also easy to modify.
- Partially it is based on cc_event but extended to meet further needs like categories.
- When the date of your event is one day ago, the event record will no longer be displayed in the FE-plugin.
- The extension is available in English and German.
Screenshots¶
screenshot 1: Frontend events at standard mode
screenshot 2: tables location, category and events
screenshot 3: insert your events etc. in the backend
Users manual¶
create a sysfolder. Name it like “events”.
In this sysfolder (Mode: Web->List ) create new records for your categories, locations and then events.
On a page include the FE-Plugin 'Event Board' german 'veranstaltungsanzeige' and choose the events sysfolder as startingpoint. Choose infinite at Recursive.
Insert your modified template file into a folder under fileadmin.
choose the view modea: standard view: events with category selector and navigation buttons.b: single view of eventc: view without category selector and no navigationd: view for context columns => left or right column. i.e. 180 px width.
Select your modified template (see 4.).
set the number of events per page
insert the css class names for event lists entries
if you want to show old events too, check “Show all events”
if this plugin should serve as a teaser click “show more-Link”
Link to Event page: page id of the target page (a page with an other kb_eventboard plugin in SingleView mode!)
show images (default checked) To show eventimages
show all images (default checked) show all images → you can configurate the image width/height by typoscript
choose the categories to be displayed.
Hint: you can insert as many plugins per page as you want. Each configured separate.
screenshot 4: Insert Plugin and startingpoint
FAQ¶
- Possible subsections: FAQ
Configuration¶
- Install the kb_eventboard extension
- In your root template at “include-static (from extension)” select the kb_eventboard TypoScript
- You can configure the date formate for each viewmode by editing the
typoscript setup file:
- showStandard{date_stdWrap.strftime= %d.%m.%y#date_stdWrap.strftime= %A %d. %B %Ytime_stdWrap.strftime= %H:%M}showSingleView{date_stdWrap.strftime= %d.%m.%y#date_stdWrap.strftime= %A %d. %B %Ytime_stdWrap.strftime= %H:%M}showFrontpage{date_stdWrap.strftime= %d.%m.%y#date_stdWrap.strftime= %A %d. %B %Ytime_stdWrap.strftime= %H:%M}showContextCol{date_stdWrap.strftime= %d.%m.%y#date_stdWrap.strftime= %A %d. %B %Ytime_stdWrap.strftime= %H:%M}
- You can config the event image height and width in the typoscript setup.txt
- see:
- eventpics
- eventpicsSingle
- eventpicsFrontpage
- eventpicsContext
Configuration for realURL¶
If you want speaking links for your event you can integrate kb_eventboard into the realURL Extension config file i.e. realurl_conf.php
Here is a snippet of the realurl config file for kb_eventboard:
array('_DEFAULT' => array(######################################## T3-EXT: kb_eventboard#######################################'evt' => array(array('GETvar' => 'tx_kbeventboard_pi1[evt]','lookUpTable' => array('table' => 'tx_kbeventboard_events','id_field' => 'uid','alias_field' => 'eventname','maxLength' => 50,'addWhereClause' => ' AND NOT deleted'),),),// --- ADD MORE EXTENSIONS HERE ---),),
Extending kb_eventboard¶
Now it is possible to extend kb_eventboard by using hooks.
I have added 4 hooks for each view mode.
This are the hook userfunctions:
- showStandardMarker($marker, $row, $conf, &$object)
- showSingleViewMarker($marker, $row, $conf, &$object)
- showFrontpageMarker($marker, $row, $conf, &$object)
- showContextColMarker($marker, $row, $conf, &$object)
Update hint¶
If you update from earlier versions:
i have renamed 2 database fields:
Table tx_kbeventboard_category:
field “description” is renamed to field “categorydescription”
Table tx_kbeventboard_location:
field “description” is renamed to field “locationdescription”
So if you update from an earlier version, just rename your fields.
FAQ¶
- Possible subsections: FAQ
Known problems¶
- not at the moment
To-Do list¶
Changelog¶
kb_eventboard 1.0.16
I have renamed 2 database fields:
Table tx_kbeventboard_category:
field “description” is renamed to field “categorydescription”
Table tx_kbeventboard_location:
field “description” is renamed to field “locationdescription”
So if you update from an earlier version, just rename your fields.
kb_eventboard 1.0.23 :
changed next and previous navigation concept.
Now Textlinks are possible.
You can set the Linktext in pi1/locallang.xml:
nextlinklabel
and
prevlinklabel
You can change the css style of the links in file kb_eventboard.css
Classes:
a.kb_eventboard-nextlink
a.kb_eventboard-prevlink
kb_eventboard 1.0.25 :
added showimage and showallimages checkboxes in flexform.
added feature to config event pics in typoscript setup.txt
template.tmpl file has changed
kb_eventboard 1.0.27:
Template selection in flexform has changed!
Choose a modified template under the fileadmin folder.
If you don´t select a template the default template will be used (typo3conf/ext/kb_eventboard/template.html)
kb_eventboard 1.0.28:
Added onMouseOut eventhandler to hide location-information-div
Hide function has an delay of 2,5 seconds. This can be changed in the template file
If you want to have a link in your location-information-div, please insert a full URL in the location recordset.
kb_eventboard 1.0.37:
ready for typo3 6.2
changed
require_once(PATH_tslib.'class.tslib_pibase.php');
to
if (!class_exists('tslib_pibase')) require_once(PATH_tslib . 'class.tslib_pibase.php');
setup.txt:
changed
imageLinkWrap = 1
to
imageLinkWrap = 0
EXT: kb_eventboard - 11