Das weBlog Modul

Klappt man den Menüpunkt tyBlog im Addons-Bereich auf, so findet man eine kurze Übersicht über die letzten Blogbeiträge und Kommentare. Hier erhält man sofort einen Überblick über eventuell noch nicht freigeschaltete Kommentare oder Trackbacks.

Mit einem Klick auf Statistik öffnet sich die Detailseite mit einer Übersicht über die letzten Blogeinträge und die neuesten Kommentare.

In den Formulareinstellungen kann man definieren, welche Attribute ein Blognutzer besitzen soll. So können dynamische Formulare zur Nutzerverwaltung erstellt werden, welche immer die Attribute enthalten, die sie im Blogmodul eingestellt haben.

Die Funktionsweise ist der des Formularmanagers recht ähnlich, jedoch können die Formulare des Blogmoduls die Daten eines Nutzers verändern (während der Formularmanager auf die Datenbank zugreift).

Ein dynamische Formular kann zum Beispiel so erzeugt werden:

<ty:blog mode=„printformfields“> <ty-blog:inputname/> <ty-blog:inputfield/><br/> </ty:blog>

Hier werden alle Attribute nacheinander ausgegeben, links der Name des Attributs und rechts ein Inputfield mit dem Wert des Attributs

Achtung: Diese Blog-Formulare sind veraltet und im Funktionsumfang stark eingeschränkt. Stattdessen sollten Formulare des Formularmanagers verwendet werden.

Im Setup werden alle Seiten definiert, die das Blog benötigt um richtig zu funktionieren und um Links mit den ty:blog-Tags zu erzeugen. Wählen Sie hier jeweils die entsprechenden Seiten aus der Navigation aus. Falls das Blog initialisiert wurde, sollten hier schon die korrekten Seiten ausgewählt sein.

Weiterhin können drei Mailvorlagen ausgewählt werden. Die Mailvorlagen müssen zunächst in der Modul Box „Mail Vorlagen“ angelegt und eingerichtet werden. Alle Mails werden an den an der Mailvorlage definierten Empfänger versendet.

• Mail bei neuem Kommentar - Diese E-Mail wird versendet sobald jemand einen neuen Kommentar schreibt
• Mail bei neuem Blogeintrag - Diese E-Mail wird versendet, wenn ein Blogeintrag auf den Status veröffentlicht gesetzt wird und vorher einen anderen Status hatte
• Mail bei Status 'Zur Korrektur' - Diese E-Mail wird versendet, wenn ein Blogeintrag auf den Status zur Korrektur gesetzt wird und vorher einen anderen Status hatte

In den Mailvorlagen können bestimmte Platzhalter verwendet werden, siehe Abschnitt „Mailvorlagen Platzhalter“

Zusätzlich können einige Optionen für das Blog festgelegt werden:

• Antispam Code für Kommentare deaktivieren (veraltet) - Normalerweise wird ein sogenanntes CAPTCHA eingesetzt um sicherzustellen, dass der Kommentar von einem Menschen per Hand abgegeben wurde. Diese CAPTCHA kann hier ausgeschaltet werden. Die Einstellung wirkt sich jedoch nur auf ältere Kommentarformulare aus. Neuere Blogs verwenden den Formularmanager zum Eintragen von Kommentaren - hier muss die Einstellung für CAPTCHAs direkt im Formularmanager vorgenommen werden
• Kommentare generell deaktivieren - Deaktiviert die Kommentarmöglichkeit komplett für alle Einträge
• Trackbacks generell deaktivieren - Deaktiviert die Möglichkeit von Trackbacks komplett für alle Einträge. Aufgrund der extremen Anfälligkeit von Trackbacks für Spam ist die Option zu empfehlen
• Kommentare müssen erst freigeschalten werden - Neue Kommentare werden nicht sofort auf der Webseite veröffentlicht, sondern müssen erst manuell aktiviert werden. Aktiviert man diese Option, sollte nach dem Eintragen unbedingt ein Hinweis auf die notwendige Freischaltung erfolgen. Ansonsten werden viele Nutzer den Kommentar mehrfach abgeben, wenn keine sichtbare Reaktion erfolgt
• Blogeinträge aus Unterkategorien auch anzeigen - Beim Aufrufen einer Kategorie werden nicht nur die Einträge der aktuellen Kategorie ausgegeben, sondern auch die alle Unterkategorien
• Seitenrechte der Rubriken beachten - Diese Option kann aktiviert werden, wenn Blognutzer nicht in allen Kategorien die gleichen Rechte besitzen. Auf der Übersichtsseite werden dann nur Einträge der Kategorien angezeigt, für die der Nutzer auch Leserechte besitzt. Diese Option benötigt zusätzliche Rechenleistung und sollte nur aktiviert werden, wenn sie auch unbedingt benötigt wird

Das Blog kann im Backend initialisiert werden um automatisch bestimmte Vorlagen, Rollen und Einstellungen anzulegen. Dazu wählen Sie in der Modul-Box „tyBlog“ im Reiter „Addons“ die Funktion „Blog initialisieren“ an. Um diesen Menüpunkt nutzen zu können müssen Sie über Admin-Rechte verfügen.

Auf der Initialisierungsseite können mehrere Bestandteile der Blogs eingerichtet werden.

1. Datenbank anbinden - Die Anbindung an das DB-Modul ist notwendig um Einträge per Inline-Editing bearbeiten zu können. Weiterhin können die Einträge so auch im DB-Manager bearbeitet werden.
2. Rollen anlegen - Legt automatisch drei Rollen (Blogger_Frontend, Blogger_Backend, Blog_Admin) an, die alle notwendigen Rechte für die Blognutzung besitzen.
3. Vorlagen und Schnipsel anlegen - Legt eine Vorlage an und Schnipsel mit allen Blogfunktionen. Es werden Schnipsel für den Hauptbereich (Liste mit Blogeinträgen, Blogeintrag Detailseite, Blogeintrag editieren) sowie einige Schnipsel für den Seitenbereich (Blog Funktionen, neueste Einträge, Stichwortwolke, etc.) angelegt.
4. Blog Navigation anlegen - Legt alle für das Blog notwendigen Seiten in der Navigation an. Es wird ein Hauptpunkt „Blog“ angelegt, dieser enthält Unterpunkte für: Detailseite, Editierseite, Rubriken, Trackback, Atom-Feed, RSS-Feed.
5. Navigation im Blogsetup zuweisen - Stellt die im vorherigen Schritt angelegten Seiten im Blog-Setup ein. Muss gleichzeitig mit dem vorherigen Punkt durchgeführt werden.
6. Formulare im Formularmanager anbinden - Es wird ein Formular zum Eintragen von Kommentaren, sowie ein Formular zum Editieren von Blogeinträgen angelegt. Diese können dann auf der Detail- bzw. der Editierseite eingesetzt werden.
7. Areas mit Schnipseln befüllen - Fügt den Seiten automatisch die benötigten Schnipsel hinzu. Zur Zeit werden nur die Schnipsel für den Hauptbereich hinzugefügt. Erfordert Punkt 3 und muss gleichzeitig mit Punkt 4 erfolgen.

In einer durch das Blog Modul verschickten Mail können die folgenden Platzhalter in der Mailvorlage verwendet werden:

• {blogentryheadline} - Überschrift des Blogeintrags
• {blogentrylink} - Link zum Blogeintrag. Da die geschweiften Klammern innerhalb eines <a href=““> unzulässig sind, kann ein HTML Link über {blogentrylinkstart}zum Blogeintrag{blogentrylinkend} ausgegeben werden.
• {blogentryauthor} - Name des Autors
• {blogpreviewtext} - Vorschautext

In der Mailvorlage für einen neuen Kommentar können zusätzlich folgende Platzhalter verwendet werden:

• {commentheadline} - Überschrift des Kommentars
• {commenttext} - Kompletter Text
• {commentauthor} - Name des Autors
• {commentemail} - Email des Autors
• {commentvalidationlink} - Link zum Freischalten des Kommentars. Kann auch über {commentvalidationlinkstart}Freischalten{commentvalidationlinkend} ausgegeben werden
• {commentdeletelink} - Link zum Löschen des Kommentars. Kann auch über {commentdeletelinkstart}Löschen{commentdeletelinkend} ausgegeben werden
• {commenttype} - Typ des Kommentars. Hier wird entweder „Kommentar“ oder „Trackback“ in der Sprache des Backends zurückgeliefert

Zielseite für das Freischalten/Löschen von Kommentaren

Um Kommentare über den Link in der E-Mail freischalten oder löschen zu können, muss zunächst im Blog-Setup eine Seite für das Freischalten/Löschen von Kommentaren definiert werden. Diese Seite muss folgenden Code enthalten um korrekt zu funktionieren:

<ty:blog mode="activation" <?php if ($_REQUEST['del']) echo 'del="true" '; if ($_REQUEST['cid']) echo 'cid="'.((int)$_REQUEST['cid']).'"'; if ($_REQUEST['tid']) echo 'tid="'.((int)$_REQUEST['tid']).'"'; ?> validation="<?php echo htmlentities($_REQUEST['validation']); ?>" />

Im Blog gibt es mehrere Rechte und Rollen die an die Nutzer verteilt werden können. Nach der Installation sind 3 Rollen mit bereits zugewiesenen Rechten vorhanden („Blog_Admin“, „Blogger_Backend“ und „Blogger_Frontend“).

Um einen neuen Blogger für das Blog zu erstellen, reicht es aus, einem Benutzer die Rollen „Blogger_Backend“ und „Blogger_Frontend“ zuzuweisen. Dadurch bekommt dieser das Recht neue Blogeinträge zu erstellen und seine eigenen Blogeinträge zu bearbeiten und zu löschen.

Will man einen Administrator für das Blog einsetzen, so weisst man diesem zusätzlich die Rolle „Blog_Admin“ zu. Dieser darf dann Blogeinträge aller Nutzer löschen und bearbeiten. Weiterhin kann er neue Seiten in der Navigation erstellen und vorhandene löschen.

Soll ein Nutzer nur ausgewählte Rechte erhalten, findet man bei der Richtlinienverwaltung die entsprechenden Rechte unter dem Modul „blog“. Dies ist aber eigentlich nur für Spezialfälle notwendig, in denen ein Nutzer nur Beiträge anlegen aber nicht löschen darf, oder ähnliches.

Standardmäßig erhält der Gastaccount das Recht Kommentare zu schreiben - will man die Kommentarfunktion nur für eingeloggte Nutzer aktivieren, so entfernt man der Gastrolle einfach das Recht blog/frontend/comments→new

Der Administrator erhält automatisch bei der Installation alle Rollen und ist somit automatisch auch „Blog-Admin“.

Seit Version 4.1RC3 des Blog Moduls werden Plugins für das Blog unterstützt. Diese können z.B. beim Absenden eines neuen Blogeintrags oder beim Löschen eines Kommentars ausgeführt werden.

Zwei Verzeichnisse werden nach Plugins durchsucht:

• /media/templates/blog/plugins
• /tycon/modules/blog/plugins

Mitgelieferte Plugins befinden sich im Plugin Verzeichnis im tycon Ordner, projektspezifische Plugins können im Media Ordner des jeweiligen Projekts abgelegt werden.

Soll ein neues Plugin entwickelt werden, so gelten dafür einige Regeln:

• Das Plugin besteht aus einer Klasse, deren Name dem Dateinamen (bis zum ersten “.“) entspricht
• Die Klasse muss entweder das Interface tyBlogPlugins direkt implementieren, oder besser von der Klasse tyBlogDefaultPlugin erben (diese implementiert bereits das komplette Interface - dadurch kann auch ein altes Plugin mit neueren Blog Versionen zusammenarbeiten)
• Das Plugin muss sich in einem der beiden Plugin-Verzeichnissen befinden

Das Twitter-Plugin sendet neue Blog-Beiträge automatisch an einen Twitter-Account. Es werden immer die ersten 105 Zeichen des Eintrags, sowie ein Link zum Blogeintrag an Twitter gesendet. Der Link wird in eine tinyURL Kurzform umgewandelt und findet so immer in den übrigen 35 Zeichen Platz. Einträge werden immer an Twitter gesendet, wenn diese veröffentlicht werden - also wenn diese auf den Status „veröffentlicht“ gesetzt werden und vorher einen anderen Status hatten.

• „Plugin aktivieren“ - nur wenn hier der Haken gesetzt ist, wird das Twitter-Plugin Beiträge an Twitter senden
• „Nutzername““ - der Login für den Twitter-Account, muss zuvor in der Twitter-Modul-Box konfiguriert worden sein
• „Blogeintrag nur an Twitter schicken, wenn am Eintrag aktiviert“ - beim Veröffentlichen eines Blogeintrags muss zusätzlich ein Haken gesetzt werden, damit dieser an Twitter gesendet wird
• „Die ersten 105 Zeichen von folgendem Feld des Blogeintrags an Twitter schicken“ - hier kann das Feld ausgewählt werden, dass an Twitter gesendet wird. Zur Auswahl stehen: Überschrift, Vorschautext, Text, Beschreibung und Freeoption. Aufgrund der Zeichenbeschränkung sind die Felder Beschreibung oder Überschrift am besten geeignet.

Das Facebook-Plugin sendet neue Blog-Beiträge automatisch an die Pinnwand eines Facebook-Accounts. Einträge werden immer an Facebook gesendet, wenn diese veröffentlicht werden - also wenn diese auf den Status „veröffentlicht“ gesetzt werden und vorher einen anderen Status hatten.

Damit die Daten an Facebook gesendet werden können, muss das Plugin zunächst autorisiert werden. Dazu folgen Sie einfach dem Link unter „Facebook Autorisierung“ und schalten das Plugin frei. Beachten Sie, dass Sie hier die gleichen Nutzerdaten verwenden, die Sie im Plugin definiert haben. Das Plugin wird nur für diesen Account freigegeben.

• „Plugin aktivieren“ - nur wenn hier der Haken gesetzt ist, wird das Facebook-Plugin Beiträge an Facebook senden
• „Nutzername“ / „Passwort“ - die Logindaten für den Facebook-Account
• „Blogeintrag nur an Facebook schicken, wenn am Eintrag aktiviert“ - beim Veröffentlichen eines Blogeintrags muss zusätzlich ein Haken gesetzt werden, damit dieser an Facebook gesendet wird
• „Das folgende Feld des Blogeintrags an Facebook schicken“ - hier kann das Feld ausgewählt werden, dass an Facebook gesendet wird. Zur Auswahl stehen: Überschrift, Vorschautext, Text, Beschreibung und Freeoption.