Kurz-Dokumentation Plugin "RealBlog"

Version RealBlog 4.3 - 2022-03

Eine Dokumentation in deutscher Sprache finden Sie unter ge-webdesign.de/cmsimplerealblog/

Das Plugin "RealBlog" ist eine Weiterentwicklung des Plugins AdvancedNews von Jan Kanters. Vielen Dank an dieser Stelle noch einmal an Jan für die Erlaubnis, den Code seines Plugins AdvancedNews als Basis für die Entwicklung des Plugins "RealBlog" zu verwenden.

 

1. Funktionen:

 

2. Systemvoraussetzungen

Voraussetzung ist eine funktionierende Installation von CMSimple 4.2 oder höher.

Für Kommentare muss das Plugin "Comments" installiert sein.

 

3. Installation

  1. zip-Datei herunterladen und mit einem geeigneten Programm entpacken
  2. Laden Sie alle Ordner und Dateien des Verzeichnisses CMSimpleRoot in das Verzeichnis, in dem sich Ihre CMSimple-Installation befindet. Das kann in einem Zug passieren, indem Sie den Inhalt des Verzeichnisses "CMSimpleRoot" in das Root-Verzeichnis Ihrer CMSimple-Installation hochladen, es werden keine vorhandenen Dateien überschrieben.
  3. Vergeben mit Ihrem ftp-Programm die erforderlichen Lese- und Schreibrechte.

 

4. Datei- und Ordnerrechte

Damit das Programm funktioniert und arbeiten kann, müssen auf älteren Servern evtl. für bestimmte Dateien und Ordner bestimmte Schreib- und Leserechte vergeben werden.

Folgende Ordner und Dateien müssen beschreibbar sein:

Ordner / Verzeichnisse: chmod 777

Dateien: chmod 666

 

5. Funktionsaufrufe

Auf den Seiten, auf denen Ihr WebLog oder Ihr Archiv laufen sollen, oder auf der Sie einen RSS-feed (veraltet - keine weitere Entwicklung) anbieten wollen, müssen Sie den entsprechenden Funktionsaufruf auf der Seite einfügen, am besten direkt unter der Hauptüberschrift:

 

5.1 Weblog:

{{{PLUGIN:showrealblog();}}}

oder mit aktivierter Suchfunktion:

{{{PLUGIN:showrealblog('showsearch=true');}}}

Auf dieser Seite werden dann die Artikel aller Kategorien ausgegeben.

 

5.2 Kategorien:

Die Artikel können nach Kategorien gefiltert ausgegeben werden. Dazu muss auf den entsprechenden CMSimple Seiten im Plugin Aufruf ein 2. Parameter angegeben werden.

Ohne Suchfunktion:

{{{PLUGIN:showrealblog('','Die_Kategorie');}}}

Mit Suchfunktion:

{{{PLUGIN:showrealblog('showsearch=true','Die_Kategorie');}}}

Auf dieser Seite werden dann nur die Artikel der entsprechenden Kategorie ausgegeben.

Kategorien für Artikel definieren:

Die Kategorie, in der ein Artikel veröffentlicht werden soll, wird im Teaser oder im Artikel per Funktionsaufruf definiert:

{{{PLUGIN:rbCat('|Kategorie_1|');}}}

Ein Artikel kann in mehreren Kategorien veröffentlicht werden:

{{{PLUGIN:rbCat('|Kategorie_1|Kategorie_2|');}}}

Vor, hinter und zwischen den Kategorien muss ein senkrechter Strich ("|") notiert werden.

 

5.3 Überschriften:

Die Überschriften im Teaser und im Artikel sind traditionell als h4 ausgezeichnet, wenn h1only_pagesplitting aktiv ist als h2. SEO-Spezialisten können das jetzt mit einem 3. Parameter im Plugin Aufruf ändern, Beispiel:

{{{PLUGIN:showrealblog('showsearch=true','all','h1');}}}

Mit diesem Plugin Aufruf ist die Suchfunktion aktiv, es werden alle Kategorien angezeigt und die Überschriften der Teaser und der Artikel als h1 ausgezeichnet.

 

5.4 Sortierung:

Die Sortierung der Artikel in der Artikelübersicht kann mit einem 4. Parameter unabhängig von der Plugin Konfiguration definiert werden, Beispiel:

{{{PLUGIN:showrealblog('showsearch=true','all','h2','desc');}}}

Mit diesem Plugin Aufruf ist die Suchfunktion aktiv, es werden alle Kategorien angezeigt, die Überschriften der Teaser und der Artikel als h2 ausgezeichnet und die neuesten Artikel erscheinen oben.

Der 4. Parameter kann folgende Werte haben:

 

5.5 Archiv:

{{{PLUGIN:showrealblogarchive();}}}

 

5.6 RealblogLink:

Diese Funktion wird im Template verwendet (meist in einer Sidebar) und zeigt Links zu den letzten Blogartikeln an. Wie viele angezeigt werden, können Sie in der Plugin Konfiguratiopn festlegen.

<?php echo realbloglink('realblogpage=Die_Blog_Seite');?>

 

5.7 RSS-feed:

Die RSS Funktion hat den Status "veraltet (deprecated)", es ist keine weitere Entwicklung oder Anpassung an irgendwelche Entwicklungen geplant.

{{{PLUGIN:realblog_rss_adv('replace=true');}}}

Der RSS Feed wird immer von allen Beiträgen erstellt. RSS Feeds für einzelne Kategorien sind zur Zeit nicht möglich.

Deshalb sollte auf der Website eine Seite sein, auf der alle Kategorien angezeigt werden. Diese Seite sollte in der Sprachdatei als rss_page: angegeben werden.

 

5.8 Kommentarfunktion nur für Mitglieder

Wenn die Plugins MembersArea und Comments 3.3 oder höher installiert sind, kann das Kommentarformular für nicht eingeloggte Besucher und Mitglieder der Gruppe für neu registrierte Mitglieder ausgeblendet werden. Die Kommentare bleiben für alle sichtbar.

Das kann global für alle Beiträge in der Konfiguration festgelegt werden, oder für jeden Beitrag einzeln per Funktionsaufruf im Artikel (nicht im Teaser!):

{{{PLUGIN:CommentsMembersOnly();}}}

Wird dieser Funktionsaufruf auf der CMSimple Seite (VOR dem Plugin Aufruf) gesetzt, ist er für alle Artikel dieser Seite (Blog oder Kategorie) wirksam.

Hinweis: fügen Sie diesen Code in der Quelltext-Ansicht ein. Prüfen Sie, ob Formatierungen im Code enthalten sind und entfernen Sie diese ggf.

 

6. Konfiguration

Wenn Sie in CMSimple eingeloggt sind, finden Sie oben im Admin Menü den Punkt "Plugins". Wählen Sie hier "Realblog".

Jetzt öffnet sich das Plugin-Menü, wählen Sie hier "RealBlog Konfiguration".

Bei den verschiedenen Einstellungs-Möglichkeiten finden Sie jeweils ein kleines blaues Fragezeichen-Symbol. Gehen Sie mit der Maus auf das entsprechende Fragezeichen-Symbol, und Sie erhalten Informationen über die entsprechende Konfigurationsmöglichkeit.

RSS Feed

Die RSS Funktion hat den Status "veraltet (deprecated)", es ist keine weitere Entwicklung oder Anpassung an irgendwelche Entwicklungen geplant.

Die meisten Einstellungen zum RSS Feed finden Sie in der Sprachdatei. Die Sprachdatei können Sie bearbeiten, wenn Sie im Plugin Menü auf "RealBlog Sprache" klicken.

 

7. Mehrere Blogs in Zweitsprachen und Subsites

Ab der Version 2.0 können auch Blogs in Zweitsprachen und Subsites betrieben werden.

7.1 Die RealBlog Daten

Die Daten werden im content-Verzeichnis der jeweiligen Zweitsprachen oder Subsites abgelegt. Sie müssen also das Verzeichnis "content" aus dem RealBlog Download in das Verzeichnis der Zweitsprache oder Subsite hochladen und die Schreibrechte vergeben, so wie im content Verzeichnis der Hauptinstallation.

7.2 Die RSS Feed Datei

Die RSS Funktion hat den Status "veraltet (deprecated)", es ist keine weitere Entwicklung oder Anpassung an irgendwelche Entwicklungen geplant.

Die RSS Feed Datei "realblog_rss_feed.xml" liegt im CMSimpleRoot bzw. im Root Verzeichnis der Subsites und Zweitsprachen.

./realblog_rss_feed.xml

./fr/realblog_rss_feed.xml

./subsite/realblog_rss_feed.xml

usw.

Alle newsfeed Dateien müssen beschreibbar sein (chmod 666).

Als Vorlage können Sie die Datei

./plugins/realblog/rss/realblog_rss_feed_template.xml

benutzen.

 

8. Stapelsicherung

Ab der Version 4.0 wird bei jedem Speichervorgang ein Backup der Datendatei realblog.txt angelegt. Die maximale Anzahl der Backups ist konfigurierbar. Ist die maximale Anzahl der Backups erreicht, wird das älteste Backup gelöscht.

Die Backups werden im folgenden Verzeichnis abgelegt:

ab RealBlog 4.0: ./content/realblog/backups/

ab RealBlog 4.3: ./backups/realblog/