Inhaltsverzeichnis 1) Installation/Implementierung a) Programminstallation (2) b) Pflege nicht implementierter Seiten (3) c) Implementierung bestehender Seiten (4) 2) Integration von Strukturen & Layouts a) Grundlagen von Trennung Layout/ Content (5) b) Auslagerung der Layoutdateien/ Integration der Includes (6) c) Integration & Verwendung der PHP-API (8) d) Integration von QuickEdit/ Browse & Edit (9) e) Integration eines bestehenden Layouts in die Strukturverwaltung (10) 3) Navigationen a) Umbau einer bestehenden statischen Navigation (11) b) Integration der verschiedenen Anzeigemodi (15) c) Zusammenfassung der wichtigsten Codes (17) 4) Erstellung von Vorlagen/ Integration der Pflegetags/Dateierweiterung a) Definition pflegbarer Bereiche (19) b) Manuelles "Einchecken" und Integration der Pflegetags (20) c) Integration und Verwendung verschiedener Editorarten (22) d) Erstellung einer Vorlagenseite (23) e) Wiederverwertbare Inhaltselemente (Server Side Includes) (24) 5) Erstellung von Listentemplates a) Funktionsweise von Listen (26) b) Einbinden einer Liste in eine Seite: Konfigurationsblock executext (27) c) Bearbeiten der Listenoptionen (29) d) Zeilentemplate erstellen (30) e) Erstellen einer Listenvorlage (32) Seite 1 von 32
1) Installation/Implementierung a) Programminstallation Einrichtung der Programmdateien von Weblication CMS auf dem Web-Server. Bitte führen Sie folgende Übung durch: 1. Kopieren Sie die Verzeichnisse /cgi-bin und /weblication aus dem Verzeichnis vorlagen_basic in die DokumentRoot des Webservers. Dadurch installieren Sie Weblication CMS auf den Zielserver. 2. Öffnen Sie einen Browser und wechseln Sie auf die Seite [domainname]/weblication. * 3. Loggen Sie sich mit dem Benutzer "admin" und dem Passwort "admin" ein und geben Sie den in der Datei vorlagen_basic/lizenz.txt hinterlegten Lizenzkey ein (Kopieren und Einfügen). * 4. Vergeben Sie ein neues Passwort für den Administatoraccount. 5. Betätigen Sie die Ansicht auf die Präsentation. 6. Kopieren Sie die Datei index.php und danach den Ordner wdeutsch aus dem Verzeichnis vorlagen_basic in die DocumentRoot des Webservers. Nun ist das workshop-design installiert. 7. Aktualisieren Sie die Ansicht im Interface über den Button Aktualisieren. Auf einen Online-Web-Server übertragen Sie Weblication CMS, indem Sie die Datei wsetup.cgi per FTP auf den Server laden, das CGI-Script per CHMOD- Befehl auf ausführbar (755) schalten und anschließend über den Browser [domainname]/cgi-bin/wsetup.cgi aufrufen. Daraufhin wird Weblication CMS automatisch installiert. Sollte Ihr Web-Server diese Methode aufgrund fehlender Module nicht unterstützten, nutzen Sie bitte die alternativ beschriebene Methode. Alternativ: Auf einen Online-Web-Server übertragen Sie die Programmdateien von Weblication CMS per FTP und schalten diese auf ausführbar (CHMOD 755). *Anmerkung: Die Daten zur Installation des Schulungsdesigns erhalten Sie durch Entpacken der auf der Service-Seite von Weblication verfügbaren zip-datei. In der Version zum Download sind die Software-Dateien nicht enthalten. Verwenden Sie für die Lizenzierung Ihrer Domain bitte einen der Lizenzkeys, die Sie mit Ihrem Vertriebspartnervertrag erhalten haben. Im vorliegenden Dokument wird der HTML-Editor Homesite verwendet. Sie können selbstverständlich jeden beliebigen anderen Editor verwenden. Seite 2 von 32
b) Pflege nicht implementierter Seiten Sie haben bereits bestehende HTML, PHP, ASP oder JSP-Seiten in einer bestehenden Präsenz und möchten alle Inhalte sofort nach der Installation von Weblication CMS pflegen. Bitte führen Sie folgende Übung durch: 1. Bearbeiten Sie die Seite "meldung.php" Verzeichnis /wdeutsch/aktuelles/news1. Diese Seite ist noch nicht in Weblication integriert und wird somit über den "Body-Editor" gepflegt. 2. Verändern Sie die Inhalte Überschrift, das Bild samt Text und den Link und speichern die Seite. 3. Überprüfen Sie die Änderungen über die Vorschau. Info: Der Bodyeditor wird als Standardeditor angeboten, solange keine Includes (für Header/ Footerbereiche) in die Seite eingetragen und/ oder keine pflegbaren Bereiche in der Seite definiert sind. Die WYSIWYG -Editorleiste am Kopf der Bearbeitungsseite kann individuell für jeden Benutzer konfiguriert werden unterhalb der Administration-> WYSIWYG-Profile. Die Verwendung des Editors wird im Handbuch für Pflegebenutzer detailiert beschrieben. Dieses finden Sie auf der Onlinehilfe von Weblication : http://whelp.weblication.de Seite 3 von 32
c) Implementierung bestehender Seiten Sie haben bereits bestehende HTML, PHP, ASP oder JSP-Seiten in einer bestehenden Präsenz und möchten die Seiten mit Weblication CMS verwalten und alle Optionen wie Workflow, Versionierung, Archivierung, Zeitsteuerung, Kategorien, Zuweisung von Bearbeitungsrechten, Personalisierung für registrierte Ansichtsbenutzer und Gruppen, Dateiabo, usw. nutzen. Bitte führen Sie folgende Übung durch: 1. Wechseln Sie in der Weblication Oberfläche in das Verzeichnis /wdeutsch/aktuelles/news1. 2. Klicken Sie auf den Namen der Datei "meldung_1.php" und wählen "Einchecken". Nun stehen Ihnen sämtliche Optionen der Seitenverwaltung zur Verfügung. 3. Vergeben Sie auf dem Reiter Beschreibung eine neue Überschrift & Beschreibung und 4. setzen Sie in den Optionen die Seite auf online. Info: Nicht eingecheckte Seiten werden vor allen Benutzern verborgen, welche nicht Administrator sind. Eingecheckte Dateien können auch wieder aus der Verwaltung von Weblication entfernt werden (auschecken). Hierzu klicken Sie auf den Dateinamen der eingecheckten Datei und wählen auschecken. Seite 4 von 32
2) Integration von Strukturen & Layouts a) Grundlagen von Trennung Layout/ Content Weblication CMS trennt konsequent das Layout vom Conte nt. Dies ermöglicht die getrennte Pflege von Inhaltsbereichen und Layoutelementen samt Navigationen. Große Anzahlen von Inhaltsseiten können auf diese Weise mithilfe der Layout-verwaltung von Weblication CMS in unterschiedlichen Layoutvarianten präsentiert werden. Desweiteren stellt die Layoutverwaltung Werkzeuge wie den StyleWizard zur Verfügung, über den zentral das Aussehen sämtlicher Bereiche global formatiert werden können. Der mittlere Teil stellt den Contentbereich dar, in den über Includes die Header (oben) und Footerbereiche (unten) automatisch beim Aufruf der Seite im Browser eingefügt werden. Diese Bereiche können bei Bedarf über weitere Includes aufgeteilt werden, um beispielsweise eine obere top-navigation von einer Seitennavigation zu trennen. In den Header bzw. in Top und Left-Bereichen werden die Navigationsaufrufe über jeweils einen Include integriert (siehe Übung 3a ff.) Im Kopf-Bereich der Seite (innerhalb der <head></head> Tags) wird zusätzlich noch die Head-Datei inkludiert. Diese beinhaltet Scripte und Funktionen, die bei php-basierten oder asp-basierten Präsenzen notwendig sind. Seite 5 von 32
b) Auslagerung der Layoutdaten/ Implementierung der Includes Im folgenden Schritt wird eine vorgegebene Seite in die für die Layout/Strukturverwaltung relevanten Teile untergliedert und die entsprechenden Strukturelemente in den dafür zu erstellenden Verzeichnissen abgelegt. In der Beispielseite sollen Layoutelemente vom Content getrennt und als individuell pflegbare Strukturelemente abgelegt werden. 1) Kopieren Sie das Verzeichnis wlayout aus vorlagen_basic in das Verzeichnis wdeutsch. In diesem Verzeichnis werden nun sämtliche layoutspezifischen Daten gespeichert und können dort zentral gepflegt werden. 2) Öffnen Sie die Datei /wdeutsch/codes/vorlage_einfache_navigation.php in Homesite. 3) Markieren Sie den von <!-- HEADER:START --> und <!-- HEADER:STOP --> umschlossenen Bereich und kopieren Ihn in die Zwischenablage. 4) Erstellen Sie eine neue, leere Datei und fügen den Bereich aus der Zwischenablage ein. 5) Speichern Sie diese Datei unter dem Namen header.php in Verzeichnis /wdeutsch/wlayout/structure. 6) Wechseln Sie nun wieder zu der Datei Vorlage_einfache_navigation.php in Homesite, markieren den von <!-- FOOTER:START --> und <!-- FOOTER:STOP --> umschlossenen Bereich und kopieren Ihn in die Zwischenablage. 7) Erstellen Sie eine neue, leere Datei und fügen den Bereich aus der Zwischenablage ein. 8) Speichern Sie diese Datei unter dem Namen footer.php im Verzeichnis /wdeutsch/wlayout/structure. 9) Ersetzen Sie nun in der Seite Vorlage_einfache_navigation.php die HTML-Bereiche, die von <!-- HEADER:START --> und <!-- HEADER:STOP --> umschlossen sind, durch folgenden Include-Befehl: <!-- HEADER:START --> <table cellpadding="0" cellspacing="0" width="775" border="0"> <td width="20" height="25"><!--placeholder left border--><!--placeholder top border--></td> </td> <td></td> <td valign="top" height="400"> <!-- HEADER:STOP --> wird zu <!-- HEADER:START --> <?PHP include_once($_server["document_root"]."/wdeutsch/wlayout/structure/header.php");?> <!-- HEADER:STOP --> Seite 6 von 32
10) Verfahren Sie identisch mit dem von <!-- FOOTER:START --> und <!-- FOOTER:STOP --> umschlossenen HTML-Bereich und includieren hier die Datei /wdeutsch/wlayout/structure/footer.php: <!-- FOOTER:START --> </td> <td></td> <td></td> <td class="blocktop"></td> <td></td> <td>scholl Communications AG Elsässer Str. 74 77694 Kehl- Neumühl</td> <td></td> </table> <!-- FOOTER:STOP --> wird zu: <!-- FOOTER:START --> <?PHP include_once($_server["document_root"]."/wdeutsch/wlayout/structure/footer.php");?> <!-- FOOTER:STOP --> 11) Speichern Sie diese Datei im Verzeichnis /wdeutsch/aktuelles/news1 unter dem Namen meldung_2.php. 12) Speichern Sie diese Seite und überprüfen die Anzeige der Seite über die Vorschau. Seite 7 von 32
c) Integration & Verwendung der PHP-API Die PHP-API ermöglicht es, auf Funktionen des Weblication PHP-Framework zuzugreifen. So lassen sich Standardfunktionen aus den folgenen Bereichen in eigene PHP-Entwicklungen nahtlos integrieren. - Listen - Navigationen - Personalisierte Ausgabe - Benutzerverwaltung - Weblics - Dateisystem - Datenbanken Anstatt ein cgi-skript mit der entsprechenden Funktionalität über einen Include aufzurufen, können diese Standardfunktionen nun direkt über eine PHP- Funktion aus der PHP-API implementiert werden. 1) Öffnen Sie die Datei head.php aus dem Verzeichnis /wdeutsch/codes/ in Homesite und speichern sie im Verzeichnis /wdeutsch/wlayout/structure/ ab. Diese Datei enthält wichtige Scripte und Funktionen, welche für die komplette Funktion aller Scripte von Weblication CMS (Popup-Fenster, Formulare etc.) benötigt wird. Desweiteren sind hier globale Metatags und Verweise auf weitere Stylesheets definiert. Verwenden Sie diese Datei, um eigene globale Funktionen oder Aufrufe zu definieren, welche nicht in der zentralen wscript.js definiert werden können. Die wichtigste Funktion der head.php in einem php-strukturdesign ist jedoch das Inkludieren der PHP-API. 2) Um auf die Funktionen der PHP-API zugreifen zu können, muss diese in die Seite eingebunden werden. Tragen Sie in die Datei head.php folgenden Include Befehl ein: <?PHP require_once ($_SERVER["DOCUMENT_ROOT"]."/weblication/lib/WAPI/WAPI.inc");?> <head> <title>weblication Workshop Basic</title> 3) Öffnen Sie nun erneut die Seite meldung_2.php aus /wdeutsch/aktuelles/news1/ in Homesite und fügen Sie in den Kopfbereich der Seite einen weiteren Include-Befehl auf die Datei /wdeutsch/wlayout/structure/head.php ein wie folgt: <script language="javascript" src="/wdeutsch/wlayout/structure/wscript.js"></script> <link rel="stylesheet" type="text/css" href="/wdeutsch/wlayout/design/style/design.css" /> <?PHP include_once($_server["document_root"]."/wdeutsch/wlayout/structure/head.php");?> </head> 4) Speichern Sie diese Änderungen. Seite 8 von 32
d) Integration von QuickEdit/ Browse & Edit Weblication CMS ermöglicht über die Funktion Quick Edit/ Browse & Edit das komfortable Bearbeiten der Internetpräsenz direkt über den Browser. Dies geschieht über in die Seite eingebettete Bearbeitungsschaltflächen, welche bei entsprechender Berechtigung angezeigt werden. In der folgenden Übung erlernen Sie, wie Sie diese Bearbeitungsschaltflächen in die Seite integrieren und damit global zur Verfügung stellen. Die Bearbeitungssschaltflächen werden durch den Aufruf der Funktion wshoweditbutton aus der PHP-API in die Seite integriert. Sinnvollerweise geschieht dies in der zentral abgelegten, in den letzten Schritten erstellten Header-Datei. Bitte führen Sie folgende Übung durch: 1) Öffnen Sie die Datei header.php aus dem Verzeichnis /wdeutsch/wlayout/structure/ in Homesite. 2) Fügen Sie den Funktionsaufruf für den Editbutton wie folgt am Ende der Datei ein: <!--navigation left stop--> </td> <td></td> <td valign="top" height="400"> <?PHP wshoweditbutton("", "blank");?> Speichern Sie diese Datei und überprüfen die Änderungen über die Vorschau auf die Datei meldung_2.php im Verzeichnis /wdeutsch/aktuelles/news1/. Info: Die Funktion wshoweditbutton: Kurzbeschreibung Zeigt die Bearbeitungsschaltflächen an Parameter file: bearbeitbare Datei ("" entspricht der aktuellen Datei) target: Zielfenster, in dem der Editor geöffnet werden soll (self inline blank) Rückgabewert Bearbeitungsschaltflächen Syntax: <?php wshoweditbutton("file", "target");?> Seite 9 von 32
e) Integration eines bestehenden Layouts in die Layoutverwaltung Im letzten Schritt wurden die Layoutdaten von den Content-Daten getrennt und in separaten Layout-Dateien header.php und footer.php unterhalb des wlayout/structure-verzeichnisses gespeichert. Im nun folgenden Schritt sollen diese Dateien in die Layoutverwaltung von Weblication CMS integriert und von dort aus pflegbar gemacht werden. Bitte führen Sie folgende Übung durch: 1) Öffnen Sie die Datei wstructure.xml aus dem Verzeichnis /wdeutsch/codes in homesite. 2) Vergeben Sie nun in den Feldern description="" und name="" jeweils einen neuen Namen für die Struktur. Beachten Sie bitte beim Eintrag im Feld name="", daß dieser weder Sonderzeichen noch Leerzeichen enthalten darf. 3) Speichern Sie diese Datei im Verzeichnis /wdeutsch/wlayout/structure/. 4) Öffnen Sie nun die Datei wdesign.xml aus dem Verzeichnis /wdeutsch/codes/ in Homesite. 5) Vergeben Sie in den Feldern description="" und name="" jeweils einen neuen Namen für das Design. Beachten Sie bitte beim Eintrag im Feld name="", daß dieser weder Sonderzeichen noch Leerzeichen enthalten darf. 6) Speichern Sie diese Datei im Verzeichnis /wdeutsch/wlayout/design/. 7) Wechseln Sie nun in die Weblication CMS Oberfläche und dort auf den Menüpunkt Layout/Templates/Implementierung. 8) Klicken Sie auf Layout anpassen und überprüfen Sie die Anzeige des von Ihnen erstellten Layouts. Bei der Installation einer neuen Struktur wird von Weblication CMS ein neues Verzeichnis unterhalb /wlayout/ angelegt, welches die Struktur- bzw. die Designdaten und Dateien enthält. Der Verzeichnisnamen setzt sich aus structure_ bzw. design_ und dem gewählten Namen aus der wstructure.xml bzw. wdesign.xml zusammen und wird beim Wechsel der Struktur/ des Designs von Weblication CMS automatisch umbenannt. Auf diese Weise können Sie beliebig viele eigene Strukturen und Designs erstellen und parallel ablegen, und diese global über die Templates/ Layout/ Implementierung von Weblication CMS zur Auswahl anbieten. Seite 10 von 32
3) Navigationen a) Umbau der bestehenden statischen Navigation Weblication CMS ermöglicht es, Navigationen zentral zu verwalten und dynamisch in die Inhaltsseiten zu integrieren. Im folgenden Abschnitt lernen Sie, die bestehende statische Navigation über Navigationstemplates zu einer über Weblication CMS pflegbaren Navigation umzubauen. Bitte führen Sie folgene Übung durch: 1) Öffnen Sie die Datei /wlayout/structure/header.php in Homesite zur Bearbeitung. 2) Markieren Sie den von <!--navigation left start--> und <!--navigation left stop--> umschlossenen Bereich und kopieren ihn in die Zwischenablage. 3) Erstellen Sie eine neue, leere Datei und fügen den Inhalt aus der Zwischenablage in diese Datei ein. 4) Speichern Sie diese Datei in einem neuen Verzeichnis /nav unterhalb von /wdeutsch/wlayout/structure unter dem Namen wnavleft.php ab. 5) Markieren Sie nun den HTML-Quelltext für einen Hauptpunkt (wie folgend abgebildet) und schneiden Ihn über Strg + X aus. Fügen Sie diesen Teil UNTERHALB des Tabellenschlußtags </table> wieder ein. <td height="20" colspan="2" class="textbold"><a href="#" target="">hauptpunkt 1</a></td> <td height="1" class="blocktop" colspan="2"></td> 6) Umschließen Sie diesen Quelltext-Bereich mit dem Weblication-Tag für eine Navigations-Hauptpunkt (<!--NAVLEVEL1-->): <!--NAVLEVEL1--> <td height="20" colspan="2" class="textbold"><a href="#" target="">hauptpunkt 1</a></td> <td height="1" class="blocktop" colspan="2"></td> <!--NAVLEVEL1--> 7) Ersetzen Sie die statische Angabe für den Linktext durch folgenden Platzhalter: <!--NAVLEVEL1--> <td height="20" colspan="2" class="textbold"><a href="#" target=""><!--text--></a></td> <td height="1" class="blocktop" colspan="2"></td> <!--NAVLEVEL1--> Seite 11 von 32
8) Ersetzen Sie nun den Platzhalter (#) für den Link: <!--NAVLEVEL1--> <td height="20" colspan="2" class="textbold"><a href="<!--link--><!--navidext-->" target=""><!--text--></a></td> <td height="1" class="blocktop" colspan="2"></td> <!--NAVLEVEL1--> 9) Fügen Sie den Weblication-Tag für das Ziel (target) des Links ein: <!--NAVLEVEL1--> <td height="20" colspan="2" class="textbold"><a href="<!--link--><!--navidext-->" target="<!--target-->"><!--text--></a></td> <td height="1" class="blocktop" colspan="2"></td> <!--NAVLEVEL1--> 10) Um die Navigation mit allen Navigationspunkten sämtlicher Hierarchien darzustellen, existieren in Weblication CMS zwei Tags: <!--SIBLINGNAVPOINT--> Steht für einen Punkt derselben Hierarchie (bezogen auf einen Hauptpunkt also ein weiterer Hauptpunkt). <!--CHILDNAVPOINT--> Steht für einen Navigationpunkt eine Hierarchie UNTERHALB der aktuell gewählten (bezogen auf einen Hauptpunkt also einen zugehörigen Unterpunkt). Diese werden immer INNERHALB einer NAVLEVEL-Definition gesetzt, damit die Punkte auch jeweils in der korrekten Zugehörigkeit angezeigt werden. 11) Fügen Sie nun einen <!--SIBLINGNAVPOINT--> direkt unterhalb des Tabellenzeilen-schlusstags () ein: <!--NAVLEVEL1--> <td height="20" colspan="2" class="textbold"><a href="<!--link--><!--navidext-->" target="<!--target-->"><!--text--></a></td> <td height="1" class="blocktop" colspan="2"></td> <!--SIBLINGNAVPOINT--> <!--NAVLEVEL1--> 12) Fügen Sie einen <!--CHILDNAVPOINT--> direkt oberhalb des <!--SIBLINGNAVPOINT--> ein: <!--NAVLEVEL1--> <td height="20" colspan="2" class="textbold"><a href="<!--link--><!--navidext-->" target="<!--target-->"><!--text--></a></td> <td height="1" class="blocktop" colspan="2"></td> <!--CHILDNAVPOINT--> <!--SIBLINGNAVPOINT--> <!--NAVLEVEL1--> Seite 12 von 32
<!--NAVLEVEL1--> 13) Markieren Sie nun den HTML-Quelltext für einen Unterpunkt wie oben beschrieben, schneiden Ihn aus (Strg + X) und fügen diesen Bereich UNTERHALB des soeben erstellten NAVLEVEL1 ein: <td width="10"></td> <td height="16"><a href="" target="">unterpunkt 1</a></td> 14) Umschließen Sie diesen Quelltext-Bereich mit dem Weblication-Tag für einen Navigations-Unterpunkt und ersetzen Sie wieder die statische Angabe für den Linktext, den Link und das Linkziel durch die entsprechenden Platzhalter (siehe Schritt 7 9): <!--NAVLEVEL2--> <td width="10"></td> <td height="16"><a href="<!--link--><!--navidext-->" target="<!--target-->"><!--text-- ></a></td> <!--NAVLEVEL2--> 15) Fügen Sie wiederum die Platzhalter für <!--CHILDNAVPOINT--> & <!--SIBLINGNAVPOINT--> direkt unterhalb des Tabellenzeilen-Schlusstags () ein. <!--NAVLEVEL2--> <td width="10"></td> <td height="16"><a href="<!--link--><!--navidext-->" target="<!--target-->"><!--text-- ></a></td> <!--CHILDNAVPOINT--> <!--SIBLINGNAVPOINT--> <!--NAVLEVEL2--> 16) Löschen Sie nun den Quellcode zwischen den Tabellenstart- und Endtag bis auf die erste Tabellenzeile und fügen den Weblication-Platzhalter für die Generierung der Navigation ein: <table cellpadding="0" cellspacing="0" border="0" width="150"> <td colspan="2" height="25" width="150"></td> <!--NAVIGATION--> </table> 17) Speichern Sie diese Änderungen und wechseln zurück in die Datei header.php. 18) Markieren Sie den zuvor kopierten Bereich zwischen <!--navigation left start--> und <!--navigation left stop--> und ersetzen Sie ihn durch folgenden Aufruf der PHP-API: <!--navigation left start--> <?php wshownavigation("/wdeutsch/standard.wnavigation.xml", "/wdeutsch/wlayout/structure/nav/wnavleft.php", "o2", wgetparameter("navid"));?> <!--navigation left stop--> 19) Speichern Sie diese Seite und überprüfen Sie die Änderungen auf der Website. Seite 13 von 32
Info: Die Funktion wshownavigation Kurzbeschreibung Zeigt eine Navigation an Parameter navconfig: Konfigurationsdatei der Navigation (z.b. /wdeutsch/standard/wnavigation.xml) navtpl: Navigationsvorlage (z.b. /wdeutsch/wlayout/structure/nav/wnavleft.php) navmode: Navigationsmodus (a o[1-n] u[1-n] b[1-n]) navid: Navigations-ID ( [0-n]) Rückgabewert Navigation Syntax: <?php wshownavigation("navconfig", "navtpl", "navmode", wgetparameter("navid"));?> Seite 14 von 32
b) Integration der verschiedenen Anzeigemodi Weblication CMS ermöglicht es, Links aus der Navigation in verschiedenen Zuständen anzuzeigen. Hierbei kann beispielsweise unterschieden werden, ob ein Link gerade angewählt wurde (aktiver Zustand), Unterpunkte hat und diese anzeigt etc. Für jeden dieser Zustände kann ein individuelles Layout definiert werden. In der folgenden Übung erlernen Sie die Implementierung verschiedener Zustände der Links. Bitte führen Sie folgende Übung durch: 1. Öffnen Sie die Datei wnavleft.php aus dem Verzeichnis /wdeutsch/wlayout/structure/nav/ in Homesite. 2. Markieren Sie den Code für das Navigationslevel 1 und kopieren Sie diesen Bereich in die Zwischenablage. Fügen Sie den Inhalt der Zwischenablage direkt unterhalb der Definition <!--NAVLEVEL1--> wieder ein. 3. Verändern Sie nun die Angabe des Navigationslevels wie folgt in ein Navigationslevel mit dem Zustand Ausgewählt/Aktiv : <!--NAVLEVEL1_selected--> <td height="20" colspan="2" class="textbold"><a href="<!--link--><!--navidext-->" target="<!--target-->"><!--text--></a></td> <td height="1" class="blocktop" colspan="2"></td> <!--CHILDNAVPOINT--> <!--SIBLINGNAVPOINT--> <!--NAVLEVEL1_selected--> Durch die Angabe der Navigationsdefinition <!--NAVLEVEL1_selected--> wird der durch diesen Tag umschlossene Sourcecode für den Navigationspunkt verwendet, welcher gerade vom Besucher der Internetpräsenz angeklickt wurde. 4. Verändern Sie nun die Anzeige des von <!--NAVLEVEL1_selected--> umschlossenen Bereiche, indem Sie ein -> vor den Weblication Tag <!--text--> setzen: <!--NAVLEVEL1_selected--> <td height="20" colspan="2" class="textbold"><a href="<!--link--><!--navidext-->" target="<!--target-->">-> <!--text--></a></td> <td height="1" class="blocktop" colspan="2"></td> <!--CHILDNAVPOINT--> <!--SIBLINGNAVPOINT--> <!--NAVLEVEL1_selected--> 5. Speichern Sie diese Änderungen und überprüfen die Anzeige auf der Website. 6. Integrieren Sie nun nach dem selben Muster weitere Zustände der Links. Hierfür stehen Ihnen folgende Tags zur Verfügung: <!--NAVLEVELx_selected--> Navigationspunkt ist ausgewählt. Seite 15 von 32
<!--NAVLEVELx_openselected--> Navigationspunkt ist ausgewählt (selected) und zeigt seine Unterpunkte (open) <!--NAVLEVELx_open--> Navigationspunkt zeigt seine Unterpunkte (open), ist aber nicht mehr ausgewählt. <!--NAVLEVELx_childs--> Navigationspunkt hat Unterpunkte, ist aber weder ausgewaehlt noch offen. Diese Zustände sind in allen Navigationslevels anwendbar. 7) Erweitern Sie nun die Navigation um Links auf die bisher erstellten Seiten im Verzeichnis /wdeutsch/aktuelles/news1/. Verwenden Sie hierfür die Navigationsverwaltung in der Administrationsleiste von Weblication CMS. Seite 16 von 32
c) Zusammenfassung der wichtigsten Codes für die Erstellung von Navigationstemplates Der Aufruf der Navigation erfolgt über die Funktion wshownavigation der PHP- API: <!-- web:navigation:start --> <?php //zeigt die angegebene Navigation an wshownavigation("/wdeutsch/standard.wnavigation.xml", "/wdeutsch/wlayout/structure/nav/wnavleft.php", "o2", wgetparameter("navid"));?> <!-- web:navigation:stop --> Dabei werden als Angaben der Modus der Navigation, die Konfigurationsdatei der Navigation (wird über die Weblication CMS Oberfläche angelegt und bearbeitet) und das Navigationstemplate angegeben. Genauere Angaben hierzu entnehmen Sie bitte der OnlineHilfe von Weblication. Navmode: Gibt die Art des Aufrufs an: navmode=a Alle Navigationspunkte werden angezeigt, d.h. die gesamte Navigation ist aufgeklappt. Wird benötigt zur Darstellung einer Sitemap. navmode=ox Alle Navigationspunkte oberhalb einschließlich von Navigationstiefe x (NAVLEVELx) werden angezeigt. Unterpunkte werden daher bei Klick bis zum angegebenen NAVLEVEL geöffnet und angezeigt. navmode=ux Alle Navigationspunkte unterhalb von Navigationstiefe x (NAVLEVELx) mit einem LEVEL unterhalb eines ausgewählten Navigationspunktes werden ausgegeben. navmode=bx Alle Navigationspunkte in allen folgenden NAVLEVELs unterhalb von Navigationstiefe x (NAVLEVELx) im Strukturbau eines ausgewählten Navigationspunktes werden ausgegeben. Navconfig: Gibt die Konfigurationsdatei der Navigation an. Navtpl: Gibt das zu verwendende Navigationstemplate an. Navigationstemplates sind unterhalb /wdeutsch/wlayout/structure/nav abgelegt und beinhalten die Definition der einzelnen Navigationslevel, sprich die Darstellung und Inhaltselemente der einzelnen Navigationshierarchien und Zustände. Anstelle des Aufrufes <!--NAVIGATION--> im Navigationstemplate wird von Weblication die Navigation aufgebaut. Dabei werden die einzelnen Seite 17 von 32
Navlevel-Definitionen in den unterschiedlichen Zuständen als Vorlagen verwendet: Die Angabe NAVLEVEL git die Strukturtiefe an: z.b Level 1 bezeichnet einen Hauptpunkt. Für jedes NAVLEVEL kann die Darstellung verschiedener Zustände definiert werden: Z.B. OPEN, SELECTED, OPENSELECTED, usw. <!--NAVLEVELx_selected--> Navigationspunkt ist ausgewählt (selected). <!--NAVLEVELx_openselected--> Navigationspunkt ist ausgewählt (selected) und zeigt seine Unterpunkte (open) <!--NAVLEVELx_open--> Navigationspunkt zeigt seine Unterpunkte (open), ist aber nicht mehr ausgewählt. <!--NAVLEVELx_childs--> Navigationspunkt hat Unterpunkte, ist aber weder ausgewählt noch offen. <!--link--><!--navidext--> <!--target--> <!--text--> sind Platzhalter für die Werte, welche in der Navigationsverwaltung angegeben werden für den Link, das Ziel (target) und den Linktext. <!--CHILDNAVPOINT--> <!--SIBLINGNAVPOINT--> definieren einen Platz, an dem Unterpunkte (CHILDS) oder weitere Hauptpunkte (SIBLINGS) angezeigt werden sollen, sofern vorhanden. Anpassungen der Stile der Navigation von Strukturdesigns führen Sie hauptsächlich in der entsprechenden css-datei /wdeutsch/wlayout/design/style/nav.css/ durch. Seite 18 von 32
4) Erstellung von Vorlagen / Manuelle Integration der Pflegetags/Dateierweiterung a) Definition pflegbarer Bereiche Bisher waren alle Inhalte einer bestehenden Seite vollständig pflegbar. Sie möchten nun aber festlegen, daß ein Pflegebenutzer nur definierte Inhaltsbereiche verändern kann und die bearbeitbaren Bereiche für Pflegebenutzer einschränken. Bitte führen Sie folgende Übung durch: 1. Klicken Sie auf den Namen der Datei "meldung_2.php" und wählen "Einchecken". Wechseln Sie auf den Reiter "Datei Quelltext". 2. Machen Sie mit Hilfe des TagWizards folgende Seitenelemente pflegbar: Überschrift, Kurzbeschreibung, Bild und den Link, indem Sie den entsprechenden Teil des Quellcodes markieren und im Auswahlfeld oben den jeweiligen Tag (Text/ Bild/ Link pflegbar machen) wählen. Bitte achten Sie hierbei darauf, daß ausschließlich der Bereich markiert ist, welcher den zu pflegenden Bereich enthält (also keine HTML Elemente). 3. Überprüfen Sie die Änderungen im Reiter "Datei Entwurf". 4. Verändern Sie Überschrift und Beschreibung der Seite in den Beschreibungen und stellen die Seite über die Optionen auf online. 5. Speichern Sie diese Seite. Seite 19 von 32
b) Manuelles "Einchecken" und Integration der Pflegetags In diesem Abschnitt wird gezeigt, wie ohne die Oberfläche von Weblication CMS über einen HTML-Editor eine Seite in Weblication CMS über einen HTML- Editor eingecheckt wird. Bitte führen Sie folgende Übung durch: 1. Öffnen Sie die Seite \wdeutsch\codes\seite.php in Homesite. 2. Öffnen Sie parallel die Datei "wvorlage_komplett.php" im selben Verzeichnis und 3. kopieren die Dateierweiterung "documentxt" aus der Datei wvorlage_komplett.php in die Datei seite.php (manuelles Einchecken). Info: Die Dateierweiterung documentxt <!-- <documentxt type="weblication" version="4.0"> <headline text="überschrift der Meldung"/> <description text=" Beschreibung der Meldung"/> <thumbnail src=""/> <keywords text=""/> <owner name="admin" profile="wdefaultprofileofuser"/> <group name="" profile="wdefaultprofileofuser"/> <others profile="ansichtsbenutzer"/> <modification name="admin" time="1100531282"/> <version number="3"/> <creation name="admin" time="1100529374"/> <protocol action="modify" name="admin" time="1100531282" version="3"/> <online from="##:##:#### ##:##" status="on" to="##:##:#### ##:##"/> </documentxt> --> Die Dokumentenerweiterung (documentxt) beinhaltet die Dateioptionen einer Datei und ist im Quelltext als Kommentarkopf abgelegt. Diese Einträge werden direkt über die Dateioptionen der Weblication CMS Oberfläche bearbeitet. 4. Speichern Sie die Seite seite.php unter dem Namen meldung_3.php im Verzeichnis /wdeutsch/aktuelles/news1/ und 5. rufen Sie die Seite in der Weblication Oberfläche zur Bearbeitung auf. Durch das Einchecken der Dateierweiterung stehen alle Optionen der Seiten/Dateiverwaltung zur Verfügung (Schlüsselworte, Kategorien, Versionierung, Archivierung, Personalisierung, Rechtevergabe, Workflow, usw.). Dies gilt auch für jede beliebige Art von Dateien wie beispielsweise doc,pdf, jpg, xls, ppt, etc. Bei diesen Dateien kann schon beim Upload gewählt werden, ob automatisiert eine Dokumentenerweiterung angelegt wird ( Beim Hochladen einchecken ). Seite 20 von 32
6. Brechen Sie die Bearbeitung ab und wechseln Sie zurück in Homesite. Machen Sie nun die verschiedenen Seitenbereiche pflegbar mit folgenden Tags: <!--web:text:start--> Text <!--web:text:stop--> <!--web:link:start--> <a href="datei.php">link</a> <!--web:link:stop--> <!--web:picture:start--> <img src="bild.jpg"> <!--web:picture:stop--> Verwenden Sie die Seite wvorlage_komplett.php als Vorlage. 7. Sichern Sie die Seite erneut und 8. überprüfen Sie die Änderungen in der Weblication -Oberfläche. Hilfe zu den Tags finden Sie in der kontextsensitiven Onlinehilfe/Technische Referenz/ durch Klicken auf?. Info: In Weblication kann jeder beliebige Dateityp eingecheckt werden (Zusatzmodul ab Classic). Hierbei wird nicht wie bei MarkUp-Dateien die Dokumentenerweiterung documentxt in den Quelltext der Datei geschrieben, sondern in einer Datei namens Dateiname.documentXt parallel zur eingecheckten Datei abgespeichert. Seite 21 von 32
c) Integration und Verwendung verschiedener Editorarten Weblication CMS bietet für den Pflegebenutzer verschiedene Editiermöglichkeiten innerhalb einer Seite. In diesem Abschnitt lernen Sie die verschiedenen Editortypen kennen und wie die verschiedenen Editortypen implementiert werden. Bitte führen Sie folgende Übung durch: 1. Um die verschiedenen Arten der Editoren zu verwenden, bearbeiten Sie die Seite meldung_3.php erneut in der Weblication Oberfäche. 2. Verwenden Sie den TagWizard, um die Pflegetags aus den Elementen Überschrift und Kurzbeschreibung zu entfernen. 3. Markieren Sie nun zuerst den Text der Überschrift und wählen den Text pflegbar machen Pflegetag aus der Auswahlliste oben aus. In der nun folgenden Maske wählen Sie als Editor In die Seite eingebettet, als Typ text. Wählen Sie eine beliebige Höhe und Breite (Angaben in Pixel) und speichern mit OK: 4. Verfahren Sie identisch mit dem Element Kurzbeschreibung und wählen hierbei den Typ wysiwyg. 5. Wechseln Sie in den Datei Entwurf, überprüfen die Änderungen und 6. speichern die Seite ab. Info: Für das Pflegbarmachen der verschiedenen Bereiche (Text, Bild, Link) können explizite Angaben zur Anzeige des Editors (in die Seite eingebettet/ in neuem Fenster öffnen), des Typs (WYSIWYG-Feld, Textfeld ohne Formatierung, ASCII oder Quellcode) und der Größe gemacht werden (Höhe/ Breite). Für Bilder und Links steht die Möglichkeit zur Verfügung, die Veränderung der Größe des Bildes anzubieten (Größe änderbar: ja nein) und den Pfad der zu verlinkenden Bilder/Dateien einzuschränken (Pfad Root Start). Unabhängig davon kann für jedes pflegbare Element eine eindeutige ID angegeben werden, über die beispielsweise Listentemplates Inhalte aus Seiten auslesen können (Siehe Workshop Professional). Werden hier keine besonderen Angaben gemacht, wird der Standard-Modus verwendet. Diese Modi können separat für Texte, Bilder und Links eingestellt werden unterhalb der Administration-> Pflegbare Bereiche. Seite 22 von 32
d) Erstellung einer Vorlagenseite Die Pflegebenutzer sollen neue Seiten nach einem vorbestimmten Grundmuster erstellen. Hierzu möchten Sie als Administrator eine Vorlage (Template) anlegen. Bitte führen Sie folgende Übung durch: 1. Erstellen Sie unterhalb /wdeutsch ein neues Verzeichnis templates (Über den Button Neuer Ordner ) und checken dieses Verzeichnis aus. 2. Kopieren Sie nun die Seite meldung_3.php aus dem Verzeichnis /wdeutsch/aktuelles/news1 über Klick auf den Dateinamen -> Kopieren in das Verzeichnis /templates (Klick mit der rechten Maustaste in die leere Fläche-> Einfügen ohne Linkanpassung ). 3. Benennen Sie die Seite um in "Vorlage_meldungen" (ohne Linkanpassung), 4. verändern Sie Überschrift und Beschreibung über Bearbeiten und 5. setzen die Seite in den Optionen offline. Beim Anlegen einer neuen Seite in einem Ordner überprüft Weblication CMS, ob in diesem Ordner ein Unterverzeichnis templates existiert. Ist dies der Fall, werden alle Dateien aus diesem Verzeichnis angeboten. Existiert kein solches Verzeichnis, wechselt Weblication CMS in den darüberliegenden Ordner und bietet die Vorlagen an, welche in einem dort vorhandenen templates-verzeichnis liegen. Dieser Mechanismus überprüft den kompletten Pfad bis in die DocumentRoot des WebServers, wird auf diesem Weg kein templates-verzeichnis gefunden, wird die Option neue Seite im jeweiligen Ordner NICHT angeboten. 6. Legen Sie nun im Verzeichnis wdeutsch/aktuelles/news1 eine neue Seite mit dem soeben erstellten Template Vorlage_meldungen an, 7. verändern Inhalte und Beschreibung der Seite und 8. stellen diese online. 9. Überprüfen Sie diese Änderungen über die Vorschau. Info: Der Standardmechanismus für das Anbieten von Templates kann umgangen werden, indem für das aktuelle Verzeichnis die Verzeichnisoptionen bearbeitet werden (Button Einstellungen ). Unterhalb des Registers Seiten erstellen kann nun ein direkter Pfad zu einem beliebigen Verzeichnis angegeben werden. In diesem Fall werden die in diesem Verzeichnis enthaltenen Seiten exklusiv als Vorlagen für das aktuelle Verzeichnis angeboten. Wie auch bei nicht eingecheckten Seiten werden nicht eingecheckte Verzeichnisse vor Benutzern versteckt, welche nicht Admin sind. Angezeigt wird dies in der Weblication Oberfläche durch eine blassgelbe Darstellung. Template-Verzeichnisse sowie Verzeichnisse mit Layout-Daten wie beispielsweise /wdeutsch/wlayout sollten ausgecheckt werden, damit kein Benutzer darauf zugreifen kann. Seite 23 von 32
e) Wiederverwertbare Inhaltselemente (Includes) Weblication CMS ermöglicht es Ihnen, über den Portalbuilder und den Struktur-Editor Inhalte z.b. Adressen, Ansprechpartner, Termine, usw. zentral zu verwalten und in unterschiedlichen Seiten zu publizieren. Im folgenden Abschnitt lernen Sie, wie wiederverwertbare Inhaltselemente als Struktur- Element im Mastertemplate eingebunden werden. Bitte führen Sie folgende Übung durch: 1. Legen Sie in der Oberfläche unterhalb /wdeutsch ein neues Verzeichnis includes an. 2. Kopieren Sie die Datei include_text.htm aus dem Verzeichnis /wdeutsch/codes/ in das Verzeichnis includes. Der Inhalt dieser Datei soll nun dynamisch über einen PHP Include in der Datei meldung_3.php angezeigt werden. Ein weiterer Vorteil dieser Arbeitsweise besteht darin, daß nun 2 verschiedene Redakteure die unterschiedlichen Inhalte der resultierenden Seite meldung_3.php getrennt bearbeiten können. 3. Öffnen Sie die Seite "meldung_3.php" aus dem Verzeichnis /wdeutsch/aktuelles/news1/ in Homesite. 4. Markieren und kopieren Sie den html-code für den Link und 5. fügen ihn direkt darunter wieder ein. 6. Löschen Sie den Inhalt (den Link samt Pflegetag). Beispiel: <td></td> <td></td> <td><!-- web:link:start --><a href="javascript:window.history.back();">zurück</a><!-- web:link:stop --></td> <td></td> <td></td> 7. Fügen den Include-Befehl sowie die Weblication -Tags ein: <td></td> <td></td> <td> <!--web:include:start--> <?PHP include_once($_server["document_root"]."/wdeutsch/includes/");?> <!--web:include:stop--> </td> <td></td> <td></td> 8. Speichern Sie diese Datei. 9. Wechseln Sie in das Verzeichnis /wdeutsch/aktuelles/news1/ und 10. bearbeiten Sie die Datei meldung_3. 11. Bearbeiten Sie das Include Element und wählen Sie die Datei /wdeutsch/includes/include_text.htm. 12. Speichern Sie die Seite und überprüfen Sie die Anzeige über -> Vorschau. 13. Wechseln Sie in das Verzeichnis /wdeutsch/includes/ und checken die Datei include_text.htm ein. 14. Verändern Sie nun den Inhalt dieser Datei. Seite 24 von 32
15. Speichern Sie diese Änderungen und überprüfen Sie die Anzeige über die Vorschau der Datei /wdeutsch/aktuelles/news1/meldungen_3.php. Info: Die zu inkludierende Datei kann prinzipiell jede beliebige Dateiendung erhalten. Der Vorteil bei der Verwendung einer MarkUp-Dateiendung ist, daß die Datei mit dem Weblication-WYSIWYG-Editor gepflegt werden und für diesen Zweck mit Pflegetags versehen werden kann. Auch die Verwendung des Struktureditors (Zusatzmodul ab Classic, siehe Workshop Professional) ist dann möglich. Seite 25 von 32
5) Erstellung von Listentemplates a) Funktionsweise von Listen (Für Classic und Enterprise, Light mit Dynamik- Modul) Listen bestehen aus 3 Elementen: 1. Konfigurationsblock "executext" Der KonfigurationsBlock (executext) beinhaltet die Konfiguration der Liste: - welche Seiten/Verzeichnisse angezeigt werden - Sortierung der Liste - welche Dateitypen (ausgehend von der Dateiendung) angezeigt werden - welche Arten von Dateien (Listen/bearbeitbare/andere) angezeigt werden - wieviel Dateien maximal in der Liste aufgelistet werden - Darstellung (Zeilenvorlage) 2. Zeilenvorlage Das Zeilentemplate beeinhaltet die Darstellung und die Auswahl der Vorschau- Elemente - welche Vorschauelemente (Überschrift, Beschreibung, Link, Thumbnail etc.) angezeigt werden sollen. Hierbei wird zwischen standardmäßig verfügbaren Elementen wie Headline, Description, Thumbnail & Link und optional wählbaren Elementen (z.b. Inhalte der Seite selbst) unterschieden. - wie und wo werden diese Elemente angezeigt/plaziert? (html-tabellenaufbau, CSS-Formatierungen, Layout) 3. Funktionsaufruf An Stelle des Funktionsaufrufs wird die Liste im php-dokument angezeigt. Für jede aufzulistende Datei wird ein Eintrag in der Darstellung wie im Zeilentemplate definiert erzeugt. Dabei kann der Konfigurationsblock sowohl in der auszugebenden Seite selbst als auch in einer externen Datei gespeichert sein. Seite 26 von 32
b) Einbinden einer Liste in eine Seite: Konfigurationsblock executext (Für Classic und Enterprise, Light mit Dynamik-Modul) Eine Liste soll in eine Seite integriert werden. Im folgenden lernen Sie, eine Liste über die entsprechende Funktion aus der PHP-API in eine Seite zu integrieren. Bitte führen Sie folgende Übung durch: 1. Kopieren Sie im Verzeichnis /wdeutsch/aktuelles/news1 die Seite meldung_3.php in die Zwischenablage und fügen Sie im selben Verzeichnis wieder ein. Benennen Sie diese Seite um in listenseite.php. 2. Bearbeiten Sie diese Datei und wechseln in den Datei-Quelltext. Ersetzen nun den PHP-Include durch die Funktion wshowlist: <!--web:include:start--> <?PHP include_once($_server["document_root"]."/wdeutsch/includes/include_text.htm");?> <!--web:include:stop--> wird zu <!--web:include:start--> <?PHP wshowlist("");?> <!--web:include:stop--> Info: Wird dieser Funktion kein Pfad mitgegeben, wird der executext in derselben Datei notiert, in der auch die wshowlist Funktion definiert ist. Wird ein Pfad angegeben, muss der executext in der durch den Pfad angegebenen Datei vorhanden sein. Eine ausführliche Beschreibung zu dieser Vorgehensweise siehe Workshop Professional. ExecuteXt Der Kommentarkopf "executext" definiert eine Datei als Listendatei und enthält die erforderlichen Parameter zum Auslesen des jeweiligen Verzeichnisses, Sortierung der Liste, etc. <!-- <executext type="weblication.list" version="1.1"> <var name="listrow" value="/wdeutsch/templates/list/zeile.row" /> <var name="listrowalt" value="" /> <var name="filetypes" value="php" /> <var name="showmode" value="2" /> <var name="filesmax" value="" /> <var name="sort" value="name_desc" /> <func name="list.show" /> <var name="subdirs" value="" /> <var name="dir" value="_self" /> </executext> --> Die Parameter der "executext" sind über das Interface in den Listenoptionen der entsprechenden Datei pflegbar. Weitere Informationen zum executext finden Sie in der Onlinehilfe unter Technische Referenz >Listen > Kommentarkopf executext Seite 27 von 32
3. Ersetzen Sie den Include -Tag durch einen list -Tag: <!--web:list:start--> <?php wshowlist("");?> <!--web:list:stop--> 4. Öffnen Sie die Onlinehilfe? und 5. kopieren den ExecuteXt-Block aus Technische Referenz->Erstellen einer Liste->Definieren des Kommentarkopfes executext direkt unterhalb des Listen-Stop-Tags (Eine Kopie dieses Kommentarkopfes befindet sich ebenfalls in der Datei /wdeutsch/codes/konfigurationsblock.php): <!--web:list:start--> <?php wshowlist("");?> <!--web:list:stop--> <!-- <executext type="weblication.list" version="1.1"> <var name="listrow" value="/wdeutsch/templates/list/zeile.row" /> <var name="listrowalt" value="" /> <var name="filetypes" value="php" /> <var name="showmode" value="2" /> <var name="filesmax" value="" /> <var name="sort" value="name_desc" /> <func name="list.show" /> <var name="subdirs" value="" /> <var name="dir" value="_self" /> </executext> --> 6. Speichern Sie diese Datei und 7. überprüfen Sie die Funktionsweise der Liste über Vorschau. 8. Setzen Sie einige der Dateien im Verzeichnis /wdeutsch/aktuelles/news1/ auf offline und 9. legen Sie eine neue Datei an. 10. Ändern Sie Überschrift und Beschreibung im Reiter Beschreibung, 11. setzen Sie diese Seite online und 12. überprüfen Sie erneut die Anzeige der Liste über Vorschau. Hinweis: Die bisher erstellte Liste wurde lediglich als Linkliste ausgegeben. Im Abschnitt d) lernen Sie, Zeilentemplates für die Darstellung der einzelnen Elemente einer Liste zu erstellen. Info: Die Funktion wshowlist Kurzbeschreibung Zeigt eine Liste an Parameter path: Pfad der Listendatei. Kann auch leer gelassen werden, in diesem Fall muss der executext in derselben Datei vorhanden sein, in dem auch der Funktionsaufruf steht. Rückgabewert Liste Syntax: <?php wshowlist("path");?> Seite 28 von 32
c) Bearbeiten der Listenoptionen (Für Classic und Enterprise, Light mit Dynamik-Modul) Im folgenden Abschnitt lernen Sie, die Einstellungen für eine Liste über die Benutzeroberfläche durchzuführen. Bitte führen Sie folgende Übung durch: 1. Wechseln Sie in das Verzeichnis /wdeutsch/aktuelles/news1 2. Bearbeiten Sie die Listenoptionen der Datei listenseite.php. 3. Setzen Sie die Anzahl der anzuzeigenden Dateien auf 2 und 4. verändern Sie die Sortierreihenfolge auf Nach Dateiname a-z. 5. Speichern Sie die Liste und 6. überprüfen Sie die Anzeige über die Vorschau. Info: Eine genaue Dokumentation aller Funktionen und Optionen finden Sie unter http://whelp.weblication.de im Bereich Benutzeroberfläche >Verzeichnisstruktur >Dateien: Funktionen + Optionen >Listenoptionen Seite 29 von 32
d) Zeilentemplate erstellen (Für Classic und Enterprise, Light mit Dynamik- Modul) Die bisher erstellte Liste wurde lediglich als Linkliste ausgegeben. Im folgenden Abschnitt lernen Sie, ein Zeilentemplate für die Darstellung der einzelnen Elemente einer Liste zu erstellen. Bitte führen Sie folgende Übung durch: 1. Öffnen Sie die Datei zeile.htm aus dem Verzeichnis /wdeutsch/codes in Homesite und 2. speichern Sie diese Datei in einem neuen Verzeichnis /wdeutsch/templates/list unter dem namen zeile.row. 3. Wechseln Sie in die Weblication Obe rfläche ( Aktualisieren ) und 4. bearbeiten diese Datei im Quelltext. 5. Umschliessen Sie den kompletten Code mit dem <!--PRC:LISTROW--> Tag. Dieser definiert den Zeilenbereich: <!--PRC:LISTROW--> <table cellpadding="0" cellspacing="0" width="350" border="0"> <td width="5" bgcolor="#ff9a35" height="15"></td> <td width="300" bgcolor="#ff9a35" class="subline">ueberschrift</td> <td width="5" bgcolor="#ff9a35"></td> <td width="40" bgcolor="#ff9a35"><a href="#" class="subline">link</a></td> <td colspan="4" height="5" bgcolor="eaeaea"></td> <td bgcolor="eaeaea"></td> <td bgcolor="eaeaea" colspan="3">beschreibung</td> <td colspan="4" height="5" bgcolor="eaeaea"></td> <td colspan="4" height="10"></td> </table> <!--PRC:LISTROW--> Durch <!--PRC:LISTROW--> und die Dateiendung.row erkennt Weblication diese Datei als Zeilenvorlage. Bisher steht im Quelltext fest codiert Überschrift, Beschreibung und Link. Diese Worte sowie der Link auf die Seite sollen später durch die in der jeweiligen Seite hinterlegte Überschrift und Beschreibung dynamisch bei der Listenausgabe ersetzt werden. Seite 30 von 32
6. Um nun nicht die statischen Vorschauelemente, sondern die Angaben aus der Beschreibung (aus der documentxt) der Datei auszulesen und anzeigen zu lassen, ersetzen Sie nun die statischen Einträge für Überschrift, Beschreibung und den Link mit Hilfe des Tagswizards: Ersetzen Sie Ueberschrift durch Überschrift <!--PRC:HEADLINE--> Ersetzen Sie Beschreibung durch Beschreibung <!--PRC:DESCRIPTION--> und ersetzen Sie den Link <a href="#" class="subline">link</a> durch URL <a href="<!--prc:fileurl-->" class="subline">link</a> 7. Speichern Sie diese Datei. 8. Bearbeiten Sie in der Weblication Oberfläche die Listenoptionen der Datei listenseite.php. 9. Wählen Sie als Zeilenvorlage die Datei /wdeutsch/templates/list/zeile.row und speichern die Einstellungen. 10. Überprüfen Sie nun die Funktionsweise der Liste, indem Sie die Vorschau der Seite listenseite.php durchführen. Info: Eine komplette Auflistung und Beschreibung aller derzeit verfügbaren Zeilentemplate-Tags finden Sie unter http://whelp.weblication.de im Bereich Technische Referenz >Listen >Zeilenvorlage > Listentags Seite 31 von 32
e) Erstellung einer Listenvorlage (Für Classic und Enterprise, Light mit Dynamik-Modul) Die bisher erstellte Liste soll als Vorlage für weitere Listendateien verwendet werden. Dadurch kann ein Benutzer über die Oberfläche von Weblication CMS beliebige weitere Listen anlegen. Bitte führen Sie folgende Übung durch: 1. Wechseln Sie ins Verzeichnis /wdeutsch/aktuelles/news1/ und kopieren die Datei listenseite.php in die Zwischenablage von Weblication CMS. 2. Wechseln Sie ins Verzeichnis /wdeutsch/templates/list/ und fügen diese Seite hier wieder ein. 3. Benennen Sie diese Seite um in vorlage_liste.php. 4. Bearbeiten Sie diese Seite und verändern Überschrift und Beschreibung in den Beschreibungen. 5. Setzen Sie diese Seite in den Optionen auf offline. 6. Wechseln Sie ins Verzeichnis /wdeutsch/aktuelles/news1 und legen über den Button neue Liste eine neue Liste mit der Listenvorlage vorlage_liste.php an. Seite 32 von 32