Implementation eines kompletten Hauptmenüs: Unterschied zwischen den Versionen

Aus DynPG-Wiki
Wechseln zu: Navigation, Suche
K
(→‎Erstellen des Navigationsmenüs: Infobox-Templates eingefügt)
 
(19 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
 
[[Kategorie:Integration in eine Webseite]]
 
[[Kategorie:Integration in eine Webseite]]
−
{{Einführungsartikel}}
+
{{Dynamische Navigation}}
−
== Einleitung ==
+
 
−
In den vorangegangenen Kapiteln haben Sie gelernt wie man DynPG in seine Seite integriert und es entsprechend anpasst. Ausgerüstet mit diesem Wissen wollen wir uns nun an eine wichtige Aufgabe machen: Die Erstellung eines '''''Seitenhauptmenüs'''''. Fangen wir also an. Als erstes benötigen wir eine leere '''''index.php''''', d.h. nicht ganz leer, sie enthält natürlich das Html-Grundgerüst. Außerdem erstellen wir uns eine CSS-Datei namens '''''style.css''''' mit der unser Menü optisch auf Vordermann gebracht werden soll. Das Grundgerüst könnte wie folgt aussehen:  
+
In diesem Artikel werden wir eine Webseite mit einem ''dynamischen Navigationsmenü'' und einer Inhaltsanzeige erstellen.
−
<code>[php,N]
+
 
 +
== Das Grundgerüst ==
 +
Als erstes benötigen wir eine neue Datei <tt>index.php</tt> mit einem HTML-Grundgerüst. Außerdem erstellen wir eine CSS-Datei namens <tt>style.css</tt> mit der wir das Aussehen des Menüs anpassen werden. Das Grundgerüst, in dem wir zunächst erst einmal nur [[DynPG in eine Webseite einbinden|DynPG einbinden]], könnte wie folgt aussehen:  
 +
<code>[html,N]
 
<?php
 
<?php
−
   require 'cms/getcontent.php'; //DynPG-Funktionalität einbinden
+
   require '../dynpg/getcontent.php';                   //DynPG-Funktionalität einbinden
−
   $DynPG->SetParam_PathToRoot('cms/'); //DynPG-Pfad setzen
+
   $GLOBALS["DynPG"]->SetParam_PathToRoot('../dynpg/'); //DynPG-Pfad setzen
 
?>
 
?>
−
 
+
 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 
<!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">
 
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-US" lang="en-US">
−
  <head>
+
<head>
−
    <title>Hauptmenue-Tutorial</title>
+
  <title>Seite mit dynamischen Navigationsmenü</title>
−
    <meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
+
  <meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
−
    <?php $DynPG->Write_CSS_JS_Header(); ?>  <!--Standard-Css von DynPG einbinden-->
+
−
    <link rel="stylesheet" type="text/css" href="style.css" />  <!--eigene style.css einbinden-->
+
−
  </head>
+
−
  <body>
+
−
    <h1>Hauptmenue-Tutorial</h1>
+
−
    <table  border="0">
+
−
      <tr valign="top">
+
−
      <th align="left" style="width:230px" id="hauptmenue">
+
−
      <div style="border: 3px black solid">
+
−
      <?php
+
−
        //hier soll das Hauptmenü hin
+
−
      ?>
+
−
      </div>
+
−
      </th>
+
−
      <th id="anzeige">
+
−
      <div style="border: 3px black solid">
+
−
      <?php
+
−
        //hier sollen die anzuzeigenden Artikel und Gruppen hin
+
−
      ?>
+
−
      </div>
+
−
      </th>
+
−
      </tr>
+
−
    </table>
+
−
  </body>
+
−
</html>
+
−
</code>
+
  
−
In den Spalten '''''hauptmenue''''' und '''''anzeige''''' sollen das Hauptmenü bzw. die eigentlichen Artikel, Artikellisten und Gruppenlisten angezeigt werden. Bevor wir nun den eigentlichen Code schreiben, müssen wir in das DynPG Backend und einen Artikel erstellen, nämlich den Artikel der das Hauptmenü tragen soll. Ja richtig, das Hauptmenü ist nämlich auch ein Artikel, nur eben ein etwas spezieller! Loggen Sie sich mit ihrem Account in das DynPG-Backend ein und gehen Sie in die Sektion '''''Artikelbezogene Texte'''''. Nun haben Sie schon einen neuen Artikeltext vor sich und müssen nur noch auf das '''''Dynamisches Menü einfügen''''' - Symbol über dem Textfeld klicken und just in diesem Moment müsste eine blaue Grafik mit der Bezeichnung "dynamisches Menü" im Textfeld erscheinen. Nun, das war es auch schon fast, drücken Sie nun den Knopf '''''Erstellen'''''.
+
  <link rel="stylesheet" type="text/css" href="style.css" />  <!--eigene style.css einbinden-->
 +
</head>
 +
 
 +
<body>
 +
  <h1>Seite mit dynamischen Navigationsmenü</h1>
  
−
[[Image:create_article.jpg|thumb|Abbildung 2.3. Artikel für das Hauptmenü erstellen]]
+
  <div id="navigation">
−
 
+
    <!-- hier kommt die dynamische Navigation hin -->
−
Der Hauptmenü-Artikel müsste nun darunter in der Liste '''''"Texte / Text-Gruppen"''''' angezeigt werden. Schauen Sie wo er sich dort befindet und merken Sie sich die '''''ID'''''. Mit der werden wir den Artikel nämlich jetzt anzeigen lassen. Gehen wir also wieder in unsere "index.php" und fügen in der '''''Spalte hauptmenue''''' folgendes ein:
+
  </div>
−
{{-}}
+
   
−
<code>[php,Y]
+
   <div id="inhalt">
−
<?php
+
    <!-- hier kommt die Inhaltsanzeige hin -->
−
   //nur anzeigen, wenn es der Kontext (also Position im Menü) vorgibt!
+
   </div>
−
  $DynPG->SetParam_A_Anytime(true);
+
</body>
−
   $DynPG->SetParam_A_Article(15);
+
</html>
−
  $DynPG->Write_Article();
+
−
?>
+
 
</code>
 
</code>
  
−
Was genau passiert da? Nun in der 1. Zeile sagen wir DynPG, dass es den folgenden Artikel immer anzeigen soll, kontextunabhängig also. Das macht auch Sinn, denn es handelt sich hier schließlich um unser Hauptmenü und das ist sozusagen omni-präsent. Bei mir wurde dem Menü-Artikel die ID 15 zugewiesen, deshalb verwende ich beim Setzen des Artikels in Zeile 2 auch diese Nummer. Mit Zeile 3 wird dann das Menü angezeigt.  
+
In den Spalten <tt>navigation</tt> und <tt>inhalt</tt> sollen das Hauptmenü bzw. die eigentlichen Artikel, Artikellisten und Gruppenlisten angezeigt werden.  
  
−
Nun müssen wir uns noch um die anzuzeigenden Artikel kümmern die man über das Menü erreichen kann, dazu fügen wir in der '''''Spalte anzeige''''' folgendes ein:  
+
== Erstellen des Navigationsmenüs ==
 +
Bevor wir nun den eigentlichen Code schreiben, müssen wir in das DynPG Backend und einen Artikel erstellen, der die dynamische Navigation enthält. Die Schritte hierzu können Sie ggf. im Artikel zum [[DynPG Module einbinden|Einbinden von DynPG Modulen]] nachlesen. Navigieren Sie im Backend zu diesem Artikel und merken Sie sich die ''ID''. Diese werden wir im folgenden Snippet brauchen. Gehen wir also wieder in unsere <tt>index.php</tt> und fügen im div <tt>navigation</tt> folgendes ein:  
  
−
<code>[php,Y]
+
<code>[php,N]
−
<?php
+
<div id="navigation">
−
   //nur anzeigen, wenn es der Kontext (also Position im Menü) vorgibt!
+
  <?php
−
   $DynPG->SetParam_A_Anytime(false);
+
   $GLOBALS["DynPG"]->SetParam_A_Anytime(true);            // dynamische Navigation immer anzeigen
−
   $DynPG->SetParam_AA_Maxview(10); //Maximal zehn Einträge in Artikellisten
+
  $GLOBALS["DynPG"]->SetParam_A_Article(1);                // Artikelnummer der dynamischen Navigation
−
   $DynPG->Write_AllArticles();
+
   $GLOBALS["DynPG"]->SetParam_A_ArticleHeader(false);     // Artikelkopf (Titel, Lead-Bild und Lead-Text) ausblenden
−
   $DynPG->Write_Article();
+
   $GLOBALS["DynPG"]->SetParam_A_CategoryNavigation(false); // Kategorienavigation (Gruppe > Untergruppe > Artikel) ausblenden
−
?>
+
   $GLOBALS["DynPG"]->SetParam_A_PrintNavigation(false);   // Drucken-Link ausblenden
 +
   $GLOBALS["DynPG"]->Write_Article();                     // dynamische Navigation ausgeben
 +
  ?>
 +
</div>
 
</code>
 
</code>
  
−
Zeile 1 funktioniert analog zu obigem Code. Die Zeilen 3 und 4 bewirken, dass sowohl Artikellisten (wenn im Menü auf eine Gruppe geklickt wird) als auch einzelne Artikel (wenn auf einen Artikel geklickt wird) angezeigt werden. Zeile 2 gibt an wie lang die Artikellisten sein dürfen, bevor sie der Übersicht halber auf mehreren Seiten (mit Navigation) dargestellt werden.  
+
{{Caution
 +
|Sie müssen in Zeile 2 den Parameterwert durch die ID des Artikels ersetzen, der die dynamische Navigation enthält.}}
  
−
Für das Beispiel werden wir die style.css wie folgt füllen:
+
In der ersten Zeile weisen wir DynPG an, dass der folgenden Artikel immer angezeigt werden soll, da es sich sich um das Navigationsmenü der Webseite handelt. In der zweiten Zeile muss <tt>ID</tt> durch die ID des Artikels ersetzt werden, der die dynamische Navigation enthält. Die folgenden Zeilen verändern die Ansicht so, dass wirklich nur die Navigation angezeigt wird und sonst nichts.
  
−
<code>[css,N]
+
== Erstellen der Inhaltsanzeige ==
−
/*alle Links schwarz*/
+
Nun müssen wir uns noch um die Darstellung der Listen und Artikel kümmern. Dazu fügen wir in der Spalte <tt>inhalt</tt> folgendes ein:  
−
a{color: black;}
+
  
−
#hauptmenu p{
+
<code>[php,N]
−
text-align: left;
+
<div id="inhalt">
−
}
+
  <?php
−
 
+
  $GLOBALS["DynPG"]->Write_AllGroups();        // Gruppenlisten-Ansicht ausgeben (standardmäßig abhängig vom Navigationskontext)
−
/*Navigation, Print-Button und Artikelheader unsichtbar machen*/
+
  $GLOBALS["DynPG"]->SetParam_AA_Maxview(10);   // Maximal zehn Einträge in Artikellisten anzeigen
−
#dynpg_A_breadcrumb{display: none;}
+
  $GLOBALS["DynPG"]->Write_AllArticles();       // Artikelliste-Ansicht ausgeben (standardmäßig abhängig vom Navigationskontext)
−
+
  $GLOBALS["DynPG"]->SetParam_A_Anytime(false); // Parameter wieder auf false setzen (wurde bei der Navigation auf true gesetzt)
−
#dynpg_AA_breadcrumb_navi{display: none;}
+
  $GLOBALS["DynPG"]->Write_Article();           // Artikel-Detailansicht ausgeben
−
#dynpg_AA_breadcrumb_pages{display: none;}
+
  ?>
−
 
+
</div>
−
#dynpg_A_btnprint{display: none;}
+
−
 
+
−
#dynpg_A_header{display: none;}
+
 
</code>
 
</code>
  
−
Hier werden die Artikel-Navigation (dynpg_A_breadcrumb), der Artikel- Printbutton (dynpg_A_btnprint) sowie der Artikelkopf (dynpg_A_header) ausgeblendet.  
+
Hier werden alle [[Die drei Ansichten von DynPG|drei Ansichten]] erzeugt und einige Parameter gesetzt. Zeile 2 gibt z.B. an wie lang eine Artikelliste sein darf, bevor sie der Übersicht halber auf mehreren Seiten dargestellt werden (wobei automatisch eine Seitennavigation im unteren Bereich der Webseite angezeigt wird).
  
−
Nun kann das ganze sogar schon ausgeführt werden und sieht bei mir folgendermaßen aus:
+
Beachten Sie, dass wir die Parameter <tt>$GLOBALS["DynPG"]->SetParam_AG_Anytime(false)</tt> und <tt>$GLOBALS["DynPG"]->SetParam_AA_Anytime(false)</tt> nicht setzen, da diese bereits standardmäßig den Wert <tt>false</tt> haben. Dadurch zeigen die Gruppen- und Artikelliste den Inhalt abhängig vom [[Der Navigationskontext|Navigationskontext]] an. Wir müssen hier aber  die Funktion <tt>$GLOBALS["DynPG"]->SetParam_A_Anytime(false)</tt> aufrufen, da wir diesen Parameter für die Artikel-Detailansicht zuvor beim Einbinden der Navigation auf <tt>true</tt> gesetzt haben. Dadurch werden nun alle drei Sichten abhängig vom Navigationskontext angezeigt.
  
−
[[Image:first_look.jpg|200px|Abbildung 2.4. ein erstes funktionierendes Hauptmenü]]
+
== Anpassen des Layouts mittels CSS ==
 +
Im Syle Sheet werden wir nun folgende Angaben machen:  
  
−
Freilich variiert diese Ansicht, denn es werden natürlich immer die Gruppen und Artikel angezeigt die man im Backend definiert hat. Hier habe ich größtenteils alles so gelassen wie man es nach der Installation von DynPG mit den Beispieldaten vorfindet. Nun kann man daran gehen eigene Artikel/Gruppen zu erzeugen, die dann natürlich auch im Menü auftauchen werden.
+
<code>[css,N]
 +
/* Navigation */
 +
div#navigation{
 +
  /* Angaben für ein zweispaltiges Layout */
 +
  float: left;
 +
  width:150pt;
 +
  margin-left:5pt;
 +
  margin-right:5pt;
  
−
Das Menü, so wie es jetzt erscheint, ist rein optisch noch etwas rudimentär, daher werden wir nun daran gehen das ganze ein bisschen aufzupeppen indem wir Grafiken für die einzelnen Menüpunkte einfügen.
+
  border:1px solid black;
 +
}
  
−
== Grafiken für die Menüpunkte ==
+
/* Inhalt */
−
Da nun bereits ein fertiges Menü-Grundgerüst steht, sollte es ein leichtes sein Grafiken für die einzelnen Menüpunkte einzufügen, denn dazu müssen wir lediglich die Stylesheet-Datei '''''style.css''''' um folgenden Code erweitern:
+
div#inhalt {
−
<code>[css,N]
+
  /* Angaben für ein zweispaltiges Layout */  
−
/*===========================Hauptkategorien==============================*/
+
  margin-left:165pt;
−
/*Hintergrundbilder für die Menüeinträge setzen*/
+
  margin-right:5pt;
−
#hauptmenue .level_0_r_i_exp, #hauptmenue .level_0_r_i_exp_hover,
+
−
#hauptmenue .level_0_r_a_exp_hover, #hauptmenue .level_0_r_a_exp
+
−
{
+
−
background: url("images/note.gif") no-repeat left top;
+
−
padding: 0px 0px 5px 0px;
+
 
}
 
}
−
/*Bezeichnungen für die Menüeinträge positionieren*/
 
−
#hauptmenue .level_0_r_i_exp p, #hauptmenue .level_0_r_i_exp_hover p,
 
−
#hauptmenue .level_0_r_a_exp_hover p, #hauptmenue .level_0_r_a_exp p
 
−
{
 
−
position: relative;
 
−
left: 40px;
 
−
}
 
−
/*===========================Sub-Kategorien==============================*/
 
−
/*Bezeichnungen für die Menüeinträge positionieren*/
 
−
#hauptmenue .level_1_r_i_exp p, #hauptmenue .level_1_r_i_exp_hover p,
 
−
#hauptmenue .level_1_r_a_exp_hover p, #hauptmenue .level_1_r_a_exp p
 
−
{
 
−
position: relative;
 
−
left: 60px;
 
−
}
 
−
/*===========================Sub-Sub-Kategorien==============================*/
 
−
/*Bezeichnungen für die Menüeinträge positionieren*/
 
−
#hauptmenue .level_2_r_i_exp p, #hauptmenue .level_2_r_i_exp_hover p,
 
−
#hauptmenue .level_2_r_a_exp_hover p, #hauptmenue .level_2_r_a_exp p
 
−
{
 
−
position: relative;
 
−
left: 60px;
 
−
}
 
−
</code>
 
−
Um diesen Code zu verstehen müssen wir zunächst ein paar Sachen klären. Jedem Menüpunkt wird von DynPG in CSS automatisch eine Klasse zugeordnet mit der wir in die Lage versetzt werden die einzelnen Eigenschaften zu setzen. Folgende Gruppen gibt es:
 
  
−
* '''''level_0_r_i_exp''''' (inaktiver(noch nicht geklickter) Menüpunkt)
+
/* In allen divs innerhalb des Navigationsmenüs wird der Inhalt um 10 pt
−
* '''''level_0_r_i_exp_hover''''' (inaktiver(noch nicht geklickter) Menüpunkt auf dem die Maus steht)
+
  nach rechts verschoben. Durch die Verschachtelung von divs innerhalb des
−
* '''''level_0_r_a_exp''''' (aktiver(geklickter) Menüpunkt)
+
  Menüs erhalten wir so eine Einrückung gemäß der Hierarchie-Ebene. */
−
* '''''level_0_r_a_exp_hover''''' (aktiver(geklickter) Menüpunkt auf dem die Maus steht)
+
div#course_categories_menu  div  {
−
 
+
  padding-left:10pt;
−
All diese Klassen beziehen sich auf Menüpunkte des Typs '''''Level 0''''', also die Hauptpunkte / Punkte der obersten Kategorie. Für Menüpunkte des Typs '''''Level X''''' gibt es natürlich auch Klassen:
+
−
 
+
−
* '''''level_X_r_i_exp''''' (inaktiver(noch nicht geklickter) Menüpunkt)
+
−
* '''''level_X_r_i_exp_hover''''' (inaktiver(noch nicht geklickter) Menüpunkt auf dem die Maus steht)
+
−
* '''''level_X_r_a_exp''''' (aktiver(geklickter) Menüpunkt)
+
−
* '''''level_X_r_a_exp_hover''''' (aktiver(geklickter) Menüpunkt auf dem die Maus steht)
+
−
 
+
−
Wobei X im Bereich von 0 bis 3 liegt! Ist ein Menüpunkt eine Gruppe werden alle seine Untergruppen bzw. Unterartikel in einem Div mit dem Namen
+
−
 
+
−
* '''''group_fold_ID'''''
+
−
 
+
−
zusammengefasst, wobei '''''ID''''' für die ID der Gruppe steht (diese wird beim Erstellen generiert und kann im Backend bzw. im generierten Html-Code (Browser) nachgelesen werden). Jetzt wird sicher auch klar wie der Code in style.css zu verstehen ist, in der nur Menüeinträge bis Level2 formatiert werden. Den vollständigen Code und ein laufendes Beispiel kann man sich [[CSS Einfaches Hauptmenü mit Bildern|hier]] anschauen.
+
−
 
+
−
== Verschiedene dynamische Grafiken für verschiedene Menüpunkte ==
+
−
Im vorherigen Beispiel haben wir Grafiken für die Menüpunkte eingefügt, nun soll jeder Menüpunkt seine eigene Grafik erhalten und diese soll sich zudem ändern, wenn man mit der Maus daraufzeigt. Das hört sich zwar schon etwas komplizierter an, tatsächlich müssen wir aber wieder "nur" die '''''style.css''''' ändern, der eigentliche Code für das Menü bleibt so bestehen.
+
−
 
+
−
[[CSS Einfaches Hauptmenü mit verschiedenen Bildern und Hovereffekt|Hier]] können der Css-Code und das ausführbare Beispiel bewundert werden.  
+
−
 
+
−
Erklärung: Im vorigen Beispiel stellten wir bereits fest, dass jedem Menüpunkt eine Klasse zugeordet wird und das Menüpunkte die Gruppen sind von divs mit dem Namen '''''group_fold_ID''''' (wobei "ID" die Id der Gruppe ist) umschlossen werden. Da die Namen (bzw. Ids) dieser divs eindeutig sind, können wir mit ihrer Hilfe jedem Menüpunkt eine eigene Grafik zuordnen:
+
−
 
+
−
<code>[css,N]
+
−
#group_fold_6 .level_0_r_i_exp
+
−
{
+
−
background: url("images/warning1.gif") no-repeat left top;
+
 
}
 
}
−
</code>
 
  
−
Bei mir ist der erste Menüpunkt eine Gruppe welche die Id "6" trägt, daher '''''group_fold_6'''''! Mit '''''.level_0_r_i_exp''''' beziehe ich mich auf die Eigenschaften des Menüpunktes die er hat, wenn er nicht aktiv (nicht angeklickt oder mit dem Mauszeiger berührt) ist. In diesem Zustand soll ihm die Grafik '''''warning1.gif''''' zugewiesen werden.
+
/* Alle Links innerhalb des Navigationsmenüs */
−
 
+
div#course_categories_menu  a {
−
<code>[css,N]
+
  text-decoration:none;
−
#group_fold_6 .level_0_r_i_exp_hover,
+
−
#group_fold_6 .level_0_r_a_exp_hover, #group_fold_6 .level_0_r_a_exp
+
−
{
+
−
background: url("images/warning2.gif") no-repeat left top;
+
 
}
 
}
 
</code>
 
</code>
  
−
Wenn er aktiv ist (also angeklickt oder mit dem Mauszeiger berührt wird), dann soll er die Grafik '''''warning2.gif''''' erhalten. Nun kann man so für alle weiteren Hauptpunkte vorgehen und erhält den im [http://www.dynpg.ch/doku/examples/css/menu_with_different_images/index.php ausfürbaren Beispiel] vorgestellten Effekt.
+
== Ausgabe ==
−
 
+
Nun kann die Seite bereits angezeigt werden und sieht dann folgendermaßen aus. Natürlich variiert diese Ansicht je nachdem welche Gruppen und Artikel Sie im Backend erstellt haben.  
−
== Direktklick auf Gruppen ==
+
−
[[Image:special_group.jpg|thumb|Abbildung 2.5. Spezielle Gruppe]]
+
−
Bis jetzt wurde bei einem Klick auf eine Gruppe im Hauptmenü immer eine Artikelliste (sowohl im Menü als auch im Anzeigefenster) dargestellt. Was aber wenn wir wollen, dass direkt und ohne jeden Umweg ein Artikel angezeigt werden soll? Nun, die Lösung ist einfach und erfordert noch nicht einmal Quellcode, denn das '''''Backend''''' erledigt all dies schon für uns. Für das Beispiel habe ich dort nämlich eine Gruppe namens '''''spezielle Gruppe''''' erstellt. In der Gruppe habe ich dann einen Artikel mit dem Namen '''''spezieller Artikel''''' erstellt und ihm einen beliebiegen Artikeltext zugewiesen. Ist dies einmal geschehen kann man in der Gruppenliste bei "spezielle Gruppe" auf das "Bearbeiten"-Symbol klicken (das, welches wie ein Kugelschreiber aussieht) und bei '''''"Gruppeninhalt"''''' die Id von "spezieller Artikel" eintragen. Und schon erhält man im [http://www.dynpg.ch/doku/examples/css/menu_with_different_images/index.php ausfürbaren Beispiel] den beschriebenen Effekt.
+
−
{{-}}
+
−
== Unterschiedliche Stile für unterschiedliche Seiten ==
+
−
Angenommen Sie haben einen Menüpunkt Kontakt und einen namens Startseite und Sie wollen, dass beide z.B. verschiedene Hintergrundfarben zur Darstellung verwenden. Was tun? Glücklicherweise gibt es dafür Menüfunktionalitäten die einem die Arbeit abnehmen. Dabei sei auf [[Code-Schnipsel Unterschiedliche Stile für unterschiedliche Seiten|dieses Beispiel]] verwiesen.
+
−
 
+
−
Im Beispiel werden die folgenden beiden Funktionen verwendet:
+
−
 
+
−
<code>[php,Y]
+
−
$DynPG->SetParam_PlugIn_Param('DPGdynmenu', 'href_page_articles', '../index.php');
+
−
$DynPG->SetParam_PlugIn_Param('DPGdynmenu', 'href_subpages', Array(1 => '../details.php'));
+
−
</code>
+
−
 
+
−
Funktion 1 legt die PHP-Datei fest, die zum anzeigen sämtlicher Menüpunkte verwendet werden soll (hier: index.php). Funktion 2 legt die Datei fest, die zum anzeigen der "Startseite"-Gruppe verwendet werden soll. Somit überschreibt Funktion 2 die Einstellungen von Funktion 1 für "Startseite". Dabei muss wieder die ID der Gruppe angegeben werden (kann im Backend nachgelesen werden). Jedesmal wenn man jetzt auf die Startseiten-Gruppe klickt, wird statt dem Code von index.php, der von details.php zum anzeigen verwendet. Man kann natürlich auch mehr als eine Datei angeben:
+
−
 
+
−
<code>[php,N]
+
−
$DynPG->SetParam_PlugIn_Param('DPGdynmenu',
+
−
                              'href_subpages',
+
−
                              Array(
+
−
                                    5 => '../details.php',
+
−
                                    7 => '../beliebige_datei.php'
+
−
                                    )
+
−
                            );
+
−
</code>
+
−
 
+
−
[[Image:caution.png]] '''Achtung''' Bei dem Pfad für die anzugebenen Dateien wird von dem Standard-Pfad von DynPG ausgegangen (dem in dem die '''''getcontent.php''''' liegt), nicht von dem der Datei in dem die Funktion aufgerufen wird!
+
−
 
+
−
[[Image:caution.png]] '''Achtung''' Hat man für eine Gruppe eine andere Datei festgelegt, dann wird diese Datei nicht zwingend auch für die Untergruppen verwendet! Man muss auch explizit für die Untergruppen die zu verwendenden Dateien angeben!!
+
−
 
+
−
== Einträge sortieren ==
+
−
Der Titel sagt bereits alles: Wir wollen hier die Einträge im Menü sortieren, und zwar nach verschiedenen Schlüsseln, wie z.B. dem Index der Gruppe / des Artikels oder dem Namen. Dazu gibt uns DynPG zwei Funktionen zur Hand nämlich:
+
−
 
+
−
<code>[php,Y]
+
−
$DynPG->SetParam_PlugIn_Param('DPGdynmenu', 'order', Array('INDEX'));
+
−
$DynPG->SetParam_PlugIn_Param('DPGdynmenu', 'sort', Array('ASC'));
+
−
</code>
+
−
 
+
−
Die erste der beiden legt den Sortierschlüssel fest (hier: der Index der Gruppe / des Artikels). Mögliche Sortierschlüssel sind:
+
−
 
+
−
* '''''INDEX''''' (Index des Eintrages)
+
−
* '''''NAME''''' (Name des Eintrages)
+
−
* '''''CREATEDATE''''' (Erstellungsdatum)
+
−
 
+
−
Die zweite sortiert schließlich die Einträge. Dabei hat man die Wahl zwischen auf- ('''''ASC''''') und absteigend ('''''DESC'''''). [[Code-Schnipsel Menüeinträge sortieren|In diesem Beispiel]] sieht man die Funktionen in Aktion.  
+
  
−
[[Image:caution.png]] '''Achtung''' Die Funktionen müssen natürlich '''''vor''''' der Ausgabe des Menüs aufgerufen werden.
+
[[Image:Implementation eines kompletten Hauptmenüs.png]]

Aktuelle Version vom 26. September 2011, 16:24 Uhr

Note.png Dieser Artikel ist Teil einer Reihe von Artikeln über die dynamische Navigation von DynPG

Dynamisches Navigationsmenü und Inhaltsanzeige | Der Navigationskontext | Implementation eines kompletten Hauptmenüs | Anpassen des Navigationsmenüs | Moduldokumentation: Dynamische Navigation | Einführungsartikel ...

zurück zu Kategorie:Integration in eine Webseite

In diesem Artikel werden wir eine Webseite mit einem dynamischen Navigationsmenü und einer Inhaltsanzeige erstellen.

Das Grundgerüst

Als erstes benötigen wir eine neue Datei index.php mit einem HTML-Grundgerüst. Außerdem erstellen wir eine CSS-Datei namens style.css mit der wir das Aussehen des Menüs anpassen werden. Das Grundgerüst, in dem wir zunächst erst einmal nur DynPG einbinden, könnte wie folgt aussehen: 

<?php
  require '../dynpg/getcontent.php';                   //DynPG-Funktionalität einbinden
  $GLOBALS["DynPG"]->SetParam_PathToRoot('../dynpg/'); //DynPG-Pfad setzen
?>
 
<!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>Seite mit dynamischen Navigationsmenü</title>
  <meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
 
  <link rel="stylesheet" type="text/css" href="style.css" />  <!--eigene style.css einbinden-->
</head>
 
<body>
  <h1>Seite mit dynamischen Navigationsmenü</h1>
 
  <div id="navigation">
    <!-- hier kommt die dynamische Navigation hin -->
  </div>
 
  <div id="inhalt">
    <!-- hier kommt die Inhaltsanzeige hin -->
  </div>
</body>
</html>

In den Spalten navigation und inhalt sollen das Hauptmenü bzw. die eigentlichen Artikel, Artikellisten und Gruppenlisten angezeigt werden.

Erstellen des Navigationsmenüs

Bevor wir nun den eigentlichen Code schreiben, müssen wir in das DynPG Backend und einen Artikel erstellen, der die dynamische Navigation enthält. Die Schritte hierzu können Sie ggf. im Artikel zum Einbinden von DynPG Modulen nachlesen. Navigieren Sie im Backend zu diesem Artikel und merken Sie sich die ID. Diese werden wir im folgenden Snippet brauchen. Gehen wir also wieder in unsere index.php und fügen im div navigation folgendes ein: 

<div id="navigation">
  <?php
  $GLOBALS["DynPG"]->SetParam_A_Anytime(true);             // dynamische Navigation immer anzeigen
  $GLOBALS["DynPG"]->SetParam_A_Article(1);                // Artikelnummer der dynamischen Navigation
  $GLOBALS["DynPG"]->SetParam_A_ArticleHeader(false);      // Artikelkopf (Titel, Lead-Bild und Lead-Text) ausblenden
  $GLOBALS["DynPG"]->SetParam_A_CategoryNavigation(false); // Kategorienavigation (Gruppe > Untergruppe > Artikel) ausblenden
  $GLOBALS["DynPG"]->SetParam_A_PrintNavigation(false);    // Drucken-Link ausblenden
  $GLOBALS["DynPG"]->Write_Article();                      // dynamische Navigation ausgeben
  ?>
</div>
Caution.png Achtung: Sie müssen in Zeile 2 den Parameterwert durch die ID des Artikels ersetzen, der die dynamische Navigation enthält.

In der ersten Zeile weisen wir DynPG an, dass der folgenden Artikel immer angezeigt werden soll, da es sich sich um das Navigationsmenü der Webseite handelt. In der zweiten Zeile muss ID durch die ID des Artikels ersetzt werden, der die dynamische Navigation enthält. Die folgenden Zeilen verändern die Ansicht so, dass wirklich nur die Navigation angezeigt wird und sonst nichts.

Erstellen der Inhaltsanzeige

Nun müssen wir uns noch um die Darstellung der Listen und Artikel kümmern. Dazu fügen wir in der Spalte inhalt folgendes ein: 

<div id="inhalt">
  <?php
  $GLOBALS["DynPG"]->Write_AllGroups();         // Gruppenlisten-Ansicht ausgeben (standardmäßig abhängig vom Navigationskontext)
  $GLOBALS["DynPG"]->SetParam_AA_Maxview(10);   // Maximal zehn Einträge in Artikellisten anzeigen
  $GLOBALS["DynPG"]->Write_AllArticles();       // Artikelliste-Ansicht ausgeben (standardmäßig abhängig vom Navigationskontext)
  $GLOBALS["DynPG"]->SetParam_A_Anytime(false); // Parameter wieder auf false setzen (wurde bei der Navigation auf true gesetzt)
  $GLOBALS["DynPG"]->Write_Article();           // Artikel-Detailansicht ausgeben
  ?>
</div>

Hier werden alle drei Ansichten erzeugt und einige Parameter gesetzt. Zeile 2 gibt z.B. an wie lang eine Artikelliste sein darf, bevor sie der Übersicht halber auf mehreren Seiten dargestellt werden (wobei automatisch eine Seitennavigation im unteren Bereich der Webseite angezeigt wird).

Beachten Sie, dass wir die Parameter $GLOBALS["DynPG"]->SetParam_AG_Anytime(false) und $GLOBALS["DynPG"]->SetParam_AA_Anytime(false) nicht setzen, da diese bereits standardmäßig den Wert false haben. Dadurch zeigen die Gruppen- und Artikelliste den Inhalt abhängig vom Navigationskontext an. Wir müssen hier aber die Funktion $GLOBALS["DynPG"]->SetParam_A_Anytime(false) aufrufen, da wir diesen Parameter für die Artikel-Detailansicht zuvor beim Einbinden der Navigation auf true gesetzt haben. Dadurch werden nun alle drei Sichten abhängig vom Navigationskontext angezeigt.

Anpassen des Layouts mittels CSS

Im Syle Sheet werden wir nun folgende Angaben machen: 

/* Navigation */
div#navigation{
  /* Angaben für ein zweispaltiges Layout */
  float: left;
  width:150pt;
  margin-left:5pt;
  margin-right:5pt;
 
  border:1px solid black;
}
 
/* Inhalt */
div#inhalt {
  /* Angaben für ein zweispaltiges Layout */ 
  margin-left:165pt;
  margin-right:5pt;
}
 
/* In allen divs innerhalb des Navigationsmenüs wird der Inhalt um 10 pt
   nach rechts verschoben. Durch die Verschachtelung von divs innerhalb des
   Menüs erhalten wir so eine Einrückung gemäß der Hierarchie-Ebene. */
div#course_categories_menu  div  {
  padding-left:10pt;
}
 
/* Alle Links innerhalb des Navigationsmenüs */
div#course_categories_menu  a {
  text-decoration:none;
}

Ausgabe

Nun kann die Seite bereits angezeigt werden und sieht dann folgendermaßen aus. Natürlich variiert diese Ansicht je nachdem welche Gruppen und Artikel Sie im Backend erstellt haben.

Datei:Implementation eines kompletten Hauptmenüs.png

Von „http://wiki-de.dynpg.org/wiki_de/index.php?title=Implementation_eines_kompletten_Hauptmenüs&oldid=3398“