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

img-1 screenshot 1: Frontend events at standard mode

img-2 screenshot 2: tables location, category and events

img-3 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.

img-4

screenshot 4: Insert Plugin and startingpoint

FAQ

- Possible subsections: FAQ

Adminstration

FAQ

- Possible subsections: FAQ

Configuration

  • Install the kb_eventboard extension
  • In your root template at “include-static (from extension)” select the kb_eventboard TypoScript
  • img-5
  • 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

img-6 EXT: kb_eventboard - 11