Die drei Ansichten von DynPG: Unterschied zwischen den Versionen

Version vom 9. Mai 2010, 12:04 Uhr

Die Ansichten

In einem ersten kleinen Beispiel konnten Sie sich davon überzeugen, wie einfach es ist mit DynPG zu einem ersten Resultat zu kommen. In dem Beispiel wurde die sogenannte Gruppenliste demonstriert. Insgesamt gibt es drei Ansichten:

• die Gruppenliste (abgekürzt mit AG)
• die Artikelliste (abgekürzt AA)
• die Artikel-Detailansicht (abgekürzt A)

Die Gruppenlisten-Ansicht gibt alle Gruppen(-namen) aus, die in der Datenbank vorhanden sind. In der Artikellisten-Ansicht kann man sich die Artikel(-namen) 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 uns nun nach und nach widmen.

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 können Sie der Funktionsreferenz entnehmen.

Integration einer Artikel-Liste

Dies ist die zweittiefste Anzeigestufe. Mit der Integration der Artikel-Liste 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 Artikel-Liste implementiert werden und direkt darunter die Detailansicht für den einzelnen Artikel. Auch hier können Sie Parameter setzen und dadurch weitere Einstellungen vornehmen.

Die Artikel-Liste 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("News");

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 "News" angezeigt werden.

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

Diese Methode erstellt die Artikel-Liste.

Nach dem Aufruf der Methode Write_AllArticles() müssen Sie nun die Einstellungen für die Detailansicht eines Artikels vornehmen. Diese sind natürlich identisch mit denen der #Integration einer Artikel-Detailansicht, deshalb werden Sie hier nicht noch mal erläutert. Am Ende muss wiederum die Methode Write_Article(); stehen. Eine Implementierung einer Artikel-Liste könnte also beispielsweise so Aussehen:

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

Weitere mögliche Parameter entnehmen Sie der Funktionsreferenz.

Integration einer Gruppen-Liste

Wie es der Name schon verrät, werden in der Gruppen-Liste alle Gruppen in einer Liste aufgereiht. 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. Auch hier 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.

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. Diese sind natürlich identisch mit denen der #Integration einer Artikel-Detailansicht und #Integration einer Artikel-Liste, deshalb werden Sie hier nicht noch mal erläutert. Am Ende der entsprechenden Ansicht muss wiederum die Methode Write_AllArticles(); bzw. Write_Article(); stehen.

Eine komplette Implementierung einer Gruppen-Liste könnte also beispielsweise so aussehen:

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

Weitere mögliche Parameter entnehmen Sie der Funktionsreferenz.

Weiterführung des Beispiels

Zur Veranschaulichung erweitern wir nun unser bestehendes Beispiel. Dieses wird um ein paar nette Funktionen verfeinert. Zusätzlich zur Gruppenliste sollen auch die Untergruppen bzw. die Artikel die in diesen Gruppen existieren, angezeigt werden. Damit sind wir dann bereits in der Lage durch unsere Gruppen zu navigieren und vorhandene Artikel darzustellen.

<?php
  $DynPG->SetParam_AA_Anytime(false);
  $DynPG->Write_AllArticles();
 
  $DynPG->SetParam_A_Anytime(false);
  $DynPG->Write_Article();
?>

Nun wird nicht mehr nur eine starre Gruppenliste angezeigt. Es existiert jetzt eine komplette Navigation. (den vollständigen Code des Beispiels finden sie hier)

Erläuterungen

Nun zur Erklärung der beiden vorangegangenen Beispiele. Was die einzelnen Funktionen genau tun werden wir hier nicht erörtern (siehe dazu:Funktionsreferenz), aber wir werden uns damit befassen, wie sie zusammenspielen. Schauen wir zuerst den Aufruf aus Beispiel 1 (das Minimalbeispiel) an.

$DynPG->SetParam_AG_Anytime(true);

Der Präfix "SetParam" kündigt schon an, dass hierbei ein Parameter gesetzt wird. Es gibt mehrere solcher Funktionen. "AG" (wie schon aus obiger Tabelle bekannt) steht für die Gruppenlisten-Ansicht. Die Funktion bewirkt, dass die Gruppenliste von Anfang an (beim Aufruf der Seite) angezeigt wird 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 gelangt). Würden wir der Funktion das Argument "false" übergeben, so wäre dies folglich nicht der Fall. Nun wurde also ein Parameter gesetzt der die folgende Funktion

$DynPG->Write_AllGroups();

in eben genannter Weise beeinflusst.

Im Beispiel 2 (komplette Navigation) funktioniert das analog, nur dass wir die Parameter- und Ausgabefunktionen auch für die Artikellistenansicht (AA) und die Artikel-Detailansicht (A) aufrufen. Es fällt allerdings auf, dass bei den "SetParam"-Funktionen als Argument "false" übergeben wird. Dies ist nötig, denn wir wollen die Artikellisten und Artikel die sich in einer Gruppe befinden ja nur dann ausgeben, wenn der Kontext es vorgibt (also dann wenn der Nutzer auf die Gruppe geklickt hat) und nicht von Anfang an.

Anmerkung Die Reihenfolge von Write_AllGroups(), Write_AllArticles() und Write_Article() im Code ist beliebig.

Nun können Sie daran gehen die Ansicht von Beispiel 2 weiter zu beeinflussen, z.B. mit:

$DynPG->SetParam_AG_ForceNav(false);

Dadurch wird die "Zurück-Weiter-Navigation" abgeschaltet. Weitere nützliche Parameter-Funktionen finden Sie in der Funktionsreferenz.