Administrator Handbuch

Dieser Abschnitt beschreibt die Handhabung der Erweiterung aus der Sicht eines Administrators.

Installation der Erweiterung

Die Erweiterung wird wie jede andere Erweiterung über das TYPO3 Extension Repository installiert. Bei der Installation wird ein neues Feld tx_addresslist4cal_addresses zu der tx_cal_event Tabelle hinzugefügt.

TypoScript Konfiguration

detailPage

Die TypoScript Einstellung detailPage definiert die Seiten ID der Seite mit der Detailansicht eines Adress-Datensatzes.

plugin.tx_addresslist4cal.detailPage = 81

addressUidParam

Die TypoScript Einstellung addressUidParam definiert den URL Parameter in dem die UID des Adress-Datensatzes an die Detailseite übergeben wird.

plugin.tx_addresslist4cal.addressUidParam = tx_wtdirectory_pi1[show]

dateFormat

Die TypoScript Einstellung dateFormat definiert das Format der Anzeige des Geburtstages eines Adress-Datensatzes.

plugin.tx_addresslist4cal.dateFormat = %d.%m.%Y

Templating

Das Templating erfolgt durch die Erweiterung der vorhandenen Kalender Templates.

In der Datei event_model.tmpl muss der Bereich TEMPLATE_PHPICALENDAR_EVENT erweitert werden.

Das Template für die Anzeige eines einzelnen Adress-Datensatzes muss innerhalb des Bereichs TEMPLATE_PHPICALENDAR_EVENT erstellt werden. Der Marker für das Template eines einzelnen Adress-Datensatzes ist ADDRESSLIST4CAL_ADDRESS. Ein Beispiel Template Teil sieht so aus:

<!--###TEMPLATE_PHPICALENDAR_EVENT### begin -->
<!--phpicalendar_event.tmpl-->
        ...
        ###ADDRESSLIST4CAL###
        ...
        <!-- ###SUBSCRIPTION### start -->
        ...
        <!-- ###SUBSCRIPTION### end -->
        <!-- ###ADDRESSLIST4CAL_ADDRESS### begin -->
        ###LAST_NAME###, ###FIRST_NAME###<br />
        <hr />
        <!-- ###ADDRESSLIST4CAL_ADDRESS### end -->
<!--/phpicalendar_event.tmpl-->
<!--###TEMPLATE_PHPICALENDAR_EVENT### end -->

Für jeden tt_address Datensatz wird dieses Template verwendet und an den vorhergehenden angehangen. Innerhalb des Template können alle Feldnamen des tt_address Datensatzes (in Großschrift) als Marker verwendet werden.

Die komplette Adress-Liste wird dann innerhalb des TEMPLATE_PHPICALENDAR_EVENT Bereichs durch den Marker ADDRESSLIST4CAL eingefügt.

Durch die Verwendung der TypoScript Einstellungen für die Detail-Seite sieht der Template Teil wie folgt aus:

<!-- ###ADDRESSLIST4CAL_ADDRESS### begin -->
###LAST_NAME###, ###FIRST_NAME###<br />
<a href="###DETAIL_PAGE_URL###">Details...</a><br />
<hr />
<!-- ###ADDRESSLIST4CAL_ADDRESS### end -->

Hier ist eine Liste aller möglichen tt_address Felder:

###NAME###
###GENDER###
###FIRST_NAME###
###MIDDLE_NAME###
###LAST_NAME###
###BIRTHDAY###
###TITLE###
###EMAIL###
###PHONE###
###FAX###
###MOBILE###
###WWW###
###ADDRESS###
###BUILDING###
###ROOM###
###COMPANY###
###CITY###
###ZIP###
###REGION###
###COUNTRY###
###DESCRIPTION###
###IMAGE###
###DETAIL_PAGE_URL###

Das Geschlechtskennzeichen (m, f) wird ersetzt durch die locallang Backend Übersetzung der tt_address Tabelle.

Das Geburtsdatum wird in eine benutzerlesbare Form umgewandelt. Die Voreinstellung ist das internationale Datumsformat (%Y-%m-%d) das mittels TypoScript geändert werden kann.