CP::Weblog
CP::Weblog ist ein kostenpflichtiges Zusatzmodul für Contentpapst. Diese Informationen benötigen Sie daher nur, wenn Sie den CP::Weblog lizensiert haben und auf Ihrer Webseite einsetzen wollen. Weitere Informationen zu CP::Weblog erhalten Sie unter http://www.sandoba.de/produkte/blog-cpweblog/.
Weitere Seiten:
CP::Weblog wird zusätzlich zu einer bestehenden Contentpapst-Installation als CP::Forms-Modul installiert. Das gelieferte ZIP-Archiv wird dafür zuerst extrahiert (inkl. der dort enthaltenen Ordner). Anschließend wird folgendermaßen vorgegangen:
- Das Script "weblog_install.php" in das Hauptverzeichnis von Contentpapst kopieren.
- Dieses Script über den Browser ausführen. CP::Weblog wird dabei im Hintergrund angelegt.
- Nachdem das Script beendet ist, dieses vom Server löschen.
- Anschließend die Ordner aus dem Archiv in den Ordner "modules" hochladen.
- Innerhalb dieser hochgeladenen Ordner gibt es jeweils die Unterordner "files" und "templates". Für diese Ordner muss per FTP noch der CHMOD auf 775 oder 777 gesetzt werden, damit z.B. Bilder zu einer Blog-Eintrag hochgeladen werden können.
Nun kann das neue Modul über den Administrationsbereich unter "Module > CP::Forms" aufgerufen werden. Weblog-Einträge lassen sich nun bereits verfassen. Zuerst sollten Sie jedoch noch Kategorien anlegen und die Einstellungen von CP::Weblog an Ihre Bedürfnisse anpassen (u.a. ist hier die ID des Artikels einzutragen, in welchem der Weblog angezeigt wird).
Da es bei CP::Weblog um ein CP::Forms-Modul handelt, gibt es im Administrationsbereich auch für dieses Modul den bekannten Komfort bei der Erstellung / Bearbeitung von Einträgen usw. D.h. Standardfunktionen für die Anpassung der Module, Im- und Export usw. stehen auch hier zur Verfügung (weitere Informationen sind dazu daher im Abschnitt "CP::Forms" zu finden).
Insgesamt besteht das Weblog aus den 5 Teilmodulen "Einträge", "BlogRoll", "Einstellungen", "Kategorien" und "Kommentare". Zur besseren Übersicht sind diese Teilmodule in der Collection "Weblog" zusammengefasst.
Über "CP::Forms > Weblog" können die Teilmodule aufgerufen werden. Für jedes Modul gibt es dort eigene Eingabemasken, über die sich z.B. die Einträge verfassen lassen. Generell gilt dabei, dass nur freigeschaltete Einträge / Kategorien usw. auch innerhalb des Weblogs erscheinen. Es können also Einträge auch schrittweise vorbereitet werden, bevor diese in der finalen Fassung freigeschalten werden.
Grundlegende Einstellungen des Weblogs lassen sich im Modul "Einstellungen" treffen. Dazu gehören u.a. die max. Anzahl der anzuzeigenden Einträge in den einzelnen Feeds oder auch die automatische Aktualisierung der BlogRoll. Weitere Detaileinstellungen können dann direkt durch die einzelnen Parameter der Container festgelegt werden (u.a. die max. Cache-Zeit).
 |
Für fortgeschrittene Anwender gibt es die Möglichkeit, über "Modul bearbeiten" auch die einzelnen Module weiter den eigenen Wünschen anzupassen, indem diese um neue Felder erweitert werden. Hier ist allerdings stets darauf zu achten, dass die allgemeinen Angaben eines Modules, sowie die bisherigen Felder nicht verändert werden, da es sonst u.U. zu Problemen kommen kann.
|
Alle Inhalte des Weblogs, die über den Administrationsbereich eingegeben werden - also z.B. die Einträge des Weblogs, Kategorien und BlogRoll-Einträge - werden über verschiedene Container auf der Webseite ausgegeben. Jeder dieser Container ist im folgenden genauer erklärt.
Um nun jedoch aus diesen Containern ein komplettes Weblog zusammenzustellen, müssen diese sinnvoll miteinander kombiniert werden. Dazu zuerst ein komplettes Beispiel der Einbindung des Weblogs samt Einträgen, Kommentaren, Kategorien und BlogRoll sowie der Anzeige von Listen- und Detailansichten:
<table cellspacing="2" cellpadding="2" width="100%" border="0">
<tr>
<td valign="top" width="170">
<div class="weblog_home"><a title="Startseite" href="/{cp:configuration:main:directory}index.php?id={cp:variable:id}">Startseite</a></div>
{cp:container module="weblog_sections" type="list" order="title" cache="3600"}
<div class="weblog_line"></div>
<p><strong>Letzte Einträge:</strong></p>
<p>{cp:container module="weblog" type="list" show_date="0" template="modules/weblog/templates/list_short.html" section="no" cache="3600"} </p>
<div class="weblog_line"></div>
<p><strong>Letzte Kommentare:</strong></p>
<p>{cp:container module="weblog_comments" type="list" template="modules/weblog_comments/templates/list_short.html" alttext="Noch keine Kommentare vorhanden." cache="3600"} </p>
<div class="weblog_line"></div>
<p><strong>BlogRoll:</strong></p>
<p>{cp:container module="weblog_blogroll" type="list" cache="3600"}</p>
<div class="weblog_line"></div><br />
<div style="padding-bottom: 6px"><a href="/{cp:configuration:main:directory}webservices.php?file=weblog&type=rss"><img alt="" src="/{cp:configuration:main:directory}modules/weblog/files/icon.rss.gif" border="0" /></a> <a href="/{cp:configuration:main:directory}webservices.php?file=weblog&type=atom"><img alt="" src="/modules/weblog/files/icon.atom.gif" border="0" /></a></div>
<div><a href="/{cp:configuration:main:directory}webservices.php?file=weblog&type=rdf"><img alt="" src="/{cp:configuration:main:directory}modules/weblog/files/icon.rdf.gif" border="0" /></a></div>
</td>
<td valign="top">
{cp:ifnot:oid}
{cp:container module="weblog" type="list" alttext="Es sind bislang noch keine Einträge vorhanden!"}
{/cp:ifnot:oid}
{cp:if:oid}
{cp:container module="weblog" type="details" number="{cp:variable:oid}" alttext="Es gibt keinen Eintrag mit dieser ID!"}
{/cp:if:oid}
</td>
</tr>
</table>
Dieser Quellcode beinhaltet die einzelnen Containeraufrufe. Im unteren Teil wird dazu mittels der {cp:tags} "{cp:if}" und "{cp:ifnot}" unterschieden, ob sich der Besucher auf einer Detailseite (Parameter "oid" ist in der URL vorhanden) oder auf der Startseite bzw. innerhalb einer Weblog-Kategorie befindet (Parameter "oid" ist nicht vorhanden.
Um den Weblog in dieser Form einzubinden, ist zuerst ein neuer Artikel im Administrationsbereich anzulegen. Dort wird auf den HTML-Modus gewechselt und der obenstehende Quellcode wird per Copy&Paste übernommen. Anschließend kann nach dem Speichern bereits auf den neuen Weblog gewechselt werden.
An der Vorlage "main.htm" aus dem Vorlagenset ist zusätzlich noch eine Anpassung vorzunehmen, damit die CSS-Befehle zur Gestaltung des Weblogs verarbeitet werden können. Folgende Zeile ist dort in den -Bereich einzubinden:
<link rel="stylesheet" href="/{cp:configuration:main:directory}modules/weblog/templates/weblog.css" type="text/css" />
Ausgehend von diesem Quellcode und den einzelnen, darauf abgestimmten Vorlagen in den Ordnern unter "/modules/weblog/templates/" und "/modules/weblog_*/templates/" kann nun unter Einsatz der einzelnen Container das Weblog weiter modifiziert werden, um beispielweise gesonderte Seiten für eine Übersicht über die letzten Kommentare anzuzeigen, weitere Grafiken einzubauen etc.
Für die Darstellung der einzelnen Elemente des Weblogs werden zahlreiche Vorlagen genutzt, welche eine starke Differenzierung der Gestaltung ohne weitere Programmierung ermöglichen. Diese Vorlagen sind in den folgenden Ordnern vorzufinden:
- "/modules/weblog/templates/"
Vorlagen für die Einträge des Weblogs.
- "/modules/weblog_blogroll/templates/"
Vorlagen für die Einträge der BlogRoll.
- "/modules/weblog_comments/templates/"
Vorlagen für die Kommentare.
- "/modules/weblog_options/templates/"
Vorlagen für die Einstellungen (nicht im öffentlichen Bereich genutzt).
- "/modules/weblog_sections/templates/"
Vorlagen für die Kategorien.
Eine genauere Auflistung der genutzten Vorlagen kann innerhalb des Administrationsbereiches über "CP::Forms > Weblog > [MODUL] > Vorlagen-Erklärung" abgerufen werden, wie z.B. über "
admin.php?file=forms&mode=show_templateinfo&form[module]=weblog" für die Einträge des Weblogs. Zusätzlich werden in der sogenannten "{cp:tags}-Erklärung" die jeweils innerhalb der Vorlagen zur Verfügung stehenden {cp:tags} aufgelistet.
Dieser Container vom Typ "list" dient zur Anzeige der im Weblog enthaltenen und freigeschalteten Einträge. Er ist Bestandteil der normalen Einbindung des Weblogs auf der Webseite, kann aber auch davon unabhängig auf einer beliebigen Seite in Contentpapst platziert werden.
{cp:container module="weblog" type="list"}
Über den Parameter "template" kann eine alternativ zu verwendende Vorlage festgelegt werden. Die Informationen zu den standardmäßig genutzten Vorlagen / verfügbaren {cp:tags} sind dabei unter "CP::Forms > Weblog > Einträge" und dann "Vorlagen-Erklärung" / "{cp:tags}-Erklärung" abrufbar.
Über den Parameter "show_date" kann angegeben werden, ob nach dem Datum gruppiert und das Datum oberhalb der Einträge an diesen Tag ausgegeben werden soll. Steht dieser Parameter auf "0", dann wird eine einfache Liste generiert. Dies ist z.B. sinnvoll, wenn neben der eigentlichen Auflistung der - oft sehr umfangreichen - Einträge noch eine kurze Auflistung der Titel generiert werden soll (in Kombination mit dem Parameter "template" für eine alternative Vorlage):
{cp:container module="weblog" type="list" show_date="0" template="modules/weblog/templates/list_short.html"}
Folgende Parameter sind für diesen Container zulässig / erforderlich:
| Parameter für diesen Container |
| dir |
|
Es wird aufsteigend ("asc") oder absteigend ("desc") geordnet. |
optional |
| limit |
|
Anzahl der insgesamt angezeigten Einträge. |
optional |
| section |
|
Mit dem Wert "no" werden die Einträge unabhängig von der Kategorie angezeigt. |
optional |
| show_date |
|
Datum der Einträge anzeigen. |
optional |
| template |
|
Vorlage, welche für die Anzeige verwendet wird. |
optional |
| type |
|
Für diesen Container muss als Wert "list" verwendet werden. |
erforderlich |
Weitere Seiten:
<< zurück zur Startseite der Dokumentation