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: naw_ehemaligenverzeichnis¶
| Author: | Kasper Skårhøj |
|---|---|
| Created: | 2002-11-01T00:32:00 |
| Changed: | 2005-11-24T10:03:43 |
| Author: | Dietrich Heise |
| Email: | heise@naw.de |
| Info 3: | |
| Info 4: |
EXT: naw_ehemaligenverzeichnis¶
Extension Key: naw_ehemaligenverzeichnis
Copyright 2005, net&works GmbH, Dietrich Heise, <heise@naw.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
Inhaltsverzeichnis¶
EXT: naw_ehemaligenverzeichnis 1
Einleitung 1
Was bewirkt diese Erweiterung? 1
Benutzer Dokumentation 1
Referenz 2
Mailing (Newsletter) 2
Das HTML-Template für die Frontendregistration 2
Das TypoScript-Template für die Frontendregistration 3
Das HTML-Template für das Ehemaligenverzeichnis 3
Bekannte Probleme 4
To-Do list 4
Changelog 4
Einleitung¶
Was bewirkt diese Erweiterung?¶
- Diese Erweiterung (Extension) für TYPO3 stellt ein Ehemaligen Verzeichnis auf einer geschützten Seite dar. D.h. Die Seite ist nur für angemeldete Besucher zugänglich.
- Um Ehemalige in dies Verzeichnis aufzunehmen, ist eine Registrierung im Frontend – auf der Webseite -- nötig. Hierzu werden Daten der ehemaligen Schüler abgefragt und in dfer TYPO3 Datenbank gespeichert. Diese Ehemaligen tauchen anschließend auf der Webseite auf.
- Damit Lehrer auf die internen Seiten Zugriff bekommen, jedoch nicht im Ehemaligenverzeichnis aufgeführt werden, ist ein Lehrer durch einen Admin im TYPO3-Backend anzulegen. Hierbei darf für den Lehrer bei der Erstellung im Backend der Punkt “Zustimmung zur Aufnahme ins Ehemaligenverzeichnis” nicht ausgewählt werden. Hierdurch wird verhindert, dass der Lehrer im Verzeichnis aufgelistet wird.
Benutzer Dokumentation¶
Um diese Erweiterung zu benutzen, wird zusätzlich die Extension naw_selfreg benötigt, die zuvor zu Installieren ist.
Folgende Datenbankfelder werden von dieser Erweiterung zu der Tabelle “fe_users” hinzugefügt:
tx_nawselfreg_gebnametx_nawselfreg_klassetx_nawselfreg_lehrertx_nawselfreg_abgangsjahrgangtx_nawselfreg_abgangsklassetx_nawselfre g_newsletter
Diese Felder müssen dem Template für die “Frontend User Selfregistration” hinzugefügt werden.
Nachdem die Extension installiert wurde, sind noch folgende Parameter im Extensionmanager zu setzten:
Start Abschlussjahrgang [startabschlussjahrgang]Range: 1900 - 2200
End Abschlussjahrgang [endabschlussjahrgang]Range: 1900 - 2200
Ausgewählter Abschlussjahrgang [defaultabschlussjahrgang]Range: 1900 - 2200
Aufzählung der Klassen durch Komma ... [klassen]Aufzählung der Klassen durch Komma getrennt (10a,10b,10c,11a,...)
Anschließend ist diese Extension: naw_ehemaligenverzeichnis zu Installieren.
Nach der Installation sind im Extensionmanager einige Einstellungen vorzunehmen.
Es ist eine Sysfolder-ID einzutragen. Dies ist der Sysfolder, in dem Ihre Frontend Benutzer gespeichert werden.Weiterhin wird eine absende Emailadresse und ein Absendername benötigt. Diese Daten werden beim Versenden des Newsletters benutzt.
Um die Ausgabe zu designen, können Sie ein Template file benutzen. Ein Vorlage Template befindet sich im Ordner /res dieser Extension.
Mailing (Newsletter)¶
Zielgruppe: Administratoren
Um einen Newsletter versenden zu können ist wie folgt zu verfahren.
Auf das Modul “IGS-Mailing” klicken
Alle Klassen auswählen, an die der Newsletter verschickt werden soll. Hierbei können mehre Klassen duch anklicken des Jahrgangs ausgewählt werden. Versendet wird jedoch nur an die Klassen die markiert sind! Falls Also der Jahrgang 1990 ausgewählt ist und dort die Klassen 10a, 10b, 10c existieren, nun jedoch 10b abgewählt wurde, wird der Newsletter nur den die Klassen 10a und 10c versendet!
Im dritten Schritt ist die Email zu verfassen, hierfür ist ein Betreff und eine Nachricht einzugegeben.
Im vierten und letzten Schritt werden die Email's versendet und es wird eine Liste dargestellt, an wen die Mails versendet worden sind.
Das HTML-Template für die Frontendregistration¶
In HTML-Template für die FE-User Registierung ist um einige Felder zu erweitern. Als Beispiel siehe der folgenden Absatz:
<!--###SUB_INCLUDED_FIELD_tx_nawselfreg_gebname###-->###LABEL_TX _NAWSELFREG_GEBNAME### ###REQUIRED_TX_NAWSELFREG_GEBNAME###<input type="text" name="FE[fe_users][tx_nawselfreg_gebname]" size="50" /><!--###SUB_INCLUDED_FIELD_tx_nawselfreg_gebname###-->
<!--###SUB_INCLUDED_FIELD_tx_nawselfreg_klasse###-->###LABEL_TX_NAWSELFREG_KLASSE### ###REQUIRED_TX_NAWSELFREG_KLASSE######TCA_I NPUT_tx_nawselfreg_klasse###<!--###SUB_INCLUDED_FIELD_tx_nawsel freg_klasse###-->
<!--###SUB_INCLUDED_FIELD_tx_nawselfreg_lehrer###-->###LABEL_TX_NAWSELFREG_LEHRER### ###REQUIRED_TX_NAWSELFREG_LEHRER###<!--###SU B_REQUIRED_FIELD_tx_nawselfreg_lehrer###-->###GW2B######MISSING_ TX_NAWSELFREG_LEHRER######GW2E###<!--###SUB_REQUIRED_FIELD_tx_na wselfreg_lehrer###--><input type="text" name="FE[fe_users][tx_nawselfreg_lehrer]" size="50" /><!--###SUB_INCLUDED_FIELD_tx_nawselfreg_lehrer###-->
<!--###SUB_INCLUDED_FIELD_tx_nawselfreg_abgangsjahrgang###-->###L ABEL_TX_NAWSELFREG_ABGANGSJAHRGANG### ###REQUIRED_TX_NAWSELFREG_ ABGANGSJAHRGANG######TCA_INPUT_tx_nawselfreg_abgangsjahrgang###<!- -###SUB_INCLUDED_FIELD_tx_nawselfreg_abgangsjahrgang###-->
<!--###SUB_INCLUDED_FIELD_tx_nawselfreg_abgangsklasse###-->###LAB EL_TX_NAWSELFREG_ABGANGSKLASSE### ###REQUIRED_TX_NAWSELFREG_ABGA NGSKLASSE######TCA_INPUT_tx_nawselfreg_abgangsklasse###<!--###SUB_INCLUDED_FIELD_tx_nawselfreg_abgangsklasse###-->
<!--###SUB_INCLUDED_FIELD_tx_nawselfreg_newsletter###-->###LABEL_TX_NAWSELFREG_NEWSLETTER### ###REQUIRED_TX_NAWSELFREG_NEWSLETTER ###<!--###SUB_REQUIRED_FIELD_tx_nawselfreg_newsletter###-->###GW2 B######MISSING_TX_NAWSELFREG_NEWSLETTER######GW2E###<!--###SUB_REQ UIRED_FIELD_tx_nawselfreg_newsletter###--><input type="checkbox" name="FE[fe_users][tx_nawselfreg_newsletter]" value=1 /><!--###SUB_INCLUDED_FIELD_tx_nawselfreg_newsletter###-->
Das TypoScript-Template für die Frontendregistration¶
Auch am TypoScript Template sind einige Erweitungen vorzunehmen. Zum einen müssen die Felder die verwendet werden als “formFields” definiert werden, und sind daher um die folgenden Felder zu erweitern:plugin.tx_srfeuserregister_pi1.formFields = tx_nawselfreg _gebname,tx_nawselfreg_klasse,tx_nawselfreg_lehrer,tx_nawselfreg _abgangsjahrgang,tx_nawselfreg_abgangsklasse,tx_nawselfreg_newsle tter
Des weiteren ist Festzulegen, ohne welche Felder eine Registierung nicht möglich ist (requiredFields):
plugin.tx_srfeuserregister_pi1.requiredFields = tx_nawselfreg_lehrer,tx_nawselfreg_newsletter
Das HTML-Template für das Ehemaligenverzeichnis¶
In dem HTML-Template gibt es fünf Untertemplates, mit den Bezeichnern und Funtionen:
###MAIN_TEMPLATE### Haupttemplate, zur Darstellung der Ehemaligen- Liste
###DETAILS_TEMPLATE### Template zum Darstellen eines Eintrages
###EMAIL_TEMPLATE### Template zur Darstellung des Email-Formulars im Frontend
###SEND_EMAIL_TEMPLATE### Template aus dem die Email generiert wird.
###SEND_EMAIL_TEMPLATE_AFTER### Template, welches nach dem Senden der Email angezeigt wird.
((generated))¶
((generated))¶
MAIN_TEMPLATE:¶
Hier gibt es die selbstsprechenden Marker:
###JAHR### begin###JAHRESZAHL######KLASSE### begin###USER### begin###USERNAME######SEND_MAIL### begin###SEND_MAIL### end###DETAILS### begin###DETAILS### end###USER### end###KLASSE### end###JAHR### end
DETAILS_TEMPLATE¶
auch hier gibt es einige Selbstsprechende Marker
###FIRST_NAME######LAST_NAME######GEB_NAME######ADDRESS######ZIP### ###CITY######ABGANGSKLASSE######ABGANGSJAHRGANG######LEHRER######KLASS E######SEND_MAIL### begin###SEND_MAIL### end###BACK_LINK### begin###BACK_LINK### end
EMAIL_TEMPLATE¶
###FIRST_NAME######LAST_NAME######TO_USER######DETAILS_LINK### begin###DETAILS_LINK### end###BACK_LINK### begin###BACK_LINK### end
SEND_EMAIL_TEMPLATE¶
###FROM_FIRST_NAME######FROM_LAST_NAME######FROM_EMAIL######BODY# ##
SEND_EMAIL_TEMPLATE_AFTER¶
###FIRST_NAME######LAST_NAME######SUBJECT######BODY######BACK_LINK# ## begin###BACK_LINK### end
Bekannte Probleme¶
- keine
EXT: naw_ehemaligenverzeichnis - 4