Die drei Ansichten von DynPG: Unterschied zwischen den Versionen

Aus DynPG-Wiki
Wechseln zu: Navigation, Suche
 
K
 
(9 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
 
[[Category:Integration in eine Webseite]]
 
[[Category:Integration in eine Webseite]]
 +
{{Einführungsartikel}}
  
Im vorigen Kapitel konnten Sie sich davon überzeugen, wie einfach es ist mit DynPG zu einem ersten Resultat zu kommen. In dem Beispiel wurde nämlich die sogenannte Gruppenliste demonstriert. Insgesamt gibt es drei Ansichten:  
+
== Die Ansichten ==
 +
Bei der [[DynPG in eine Webseite einbinden|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:  
  
* Gruppenliste (nachfolgend '''''AG''''' genannt)
+
* die Gruppenliste: abgekürzt mit '''AG''' für ''all groups''
* Artikelliste ('''''AA''''')
+
* die Artikelliste: abgekürzt mit '''AA''' für ''all articles''
* Artikel-Detailansicht ('''''A''''')
+
* die Artikel-Detailansicht: abgekürzt mit '''A''' für ''article''
  
Die Gruppenlisten-Ansicht gibt einfach alle Gruppen(-namen) die in der Datenbank vorhanden sind aus. In der Artikellisten-Ansicht kann man sich die Artikel(-namen) einer bestimmten Gruppe anzeigen lassen und die Artikel-Detailansicht zeigt letztlich den Artikelinhalt eines bestimmten Artikels an. Alle drei Ansichten haben natürlich gewisse Parameter, die die Ausgabe beeinflussen und diesen Parametern und Aufrufen werden wir uns nach und nach widmen.  
+
Die ''Gruppenlisten-Ansicht'' gibt alle Gruppen aus, die in der Datenbank vorhanden sind. In der ''Artikellisten-Ansicht'' werden alle Artikel einer bestimmten Gruppe angezeigt. Die ''Artikel-Detailansicht'' zeigt letztlich den Artikelinhalt eines bestimmten Artikels an. Alle drei Ansichten haben Parameter, welche die Ausgabe beeinflussen. In diesem Artikel erfahren Sie zunächst, wie Sie die verschiedenen Ansichten erstellen.
  
Zur Veranschaulichung erweitern wir aber zuerst 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.  
+
Die drei Ansichten können Sie an einer beliebigen Stelle zwischen den <tt>body</tt> Tags einfügen.  
  
<code>[php,N]
+
== Erstellen einer Gruppenliste ==
<?php
+
Die Gruppenliste zeigt eine Übersicht aller Gruppen des Backends an. Wenn eine Gruppe weitere Untergruppen enthält, dann werden diese bei einem Klick auf die Gruppe angezeigt. Dabei können Sie Parameter setzen und so weitere Einstellungen vornehmen und zusätzliche Optionen ein oder ausblenden.
$DynPG->SetParam_AA_Anytime(false);
+
$DynPG->Write_AllArticles();
+
  
$DynPG->SetParam_A_Anytime(false);
+
Die Gruppenliste erstellen Sie durch folgenden PHP Code:
$DynPG->Write_Article();
+
<code>[php,Y]
 +
<?php
 +
  $GLOBALS["DynPG"]->SetParam_AG_Anytime(true);
 +
  $GLOBALS["DynPG"]->Write_AllGroups();
 
?>
 
?>
 
</code>
 
</code>
  
Nun wird nicht mehr nur eine starre Gruppenliste angezeigt! Es existiert jetzt eine komplette Navigation! (den vollständigen Code des Beispiels finden sie [http://www.dynpg.ch/doku/ch05s01s03.html#link.example.allviews_code hier])  
+
'''Erläuterung:'''
 +
*Zeile 2: <tt>$GLOBALS["DynPG"]->SetParam_AG_Anytime(true);</tt>
 +
:Dieser Parameter weist DynPG an, diese Gruppenliste ständig anzuzeigen und nicht nur dann, wenn dies durch den [[Der Navigationskontext|Navigationskontext]] vorgegeben ist (d.h. wenn ein Benutzer durch eine Gruppenliste oder andere Elemente mit dynamischen Gruppenlisten auf diese Seite gelangen).
 +
*Zeile 3: <tt>$GLOBALS["DynPG"]->Write_AllGroups();</tt>
 +
:Diese Methode erstellt die Gruppenliste.
  
Nun zur Erklärung der beiden vorangegangenen Beispiele. Was die einzelnen Funktionen genau tun werde ich hier nicht erörtern (das können Sie in der [http://www.dynpg.ch/doku/ch02s03.html#chapter.integration.referenz Funktionsreferenz] nachlesen), aber ich werde erklären wie sie zusammenspielen. Schauen wir zuerst den Aufruf
+
Weitere mögliche Parameter für die Gruppenliste können Sie der [[Funktionsreferenz#Gruppenlistenansicht|Funktionsreferenz (Gruppenliste)]] entnehmen.
  
<code>[php,N]
+
== Erstellen einer Artikelliste ==
$DynPG->SetParam_AG_Anytime(true);
+
</code>
+
  
aus Beispiel 1 (das Minimalbeispiel) an. 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
+
Dies ist die zweittiefste Anzeigestufe. Mit der Integration der Artikelliste wird eine Liste aller Artikel einer Gruppe angezeigt. Auch hier können Sie Parameter setzen und dadurch weitere Einstellungen vornehmen.
  
<code>[php,N]
+
Die Artikelliste erstellen Sie durch folgenden PHP Code:
$DynPG->Write_AllGroups();
+
<code>[php,Y]
 +
<?php
 +
  $GLOBALS["DynPG"]->SetParam_AA_Anytime(true);
 +
  $GLOBALS["DynPG"]->SetParam_AA_Group("Gruppenname");
 +
  $GLOBALS["DynPG"]->Write_AllArticles();
 +
?>
 
</code>
 
</code>
  
in eben genannter Weise beeinflusst.  
+
'''Erläuterung:'''
 +
*Zeile 2: <tt>$GLOBALS["DynPG"]->SetParam_AA_Anytime(true);</tt>
 +
:Dieser Parameter weist DynPG an, diese Artikelliste ständig anzuzeigen und nicht nur dann, wenn dies durch den [[Der Navigationskontext|Navigationskontext]] vorgegeben ist (d.h. wenn ein Benutzer durch eine Artikelliste oder andere Elemente mit dynamischen Artikellisten auf diese Seite gelangen).
 +
*Zeile 3: <tt>$GLOBALS["DynPG"]->SetParam_AA_Group("Gruppenname");</tt>
 +
: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: <tt>$GLOBALS["DynPG"]->Write_AllArticles();</tt>
 +
:Diese Methode erstellt die Artikelliste.
  
Im Beispiel 2 (komplette Navigation) funktioniert das alles analog, nur dass wir eben 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!
+
Weitere mögliche Parameter für die Artikelliste können Sie der [[Funktionsreferenz#Artikellistenansicht|Funktionsreferenz (Artikelliste)]] entnehmen.
  
[[Image:note.png]] '''Anmerkung''' Die Reihenfolge von "Write_AllGroups()", "Write_AllArticles()" und "Write_Article()" im Code ist beliebig!
+
== Erstellen einer Artikel-Detailansicht ==
  
Nun können Sie daran gehen die Ansicht von Beispiel 2 weiter zu beeinflussen, z.B. mit:
+
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.
  
<code>[php,N]
+
Die Artikel-Detailansicht erstellen Sie durch folgenden PHP Code:
$DynPG->SetParam_AG_ForceNav(false);
+
<code>[php,Y]
 +
<?php
 +
  $GLOBALS["DynPG"]->SetParam_A_Anytime(true);
 +
  $GLOBALS["DynPG"]->SetParam_A_Article(1);
 +
  $GLOBALS["DynPG"]->Write_Article();
 +
?>
 
</code>
 
</code>
  
Dadurch wird die "Zurück-Weiter-Navigation" abgeschaltet. Weitere nützliche Parameter-Funktionen finden Sie in der [http://www.dynpg.ch/doku/ch02s03.html#chapter.integration.referenz Funktionsreferenz].
+
'''Erläuterung:'''
 +
*Zeile 2: <tt>$GLOBALS["DynPG"]->SetParam_A_Anytime(true);</tt>
 +
:Dieser Parameter weist DynPG an, diesen Artikel ständig anzuzeigen und nicht nur dann, wenn dies durch den [[Der Navigationskontext|Navigationskontext]] 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: <tt>$GLOBALS["DynPG"]->SetParam_A_Article(1);</tt>
 +
:Hier können Sie angeben, welchen Artikel Sie anzeigen möchten. Geben Sie einfach die Artikelnummer an, 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: <tt>$GLOBALS["DynPG"]->Write_Article();</tt>
 +
:Diese Methode erstellt die Detailansicht des Artikels.
 +
 
 +
Weitere mögliche Parameter für die Artikel-Detailansicht können Sie der [[Funktionsreferenz#Artikel-Detailansicht|Funktionsreferenz (Artikel-Detailansicht)]] entnehmen.

Aktuelle Version vom 17. September 2011, 17:01 Uhr

Note.png 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 aus, die in der Datenbank vorhanden sind. In der Artikellisten-Ansicht werden alle Artikel einer bestimmten Gruppe angezeigt. Die Artikel-Detailansicht zeigt letztlich den Artikelinhalt eines bestimmten Artikels an. Alle drei Ansichten haben Parameter, welche die Ausgabe beeinflussen. In diesem Artikel erfahren Sie zunächst, wie Sie die verschiedenen Ansichten erstellen.

Die drei Ansichten können Sie an einer beliebigen Stelle zwischen den body Tags einfügen.

Erstellen einer Gruppenliste

Die Gruppenliste zeigt eine Übersicht aller Gruppen des Backends an. Wenn eine Gruppe weitere Untergruppen enthält, dann werden diese bei einem Klick auf die Gruppe angezeigt. Dabei können Sie Parameter setzen und so weitere Einstellungen vornehmen und zusätzliche Optionen ein oder ausblenden.

Die Gruppenliste erstellen Sie durch folgenden PHP Code:

  1. <?php
  2. $GLOBALS["DynPG"]->SetParam_AG_Anytime(true);
  3. $GLOBALS["DynPG"]->Write_AllGroups();
  4. ?>

Erläuterung:

  • Zeile 2: $GLOBALS["DynPG"]->SetParam_AG_Anytime(true);
Dieser Parameter weist DynPG an, diese Gruppenliste ständig anzuzeigen und nicht nur dann, wenn dies durch den Navigationskontext vorgegeben ist (d.h. wenn ein Benutzer durch eine Gruppenliste oder andere Elemente mit dynamischen Gruppenlisten auf diese Seite gelangen).
  • Zeile 3: $GLOBALS["DynPG"]->Write_AllGroups();
Diese Methode erstellt die Gruppenliste.

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

Erstellen einer Artikelliste

Dies ist die zweittiefste Anzeigestufe. Mit der Integration der Artikelliste wird eine Liste aller Artikel einer Gruppe angezeigt. Auch hier können Sie Parameter setzen und dadurch weitere Einstellungen vornehmen.

Die Artikelliste erstellen Sie durch folgenden PHP Code:

  1. <?php
  2. $GLOBALS["DynPG"]->SetParam_AA_Anytime(true);
  3. $GLOBALS["DynPG"]->SetParam_AA_Group("Gruppenname");
  4. $GLOBALS["DynPG"]->Write_AllArticles();
  5. ?>

Erläuterung:

  • Zeile 2: $GLOBALS["DynPG"]->SetParam_AA_Anytime(true);
Dieser Parameter weist DynPG an, diese Artikelliste ständig anzuzeigen und nicht nur dann, wenn dies durch den Navigationskontext vorgegeben ist (d.h. wenn ein Benutzer durch eine Artikelliste oder andere Elemente mit dynamischen Artikellisten auf diese Seite gelangen).
  • Zeile 3: $GLOBALS["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: $GLOBALS["DynPG"]->Write_AllArticles();
Diese Methode erstellt die Artikelliste.

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

Erstellen 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 erstellen Sie durch folgenden PHP Code:

  1. <?php
  2. $GLOBALS["DynPG"]->SetParam_A_Anytime(true);
  3. $GLOBALS["DynPG"]->SetParam_A_Article(1);
  4. $GLOBALS["DynPG"]->Write_Article();
  5. ?>

Erläuterung:

  • Zeile 2: $GLOBALS["DynPG"]->SetParam_A_Anytime(true);
Dieser Parameter weist DynPG an, diesen Artikel ständig anzuzeigen und nicht nur dann, wenn dies durch den Navigationskontext 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: $GLOBALS["DynPG"]->SetParam_A_Article(1);
Hier können Sie angeben, welchen Artikel Sie anzeigen möchten. Geben Sie einfach die Artikelnummer an, 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: $GLOBALS["DynPG"]->Write_Article();
Diese Methode erstellt die Detailansicht des Artikels.

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