Die drei Ansichten von DynPG

Dieser Artikel ist Teil einer Reihe von Einführungsartikeln zu DynPG

Webseiten erstellen mit DynPG | DynPG in eine Webseite einbinden | Die drei Ansichten von DynPG | Eine einfache Inhaltsübersicht | Dynamisches Navigationmenü ... | CSS | Templates

zurück zu Kategorie:Integration in eine Webseite

Die Ansichten

Bei der Einbindung von DynPG in eine Webseite haben Sie bereits sehen können, wie einfach man mit DynPG eine Liste der Gruppen im Backend anzeigen lassen kann. In dem Beispiel wurde die sogenannte Gruppenliste demonstriert. Insgesamt gibt es drei Ansichten:

• die Gruppenliste: abgekürzt mit AG für all groups
• die Artikelliste: abgekürzt mit AA für all articles
• die Artikel-Detailansicht: abgekürzt mit A für article

Die Gruppenlisten-Ansicht gibt alle Gruppen(-namen) aus, die in der Datenbank vorhanden sind. In der Artikellisten-Ansicht kann man sich die Artikel einer bestimmten Gruppe anzeigen lassen. Die Artikel-Detailansicht zeigt letztlich den Artikelinhalt eines bestimmten Artikels an. Alle drei Ansichten haben Parameter, die die Ausgabe beeinflussen. Diesen Parametern und Aufrufen werden wir nun nach und nach vorstellen.

Integration einer Gruppenliste

Wie es der Name bereits vermuten lässt, werden in der Gruppenliste alle Gruppen in einer Liste dargestellt. Bei einem Klick auf eine der Gruppen, wird von dieser eine Artikel-Liste angezeigt oder wenn weitere Untergruppen bestehen eine Gruppen-Liste der Untergruppen. Von der Artikel-Liste gelangt man mittels Link zu der Detailansicht. Deshalb muss zuerst eine Gruppen-Liste, dann eine Artikel-Liste und zuletzt die Detailansicht eines Artikels implementiert werden. Dabei können Sie Parameter setzen und so weitere Einstellungen vornehmen und zusätzliche Optionen ein oder ausblenden.

Die Gruppen-Liste implementieren Sie durch folgenden PHP Code:

<?php
  $DynPG->SetParam_AG_Anytime(true);
  $DynPG->Write_AllGroups();
?>

Erläuterung:

• Zeile 3: $DynPG->Write_AllGroups();

Diese Methode erstellt die Gruppen-Liste.

Weitere mögliche Parameter für die Gruppenliste können Sie der Funktionsreferenz entnehmen. Nach dem Aufruf der Methode Write_AllGroups() müssen Sie nun die Einstellungen für die Artikel-Liste und danach die Einstellungen für die Detaiansicht eines Artikels vornehmen.

Integration einer Artikelliste

Dies ist die zweittiefste Anzeigestufe. Mit der Integration der Artikelliste wird eine Liste aller Artikel einer Gruppe angezeigt. Bei einem Klick auf einen der Artikel, wird dieser in der Detailansicht angezeigt. Deshalb muss zuerst eine Artikelliste implementiert werden und darunter die Detailansicht für den einzelnen Artikel. Auch hier können Sie Parameter setzen und dadurch weitere Einstellungen vornehmen.

Die Artikelliste implementieren Sie durch folgenden PHP Code (muss innerhalb des "body"-Tags stehen):

<?php
  $DynPG->SetParam_AA_Anytime(true);
  $DynPG->SetParam_AA_Group("Gruppenname");
  $DynPG->Write_AllArticles();
?>

Erläuterung:

• Zeile 2: $DynPG->SetParam_AA_Anytime(true);

Dieser Parameter weist DynPG an, diese Artikelliste ständig anzuzeigen und nicht nur dann, wenn dies durch den Kontext vorgegeben ist (d.h. wenn ein Benutzer durch eine Artikelliste oder andere Elemente mit dynamischen Artikellisten auf diese Seite gelangen).

• Zeile 3: $DynPG->SetParam_AA_Group("Gruppenname");

Geben Sie hier den Namen der Gruppe an, von der Sie eine Artikel-Listenansicht angezeigt haben wollen. In diesem Beispiel würde eine Liste der Artikel in der Gruppe "Gruppenname" angezeigt werden.

• Zeile 4: $DynPG->Write_AllArticles();

Diese Methode erstellt die Artikel-Liste.

Weitere mögliche Parameter für die Artikelliste können Sie der Funktionsreferenz entnehmen.

Integration einer Artikel-Detailansicht

Dies ist die detaillierteste Anzeigestufe. Mit der Integration eines einzelnen Artikels wird ein bestimmter Artikel in der Detailansicht angezeigt. Durch diverse Parameterangaben können Sie weitere Einstellungen vornehmen.

Die Artikel-Detailansicht implementieren Sie durch folgenden PHP Code:

<?php
  $DynPG->SetParam_A_Anytime(true);
  $DynPG->SetParam_A_Article(1);
  $DynPG->Write_Article();
?>

Erläuterung:

• Zeile 2: $DynPG->SetParam_A_Anytime(true);

Dieser Parameter weist DynPG an, diesen Artikel ständig anzuzeigen und nicht nur dann, wenn dies durch den Kontext vorgegeben ist, d.h. wenn ein Benutzer durch eine Artikelliste oder andere Elemente mit dynamischen Artikellisten auf diese Seite gelangen. Wenn Sie einen Artikel einzeln anzeigen, muss dieser Parameter stets auf true gesetzt sein.

• Zeile 3: $DynPG->SetParam_A_Article(19);

Hier können Sie angeben, welchen Artikel Sie anzeigen möchten. Schreiben Sie einfach die Artikelnummer, die automatisch von DynPG zugewiesen wurde, als Sie den Artikel erstellt haben. Diese können Sie im Backend einsehen. In der Artikelauflistung finden Sie dort eine Spalte, welche die jeweilige ID anzeigt.

• Zeile 4: $DynPG->Write_Article();

Diese Methode erstellt die Detailansicht des Artikels. Sie muss zwingend der letzte Aufruf auf dieser Ebene sein.

Weitere mögliche Parameter für die Artikel-Detailansicht können Sie der Funktionsreferenz entnehmen.