Eine einfache Inhaltsübersicht

Aus DynPG-Wiki
Version vom 26. September 2011, 14:58 Uhr von Torsten (Diskussion | Beiträge)

(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Wechseln zu: Navigation, Suche

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

Im Artikel über die drei Ansichten von DynPG haben wir gesehen, wie wir eine Gruppenliste, Artikelliste und Artikeldetailansicht erstellen. In diesem Artikel wollen wir die drei Ansichten nun kombinieren, um eine einfache Navigation für den Inhalt zu erstellen.

Erstellen der Inhaltsübersicht

DynPG einbinden

Zuerst binden wir DynPG in unsere Webseite ein. Dazu schreiben wir and den Anfang der PHP-Datei folgende Zeilen und passen diese wie im Artikel zur Einbindung beschrieben an den Speicherort von DynPG an: 

<?php
  require('../dynpg/getcontent.php');
  $GLOBALS["DynPG"]->SetParam_PathToRoot('../dynpg/');
?>

Standard-CSS einbinden

Nun sollten wir die Standard-CSS Dateien von DynPG einbinden, um ein bereits fertig definiertes Layout für die Inhaltsansicht zu erhalten. Dazu fügen wir im <head>-Bereich der Webseite folgende Zeile ein. 

<head>
 
  <!-- ... -->
 
  <?php $GLOBALS["DynPG"]->Write_CSS_JS_Header(); ?>
</head>

Dieser Befehl bindet die CSS-Dateien von DynPG ein. Sie können sich natürlich später auch eigene Stylesheets definieren.

Inhaltsübersicht

Nun folgt das eigentliche Snippet für die Inhaltsübersicht, das Sie an einer beliebigen Stelle innerhalb der body Tags platzieren können: 

<body>
 
  <!-- ... -->
 
  <?php
    $GLOBALS["DynPG"]->SetParam_AG_Anytime(true);
    $GLOBALS["DynPG"]->Write_AllGroups();
    $GLOBALS["DynPG"]->SetParam_AA_Anytime(false);
    $GLOBALS["DynPG"]->Write_AllArticles();
    $GLOBALS["DynPG"]->SetParam_A_Anytime(false);
    $GLOBALS["DynPG"]->Write_Article();
  ?>
</body>

Die erste Anweisung bewirkt, dass die Gruppenliste immer angezeigt wird. Danach wird die Gruppenliste dann ausgegeben. Die dritte und fünfte Anweisung bewirken, dass die Artikelliste bzw. Artikel-Detailansicht abhängig vom Navigationskontext angezeigt werden. Das bedeutet, wenn in der Gruppenliste zu einer Gruppe navigiert wird, die Artikel enthält, so werden diese durch die Artikelliste angezeigt. In allen anderen Fällen gibt die Artikelliste nichts aus. Wird in der Artikelliste dann ein Artikel angeklickt, so wird dieser durch die Artikel-Detailansicht angezeigt. Andernfalls zeigt auch diese Ansicht nichts an. Durch dieses Prinzip haben wir nun eine einfache Inhaltsübersicht erzeugt, die alle im Backend erstellten Inhalte anzeigen kann.

Vollständiges Beispiel

Das vollständige Beispiel für die Inhaltsübersicht sieht nun aus, wie folgt: 

<?php
  require('../dynpg/getcontent.php');
  $GLOBALS["DynPG"]->SetParam_PathToRoot('../dynpg/');
?>
 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-US" lang="en-US">
 
<head>
  <title>Inhaltsübersicht</title>
  <meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
 
  <?php $GLOBALS["DynPG"]->Write_CSS_JS_Header(); ?>
</head>
 
<body>
  <h1>Inhaltsübersicht</h1>
 
  <?php
    $GLOBALS["DynPG"]->SetParam_AG_Anytime(true);
    $GLOBALS["DynPG"]->Write_AllGroups();
    $GLOBALS["DynPG"]->SetParam_AA_Anytime(false);
    $GLOBALS["DynPG"]->Write_AllArticles();
    $GLOBALS["DynPG"]->SetParam_A_Anytime(false);
    $GLOBALS["DynPG"]->Write_Article();
  ?>
</body>
 
</html>

Ausgabe im Browser

Im Browser sollten wir nun die vollständige Inhaltsübersicht sehen können. Diese Übersicht stellt bereits eine vollständige Navigation dar, mit der Sie sich durch alle Gruppen und Artikel klicken können.

Datei:Inhaltsübersicht.png

Einstellungen der Sichten ändern

Wir können nun etwas an den Einstellungen für die drei Ansichten von DynPG herumspielen, um zu demonstrieren, wie man die Sichten nach seinen Wünschen anpassen kann.

Funktionen zum Setzen von Parametern beginnen immer mit SetParam. Allgemein haben Sie den folgenden Aufbau:

SetParam_ANSICHT_PARAMETER(WERT)

wobei:

  • ANSICHT die betreffende Ansicht ist (AG - Gruppenliste, AA - Artikellsite oder A - Artikel).
  • PARAMETER der betreffende Parameter ist, welcher gesetzt wird.
  • WERT der neue Wert des Parameters ist.
Tip.png Tipp: Einstellungen für die Sichten müssen immer vor dem jeweiligen Write_ Befehl vorgenommen werden, da dieser die Sicht ausgibt und weitere Änderungen der Parameter sich nicht mehr auf die Ausgabe auswirken.

Für die Sichten setzen wir nun die folgenden Parameter: 

  1. <body>
  2.   <?php
  3.     // Gruppenliste
  4.     $GLOBALS["DynPG"]->SetParam_AG_Anytime(true);
  5.     $GLOBALS["DynPG"]->SetParam_AG_Order( Array( 'INDEX' ) );
  6.     $GLOBALS["DynPG"]->SetParam_AG_Sort( Array( 'ASC' ) );
  7.     $GLOBALS["DynPG"]->Write_AllGroups();
  8.  
  9.     // Artikelliste
  10.     $GLOBALS["DynPG"]->SetParam_AA_Anytime(false);
  11.     $GLOBALS["DynPG"]->SetParam_A_CategoryNavigation(false);
  12.     $GLOBALS["DynPG"]->Write_AllArticles();
  13.  
  14.     // Artikel-Detailansicht
  15.     $GLOBALS["DynPG"]->SetParam_A_Anytime(false);
  16.     $GLOBALS["DynPG"]->SetParam_A_LinkNavigation(true);
  17.     $GLOBALS["DynPG"]->SetParam_A_PdfNavigation(true);
  18.     $GLOBALS["DynPG"]->SetParam_A_PrintNavigation(true);
  19.     $GLOBALS["DynPG"]->SetParam_A_RecommendNavigation(true);
  20.     $GLOBALS["DynPG"]->SetParam_A_ArticleHeader(false);
  21.     $GLOBALS["DynPG"]->Write_Article();
  22.   ?>
  23. </body>

Erklärung

Gruppenliste

  • Zeile 5: legt fest, dass die Gruppen nach dem Sortierindex sortiert werden sollen
  • Zeile 6: legt fest, dass die Sortierung nach aufsteigendem Sortierindex geschehen soll


Artikelliste

  • Zeile 11: blendet die Kategorie-Navigation (Breadcrumb-Navigation) aus


Artikel-Detailansicht

  • Zeile 16: aktiviert den Button zur Anzeige des Links
  • Zeile 17: aktiviert den Button zur Konvertierung des Artikels in das PDF-Format
  • Zeile 18: aktiviert den Button zum Drucken des Artikels
  • Zeile 19: aktiviert den Button zum Weiterempfehlen des Artikels
  • Zeile 20: blendet den Artikel-Header (den Lead-Text und das Lead-Bild) aus
Tip.png Tipp: Eine Übersicht, welche die am häufigsten verwendeten Methoden zur Änderung von Parametern enthält, finden Sie in der Schnellreferenz zum Ausdrucken. Eine vollständige Liste finden Sie in der Funktionsreferenz.
Von „http://wiki-de.dynpg.org/wiki_de/index.php?title=Eine_einfache_Inhaltsübersicht&oldid=3396“