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: kool_feaddevent¶
| Author: | idefix |
|---|---|
| Created: | 2007-02-27T15:00:08 |
| Changed by: | idefix |
| Changed: | 2007-03-26T15:15:53 |
| Classification: | kool_feaddevent |
| Author: | Renzo Lauper |
| Email: | renzo.lauper@kircheonline.ch |
| Info 3: | |
| Info 4: |
EXT: kool_feaddevent¶
Extension Key: kool_feaddevent
Copyright 2007, Renzo Lauper, <renzo.lauper@kircheonline.ch>
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: kool_feaddevent 1
Introduction 1
What does it do? 1
Screenshots 1
Users manual 2
Configuration 3
Reference 3
Tutorial 3
Changelog 4
Introduction¶
What does it do?¶
Diese Extension bildet die Schnittstelle zwischen der Webseite und der Gruppenverwaltung in kOOL - dem Kirchen-Tool. Ohne kOOL macht diese Extension keinen Sinn. Mehr über kOOL erfahren Sie unter http://kool.kircheonline.ch .
Diese Extension zeigt im Frontend ein Formular an, über welches Termine erfasst werden können. Diese Termine können durch einen Moderations-Schritt direkt ins kOOL integriert werden.
Die Idee dabei ist es, die kOOL Termine-Datenbank möglichst umfangreich und aktuell zu haben, indem externe Benutzer ihre Termine erfassen können.
Screenshots¶
Users manual¶
sr_freecap¶
Zur Verminderung des Missbrauches wird empfohlen, die Extension sr_freecap zu installieren. Diese wird automatisch erkannt, kann aber immer noch mittels Checkbox in der Flexform deaktiviert werden.
kool_feaddevent¶
Hier erfahren Sie, wie Sie ein Formular auf Ihrer Webseite einfügen können, damit die Webseiten-Besucher Termine erfassen können. Die Handhabung der Moderation der erfassten Termine im kOOL ist in der kOOL-Dokumentation des Termine-Moduls enthalten.
0. Extension installieren¶
Als erstes muss natürlich die Extension kool_feaddevent installiert werden. Dazu muss lediglich die Extension über den Typo3-Extension- Manager installiert werden, sonst nichts.
1. Plugin einfügen¶
Fügen Sie auf einer Seite im Typo3 ein neues Inhaltselement
vom Typ “kOOL FE Termin erfassen” ein. Dieses finden Sie auf der Liste
der Inhaltselemente ganz unten im Bereich “Plugins”.
2. Einstellungen vornehmen¶
- Pflichtfelder: Wählen Sie, welche Angaben vom Benutzer
gemacht werden müssen.
- Erlaubte Termingruppen: Wählen Sie die Termingruppen, für die neue Termine erfasst werden dürfen.
- Wiederholte Termine erlauben: Wenn Sie diese Option aktivieren, werden im Formular die Optionen für einen wiederholten Termin angezeigt.Vorsicht: Dadurch kann ein Benutzer mit unguten Absichten sehr schnell eine Menge Termine erfassen, die Sie dann alle wieder löschen müssen.
- Weiterleitung nach Abschicken: Wählen Sie eine Seite, auf die der Benutzer geleitet werden soll, wenn er seinen Termin erfasst hat.
- Alternativ: Danke-Text: Wenn keine Weiterleitung definiert ist, wird dieser Danke-Text nach dem Abschicken des Formulares dargestellt.
- Template Datei: Hier können Sie eine HTML-Datei angeben, die für die Darstellung des Formulares verwendet wird. Als Standard wird die Template-Datei aus dem Extension-Verzeichnis verwendet.
- CAPTCHA-Bild verwenden: Wenn Sie die Extension sr_freecap installiert haben, können Sie hier das CAPTCHA-Bild im Formular aktivieren. Dies dient der Spamverminderung.
Configuration¶
((generated))¶
Zugriff auf die kOOL-Datenbank¶
Die Extension kool_feaddevent holt die Angaben zu den Terminen mittels SQL-Befehlen direkt aus der kOOL-Datenbank. Dabei wird das folgende Namens-Schema verwendet:
Typo3-Datenbank: t3_meineseitekOOL-Datenbank: kOOL_meineseite
Dies ist momentan eine zwingende Voraussetzung (hard coded), kann aber bei Bedarf jederzeit erweitert werden.
TypoScript vs. Flexform-Werte¶
Alle Einstellungen, die über TS vorgenommen wurden, können mit den Werten in der Flexform überschrieben werden.
Weiter kann die Extension auch direkt als cObj über TypoScript ins Template eingebunden werden:
Beispiel: Verwendung im TS-Template¶
plugin.tx\_koolfeaddevent\_pi1.eventGroups = 2,3,17
:code:`temp.addevent = COA` temp.addevent.1 =
TEXTtemp.addevent.1.value = <div>Termin erfassen:</div>temp.addevent.2
< plugin.tx\_koolfeaddevent\_pi1
Reference¶
Reference (TypoScript)¶
redirect¶
Property
redirect
Data type
int
Description
Seiten-ID der Seite, auf die nach dem Absenden der Anmeldung gesprungen werden soll.
Wird durch allfälligen Eintrag bei den Plugin-Einstellungen überschrieben.
Default
doneText¶
Property
doneText
Data type
string
Description
Text, der nach Absenden der Anmeldung angezeigt werden soll, falls redirect nicht definiert ist.
Default
allowRepeat¶
Property
allowRepeat
Data type
boolean
Description
Boolean, ob wiederholte Termine erfasst werden dürfen oder nicht.
(GEHT NOCH NICHT)
Default
0
eventGroups¶
Property
eventGroups
Data type
string
Description
Kommagetrennte Liste der Eventgruppen-IDs, für welche Termine erfasst werden dürfen. (Andere erscheinen im FE-Formular nicht zur Auswahl)
Default
mandatoryFields¶
Property
mandatoryFields
Data type
string
Description
Kommagetrennte Liste der Inputfelder, welche Pflicht sind. Mögliche Werte sind: eventgroup, startdate, enddate, starttime, endtime, room, comment
Default
eventgroup,startdate,starttime
templateFile¶
Property
templateFile
Data type
string
Description
Template-Datei
Default
EXT:kool_feaddevent/pi1/template.tmpl
useFreeCap¶
Property
useFreeCap
Data type
boolean
Description
Definiert, ob ein CAPTCHA-Bild angezeigt werden soll oder nicht. Setz die Extension sr_freecap voraus.
Default
[tsref:(cObject).tx_koolfeaddevent_pi1]
Reference (CSS)¶
.tx-koolfeaddevent-pi1¶
Class
.tx-koolfeaddevent-pi1
Description
Klasse des Div-Containers, der das ganze Formular umgibt
Default
width: 600px;
.tx-koolfeaddevent-pi1-field¶
Class
.tx-koolfeaddevent-pi1-field
Description
Klasse des Div-Containers, der ein einzelnes Field inkl. label und input-Feld umgibt.Darin kommen vor <label> für die Beschreibung des Eingabefeldes und <input> oder <select> für die Eingabe.
Default
label { font-size: 10px; font-weight:900; display:block; margin- top:8px; }
input { border: 1px solid #aaa; }
select { border: 1px solid #aaa; }
.tx-koolfeaddevent-pi1-submit¶
Class
.tx-koolfeaddevent-pi1-submit
Description
Klasse des Absenden-Buttons
Default
width:100%; text-align:center; margin-top:8px;
.tx-koolfeaddevent-pi1-doneText¶
Class
.tx-koolfeaddevent-pi1-doneText
Description
Klasse des Div-Containers, der den Text umgibt, der nach dem Absenden des Formulares angezeigt wird, falls keine Weiterleitung konfiguriert wurde.
Default
width:100%; background: #bbeebb; border:2px solid #aaa; padding:8px; font-weight:900;
.tx-koolfeaddevent-pi1-repeat¶
Class
.tx-koolfeaddevent-pi1-repeat
Description
Klasse des Div-Containers, der die ganzen Wiederholungs-Optionen enthält.
Default
padding:0px; border:1px solid #aaa; background:#eee; font-size:10px;
input { border: 1px solid #aaa; font-size:10px; }
select { border: 1px solid #aaa; font-size:10px; }
.tx-koolfeaddevent-pi1-repeat-header¶
Class
.tx-koolfeaddevent-pi1-repeat-header
Description
Klasse des Div-Containers, der den Titel der Wiederholungs-Optionen enthält, mit dem Text “Wiederholung”
Default
font-size:10px; font-weight:900; padding: 4px 0px 4px 0px; width:100%; background:#aaa;
.tx-koolfeaddevent-pi1-captcha¶
Class
.tx-koolfeaddevent-pi1-captcha
Description
Klasse des Div-Containers, der den ganzen CAPTCHA-Bereich umgibt.
Default
font-size: 10px;
[cssref:.tx_koolfeaddevent_pi1]
Tutorial¶
Siehe Users manual.
To-Do list¶
- SQL-Angaben mittels TS definieren (Server, Datenbank, Authentication)
- Wiederholungen aktivieren und verarbeiten
Changelog¶
1.0.1: Verwendung von sr_freecap für CAPTCHA-Bilder. Template-Datei für das Formular.
1.0.0: Erste öffentliche und soweit fertige Version.
EXT: kool_feaddevent - 4