.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ===================== 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: EXT: kool\_feaddevent ===================== Extension Key: **kool\_feaddevent** Copyright 2007, Renzo Lauper, 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: 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: Introduction ------------ .. _What-does-it-do: 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. .. _img-1-Screenshots: |img-1| Screenshots ^^^^^^^^^^^^^^^^^^^ |img-2| .. _Users-manual: Users manual ------------ .. _sr-freecap: 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: 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: 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-einfgen: 1. Plugin einfügen """""""""""""""""" |img-3| 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: 2. Einstellungen vornehmen """""""""""""""""""""""""" - |img-2| **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: Configuration ------------- .. _generated: ((generated)) ^^^^^^^^^^^^^ .. _Zugriff-auf-die-kOOL-Datenbank: 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: 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: Beispiel: Verwendung im TS-Template ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ :code:`plugin.tx\_koolfeaddevent\_pi1.eventGroups = 2,3,17` :code:`:code:`temp.addevent = COA`` :code:`temp.addevent.1 = TEXTtemp.addevent.1.value =
Termin erfassen:
temp.addevent.2 < plugin.tx\_koolfeaddevent\_pi1` .. _Reference: Reference ^^^^^^^^^ .. _Reference-TypoScript: Reference (TypoScript) """""""""""""""""""""" .. ### BEGIN~OF~TABLE ### .. _redirect: redirect ~~~~~~~~ .. container:: table-row 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: doneText ~~~~~~~~ .. container:: table-row Property doneText Data type string Description Text, der nach Absenden der Anmeldung angezeigt werden soll, falls redirect nicht definiert ist. Default .. _allowRepeat: allowRepeat ~~~~~~~~~~~ .. container:: table-row Property allowRepeat Data type boolean Description Boolean, ob wiederholte Termine erfasst werden dürfen oder nicht. (GEHT NOCH NICHT) Default 0 .. _eventGroups: eventGroups ~~~~~~~~~~~ .. container:: table-row 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: mandatoryFields ~~~~~~~~~~~~~~~ .. container:: table-row 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: templateFile ~~~~~~~~~~~~ .. container:: table-row Property templateFile Data type string Description Template-Datei Default EXT:kool\_feaddevent/pi1/template.tmpl .. _useFreeCap: useFreeCap ~~~~~~~~~~ .. container:: table-row Property useFreeCap Data type boolean Description Definiert, ob ein CAPTCHA-Bild angezeigt werden soll oder nicht. Setz die Extension sr\_freecap voraus. Default .. ###### END~OF~TABLE ###### [tsref:(cObject).tx\_koolfeaddevent\_pi1] .. _Reference-CSS: Reference (CSS) """"""""""""""" .. ### BEGIN~OF~TABLE ### .. _tx-koolfeaddevent-pi1: .tx-koolfeaddevent-pi1 ~~~~~~~~~~~~~~~~~~~~~~ .. container:: table-row Class .tx-koolfeaddevent-pi1 Description Klasse des Div-Containers, der das ganze Formular umgibt Default width: 600px; .. _tx-koolfeaddevent-pi1-field: .tx-koolfeaddevent-pi1-field ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. container:: table-row Class .tx-koolfeaddevent-pi1-field Description Klasse des Div-Containers, der ein einzelnes Field inkl. label und input-Feld umgibt.Darin kommen vor