Knowledgebase:Blog

From Cloudrexx Development Wiki
Jump to: navigation, search

Dieser Artikel beschreint die Software Contrexx. Das neue Handbuch zu Cloudrexx wird unter support.cloudrexx.com bereit gestellt.

Handbuch

Kurzbeschreibung

Über diese Anleitung

Die folgende Anleitung führt Sie durch die ersten Schritte mit dem Blog-Moduls. Sie werden dabei schrittweise den kompletten Funktionsumfang des Modules kennen lernen.

Kurzbeschreibung

Mit dem Blog-Modul können Sie ein Tagebuch oder Journal auf Ihrer Webseite führen. Teilen Sie allen Besuchern Ihre Gedanken und Ideen mit. Über Kategorisierung und Schlüsselwörter werden die Nachrichten strukturiert und können anschliessend von Ihren Besuchern über die Suchfunktion wieder gefunden werden.

Anwendung

Kategorien

Über Kategorien können Sie eine Struktur in Ihre verschiedenen Meldungen bringen. Das hilft Ihren Besuchern, sich bei vielen Themen zu orientieren und schneller zu Ihrem gewünschten Resultat zu kommen.

Kategorie erstellen

Bevor Sie Meldungen verfassen wollen Sie vermutlich passende Kategorien erstellen. Dazu klicken Sie zuerst auf den Menupunkt Kategorien verwalten.

Modul Blog Menu Kategorien.gif

Auf der sich öffnenden Seite wechseln Sie nun ins Register Kategorie einfügen. Hier können Sie Ihrer neuen Kategorie einen Namen geben und festlegen, in welchen Systemsprachen diese aktiviert werden soll. Falls der Kategorienname von der Sprache abhängt, so kann dies über Erweitert dies werden.

Modul Blog Kategorien Hinzu.gif

Nach einen Klick auf Speichern wird die neue Kategorie im System erfasst.

Kategorie bearbeiten

Falls eine bestehende Kategorie angepasst werden soll, so kann dies ebenfalls über Kategorien verwalten erreicht werden.

Modul Blog Menu Kategorien.gif

Anders als beim Hinzufügen von Kategorien bleiben Sie nun allerdings im Register Kategorien verwalten.

Modul Blog Kategorien Edit.gif

Hier bekommen Sie eine Auflistung aller momentan vorhandenen Kategorien angezeigt. Durch klicken auf den Namen der Kategorie oder das Editieren-Symbol (Verzeichnisicon1.jpg) am Ende der betreffenden Zeile kommen Sie zur "Kategorie editieren"-Ansicht.

Modul Blog Kategorien Edit Form.gif

Diese Ansicht ist identisch mit derjenigen unter Kategorie hinzufügen. Sie können den Namen der Kategorie sowie den Aktivierungsstatus in den einzelnen Sprachen anpassen. Nach einem Klick auf Speichern werden die Änderungen übernommen.

Kategorie löschen

Das Löschen einer Kategorie gestaltet sich sehr einfach. Wie auch für die anderen Kategorie-Aktionen müssen Sie ins Menu Kategorien verwalten wechseln.

Modul Blog Menu Kategorien.gif

Im angezeigten Fenster bleiben Sie im Register Kategorien verwalten. Sie sehen eine Übersicht aller momentan vorhandenen Kategorien.

Modul Blog Kategorien Edit.gif

Klicken Sie nun am Ende der Zeile auf das Löschen-Symbol (Verzeichnisicon4.jpg). Nach Bestätigung einer Kontrollfrage wird die Kategorie gelöscht.

Meldungen

Hier kommen wir zu dem Hauptelement des Moduls: Die Meldungen. Dabei handelt es sich um die Nachrichten, welche Sie in Ihrem Blog veröffentlichen.

Meldung verfassen

Im vorherigen Schritt wurde erklärt, wie Sie passende Kategorien erstellen können. Nun kommen wir dazu, eine Meldung zu erstellen und diese der Kategorie zuzuweisen. Dazu öffnen wir im Modul-Menu den Link Meldung verfassen.

Modul Blog Menu Verfassen.gif

Auf der neu geöffneten Seite können Sie nun alle für Ihre Nachricht relevanten Angaben machen.

Modul Blog Meldungen Add.gif

  • Sprachen: Wählen Sie die Sprachen aus, in welchem diese Meldung veröffentlich werden soll. Pro Sprache wird ein eigenes Register ("Deutsch", "English") angezeigt.
  • Titel: Der Titel Ihrer Meldung
  • Schlüsselwörter: Geben Sie einige Begriffe an, welche für diese Nachricht markant sind. Dies hilft Ihren Besuchern beim schnelleren Auffinden der gesuchten Themen. Ausserdem werden die Begriffe in der Tagcloud angezeigt. Mehrere Begriffe werden dabei durch Komma getrennt.
  • Nachrichten-Bild: Erlaubt die Kennzeichnung Ihrer Nachricht mit einem Bild.
  • Kategorien: Markieren Sie eine oder mehre Kategorien, welchen diese Meldung zugewiesen werden soll.

Wenn Sie mit Ihrer Meldung zufrieden sind klicken Sie anschliessend auf Speichern. Die Meldung wird im System erfasst und automatisch veröffentlicht.

Meldung bearbeiten

Sie wissen nun, wie Sie neuen Meldungen verfassen. Nun kann es natürlich vorkommen, dass Sie, aus welchen Gründen auch immer, eine bereits bestehenden Meldung anpassen wollen. Dazu wählen Sie den Menueintrag Meldungen verwalten aus.

Modul Blog Menu Verwalten.gif

Ihnen wird als Antwort eine Übersicht aller im System eingetragenen Meldungen mit verschiedenen nützlichen Statistiken präsentiert.

Modul Blog Meldungen Verwalten.gif

Zum Editieren einer Meldung klicken Sie auf den Titel der Nachricht oder das Editieren-Symbol (Verzeichnisicon1.jpg). Darauf hin bekommen Sie das von Meldung verfassen bekannte Eingabeformular präsentiert. Hier können Sie nun Ihre Änderungen vornehmen.

Meldung löschen

Falls Sie eine Meldung löschen wollen, so wählen Sie zuerst den Menueintrag Meldungen verwalten aus.

Modul Blog Menu Verwalten.gif

In der Meldungs-Übersicht müssen Sie nun das Löschen-Symbol (Verzeichnisicon4.jpg) anklicken. Nach der Bestätigung einer Kontrollfrage wird die Meldung gelöscht.

Kommentare editieren / löschen

Wie Sie sicherlich gelesen haben bietet das Modul Ihren Besuchern die Option zu Ihren Meldungen Kommentare zu verfassen. Natürlich haben Sie als Seitenverwalter auch die Möglichkeit, diese Kommentare nachträglich zu bearbeiten. Falls Sie also einen Kommentare verändern oder löschen wollen, so wählen Sie zuerst den Menueintrag Meldungen verwalten aus.

Modul Blog Menu Verwalten.gif

Anschliessend bekommen Sie die Übersicht der vorhandenen Meldungen präsentiert. Hier klicken Sie in der Spalte Kommentare auf den gewünschten Link.

Modul Blog Meldungen Verwalten Kommentare.gif

Nun bekommen Sie eine Auflistung aller Kommentare zu diesem Thema präsentiert. Wenn Sie nun einen Kommentar editieren möchten, so können Sie entweder auf den Titel oder das Editieren-Symbol (Verzeichnisicon1.jpg) klicken. Zum Löschen eines Kommentars genügt ein Klick auf das Löschen-Symbol (Verzeichnisicon4.jpg). Weiter können Sie über das Status-Icon (Verzeichnisicon6.jpg / Verzeichnisicon7.jpg) einen Kommentar vorübergehend de- / aktivieren.

Modul Blog Meldungen Kommentare.gif

Bewertungen anzeigen / löschen

Neben Kommentaren können Ihre Besucher Ihre Meinung zu Ihrem Beitrag auch über eine Bewertungsfunktion zum Ausdruck bringen. Als Administrator haben Sie jedoch auch über diesen Vorgang die volle Kontrolle. Um die Bewertungen eines Themas anzuzeigen wählen Sie zuerst den Menueintrag Meldungen verwalten aus.

Modul Blog Menu Verwalten.gif

Anschliessend bekommen Sie die Übersicht der vorhandenen Meldungen präsentiert. Hier klicken Sie in der Spalte Bewertung auf den gewünschten Link.

Modul Blog Meldungen Verwalten Bewertungen.gif

Jetzt bekommen Sie eine Auflistung aller vorhandenen Bewertungen zu diesem Thema angezeigt. Im ersten Register (Bewertung des Themas) wird Ihnen dabei eine statistische Übersicht präsentiert.

Modul Blog Meldungen Bewertungen 1.gif

Im zweiten Register (Bewertungen) sehen Sie eine Detailauflistung aller abgegebenen Bewertungen. Hier können Sie eine Bewertung mittels Klick auf das Löschen-Symbol (Verzeichnisicon4.jpg) auch entfernen.

Modul Blog Meldungen Bewertungen 2.gif

Bookmark-Netzwerke

Ein wichtiges Element zur Steigerung der Bekanntheit Ihres Blogs sind so genannte Bookmark Netzwerke. Über diese können Ihre Besucher einen Link zu einem bestimmten Thema für später Archivieren oder mit anderen Interessenten teilen. Um der ständig wachsenden Anzahl an Netzwerken Herr zu werden bietet das Contrexx Blog-Modul eine Verwaltungsmöglichkeit für diese.

Bookmark-Netzwerk hinzufügen

Wenn Sie ein neues Netzwerk hinzufügen möchten, so klicken Sie zuerst auf den Menueintrag Netzwerke verwalten

Modul Blog Menu Netzwerke.gif

In dem nun angezeigten Fenster wechseln Sie in das Register Netzwerk hinzufügen. Hier können Sie nun die Werte für das neue Netzwerk definieren:

Modul Blog Netzwerke Add.gif

  • Name des Anbieters: Geben Sie dem Anbieter des Bookmark-Netzwerks einen Namen
  • URL des Anbieters: Die Webadresse des Anbieters.
  • URL für Eintragungen: Um Ihre Seite im Linkverzeichnis des Anbieters zu erfassen wird üblicherweise eine "Registrations"-URL verwendet. In dieser müssen Sie für gewöhnlich als Parameter die zu verlinkende URL ([URL]) als auch den Namen der Seite ([SUBJECT]) übergeben. Der Link ändert von Anbieter zu Anbieter.
  • Icon des Anbieters: Dieses Bild wird für den neuen Anbieter in der Übersicht angezeigt. Üblichweise bieten die Netzwerk-Anbieter selbständig eine Reihe von Icons an.
  • Sprachen: In welchen Sprachen soll das Netzwerk angezeigt werden?

Nachdem Sie alle Felder mit Werten gefüllt haben müssen Sie zum Abschluss noch auf Speichern klicken, um das Netzwerk zur Datenbank hinzuzufügen.

Bookmark-Netzwerk bearbeiten

Um ein bestehendes Netzwerk anzupassen klicken Sie zuerst auf den Menueintrag Netzwerke verwalten

Modul Blog Menu Netzwerke.gif

Im Register Netzwerke verwalten sehen Sie nun eine Liste aller momentan verfügbaren Netzwerke. Standardmässig werden etwa knapp 30 Netzwerke bereits mitgeliefert.

Modul Blog Netzwerke.gif

Zum Ändern eines Netzwerkes genügt ein Klick auf den Namen des Anbieters oder das Edit-Icon (Verzeichnisicon1.jpg). Sie bekommen darauf hin das Formular angezeigt, welches Sie bereits von Netzwerk hinzufügen kennen.

Bookmark-Netzwerk löschen

Um ein bestehendes Netzwerk zu löschen klicken Sie zuerst auf den Menueintrag Netzwerke verwalten

Modul Blog Menu Netzwerke.gif

Im Register Netzwerke verwalten sehen Sie nun eine Liste aller momentan verfügbaren Netzwerke. Standardmässig werden etwa knapp 30 Netzwerke bereits mitgeliefert.

Modul Blog Netzwerke.gif

Zum Löschen eines Netzwerkes genügt ein Klick das Löschen-Icon (File:Verzeichnisicon4jpg). Nach Bestätigung einer Sicherheitsfrage wird das Netzwerk gelöscht.

Dateien

  • Alle Dateien des Umfragesystem Moduls liegen im Verzeichnis modules/blog/*

Platzhalter

Unter dem Menüpunkt Platzhalter finden Sie eine Übersicht aller verfügbaren Platzhalter. Diese können, falls nicht anders vermerkt, innerhalb der Datei blog.html (Administration > Layout & Design) eingesetzt werden.

Modul Blog Menu Platzhalter.gif

Allgemein

Anders als die normalen Platzhalter können alle unter Allgemein gelisten Platzhalter auch in anderen Dateien (Administration > Layout & Design) eingesetzt werden. Im Detail sind dies:

  • index.html
  • home.html
  • content.html
  • sidebar.html
  • blog.html

Es sind folgende Platzhalter verfügbar:

  • [[BLOG_CALENDAR]]: Ein Kalender des aktuellen Monats. Tage mit Meldungen werden hervorgehoben.
  • [[BLOG_CATEGORIES_SELECT]]: Ein Dropdown-Menu, welches alle bestehenden Kategorien enthält. Erlaubt die Filterung von Nachrichten auf eine Kategorie.
  • [[BLOG_CATEGORIES_LIST]]: Eine Liste mit allen bestehenden Kategorien. Erlaubt die Filterung von Nachrichten auf eine Kategorie.
  • [[BLOG_TAG_CLOUD]]: Gibt eine komplette Tag-Cloud aller Schlüsselwörter aus.
  • [[BLOG_TAG_HITLIST]]: Gibt eine Rangliste der beliebtesten Schlüsselwörter aus.

Meldungen

Diese Platzhalter müssen innerhalb der Datei blog.html und im Block blogBlockEntries stehen. Der Block wird anschliessend für jede anzuzeigende Meldung verwendet. Hier die verfügbaren Text-Platzhalter:

  • [[TXT_BLOG_ENTRY_CATEGORIES]]: Kategorien (Nur Textausgabe)
  • [[TXT_BLOG_ENTRY_TAGS]]: Schlüsselwörter (Nur Textausgabe)
  • [[TXT_BLOG_ENTRY_VOTING]]: Bewertung (Nur Textausgabe)
  • [[TXT_BLOG_ENTRY_COMMENTS]]: Kommentare (Nur Textausgabe)
  • [[TXT_BLOG_ENTRY_LINK]]: Link (Nur Textausgabe)

Nun folgend die Inhalt-Platzhalter. Anders als die Text-Platzhalter geben diese keinen Text aus, sondern wirklich Inhalt.

  • [[BLOG_ENTRY_ROWCLASS]]: CSS-Klasse für die Tabellen-Zeile
  • [[BLOG_ENTRY_ID]]: Eindeutige ID der Kategorie
  • [[BLOG_ENTRY_SUBJECT]]: Titel der Meldung
  • [[BLOG_ENTRY_LINK]]: Link zur Detailseite
  • [[BLOG_ENTRY_DATE]]: Datum der Meldung
  • [[BLOG_ENTRY_POSTED_BY]]: Text welcher das Datum und den Benutzer enthält
  • [[BLOG_ENTRY_INTRODUCTION]]: Kurzer Einleitungstext der Meldung
  • [[BLOG_ENTRY_CONTENT]]: Vollständiger Text der Meldung
  • [[BLOG_ENTRY_AUTHOR_ID]]: Eindeutige ID des Verfassers
  • [[BLOG_ENTRY_AUTHOR_NAME]]: Name des Verfassers
  • [[BLOG_ENTRY_CATEGORIES]]: Kategorien der Meldung
  • [[BLOG_ENTRY_TAGS]]: Schlüsselwörter der Meldung
  • [[BLOG_ENTRY_VOTING]]: Durchschnittliche Bewertung der Meldung
  • [[BLOG_ENTRY_VOTING_STARS]]: Bewertung der Meldung in Sternen
  • [[BLOG_ENTRY_COMMENTS]]: Anzahl der Kommentare der Meldung
  • [[BLOG_ENTRY_IMAGE]]: Zugewiesenes Bild

Nachfolgend ein Beispiel-Code zur Verwendung innerhalb von blog.html:

<!-- BEGIN blogBlockEntries -->
<h2 class="blogTitle"><a href="index.php?section=blog&cmd=details&id=[[BLOG_ENTRY_ID]]" title="[[BLOG_ENTRY_SUBJECT]]">[[BLOG_ENTRY_SUBJECT]]</a></h2>
<h4 class="blogPostedBy">[[BLOG_ENTRY_POSTED_BY]]</h4>
<br />
<div align="justify"><em>[[BLOG_ENTRY_INTRODUCTION]]</em></div><br />
 <strong>[[TXT_BLOG_ENTRY_CATEGORIES]]:</strong>  [[BLOG_ENTRY_CATEGORIES]]<br />
 <strong>[[TXT_BLOG_ENTRY_TAGS]]:</strong>  [[BLOG_ENTRY_TAGS]]<br />
 <strong>[[TXT_BLOG_ENTRY_VOTING]]:</strong>  [[BLOG_ENTRY_VOTING_STARS]] (<a href="index.php?section=blog&cmd=details&id=[[BLOG_ENTRY_ID]]#voting" title="[[TXT_BLOG_ENTRY_VOTING]]">[[BLOG_ENTRY_VOTING]]</a>)<br />
 <strong>[[TXT_BLOG_ENTRY_COMMENTS]]:</strong>  <a href="index.php?section=blog&cmd=details&id=[[BLOG_ENTRY_ID]]#comments" title="[[TXT_BLOG_ENTRY_COMMENTS]]">[[BLOG_ENTRY_COMMENTS]]</a><br />
 <strong>[[TXT_BLOG_ENTRY_LINK]]:</strong>  [[BLOG_ENTRY_LINK]]<br /><br />
<!-- END blogBlockEntries -->

Kategorien

Diese Platzhalter müssen innerhalb der Datei blog.html und im Block blogBlockCategories stehen. Der Block wird anschliessend für jede anzuzeigende Kategorie verwendet. Hier die verfügbaren Platzhalter:

  • [[BLOG_CATEGORY_ID]]: Eindeutige ID der Kategorie
  • [[BLOG_CATEGORY_NAME]]: Name der Kategorie
  • [[BLOG_CATEGORY_COUNT]]: Anzahl Meldungen in dieser Kategorie

Auch hier ein Beispiel-Code zur Verwendung innerhalb von blog.html:

<!-- BEGIN blogBlockCategories -->
<a href="index.php?section=blog&cmd=search&category=[[BLOG_CATEGORY_ID]]">[[BLOG_CATEGORY_NAME]] ([[BLOG_CATEGORY_COUNT]])</a><br />
<!-- END blogBlockCategories -->	

Einstellungen

Über die Einstellungen können Sie das Blog-Modul nach Ihren Wünschen konfigurieren.

Allgemein

  • Anzahl Zeichen in Einleitungstext: Dieser Wert legt die Anzahl der Zeichen im Einleitungstext fest. Wenn Sie immer den kompletten Text anzeigen lassen wollen, so setzen Sie hier die Zahl 0 ein.

Kommentare

  • Kommentare erlauben: Wenn Sie Ihren Besuchern die Möglichkeit geben wollen, zu Ihren Beiträgen Kommentare zu schreiben, so müssen Sie diese Option aktivieren.
  • Anonyme Kommentare erlauben: Wenn es auch unregistrierten Besuchern erlaubt sein soll Kommentare zu verfassen, so aktivieren Sie diese Option.
  • Neue Kommentare automatisch aktivieren: Durch setzen dieses Schalters werden neue Beiträge automatisch aktiviert. Andernfalls müssen alle Kommentare von Ihnen freigeschaltet werden.
  • Benachrichtung bei neuen Kommentaren: Ist diese Einstellung aktiviert, so erhalten Sie bei neuen Kommentaren eine E-Mail zugestellt.
  • Wartezeit zwischen Kommentaren: Dieser Wert beschreibt, wie viele Sekunden zwischen zwei Kommentaren eines Benutzers liegen müssen. Dadurch wird übermässiges Verwenden der Kommentarfunktion verhindert. Empfohlener Wert sind 30 Sekunden.
  • Editor: Legen Sie fest, welchen Editor Sie Ihren Besuchern zum Verfassen von Kommentaren zur Verfügung stellen wollen.

Bewertungen

  • Bewertungen erlauben: Wenn Sie Ihren Besuchern die Möglichkeit geben wollen, Ihre Beiträge zu bewerten, so müssen Sie diese Option aktivieren.

Schlüsselwörter

  • Schlüsselwörter in Hitliste: Legen Sie hier die Zahl der angezeigten Schlüsselwörter in der Hitliste fest.

RSS

  • RSS-Feeds aktivieren: Wenn Sie von Ihrem Blog einen RSS-Feed erstellen lassen möchten, so müssen Sie diese Option aktivieren. Dadurch werden im Ordner feed/ Dateien vom Schema
    blog_messages_XX.xml | blog_comments_XX.xml | blog_category_ID_XX.xml
    erstellt, wobei XX für die jeweilige Systemsprachen-Kurzform und ID für die ID der Kategorie steht.
  • Anzahl Nachrichten: Anzahl der Nachrichten, welche in der XML-Datei enthalten sind. Es handelt sich dabei immer um die aktuellsten Nachrichten.
  • Anzahl Kommentare: Anzahl der Kommentare, welche in der XML-Datei enthalten sind. Es handelt sich dabei immer um die aktuellsten Kommentare.

Block Vorlage

  • Block-Funktion aktivieren: Durch Aktivieren dieser Funktion können Sie an verschiedenen Orten im System den Platzhalter {BLOG_FILE} durch die Datei blog.html ersetzen lassen. Dazu können Sie untenstehende Platzhalter einsetzen.
  • Anzahl Nachrichten: Anzahl der Nachrichten, welche angezeigt werden sollen. Es werden dabei immer die neusten Nachrichten angezeigt.

FAQ