mod_rd_section_blog_reloaded

Stark erweiterte Version von Robert Deutz' "RD Section Blog" zur Anzeige von Blog Sections und/oder Categories in einem Modul in Joomla! 1.0.x

© Gero Zahn, gero-at-gerozahn.de


German versionEnglish versionEinleitung

Robert Deutz' Mambo/Joomla! Modul "RD Section Blog" V4.5.1 ist ein sehr nützliches Werkzeug, um Meldungs-Sections zusammen mit ihren Categories als Modul einzubinden - quasi als Ersatz für die normale Blog-Komponente, wodurch der Blog-Inhalt weitaus flexibler auf anderen Seiten platziert werden kann, statt selbst eine ansonsten kaum konfigurierbare Seite zu sein.
Weist man dieses neue Modul einer bislang unbenutzten Modulposition wie "user3" zu, kann man ein derartiges News-Modul mit {mosloadposition user3} an beliebiger Stelle eines statischen (oder auch dynamischen) Inhalts platzieren. Auf diese Weise lässt sich eine wirklich individuelle News-Einleitung erstellen und der eigentliche News-Blog einfach darunter einbinden.is a very useful tool to embed message sections together with their categories as a module - quasi as a substitute to the normal blog component, so the blog content can be placed in a far more flexible way on other pages instead of being an otherwise hardly configurable page itself.
Lesen Sie Robert' Original-Dokumentation, um mehr über das Original-rd_section_blog herauszufinden.

Nichtsdestotrotz war das Original-rd_section_blog recht eingeschränkt, und so habe ich selbst die Initiative ergriffen und die fehlenden Funktionen nachgerüstet (und gleichzeitig hier und da einen kleineren Bug bereinigt). Das resultierende rd_section_blog_reloaded sollte das bestehende Original-rd_section_blog ersetzen können und dabei keine oder nur vernachlässigbare Seiteneffekte hervorrufen, dabei aber viele neue Funktionen beisteuern.

Die Verbesserungen von rd_section_blog_reloaded an rd_section_blog in kurz:

Allgemein gesagt stellt rd_section_blog_reloaded einen engen Abkömmling der regulären Blog-Komponente dar, teilweise fehlen Funktionen (z.B. gibt es noch keine mehrspaltige Darstellung und kein Editieren der Beiträge nach Frontend-Login mit entsprechenden Rechten), aber manchmal geht es sogar darüber hinaus (z.B. Multi-Section-, Multi-Category-Darstellung).

Um noch jemandem die angemessene Ehre zu erweisen: Der Mambot-Expansions-Code wurde nahezu wörtlich aus mod_d4j_content_listing von DesignForJoomla.com (ebenfalls unter der GNU-GPL-Lizenz) übernommen. Somit kombiniert rd_section_blog_reloaded gewissermaßen das Beste aus beiden Welten rd_section_blog und mod_d4j_content_listing - und fügt sogar noch einiges mehr hinzu.

Roberts Original-rd_section_blog trug die Versionsnummer 4.5.1 und sollte sowohl unter Mambo als auch unter Joomla! laufen (ungetestet). Mein rd_section_blog_reloaded wurde unter Joomla! 1.0.10 stable entwickelt. Ich habe nicht geprüft, ob es auch unter Mambo läuft - aber ich habe begründete Zweifel daran.

Ich habe dieses Release von rd_section_blog_reloaded mit der Versionsnummer 1.0.4.5.1 betitelt, weil es einerseits in weiten Teilen eine Menge neuen Code enthält und es für Joomla! 1.0.x geeignet ist - und weil es andererseits auf Roberts Original-Version 4.5.1 von rd_section_blog basiert.


Parameter-Bildschirm von mod_rd_section_blog_reloadedDie Parameter

Schauen Sie sich bitte rechts den umfangreichen Parameter-Satz von rd_section_blog_reloaded an. Einige davon sind identisch mit denen in Robert's Original-rd_section_blog, andere sind brandneu.

Die neuen verwenden Default-Einstellungen, die den unveränderlichen Einstellungen in rd_section_blog entsprechen. Daher sollte der Austausch von rd_section_blog durch rd_section_blog_reloaded das CMS relativ unverändert lassen. - Es gibt jedoch zwei kleine Ausnahmen, die ich weiter unten genauer beschreibe.

Frontpage Items - entscheiden Sie, ob Meldungen, die für die Frontpage-Komponente konfiguriert worden sind, hier nochmals erscheinen sollen oder nicht.

Enable Cache - die übliche Einstellung von Joomla!s Cache-Mechanismus.

Header Level - im Gegensatz zur normalen News-Komponente verwendet rd_section_blog ein <h?>...</h?>-Tag, um Überschriften zu erzeugen. Wählen Sie den Level für die Section- bzw. Category-Titel - für Inhalts-Titel wird ein Titel eine Stufe niedriger verwendet.

Header Class - eine CSS-Klasse, die für die Titel verwendet wird. Falls Sie h3 als Header Class ausgewählt haben und Sie z.B. "news" als Header Class eingeben, sollten Sie in Ihrer CSS-Datei h3.news und h4.news konfigurieren.

Section Title / Category Title - entscheiden Sie, ob die Section- bzw. Category-Titel angezeigt werden sollen oder nicht. Zur Erinnerung: Dies ist endlich Joom!Fish-konform ... !

Section Name of Title / Category Name or Title - entscheiden Sie, ob Sie lieber die kurzen "Title"-Einträge oder die langen "Name"-Einträge Ihrer Sections bzw. Categories sehen möchten.

Section / Category Separator - rd_section_blog verwendete als Default-Einstellung "::". Wenn Sie definieren, dass sowohl Section- als auch Category-Titel angezeigt werden sollen, würde "Section-Titel :: Category-Titel" angezeigt.

Count - wählen Sie, wie viele Meldungen angezeigt werden sollen. Geben Sie "0" für "alle" ein.

Leading Count - wählen Sie, wie viele Meldungen "Lead Stories" sein sollen: Lead Stories werden zusammen mit ihrem Einleitungs-Text darggestellt, alle weiteren werden nur durch ihre Überschriften repräsentiert.
Geben Sie "0" für "keine" ein (alle Meldungen werden nur durch ihre Überschrift dargestellt) oder "-1" für "alle" (alle Meldungen werden mit ihrem Intro-Texten dargestellt).

Category ID - geben Sie die Category-ID ein, die hier dargestellt werden soll. Wenn Sie Beiträge aus mehreren Categories dargestellt haben wollen, geben Sie alle Category-IDs durch Kommata getrennt an.
Sie können dieses Feld auch leer lassen, wenn Sie alle Meldungen aller Categories einer gesamten Section oder sogar mehrere Sections darstellen wollen.

Section ID - geben Sie die Section-ID ein, die hier dargestellt werden soll. Sie dürfen dieses Feld nicht leer lassen, aber Sie können die Ausgabe mit Hilfe des Category ID-Feldes begrenzen. Wenn Sie sich dazu entscheiden, mehrere Category-IDs anzugeben, stellen Sie sicher, dass diese zu der Section (bzw. zu den Section) gehören, die Sie hier angegeben. Wenn Sie Beiträge aus mehreren Sections dargestellt haben wollen, geben Sie alle Section-IDs durch Kommata getrennt an.

Show Create date - definieren Sie, ob das Erstellungsdatum einer Meldung dargestellt werden soll oder nicht. Sie haben die Wahl zwischen show (anzeigen), hide (nicht anzeigen) und use global (Globalvorlage verwenden).

Show Modified date - definieren Sie, ob das Datum der letzten Änderung einer Meldung dargestellt werden soll oder nicht. Sie haben die Wahl zwischen show (anzeigen), hide (nicht anzeigen) und use global (Globalvorlage verwenden).

Show Author name - definieren Sie, ob der Name des Autors einer Meldung dargestellt werden soll oder nicht. Sie haben die Wahl zwischen show (anzeigen), hide (nicht anzeigen) und use global (Globalvorlage verwenden).

Load Bots - definieren Sie, ob Mambot Pseudo-Tags wie {mosimage} in den Einleitungs-Texten der Meldungen durch ihren eigentlichen Inhalt ersetzt werden sollen oder nicht. Wenn Sie no wählen, werden alle Mambot-Tags entfernt, so dass Sie keine {...}-Tags jedweder Art in Ihren Einleitungs-Texten ihrer Lead-Stories sehen werden.


Installation

Wenn Sie rd_section_blog noch nie zuvor verwendet haben, installieren Sie rd_section_blog_reloaded wie gewohnt mit Hilfe von Joomla!s Modul-Manager im Back-End - viel Spaß damit!

Wenn Sie planen, von rd_section_blog auf rd_section_blog_reloaded upzugraden, beachten Sie bitte folgendes:

Kompatiblität von rd_section_blog_reloaded mit rd_section_blog

Da rd_section_blog_reloaded alle neuen Parameter mit den Default-Werten der unveränderlichen Einstellungen von rd_section_blog füllt, sollte es keine schwerwiegenden Inkompatiblitäten geben, wenn Sie auf rd_section_blog_reloaded upgraden. - Dennoch empfehle ich einen Testlauf auf einen Nicht-Produktiv-Duplikat Ihres CMS, um sicherzugehen.

Allerdings hatte Robert zwei recht merkwürdige Formatierungen für die Textausgabe fest einprogrammiert:

  1. <ul class="articel">...</ul> für die Nicht-Lead-Strory-Meldungen (ja, "articel" in dieser Schreibweise).
  2. <div class="float">...</div> für die Textrümpfe der Meldungen.

Ich habe diese beiden undokumentierten, unveränderlichen Classes wiederum durch die Header Class ersetzt. Wenn Sie gar keine Header Class definieren, wird daraus also lediglich <ul>...</ul> und <div>...</div>, bzw. andererseits <ul class="???">...</ul> und <div class="???">...</div>, wobei "???" für den Namen steht, den Sie als Header Class eingegeben haben.

Falls Sie z.B. "news" als Header Class eingeben, sollten Sie in Ihrer CSS-Datei ul.news und div.news konfigurieren. Sollten Sie zuvor schon ul.articel und div.float konfiguriert haben, müssen Sie Ihre CSS-Datei anpassen.


Download

 

 


Disclaimer: Alle genannten Produkt- oder Firmennamen sind oder könnten ggf. eingetragene Handelsmarken der entsprechenden Firmen sein. Diese Namen werden hir lediglich zu Dokumentations-Zwecken verwendet.
Alle auf dieser Seite enthaltenen Informationen erscheinen hier "so wie sie sind". Obgleich Gero Zahn gero-at-gerozahn.de der alleinige Urheber und Rechteinhaber an diesem Dokument ist, schließt der Autor jedgliche Verantwortung für die beschriebenen Funktionen oder Seiteneffekte durch die Verwendung seiner Software in unveränderter oder veränderter Form aus.