Dokumentation Categorywalker

Aus DeDi-Help

(Unterschied zwischen Versionen)

Wechseln zu: Navigation, Suche

Version vom 19:57, 19. Aug. 2004

Von „https://help.der-dirigent.de/index.php?title=Dokumentation_Categorywalker“

 === Ziel des Moduls ===
-Der Categorywalker bringt zwar eine Menge an Funktionalit�t, mit die auch in anderen Modulen vorliegen,
+Der Categorywalker bringt zwar eine Menge an Funktionalit�t, mit die auch in anderen Modulen vorliegen, doch ist es nicht Sinn dieses Moduls sich Spezialisiert auf eine Funktion (z.B.: NewsTeaser) zu beschr�nken.
-doch ist es nicht Sinn dieses Moduls sich Spezialisiert auf eine Funktion (z.B.: NewsTeaser)
-zu beschr�nken.
+Vielmehr soll der Umfang und die M�glichkeiten des Categorywalker dazu dienen Aufgaben zu bew�ltigen, mit anderen Modulen nur schwer oder nicht vollst�ndig (weil zu Spezialisiert) umgesetzt werden k�nnen.
-Vielmehr soll der Umfang und die M�glichkeiten des Categorywalker dazu dienen Aufgaben zu bew�ltigen, mit anderen Modulen nur schwer oder nicht vollst�ndig (weil zu Spezialisiert)
-umgesetzt werden k�nnen.
 === G�ltigkeit dieser Dukumentation ===
 Diese Dokumentation gilt ab Version 0.64 bis 0.7, alle anderen Versionen werden nicht Supportet!
 Alle �nderungen seit Version 0.6 sind ber�cksichtigt und in diese Dokumentation eingeflossen.
 F�r die Light-Version gibt es eine kleinere angepasste Dokumentation, da dort nicht alle Features
 Enthalten sind. In der Dokumentation verwendete Abk�rzungen wie z.B.: 2.2 oder 4.2.2 beziehen sich auf
 === Standart Installation als XML-Modul ===
 Standart Installation als XML-Modul:
 Voraussetzung ist hierbei das Sie das Modul vom DeDi-Modul Repository heruntergeladen haben.
-Nach der Anmeldung im Backend, �ffnen Sie �ber Design->Module die 'Modul' �bersichtsseite.
-Klicken Sie auf die Schaltfl�che Durchsuchen..., in dem unteren Bereich der Seite 'Modul uploaden'.
+Nach der Anmeldung im Backend, �ffnen Sie �ber '''Design->Module''' die 'Modul' �bersichtsseite.
-W�hlen Sie nun in dem sich �ffnenden 'Datei ausw�hlen' � Fenster
-das Modul 'Categorywalker.dedimod' aus.
+Klicken Sie auf die Schaltfl�che '''Durchsuchen...''', in dem unteren Bereich der Seite 'Modul uploaden'.
+W�hlen Sie nun in dem sich �ffnenden 'Datei ausw�hlen' � Fenster das Modul 'Categorywalker.dedimod' aus.
 Best�tigen Sie die Auswahl mit Klick auf '�ffnen' und starten den Upload mit Klick auf die Schaltfl�che 'Modul uploaden' (Diskettensymbol, rechts).
 Bei erfolgreichem Upload, wird das neue Modul sofort in der Modul�bersicht angezeigt.
 Sie k�nnen nun in einem Template das neue Modul einstellen.
 === Installation als Developer-Modul ===
 Installation als Developer-Modul:
 Voraussetzung ist wie bei 2.2, oder das Sie das Modul aus dem Entwicklerforum kopiert haben.
-Nach der Anmeldung im Backend, �ffnen Sie �ber Design->Module die Modul�bersichtsseite.
-Klicken Sie auf neues Modul, es �ffnet sich die 'Modul bearbeiten' Seite.
+Nach der Anmeldung im Backend, �ffnen Sie �ber '''Design->Module''' die Modul�bersichtsseite.
-Hier f�gen Sie den Code in die entsprechenden Felder ein. Zur besseren �bersicht geben Sie dem Versionsnamen eine Unterzahl (z.B.: 0.6y.x-dev)
-und benennen die Kategorie 'Develope'.
+Klicken Sie auf '''neues Modul''', es �ffnet sich die 'Modul bearbeiten' Seite.
+Hier f�gen Sie den Code in die entsprechenden Felder ein. Zur besseren �bersicht geben Sie dem Versionsnamen eine Unterzahl (z.B.: 0.6y.x-dev) und benennen die Kategorie 'Develope'.
 Speichern Sie das Modul. Das neue Modul wird sofort in der Modul�bersicht angezeigt.
 Sie k�nnen nun in einem Template das neue Modul einstellen.
 Achtung: Developer-Module erzeugen einen Warnhinweis im Backend bei der Einbindung
 des Moduls in ein Template!
 DIES IST EINE ENTWICKLERVERSION. SIE IST NICHT F�R DEN PRODUKTIVEN EINSATZ GEEIGNET !!!
 === Allgemeines ===
-Der Categorywalker durchsucht die Datenbank. �ber die Angabe von Container, Startoptionen
+Der Categorywalker durchsucht die Datenbank. �ber die Angabe von Container, Startoptionen (Startseite, On-/Offline) und Suchmuster (4.3) kann man die Suche eingrenzen und komfortabel das Suchergebnis beeinflussen.
-(Startseite, On-/Offline) und Suchmuster (4.3) kann man die Suche eingrenzen und komfortabel
-das Suchergebnis beeinflussen.
 Die Ausgabe erfolgt �ber 4 Templates, die einzeln definiert werden k�nnen.
-Zus�tzlich generiert der Categorywalker eine zusammenh�ngende Navigation die es bequem macht
-das Ergebnis auf mehrere Seiten aufzuteilen (Galery). Die Navigation kann optional �floaten� das hei�t
+Zus�tzlich generiert der Categorywalker eine zusammenh�ngende Navigation die es bequem macht das Ergebnis auf mehrere Seiten aufzuteilen (Galery). Die Navigation kann optional �floaten� das hei�t die Anzeige der Navigation wird auf z.B.: maximal 20 Navigationspunkte begrenzt und die Nummerierung wandert in einem Bereich Rechts und Links um die aktuelle Seite mit.
-die Anzeige der Navigation wird auf z.B.: maximal 20 Navigationspunkte begrenzt und die Nummerierung
-wandert in einem Bereich Rechts und Links um die aktuelle Seite mit.
 === Templates ===
 Die Templates werden wie normales Html behandelt (also sind Html-Tags erlaubt).
 Es gibt ein 'Top-Artikel' Template welches separat angesprochen werden kann um einen Artikel auf der Startseite hervorzuheben.
 Die beiden 'Content1' und 'Conten2' Templates wiederum wiederholen in einer Schleife jeweils die gegebene Anzahl von Artikel/Suchergebnissen und das v�llig unabh�ngig voneinander.
-Das letzte Template 'Merge' ist f�r den Gesamtaufbau der Anzeige verantwortlich,
+Das letzte Template 'Merge' ist f�r den Gesamtaufbau der Anzeige verantwortlich, hier werden die anderen 3 Templates zu einer Seite zusammengef�gt.
-hier werden die anderen 3 Templates zu einer Seite zusammengef�gt.
 Innerhalb dieser Templates sind auch einige Scripttags erlaubt die eine genaue Positionierung und Wiederholung von Content-Variablen erlauben.
-Die Scripttags werden in 4.2.1 erl�utert.
+Die Scripttags werden in 4.2 unter 'ScriptTags' erl�utert.
 * Verbindungs Template, das Verbindungs Template (Merge) verbindet die anderen Templates zu einer einheitlichen Ausgabe.
 * Anchors, das sind Anker im Html-Code.
 === Templates ===
 Templates k�nnen nur einzelne Variablen oder auch ganze Html-Seiten (Vorlagen) enthalten.
 Die Ausgabe von Variablen wird �ber die Scripttags gesteuert. Dabei lassen diese Tags Verschachtelung und Abh�ngigkeiten zu, um auch die verschiedensten Inhalte Korrekt darzustellen.
 '''ScriptTags'''
 Die Scripttags Legende:
 * {text}, ist der 1. text-Typ in einem Content
 * {file_target:x}, -> siehe {img_desc:x}
 * {url_to_articel}, ist der interne Link zu dem gefundenen Content/Artikel
-* {exist yyy[:x]}/{/exist}, ein Konstrukt das ein Variabelenabfrage f�r yyy:x (wobei :x optional ist!) ausf�hrt  und nur bei Vorhandensein der innere Code (Html/Script) ausgef�hrt wird. Man kann somit im Template sicherstellen das ein Layout wie im Beispiel:
+* {exist yyy[:x]}/{/exist}, ein Konstrukt das ein Variabelenabfrage f�r yyy:x (wobei :x optional ist!) ausf�hrt und nur bei Vorhandensein der innere Code (Html/Script) ausgef�hrt wird. Man kann somit im Template sicherstellen das ein Layout wie im Beispiel: <br /><nowiki>{exist text:3}<b>{text:3}</b><br>{/exist} </nowiki><br />nicht ausgef�hrt wird, wenn die Variable nicht existiert oder leer ist.
-** {exist text:3}<b>{text:3}</b><br>{/exist}
+* {loop yyy}/{/loop}, ein Konstrukt das eine Schleife um den Contenttype yyy (ohne :x) ausf�hrt, man kann somit im Template ein Layout wie im Beispiel: <br /><nowiki><ul>{loop text}<li><b>{text}</b></li>{/loop}</ul> </nowiki><br />mehrfach durchlaufen und alle Inhalte von z.B.: {text} (text:1, text:2, text:3 usw.) werden wiedergeben.
-** nicht ausgef�hrt wird, wenn die Variable nicht existiert oder leer ist.
-* {loop yyy}/{/loop}, ein Konstrukt das eine Schleife um den Contenttype yyy (ohne :x) ausf�hrt, man kann somit im Template ein Layout wie im Beispiel:
-<ul>{loop text}<li><b>{text}</b></li>{/loop}</ul>
-mehrfach durchlaufen und alle Inhalte von z.B.: {text} (text:1, text:2, text:3 usw.) werden wiedergeben.
 * {each xxx}, ist eine vereinfachte Form von {loop xxx}{xxx}{/loop}
 * Cuttexte, das Attribut [cut:xy] ist eine optionale Einstellung (ohne die eckigen [...] Klammern) um den Text auf xy Zeichen zu k�rzen! z.B.: {text:1 cut:100} - Damit kann man Teaser erzeugen die 100 Zeichen lang sind Minus das Letzte (�berh�ngige) Wort aus dem erstem Textfeld einer Seite.
 ''Beispiel1:''
- - das Beispiel gibt immer den ersten gefundenen text-Typ + textarea:1 aus, und nur wenn vorhanden auch text:2 + textarea:1  und text:3 + textarea:1 inklusive der umfassenden <b>...</b><br> Tags
+<nowiki>das Beispiel gibt immer den ersten gefundenen text-Typ + textarea:1 aus, und nur wenn vorhanden auch text:2 + textarea:1  und text:3 + textarea:1 inklusive der umfassenden <b>...</b><br> Tags</nowiki>
- <b>{text}{textarea:1}</b><br>
+ <nowiki><b>{text}{textarea:1}</b><br></nowiki>
  {exist text:2}
- <b>{text:2}{textarea:1}</b><br>
+ <nowiki><b>{text:2}{textarea:1}</b><br></nowiki>
  {/exist}
  {exist text:3}
- <b>{text:3}{textarea:1}</b><br>
+ <nowiki><b>{text:3}{textarea:1}</b><br></nowiki>
  {/exist}
 ''Beispiel2:''
- - das Beispiel zeigt den Aufbau einer Liste mit Artikel-Teasern + Bild
+das Beispiel zeigt den Aufbau einer Liste mit Artikel-Teasern + Bild
- <ul>
+ <nowiki><ul></nowiki>
  {loop text}
- <li><b>{img}{text}</b></li>
+ <nowiki><li><b>{img}{text}</b></li></nowiki>
  {/loop}
- </ul>
+ <nowiki></ul></nowiki>
 === Suchmuster===
-Der Categorywalker kann als Newsgrabber, DokuWeb, Redaktionstool oder Galery eingesetzt werden. Sicherlich gibt es noch viele andere M�glichkeiten, das auszuprobieren ist ja Ihr Job ;)
+Der Categorywalker kann als Newsgrabber, DokuWeb, Redaktionstool oder Galery eingesetzt werden.
+Sicherlich gibt es noch viele andere M�glichkeiten, das auszuprobieren ist ja Ihr Job ;)
 Weitere, ausf�hrliche Beispiele siehe Anhang A.
 Der Categorywalker wird noch einige Updates erfahren, welcher Art k�nnen Sie der Doku entnehmen.
 Die v0.64.4 ist die aktuelle Stabel-Version, bis zur v0.7 werden zumindest einige Code Optimierungen durchgef�hrt. Bis zur DeDi 1.0 wird die Version 0.8 released.

Dokumentation Categorywalker

Aus DeDi-Help

Version vom 19:57, 19. Aug. 2004

Ansichten

Persönliche Werkzeuge

Navigation

Suche

Werkzeuge