Newsletter Snippet - An- und Abmeldedialog für einen Newsletter

Das Newsletter Snippet ergänzt das Massmail Modul um einen Frontend Dialog, über den sich die Besucher Ihrer Website für einen Newsletter eintragen können.

Das Newsletter Snippet sendet einen Aktivierungslink an die angegebene E-Mail Adresse und trägt die E-Mail Adresse nach erfolgter Aktivierung in die angegebene Massmail Group ein. Das Austragen aus dem Newsletter erfolgt auf die gleiche Weise: der Besucher gibt seine E-Mail Adresse an, existiert sie im Verteiler, sendet das Newsletter Snippet einen Bestätigungslink an die angegebene Adresse, nach Bestätigung wird die E-Mail Adresse aus der Massmail Group ausgetragen.

Die Verwaltung und der Versand der Newsletter an die Abonnenten erfolgt über das Massmail Modul.

Das Massmail Modul wurde Johannes Holzer, U. Christoffersen und R. Smith entwickelt und unter GPL bereitgestellt. Sie finden es im Website Baker Addons Repository und können es dort herunterladen.

Das Massmail Modul muss installiert sein, damit das Newsletter Snippet funktioniert.

Wenn Sie Fragen zum Massmail Modul haben, wenden Sie sich bitte an die Autoren, Sie erreichen sie über das Website Baker Module Forum.

Code Snippets oder "Programm Schnipsel" sind Programme bzw. Funktionen, die in Website Baker eingebunden werden und global zur Verfügung stehen. Snippets sind ideal, wenn Funktionen nicht auf eine einzelne Seite beschränkt sein sollen, sie lassen sich in Templates einbinden oder als Abschnitt vom Typ Code in beliebigen Seiten integrieren.

Nach der Installation können Sie das Newsletter Snippet an der gewünschten Stelle einbinden: 

<?php
  if (function_exists('newsletter_info')) {
    newsletter_info('Newsletter','newsletter@ralf-hertsch.de',true,false);
  }
?>

Mit if (function_exists('newsletter_info')) {...} überprüfen Sie, ob das Newsletter Snippet tatsächlich installiert ist, newsletter_info() ist der eigentliche Funktionsaufruf.

Die Funktion verfügt über mehrere Parameter:

newsletter_info($massmailGroup, $fromEMail, $textOnly=true, $infoAdmin=false)

• $massmailGroup ist die Gruppe in Massmail, in die das Newsletter Snippet Abonnenten einträgt. Diese Gruppe muss bereits existieren, sonst meldet Ihnen das Newsletter Snippet einen Fehler. Im Beispiel oben lautet die Gruppe 'Newsletter'.
• $fromEMail ist die E-Mail Adresse, die das Newsletter Snippet als Absender für die Aktivierungsmails verwendet, im Beispiel lautet die Adresse 'newsletter@ralf-hertsch.de'.
• $textOnly kann true oder false sein. Ist true gesetzt, versendet das Newsletter Snippet E-Mails im TEXT Format, ist dagegen false gesetzt, versendet das Newsletter Snippet E-Mails im Mulitpart Modus (HTML und TEXT).
• $infoAdmin kann true oder false sein. Ist true gesetzt, versendet das Newsletter Snippet Statusmails an die E-Mail Adresse $fromEMail. 

Es gibt verschiedene Möglichkeiten, das Newsletter Snippet einzubinden:

Einbindung als einzelne Seite

Diese Möglichkeit das Newsletter Snippet als einzelne Seite einzubinden bietet sich an, wenn Sie den Dialog für die An- und Abmeldung zu Ihrem Newsletter auf einer einzelnen Seite haben möchten.

Die Vorteile hierbei sind, dass Sie den Newsletter in ihr Menu aufnehmen können und an verschiedenen Stellen innerhalb Ihrer Website, insbesondere wenn es inhaltlich passt, einen Link auf den Newsletter setzen können.

Hierzu erstellen Sie eine neue Seite oder einen neuen Abschnitt vom Typ Code innerhalb einer bereits bestehenden Seite und geben im Textfeld den Funktionsaufruf für das Newsletter Snippet ein: 

if (function_exists('newsletter_info')) {
  newsletter_info('Newsletter','newsletter@ralf-hertsch.de',true,false);  
}

Einbindung in das Template 

Die Möglichkeit das Newsletter Snippet in das Template einzubinden bietet sich an, wenn sich die Dialogbox für die An- und Abmeldung für den Newsletter auf allen Seiten befinden soll.

Hierzu müssen Sie die index.php Ihres Templates bearbeiten. Öffnen Sie die Datei und fügen Sie an der gewünschten Stelle im Template den Funktionsaufruf für das Newsletter Snippet ein:

  if (function_exists('newsletter_info')) {
    newsletter_info('Newsletter','newsletter@ralf-hertsch.de',true,false);  }
?>

Beim Template Round, dass mit Website Baker mitgeliefert wird, ist ein ganz guter Platz auf der linken Seite unterhalb des Menus und der Suchen Box ab Zeile 107 in der index.php: 

<?php if(SHOW_SEARCH) { ?>
  <form name="search" action="" method="get">
    <table cellpadding="0" cellspacing="0" border="0" width="150" align="center" style="margin-top: 10px;">
      <tr>
        <td class="border">
          <img src="/menu_top.gif" border="0" alt="" />
        </td>
      </tr>
      <tr>
        <td class="login">
          <input type="text" name="string" />
        </td>
      </tr>
      <tr>
        <td class="login">
          <input type="submit" name="submit" value="" />
        </td>
      </tr>
      <tr>
        <td class="border">
          <img src="/menu_bottom.gif" border="0" alt="" />
        </td>
      </tr>
    </table>
  </form>
<?php } ?>
<?php
  if (function_exists('newsletter_info')) {
    newsletter_info('Newsletter','newsletter@ralf-hertsch.de',true,false);  
  }
?>

Formatierung des Newsletter Snippet 

Die Formatierung des Newsletter Snippet erfolgt über die screen.css des Templates, das Sie verwenden.

Das Newsletter Snippet gibt die Dialogbox innerhalb eines Block aus: 

<div class="newsletter">
[...]
</div>

Neben der Klasse newsletter wird lediglich eine weitere, newsletter_error, für die Ausgabe von Fehlern verwendet.

Um eine Newsletter Anmeldung wie in der nebenstehenden Abbildung zu erreichen, stehen für die Formatierung des Newsletter Snippet die folgenden Anweisungen in der verwendeten screen.css:

.newsletter {   
  width:180px;   
  margin:50px 0 0 10px;   
  padding: 50px 5px 5px 5px;   
  background-image: url(newsletter-bkgnd-2.jpg);   
  background-repeat: no-repeat;   
  background-position: top left;   
  color: #fff;   
  background-color: transparent;   
  font-size: 8pt;   
  } 
.newsletter input[type=text], 
.newsletter input[type=submit] {   
  width: 100%;   
  color: #fff;   
  background-color: transparent;   
  border: 1px solid #fff;   
  } 
.newsletter input:hover {   
  color: #000;   
  background-color: #fff;   
  } 
.newsletter input:focus {   
  color: #000;   
  background-color: #fff;   
  }

Anpassen des Newsletter Snippet

Das Newsletter Snippet läßt sich auch über die Sprachdateien an die eigenen Vorstellungen anpassen.

Wollen Sie z.B. den Einleitungssatz "Mein Newsletter informiert Sie in unregelmäßigen Abständen über neue oder aktualisierte Website Baker Module." ändern, öffnen Sie die Sprachdatei DE.php im Verzeichnis /modules/newsletter/languages mit einem beliebigen Editor und suchen Sie nach dem Eintrag:

 
define('nl_text_intro', 'Mein <strong>Newsletter</strong> informiert Sie in unregelm&auml;&szlig;igen Abst&auml;nden &uuml;ber neue oder aktualisierte WebsiteBaker Module.');
 

Führen Sie die gewünschten Änderungen durch und speichern Sie die Datei wieder auf dem Server.

Anmerkungen:

• Texte die in den Dialogen verwendet werden beginnen mit nl_text_, Texte die in den E-Mails verwendet werden beginnen mit nl_mail_ und die Betreffzeilen der E-Mails beginnen mit nl_subject_
• Bei den nl_text_ Texten können Sie beliebige HTML Formatierungen verwenden, achten Sie darauf daß Sie die Platzhalter %s nicht überschreiben und maskieren Sie Umlaute, z.B. ü -> &uuml;
• Bei den nl_mail_ und nl_subject_ Texten sollten Sie keinerlei Formatierungen verwenden. Es hat sich in der Praxis bewährt bei E-Mail Benachrichtigungen Umlaute zu umschreiben um Darstellungsfehler beim Anwender zu vermeiden, z.B. ä -> ae. Einen Zeilenumbruch erhalten Sie durch Einfügen von \r\n im laufenden Text.

Â

Bei allen Fragen, Fehlermeldungen und Verbesserungsvorschlägen nehmen Sie bitte über das Website Baker Forum (Deutsch) oder per E-Mail Kontakt mit mir auf.

Vielen Dank für Ihr Interesse!

Download

Die aktuelle Version finden Sie auf der Download Seite.