DynPG in eine Webseite einbinden: Unterschied zwischen den Versionen

Aus DynPG-Wiki
Wechseln zu: Navigation, Suche
(Artikel aktualisiert)
(Infobox-Templates eingefügt)
 
(6 dazwischenliegende Versionen des gleichen Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
 
[[Category:Integration_in_eine_Webseite]]
 
[[Category:Integration_in_eine_Webseite]]
 +
{{Einführungsartikel}}
 +
 
== Einbinden von DynPG ==
 
== Einbinden von DynPG ==
−
DynPG kann in jede beliebige HTML-Seite eingebunden werden. Dies geschieht, indem zuerst die entsprechende HTML-Datei mit der Endung <tt>.php</tt> versehen wird. Die eigentliche Integration erfolgt nun durch Einfügen folgender Zeilen am Anfang der Seite:
+
DynPG kann in jede beliebige HTML-Seite eingebunden werden. Dies geschieht, indem zuerst die entsprechende HTML-Datei mit der Endung <tt>.php</tt> versehen wird. Die Integration erfolgt nun durch Einfügen folgender Zeilen am Anfang der Seite:
  
 
'''Snippet - Einbinden von DynPG'''
 
'''Snippet - Einbinden von DynPG'''
 
<code>[php,N]
 
<code>[php,N]
 
<?php
 
<?php
−
   require('cms/getcontent.php');
+
   require('../cms/getcontent.php');
−
   $DynPG->SetParam_PathToRoot('cms/');
+
   $GLOBALS["DynPG"]->SetParam_PathToRoot('../cms/');
 
?>
 
?>
 
</code>
 
</code>
  
 +
{{Note
 +
|die relativen Pfadangaben müssen an den Speicherort Ihrer DynPG-Installation angepasst werden.}}
  
 
'''Erklärung''':
 
'''Erklärung''':
Zeile 16: Zeile 20:
 
Diese Zeilen müssen Sie als erstes in jeder PHP-Datei, in der Sie DynPG nutzen wollen, angeben. Dadurch werden die Anweisungen für die Code-Snippets von DynPG verfügbar gemacht.
 
Diese Zeilen müssen Sie als erstes in jeder PHP-Datei, in der Sie DynPG nutzen wollen, angeben. Dadurch werden die Anweisungen für die Code-Snippets von DynPG verfügbar gemacht.
  
−
* ''Zeile 1'': Die erste Zeile muss den Pfad zur Datei mit dem Namen <tt>getcontent.php</tt> enthalten. Diese Datei befindet sich im Hauptverzeichnis von DynPG. Da es sich um eine relative Pfadangabe handelt, erfolgt die Angabe ausgehend vom Verzeichnis in der die PHP Datei gespeichert ist.  
+
* ''Zeile 1'': Die erste Zeile muss den Pfad zur Datei mit dem Namen <tt>getcontent.php</tt> enthalten. Diese Datei befindet sich im Hauptverzeichnis von DynPG. Da es sich um eine relative Pfadangabe handelt, erfolgt die Angabe ausgehend vom Verzeichnis, in dem sich die gerade bearbeitete PHP Datei befindet.  
−
* ''Zeile 2'': In der zweiten Zeile geben Sie das Verzeichnis an, indem Sie DynPG installiert haben. Dabei ist immer von dem Verzeichnis auszugehen, in der Sie diese Datei gespeichert haben. Um ein höheres Verzeichnis zu erreichen schreiben Sie zwei Punkte ( <tt>..</tt> ). Jede Ordnerangabe müssen Sie mit einem "Slash" ( <tt>/</tt> ) abschliessen.  
+
* ''Zeile 2'': In der zweiten Zeile geben Sie das Verzeichnis an, in dem Sie DynPG installiert haben. Auch hier erfolgt die Angabe ausgehend vom Vezeichnis, in dem sich die gerade bearbeitete PHP Datei befindet. Um ein höheres Verzeichnis zu erreichen schreiben Sie zwei Punkte ( <tt>..</tt> ). Jede Ordnerangabe müssen Sie mit einem "Slash" ( <tt>/</tt> ) abschließen.  
−
 
+
−
[[Image:Note.png]] ''Hinweis'':  Wenn Sie anderes Snippet mit dem <tt>include</tt> Befehl von PHP in eine Seite einbinden, die DynPG bereits eingebunden hat, dann können Sie diese Zeilen in dem Snippet, dass Sie einbinden möchten, weglassen. 
+
−
 
+
  
 
'''Ein einfaches Beispiel''':
 
'''Ein einfaches Beispiel''':
Zeile 36: Zeile 37:
 
?>
 
?>
 
</code>
 
</code>
 +
 +
{{Note
 +
|die relativen Pfadangaben müssen an den Speicherort Ihrer DynPG-Installation angepasst werden.}}Wenn Sie ein Snippet mit dem <tt>include</tt> Befehl von PHP in eine Seite einbinden, die DynPG bereits auf diese Weise eingebunden hat, dann können Sie diese Zeilen in dem Snippet, dass Sie einbinden möchten, weglassen.}}
  
 
== Minimalbeispiel ==
 
== Minimalbeispiel ==
Zeile 43: Zeile 47:
 
<?php
 
<?php
 
   require('../dynpg/getcontent.php');
 
   require('../dynpg/getcontent.php');
−
   SetParam_PathToRoot('../dynpg/');
+
   $GLOBALS["DynPG"]->SetParam_PathToRoot('../dynpg/');
 
?>
 
?>
−
 
+
 
<!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">
Zeile 52: Zeile 56:
 
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
 
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
 
</head>
 
</head>
−
 
+
 
<body>
 
<body>
 
   <?php
 
   <?php
−
     $DynPG->SetParam_AG_Anytime(true);
+
     $GLOBALS["DynPG"]->SetParam_AG_Anytime(true);
−
     $DynPG->Write_AllGroups();
+
     $GLOBALS["DynPG"]->Write_AllGroups();
 
   ?>
 
   ?>
 
</body>
 
</body>
−
 
+
 
</html>
 
</html>
 
</code>
 
</code>
  
  
−
Was genau das alles bedeutet, werden wir später in den Artikeln zu den [[Die drei Ansichten von DynPG|drei Sichten von DynPG]] sehen. Wenn wir aber alles richtig gemacht haben, dann müsste beim Aufrufen der Seite nun eine ähnliche Ausgabe, wie die folgende zu sehen sein:  
+
Was genau die Anweisungen bedeuten, werden wir im nächsten Artikel zu den [[Die drei Ansichten von DynPG|drei Sichten von DynPG]] sehen. Wenn wir aber alles richtig gemacht haben, dann müsste beim Aufrufen der Seite nun eine ähnliche Ausgabe, wie die folgende zu sehen sein:  
  
 
[[Image:frontend_example1.jpg|Abbildung 2.2. Ausgabe des Minimalbeispiels]]
 
[[Image:frontend_example1.jpg|Abbildung 2.2. Ausgabe des Minimalbeispiels]]

Aktuelle Version vom 26. September 2011, 16:23 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

Einbinden von DynPG

DynPG kann in jede beliebige HTML-Seite eingebunden werden. Dies geschieht, indem zuerst die entsprechende HTML-Datei mit der Endung .php versehen wird. Die Integration erfolgt nun durch Einfügen folgender Zeilen am Anfang der Seite:

Snippet - Einbinden von DynPG 

<?php
  require('../cms/getcontent.php');
  $GLOBALS["DynPG"]->SetParam_PathToRoot('../cms/');
?>
Note.png Bemerkung: die relativen Pfadangaben müssen an den Speicherort Ihrer DynPG-Installation angepasst werden.

Erklärung:

Diese Zeilen müssen Sie als erstes in jeder PHP-Datei, in der Sie DynPG nutzen wollen, angeben. Dadurch werden die Anweisungen für die Code-Snippets von DynPG verfügbar gemacht.

  • Zeile 1: Die erste Zeile muss den Pfad zur Datei mit dem Namen getcontent.php enthalten. Diese Datei befindet sich im Hauptverzeichnis von DynPG. Da es sich um eine relative Pfadangabe handelt, erfolgt die Angabe ausgehend vom Verzeichnis, in dem sich die gerade bearbeitete PHP Datei befindet.
  • Zeile 2: In der zweiten Zeile geben Sie das Verzeichnis an, in dem Sie DynPG installiert haben. Auch hier erfolgt die Angabe ausgehend vom Vezeichnis, in dem sich die gerade bearbeitete PHP Datei befindet. Um ein höheres Verzeichnis zu erreichen schreiben Sie zwei Punkte ( .. ). Jede Ordnerangabe müssen Sie mit einem "Slash" ( / ) abschließen.

Ein einfaches Beispiel:

Nehmen wir an, Sie haben die folgenden Dateistruktur auf Ihrem Server:

  • die Datei beispielseite.php liegt im Verzeichnis seiten/beispielseite.php.
  • die Dateien von DynPG sind im Verzeichnis dynpg/ gespeichert
  • die Ordner seiten/ und dynpg/ befinden sich im selben Verzeichnis

Die Pfadangaben sehen dann folgendermaßen aus: 

<?php
  require('../dynpg/getcontent.php');
  SetParam_PathToRoot('../dynpg/');
?>
Note.png Bemerkung: die relativen Pfadangaben müssen an den Speicherort Ihrer DynPG-Installation angepasst werden.
Wenn Sie ein Snippet mit dem include Befehl von PHP in eine Seite einbinden, die DynPG bereits auf diese Weise eingebunden hat, dann können Sie diese Zeilen in dem Snippet, dass Sie einbinden möchten, weglassen.}}

Minimalbeispiel

Zum Testen der Einstellung können Sie das folgende Minimalbeispiel verwenden. Passen Sie hier die ersten beiden Zeilen wie im vorherigen Abschnitt beschrieben an. Wir wollen zudem gleich eine Liste aller im Backend vorhandenen Gruppen ausgeben. Dazu fügen wir zwei weitere DynPG-Anweisungen zwischen den body Tags ein. 

<?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>Minimalbeispiel</title>
	<meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
</head>
 
<body>
  <?php
    $GLOBALS["DynPG"]->SetParam_AG_Anytime(true);
    $GLOBALS["DynPG"]->Write_AllGroups();
  ?>
</body>
 
</html>


Was genau die Anweisungen bedeuten, werden wir im nächsten Artikel zu den drei Sichten von DynPG sehen. Wenn wir aber alles richtig gemacht haben, dann müsste beim Aufrufen der Seite nun eine ähnliche Ausgabe, wie die folgende zu sehen sein:

Abbildung 2.2. Ausgabe des Minimalbeispiels

Von „http://wiki-de.dynpg.org/wiki_de/index.php?title=DynPG_in_eine_Webseite_einbinden&oldid=3397“