Die Einstellungen werdenüber den Menüpunkt "Module verwalten" aufgerufen.
Im folgenden werden die einzelnen Einstell-Möglichkeiten beschrieben.
Hier werden die grundsätzlichen Modul-Einstellungen vorgenommen, die bestimmen, welche Aktionen durchgeführt werden, welches Format der Newsletter hat und welche Möglichkeiten den Redakteuren zur Verfügung stehen.
Länge der Empfänger-Liste
Definiert die Anzahl der Einträge pro Seite in der Empfängerliste.
Bestätigungs-Verzögerung
ist der Zeitraum in Tagen, bevor ein Empfänger-Eintrag automatisch gelöscht wird, der nicht bestätigt wurde.
Adressen-Prüfung
gibt an, ob Empfänger-Adressen ohne weitere Prüfung aufgenommen werden oder die Eintragung erst duch ein Link in einem Bestätigungsmail vorgenommen werden kann.
Mailserver Check
gibt an, ob Mail-Adressen über das Internet auf Vorhandensein eines entsprechenden Mailservers geprüft werden sollen.
Email Regulärer Ausdruck
ist ein regulärer Ausdruck, der als Suchmuster zur Prüfung der Adresse verwendet wird. Bevor dieser geändert wird sollten die Grundlagen regulärer Ausdrücke bekannt sein.
Newsletter-Format
schaltet zwischen reinem Text-Mail, reinem HTML-Mail und Multipart-Text/HTML-Mail um.
Absender-Adresse
ist die Absender-Adresse, die auf den Mail angegeben wird (Voreinstellung ist der Administrator).
Bilder in HTML-Mails einbetten
gibt an, ob Bilder als Online-Link im HTML-Text erscheinen oder als eingebettete Bilder (ohne online-Verbindung lesbar) mitgesendet werden.
Admin informieren
gibt an, ob der Admin über neue Empfänger in der Empfängerliste nach deren Aktivierung per Mail informiert werden soll.
Mail-Adresse Administrator
ist die Adresse, an die die Informationen für den Administrator gesendet werden.
Generalproben Mail-Adresse
ist die Adresse, an die bei einer Generalprobe der Newsletter gesendet wird.
Kategorien benutzen
aktiviert bei Bedarf das Kategorien-System, das kundenspezifische Newsletter erlaubt.
Rang-System benutzen
aktiviert bei Bedarf das Rang-System, mit dem sich die Frequenz und Zielgruppe für den Newsletterversand genauer definieren lässt.
Standard-Rang (nur verfügbar bei Benutzung des Rang-Systems)
ist der Rang, der neu angemeldeten Empfängern zugeteilt wird.
Intervallverarbeitung (nur registrierte kommerzielle Version)
gibt an, ob das Intervallsystem benutzt werden soll.
Anzahl Newsletter je Intervall (nur registrierte kommerzielle Version)
gibt an, wieviele Newsletter je Intervall verarbeitet werden sollen, bevor eine fünfsekündige Pause eingelegt wird und dann die Seite zum Fortsetzen der Verarbeitung automatisch neu geladen wird.
Aktionen protokollieren
gibt an, ob bei Newsletter-Aktionen wie Newsletter-Versand oder Empfänger-Aktionen ein Eintrag im System-Log angelegt wird.
Hier werden die für den Newsletter benutzten Abschnitte benannt. Dabei steht ohne Kategoriensystem neben Kopf- und Fußteil nur ein Hauptteil, mit Kategoriensystem eine entsprechende Anzahl von Kategorien zur Verfügung, um hochwertige informative Newsletter zu produzieren.
Kopfbereich
ist der Teil, der am Anfang eines Newsletters steht.
Hauptteil (nur verfügbar, wenn Kategorien NICHT benutzt werden)
ist der Teil, der in der Mitte eines Newsletters steht.
Newsletter Kategorien (nur verfügbar, wenn Kategorien benutzt werden)
sind beliebig viele themenspezifische Bereiche, die vom Newsletterempfänger innerhalb dieser Vorgabe nach Belieben zusammengestellt werden können.
Fußbereich
ist der Teil, der am Ende eines Newsletters steht.
Hier werden besondere HTML-Elemente definiert, die eine einheitliche Gestaltung über Abschnitte und Kategorien hinweg erlauben.
CSS-Style-Sheet
erlaubt die Einbindung eines CSS-Stylesheets zur Definition der Formate. Hierfür bietet sich die ohnehin im Projekt verwendete Style-Sheet-Datei an oder eine speziell für den Newsletter-Versand geschaffene. Hier ist der relative Pfad zur CSS-Datei anzugeben! Die CSS-Anweisungen werden komplett in das Mail einkodiert und nicht verlinkt!
HTML-Kopfbereich
ist der den BODY-Bereich der Newsletters anführende HTML-Teil. Hier lassen sich einfache umschließende Tags oder auch komplexe Kopfbereiche definieren.
HTML-Fußbereich
ist der den BODY-Bereich der Newsletters schließende HTML-Teil. Hier lassen sich einfache umschließende Tags oder auch komplexe Fußbereiche definieren.
Hier werden einige reine Textbausteine definiert, die dem Empfänger wichtige Informationen liefern können.
"No-Spam"-Hinweis
Dieser Text wird ihren Mail hinzugefügt, um dem Empfänger zu erklären, warum er dieses Mail erhält. Bei Änderungen in den Einstellungen in den Moduleinstellungen sollte er sinngemäß angepasst werden!
Abmelde-Hinweis
Dieser Text wird ihren Mail hinzugefügt, um dem Empfänger zu erklären, wie er den Newsletter abbestellen kann. Bei Änderungen in den Einstellungen in den Moduleinstellungen sollte er sinngemäß angepasst werden!
Profil-Einstellungen-Hinweis
Dieser Text wird ihren Mail hinzugefügt, um dem Empfänger zu erklären, wie und wo er seine Persönlichen Einstellungen vornehmen kann. Bei Änderungen in den Einstellungen in den Moduleinstellungen sollte er sinngemäß angepasst werden!
Besondere Mail-Header
Dieser Teil ergänzt den Mailheader um spezielle Informationen. Diese Angaben sollten nur verändert werden, wenn Sie sich mit Mail-Headern auskennen. Wenn nicht, einfach leer lassen!
Hier werden die im eigentlich Webauftritt sichbaren Seiteninhalte definiert. Diese Inhalte sollten unbedingt an die persönlichen erfordernisse angepasst werden!.
Index Seite
Dies ist der Inhalt der index.php des Modulverzeichnisses. Hierbei ist die Erhaltung der zwei Formulare zu beachten, um ihre Funktion nicht zu zerstören, das Layout ist aber freigestellt.
Subscribe-Forumlar-Elemente:
<form method="post" action="index.php">
<input name="action" type="hidden" value="subscribe">
Name:<input type="text" name="Name" value="">
eMail:<input type="text" name="eMail" value="">
<input type="submit" name="subscribe" value="eintragen">
<input type="submit" name="unscribe" value="austragen">
</form>
Login-Formular-Elemente:
<form method="post" action="index.php">
<input name="action" type="hidden" value="login">
eMail:<input type="text" name="eMail" value="">
Passwort:<input type="password" name="password" value="">
<input type="submit" name="subscribe2" value="senden">
<input type="submit" name="subscribe3" value="Passwort vergessen!">
</form>
Hinweis bei eMail-Fehler
Dieser Hinweis wird bei fehlerhafter Mail-Adresse ausgegeben.
Hinweis "Bereits in der Liste"
Dieser Hinweis wird ausgegeben, wenn die Adresse bereits als Newsletter-Emfänger eingetragen ist.
Hinweis auf gebannte Adresse
Dieser Hinweis wird ausgegeben, wenn die Adresse gebannt wurde.
Hinweis bei Passwort-Fehler
Dieser Hinweis wird bei fehlerhaftem Passwort ausgegeben.
Hinweis "Kein eingetragener Empfänger"
wird ausgegeben, wenn versucht wird sich mit einer nicht eingetragenen Adresse einzuloggen.
Abmelde Hinweis
Dieser Hinweis wird bei erfolgreicher Abmeldung ausgegeben.
Passwort-Bestätigungs-Information
informiert den neuen Empfänger über das weitere Vorgehen, wenn eine Bestätigung durch einen zugesendeten Link erfolgen muß (confirmed opt-in).
Information zu neuem Passwort
informiert über die Aktivierung eines angeforderten Passwortes und sollte darauf hinweisen, daß man sich mit dem neuen Passwort einloggt, um ein eigenes Passwort zu vergeben.
Fehlermeldung bei Passwortänderung
wird ausgegeben, wenn bei einer Passwortänderung beide Passworteingaben nicht übereinstimmen.
Bestätigungs-Seite
wird ausgegeben, um die erfolgreiche Registrierung anzuzeigen. Es sollte auf das Bestätigungsmail hingewiesen werden und das weitere Vorgehen erläutert werden.
Anmelde-Bestätigung
Dieser Hinweis wird bei erfolgreicher Anmeldung ausgegeben. Es sollte gleichzeitig das Formular zum Einloggen sein, da keine weitere Bestätigung mehr erfoderlich ist.
Abmelde Info
wird nach einer erfolgreichen Abmeldung ausgegeben.
Empfänger-Profil-Seite
Diese Seite dient der Frontend-Verwaltung des Empfänger-Profils und sollte ein Formular mit folgenden Komponenten enthalten:
<form method="post" action="index.php">
Name:<!-- NL-NAME -->
eMail:<!-- NL-MAIL -->
Kategorien:<!-- NL-CAT-ALL --> Alle
<!-- NL-CAT-SELECT --> Auswahl<!-- NL-CAT-CHECK -->
<input type="submit" name="change_profile" value="Abschicken">
Passwort ändern
Altes Passwort:<input type="password" name="old_password">
Neues Passwort:<input type="password" name="new_password">
Passwort-Wiederholung:<input type="password" name="new_password_double">
<input type="submit" name="change_profile" value="Abschicken">
</form>
Die Platzhalter werden bei der Ausgabe durch folgendes ersetzt:
<!-- NL-NAME --> Der Name des Empfängers
<!-- NL-MAIL --> Die Mail-Adresse des Empfängers
<!-- NL-CAT-ALL --> Ein Radio-Button zur Auswahl aller Kategorien
<!-- NL-CAT-SELECT --> Ein Radio-Button zur Auwahl der individuellen Kategorieauswahl
<!-- NL-CAT-CHECK --> Eine Reihe von Kontrollkästchen zur Wahl der gewünschten Kategorien
<!-- NL-DATA-ROWS --> enthält die personalisierten Daten, wenn diese benutzt werden
Die Felder werden mit den gespeicherten Werten aus der Empfängerliste gefüllt.
Meldung bei Profiländerung
informiert über eine erfolgreiche Änderung der Profildaten.
Meldung bei Passwortänderung
informiert über eine erfolgreiche Passwortänderung.
Newsletter-Übersicht
bestimmt das Aussehen des Template-Platzhalters <!-- NEWSLETTER-DIR: List --> und kann selbst mit den Platzhaltern
<!-- NL_TITLE --> (der Titel des Newsletters) und
<!-- NL-NR --> (die Nummer des Newsletters)
versehen werden. Diese Liste wird gerne ausgegeben, um neuen Interessenten einen Einblick in die üblicherweise versendeten Informationen zu geben.
Übersichts-Länge
definiert die Anzahl der gelisteten Newsletter.
Miniatur Index-Seite und
Miniatur Bestätigungs-Seite
definieren die Minimal-Versionen der Standard-Newsletter-Index- und Bestätigungsseite, die mittels index_mini_php.php eingebunden werden kann.
Dies sind die Inhalte, die per Mail an die sich eintragenden Empfänger versendet werden. Diese sollten ggf. den Moduleinstellungen und den Bedingungen der Website angepasst werden.
Wichtig: Bei den Platzhaltern auf die korrekte Schreibweise achten! Zuerst "<!--", dann ein Leerschritt, dann der Platzhalter-Name, noch ein Leerschritt und schließlich "-->".
Bestätigungs-Mail-Betreff und -Inhalt
definiert die Informationen, die im Mail enthalten sind, die der neue Empfänger nach Eintragung seiner Mail-Adresse bekommt. Dabei sind folgende Platzhalter vorgesehen:
<!-- NL-MAIL --> Die eingetragene Mail-Adresse
<!-- NL-CONFIRMATION-LINK --> Der Link zum Aktivieren des Empfänger-Kontos
<!-- NL-PASSWORD --> Ein automatisch generiertes Passwort zum Einloggen
<!-- NL-DELAY --> Die eingestellte Zeit bis zur Löschung nicht aktivierter Konten
Registrierungs-Erfolg-Betreff und -Inhalt
definiert die Informationen, die im Mail enthalten sind, die der neue Empfänger nach Aktivierung seiner Mail-Adresse bekommt. Dabei sind folgende Platzhalter vorgesehen:
<!-- NL-MAIL --> Die eingetragene Mail-Adresse
Direkte Registrierung Betreff und -Inhalt
wird verwendet, wenn eine direkte Registrierung ohne Verfifizierungsmail eingestellt ist. Hier werden die gleichen Platzhalter verwendet:
<!-- NL-MAIL --> Die eingetragene Mail-Adresse
<!-- NL-PASSWORD --> Ein automatisch generiertes Passwort zum Einloggen
<!-- NL-UNSCRIBE-LINK --> Link zur Index-Seite des Newsletters
Abmeldung Betreff und -Inhalt
dient der Verifizierung einer Abmeldung, damit nicht fremde Adressen abgemeldet werden können. Platzhalter sind:
<!-- NL-MAIL --> Die eingetragene Mail-Adresse
<!-- NL-UNSCRIBE-LINK --> Ein Link zu direkten Abmelden
"Vergessenes Passwort" Betreff und -Inhalt
wird versendet, wenn ein neues Passwort angefordert wurde. Platzhalter sind:
<!-- NL-MAIL --> Die eingetragene Mail-Adresse
<!-- NL-NEW-PASSWORD --> Das neue Passwort
<!-- NL-NEW-PASSWORD-LINK --> Ein Link, um das neue Passwort zu aktivieren
Admin-Info Betreff und -Inhalt
und Abmelde-Info Betreff und -Inhalt
informieren den Administrator über Ein- und Austragungen in der Empfängerliste, wenn dies in den Einstellungen aktiviert wurde. Es gibt hier nur einen Platzhalter:
<!-- NL-MAIL --> Die eingetragene oder ausgetragene Mail-Adresse
Felder
bestimmt, ob und wie benutzerdefinierte Felder eingesetzt werden können. Sobald hier etwas eingetragen wird, dann wird dies als Eingabefelder auf der Index-Seite beim Platzhalter <!-- NL-DATA-ROWS --> ausgegeben.
Im einfachsten Fall werden einfach Feldnamen durch Zeilenumbrüche getrennt. Diese können im eigentlichen Newsletter durch Platzhalter in der Form <!-- fieldname --> eingesetzt werden, die dann durch die entsprechenden Inhalte ersetzt werden.
Syntax: fieldname[;required(0|1)[;type(text|select|radio|checkbox);values(a,b,c,...)]] + LF/CR
Weitere optionale Parameter werden jeweils durch Semikolon (;) getrennt. Die Parameter in der Reihenfolge ihrer Anwendung:
required kann die Werte 0 und 1 annehmen und gibt an, ob eine Eingabe erforderlich ist
type definiert die Art des Eingabefeldes analog den HTML-Tags und kann text, select, radio oder checkbox sein
values ist eine Liste von mit Komma (,) getrennten Werten, die für die Typen select, radio und checkbox benötigt werden
Persönliche Daten Zeile
definiert die Darstellung innerhalb des Formulars, z.B. als Tabellenzeile und sollte mit dem Formular der Index-Seite harmonieren. Ein Beispiel:
<tr><td><!-- NL-CAPTION --></td><td><!-- NL-INPUT --></td></tr>
Dabei kommen zwei Platzhalter zum Einsatz:
<!-- NL-CAPTION --> ist der Name des Feldes
<!-- NL-INPUT --> ist das Eingabefeld selbst in der gewünschten Form
Hinweis auf erforderliche Daten
informiert über fehlende Eingaben insofern der Parameter required auf 1 bei einem Feld steht. Der Name dieses Feldes wird für die Variabel %s eingesetzt. Beispiel:
Bitte ergänzen Sie eine Eingabe für <b>%s</b>!
Captcha benutzen
definiert grundsätzlich, ob die Captcha-Funktionalität benutzt wird, d.h. ob auf den eingegebenen Sicherheitscode geprüft werden soll. Damit dies überhaupt möglich ist muß die Grafik sowie das Feld zur Eingabe des Sicherheitscodes im Formular eingebaut sein.
Das könnte z.B. so aussehen:
<tr>
<td>
Sicherheitscode:
</td>
<td>Bitte tragen Sie vor dem Absenden den nachstehenden Sicherheitscode in das nebenstehende Feld ein<br />
<img src="captcha/captcha.php" border="0" title="Sicherheitscode">
Sicherheitscode hier eintragen: <input type="text" name="sicherheitscode" size="5"><br />
Diese Maßnahme dient der Spam-Vermeidung. Wir bitten um Ihr Verständnis.</td>
</tr>
Grundsätzlich erfoderlich ist zum einen das Bild <img src="captcha/captcha.php"> sowie das Eingabefeld <input type="text" name="sicherheitscode"> das den Namen "sicherheitscode" haben muß!
Captcha-Fehlermeldung
gibt bei fehlerhafter Eingabe einen Hinweis aus, der auf typische Fehlerquellen hinweisen sollte, wie z.B. falsche Gross- und Kleinschreibung.
Im Captcha wurden verwechselbare Zeichen wie z.B. I, l und 1 (grosses i, kleines L und Eins) oder q und g weggelassen und es können nur folgende Zeichen vorkommen:
ABCDEFGHJKLMNPRTUVWXYZabcdehkmnsuwxz2346789
Bei diesem Verfahren zum zeitversetzten Senden werden alle Newsletter vollständig erzeugt und ihr Inhalt in die Datenbank geschrieben (was diese stark belasten kann). Diese Newsletter werden nun durch benutztung eines serverseitigen Cronjobs in kleinen Portionen versendet, bis alle verschickt wurden.
Die Serverlast entsteht also direkt beim Erstellen der Newsletter, wird aber durch die Intervallverarbeitung problemlos bewältigt.
Außerdem kann direkt nach dem Erstellen der Newsletter an selbigen weitergearbeitet werden, also Löschungen vorgenommen werden, Varianten erstellt und auch Empfänger verändert werden, da diese Daten nicht mehr benötigt werden.
Ausstehende Cronjobs
gibt die exakte Zahl der zum Versand anstehenden Newsletter an.
Anzahl Newsletter pro Cronjob
gibt an wieviele Newsletter pro Cronjob versendet werden. Dies passt man möglichst der Gesamtzahl, der Serverleistung sowie der Möglichkeit zur Einstufung als Spammer an.
Cronjob-Kennzeichnung
ist eine eindeutige ID, die verhindert, daß der Cronjob extern gestartet wird. Diese wird automatisch erzeugt und muß bei einem Aufruf verwendet werden. Man kann auch eine eigene ID eintragen. Im folgenden werden die zwei Möglichkeiten zum Aufruf gezeigt. Einmal als serverseitiger "echter" Cronjob:
php -f ServerpfadZumCronjob/cronjob.php id_cronjob=CronjobKennzeichnung dir=ModulVerzeichnis
Hierzu müssen die üblichen Zeitangaben vorangestellt werden, also z.B. */5 * * * * für eine Verarbeitung alle 5 Minuten.
Alternativ kann der Cronjob auch als URL aufgerufen werden, wenn z.B. ein "externer" Cronjob-Dienstleister benutzt wird:
http://www.meinedomain.de/ModulVerzeichnis/cronjob.php?id_cronjob=CronjobKennzeichnung&dir=ModulVerzeichnis
Cronjob Stornierung
erlaubt es alle anstehenden Newsletter aus der Datenbank zu löschen.
Bei diesem Verfahren zum zeitversetzten Senden werden die Newsletter erst dann erzeugt, wenn durch einen serverseitigen Cronjob die gespeicherten Parameter verarbeitet werden. Hierbei entseht die Serverlast erst beim Erstellen durch den Cronjob. Damit fehlt allerdings eine Kontrollmöglichkeit und es darf nichts an den Voraussetzungen zum Versenden des Newsletters geändert werden!
Anstehende Zeitpläne
ist die Anzahl der Zeitpläne. Wieviele Newsletter das nun im Endeffekt sind wird sich erst beim Versand zeigen, weil z.B. Empfänger wegfallen können.
Anzahl Newsletter pro Zeitplan
gibt an, wieviele Newsletter gleichzeitig pro Versandjob ausgewählt werden. Bei der Vorbereitung wird der Job in entsprchende Teilabschnitte unterteilt, die dann einzeln abgearbeitet werden. Daher kann sich eine große Anzahl von einzelnen Zeitplänen ergeben.
Zeitplan-Kennzeichnung
ist eine eindeutige ID, die verhindert, daß der Zeitplan extern gestartet wird. Diese wird automatisch erzeugt und muß bei einem Aufruf verwendet werden. Man kann auch eine eigene ID eintragen. Im folgenden werden die zwei Möglichkeiten zum Aufruf gezeigt. Einmal als serverseitiger "echter" Cronjob:
php -f ServerpfadZumCronjob/schedule.php id_cronjob=CronjobKennzeichnung dir=ModulVerzeichnis
Hierzu müssen die üblichen Zeitangaben vorangestellt werden, also z.B. */5 * * * * für eine Verarbeitung alle 5 Minuten.
Alternativ kann der Cronjob auch als URL aufgerufen werden, wenn z.B. ein "externer" Cronjob-Dienstleister benutzt wird:
http://www.meinedomain.de/ModulVerzeichnis/schedule.php?id_cronjob=CronjobKennzeichnung&dir=ModulVerzeichnis
BASE_URL
ist die URL des Webauftritts. Diese ist für schedule.php notwendig, da hier die Erstellung erst durch den Cronjob erfolgt und somit die notwendige Servervariable entfällt.
Zeitplan Stornierung
erlaubt es die anstehenden Zeitpläne aus der Datenbank zu löschen. Es ist eine Mehrfachauswahl mit Strg oder Shift möglich.