Einrichtung des Newsletterarchivs

Nutzen Sie das Newsletterarchiv um den Besuchern Ihrer Webseite die Möglichkeit zu geben in der Vergangenheit versendete Newsletter anzuschauen. Neben der Anzeige des Newsletterarchivs als HTML-Variante steht ebenfalls die Variante als RSS-Feed zur Verfügung. Optional kann ebenfalls ein Twitter Tweet mit dem Link auf den neuen Newsletter im Newsletterarchiv erstellt werden.

Voraussetzungen für den Einsatz des Newsletterarchivs

 

 

Layout-Anpassungen

Es ist empfehlenswert das Layout des Newsletterarchivs an das Layout der eigenen Webseite anzupassen. Dazu müssen die Dateien na_start.htm, na_year.htm, na_day.htm und na.css im SuperMailer-Programmordner angepasst werden. Die Dateien sollte in einen separaten Ordner kopiert werden, diesen Ordner geben Sie als Vorlagenordner an.
In den HTML-Dateien befinden sich Platzhalter in Form von Kommentaren. Diese Kommentare werden vom Script ersetzt. Es gelten dabei die folgenden Regeln:

  1. Angaben im Kommentar <!--NAME//-> werden durch Zeichenketten ersetzt, die sich in der Datei strings.inc.php befinden.
  2. Angaben im Kommentarblock <!--NAME_BEGIN//-> und <!--NAME_END//-> werden mehrfach verwendet z.B. um mehrere Jahre oder Einträge des Archivs darzustellen.
  3. Angaben im Kommentarblock <!--NAME_IF_FIRST_BEGIN//->, <!--NAME_IF_FIRST_END//->, <!--NAME_IF_LAST_BEGIN//->, <!--NAME_IF_LAST_END//-> werden nur verwendet, falls es sich um den ersten bzw. letzten Eintrag handelt.

Die Kommentare sind Dateispezifisch, d.h. es können nur die Kommentare in den Dateien verwendet werden, die in den Vorgabedateien angegeben sind.

 

Aufruf des Scripts des HTML-Variante

Rufen Sie das übertragene Script ohne Parameter auf, dann wird die Startseite des Newsletterarchivs angezeigt. Diese Variante ist für die Verlinkung z.B. im Navigationsbereich Ihrer Webpräsenz empfohlen.

 

Aufruf des Scripts als RSS-Feed

Rufen Sie das übertragene Script mit dem Parameter ?showRSS=x (x kann ein beliebiger Wert sein) auf, um alle Newsletter des aktuellen Jahres als RSS-Feed anzeigen zu lassen. Verwenden Sie zusätzlich den Parameter &showAll=y (y kann ein beliebiger Wert sein), um alle gespeicherten Newsletter des Newsletterarchivs als RSS-Feed anzeigen zu lassen.

 

Konfiguration des Newsletterarchivs

Rufen Sie im Menü Projekt die Konfiguration des Newsletterarchivs auf.

Wichtige Hinweise

 

Registerkarte Informationen

Einstellung Hinweise
Newsletterarchiv-Funktion aktivieren Aktivieren Sie diese Einstellung um das Newsletterarchiv zu verwenden. SuperMailer wird in diesem Fall vor dem E-Mail-Versand das notwendige Script und die Daten zur E-Mail übertragen.

 

Ordner mit den Vorlagedateien (leer = Programmordner) Für unterschiedliche Projekte können unterschiedliche Newsletterarchiv-Vorlagen erstellt werden. Verwenden Sie nur ein Projekt, dann können Sie diese Angabe leer lassen. SuperMailer verwendet in diesem Fall die Vorlage-Dateien aus dem eigenen Programmordner.

Bei Verwendung mehrerer Projekte müssen die Vorlagedateien na.css, na_day.htm, na_start.htm und na_year.htm in einen separaten Ordner kopiert und das Layout angepasst werden. Diesen Ordner geben Sie als Ordner mit den Vorlagen an.

 

Benutzername/Passwort Geben Sie Benutzername und Passwort zum Schutz des Newsletterarchivs ein. Diese Daten werden nur beim Entfernen von Daten aus dem Newsletterarchiv verwenden.

 

 

Registerkarte Upload

Einstellung Hinweise
Domain inkl. Verzeichnis Geben Sie die komplette URL bestehend aus http://<domainname>/<unterverzeichnis>/ an. Diese Angabe wird von SuperMailer verwendet, um die lokalen Ordnerangaben in Webadressen umzuwandeln. Die Angabe des Unterverzeichnisses muss mit dem FTP-Verzeichnis bzw. Verzeichnis im Script upload.php übereinstimmen.

Hinweis:
Ist die Angabe falsch, dann kann SuperMailer das Newsletterarchiv nicht aufrufen und es wird eine Fehlermeldung ausgeben.

 

Name des Scripts Geben Sie den Namen des PHP-Scripts an. Beachten Sie dabei, dass das Script die Dateierweiterung .php tragen muss, ansonsten wird es nicht ausgeführt. Im Dateinamen des Scripts dürfen nur die Buchstaben A-Z (a-z), die Ziffern 0..9 und der Unterstrich oder Bindestrich verwendet werden.

Installieren Sie das Newsletterarchiv in ein eigenes Verzeichnis dann sollte das Script index.php benannt werden. In diesem Fall wird auf den meisten Webservern das Script als Standard-Seite für das Verzeichnis behandelt.

 

 

Für den Upload der Dateien steht die Variante des Uploads per FTP und die Variante per HTTP mit dem Upload-Script zur Verfügung. Es ist empfohlen die Variante zur Übertragung der Dateien mit Hilfe des FTP-Protokolls zu verwenden. In Firmennetzwerken ist die Nutzung von FTP nicht immer möglich, in diesem Fall kann die Variante zur Übertragung der Dateien per HTTP mit Hilfe des Upload-Scripts verwendet werden.

FTP-Upload einrichten

Verbindungstyp Wählen Sie den Typ der Verbindung. Bei Ihrem Webspace-Provider im Kundenbereich finden Sie die entsprechenden Informationen.

Zur Auswahl stehen:

  • Normales FTP (Port 21), unverschlüsselt
  • FTPS (explizites FTPS, Port 21), verschlüsselt
  • FTPS (implizites FTPS, Port 990), verschlüsselt
  • SFTP (Port 22), verschlüsselt auf SSH basierend

 

Port Der Port sollte nur geändert werden, falls der Webspace-Provider dies explizit angibt, ansonsten sind immer die vorgegebenen Ports als Standard zu belassen.

 

FTP-Server Geben Sie den Namen oder die IP-Adresse des FTP-Servers ein.

Informationen zum FTP-Server erhalten Sie von Ihrem Webspaceprovider.

 

Benutzername / Passwort Geben Sie den Benutzernamen und das Passwort für den FTP-Zugriff ein.

Informationen zu den FTP-Zugangsdaten erhalten Sie von Ihrem Webspaceprovider.

 

FTP-Verzeichnis Geben Sie das FTP-Verzeichnis an, in das SuperMailer beim Upload der Dateien wechseln soll. Um ein Verzeichnis wählen Sie können, muss FTP-Server, FTP-Benutzername und FTP-Passwort eingegeben werden.

Hinweis:
FTP-Verzeichnis und Angabe der Domain inkl. Unterverzeichnis müssen natürlich übereinstimmen, so dass SuperMailer das Newsletterarchiv-Script finden kann.
Haben Sie die Daten zum FTP-Server, sowie Benutzername/Passwort eingegeben, dann können Sie auch auf die Durchsuchen-Schaltfläche klicken, um ein Verzeichnis zu suchen bzw. anzulegen.

Informationen zu Verzeichnisangaben erhalten Sie von Ihrem Webspaceprovider.

 

Passive Übertragung verwenden Die Option "Passive Übertragung verwenden" sollte gewählt werden, wenn Probleme beim Upload der Dateien auftreten.

 

HTTP-Upload einrichten

Aufruf des Upload-Scripts Geben Sie den HTTP-Aufruf inkl. Namen des Upload-Scripts ein.

Siehe auch
Konfiguration des Upload-Scripts

 

 

 

Erweiterte SFTP-Einstellungen

Die erweiterten SFTP-Einstellungen sollten nur angepasst werden, falls der Webspace-Provider dies erfordert, z.B. um eine Authentifizierung mit privaten Schlüssel anstatt mit einem Passwort zu ermöglichen.

 

Registerkarte Erscheinungsbild

Aktivieren Sie die Einstellung "Farben und Schriftart anpassen (bei eigenen Layouts deaktivieren)" um die Farben und Schriftarten anzupassen. Diese Option muss deaktiviert werden sobald Sie eigene Stylesheets in der Datei nav.css definiert haben.

 

Registerkarte Standardtexte

Die Vorgabetexte können beliebig verändert werden. Achten Sie dabei auf die Länge der Texte, da zu lange Texte zu Darstellungsproblemen führen könnten.

Platzhalter

Im Feld "Überschrift auf der Seite nach Auswahl eines Jahres:" kann der Platzhalter $NewsletterYear$ verwendet werden, das Script wird an dieser Stelle das Jahr einsetzen.

Im Feld "Text für einen Newslettereintrag:" können die Platzhalter:

verwendet werden

 

Registerkarte Impressum

Soll auf jeder Seite das Impressum am Ende der Seite angezeigt werden, dann aktivieren Sie die Einstellung und geben Sie die Daten für das Impressum ein. Sie können direkten HTML-Code in das Eingabefeld einfügen, aktivieren Sie danach unbedingt die Option "Der Text für das Impressum enthält HTML-Code.". Besteht das Impressum nur aus reinem Text, dann aktivieren Sie die Einstellung "Der Text für das Impressum enthält HTML-Code." nicht, SuperMailer wird aus dem Text HTML-Code erstellen.

 

Registerkarte Ersetzungen

In personalisierten E-Mails verwenden Sie z.B. den Namen, Anrede usw.. um den Empfänger persönlich anzusprechen. Im Newsletterarchiv ist natürlich die persönliche Ansprache nicht möglich. Sie können daher die empfängerspezifischen Daten durch Standardwerte ersetzen lassen.

 

Registerkarte Header

Diese Zusatz-Angaben können vom Newsletterarchiv-Script in den unsichtbaren Kopfteil (Header) der HTML-Seite eingesetzt werden. Die Angaben verbessern das Auffinden der Seiten in Suchmaschinen.

 

Registerkarte Social Network

Aktivieren Sie das Hinzufügen eines Twitter Tweets oder einer Facebook Status-Message, so dass nach dem Upload des Newsletterarchivs direkt ein Beitrag mit Verweis auf den Eintrag im Newsletterarchiv bei Twitter oder Facebook erstellt werden kann.

 

Siehe auch
Einträge aus dem Newsletterarchiv entfernen

 

 

 

 

Konfiguration des Upload-Scripts

Das Upload-Script upload.php kann als Alternative zur Übertragung der Dateien per FTP verwendet werden. Sie finden das Script upload.php im SuperMailer-Ordner. Dieses Script muss einmalig per FTP z.B. von einem Administrator auf die Webseite übertragen werden, danach kann es immer wieder verwendet werden. Vor der Übertragung muss die Konfiguration des Scripts geändert werden, so dass der Upload der Dateien in das richtige Serververzeichnis durchgeführt wird.

Hinweis
Das Script sollte mit einem zufälligen Namen versehen werden, so dass nicht jeder von außen auf das Upload-Script zugreifen kann. Dieser zufällige Name muss inkl. Domain im Feld "Aufruf des Upload-Scripts" angegeben werden.

Das Script kann für die Tracking-Funktion, für den Dateiupload, für den alternativen Browserlink, für den Feedback-Link, für die Abstimmungen und für das Newsletterarchiv verwendet werden.

Ändern der Script-Konfiguration

  1. Öffnen Sie das PHP-Script in einem Texteditor (nicht in Word oder WordPad!)
  2. Suchen Sie im Script nach

# Upload-Verzeichnis mit / am Ende angeben
# Upload-Verzeichnis entspricht dem kompletten Verzeichnis vom Root-Verzeichnis auf
# dem Server, dieses Verzeichnis stimmt nicht unbedingt mit dem FTP-Verzeichnis überein
# Das Verzeichnis sollte mit 777 unter Linux freigegeben werden, um Probleme mit
# Zugriffsrechten zu vermeiden
$UPLOADDIR="/home/www/tracking/";

  1. Ändern Sie im Script den Wert der Variablen $UPLOADDIR von /home/www/tracking auf das korrekte Verzeichnis auf Ihrem Webspace/Server.
  2. Speichern Sie das Script und übertragen Sie es per FTP auf Ihren Webspace/Server

Informationen zu Verzeichnisangaben auf Ihrem Server erhalten Sie von Ihrem Webspaceprovider.