DynPG Module einbinden: Unterschied zwischen den Versionen

Aus DynPG-Wiki
Wechseln zu: Navigation, Suche
K
(Infobox-Templates eingefügt)
 
(12 dazwischenliegende Versionen des gleichen Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
−
[[Kategorie:Module]][[Kategorie:Bedienung des Backends]]
+
[[Kategorie:Module]]
−
''Ursprünglicher Autor: Urs Gamper''
+
[[Kategorie:Bedienung des Backends]]
 +
Module sind Plugins, welche entweder bereits kostenlos enthalten sind oder später erworben werden können. Als Module gelten z.B. die Navigation, das Gästebuch, der Blog, die Bildergalerie, der e-Shop etc. In diesem Artikel erfahren Sie, wie Sie diese DynPG Module in Ihre Webseite einbinden.
  
−
'''Module sind Plugins, welche entweder kostenlos dabei sind oder später erworben werden können. Als Module gelten z.B. die Navigation, das Gästebuch, der Blog, die Bildergalerie, der e-Shop etc. Hier lernen Sie ganz allgemein, wie Module in eine Website eingebunden werden.'''
+
== Grundsätzlicher Ablauf ==
−
=== Gruppe: Bereich für das Gästebuch auswählen ===
+
Der prinzipielle Ablauf zur Einbindung eines Moduls ist immer gleich. Er besteht aus den folgenden zwei Schritten:
−
Zuerst wählen Sie sich in die Gruppe ein, wo Sie z.B. ein Gästebuch erstellen wollen. In unserem Fall ist dies die Gruppe Kontakt in der Hierarchie Diverses – Bereichsinhalte.
+
# Erstellen eines neuen Artikels mit dem Platzhalter für das Modul.
 +
# Anzeigen des Artikels in Frontend.
  
−
[[Image:gruppen.png]]
+
Diese Schritte sind für alle Module gleich und werden in diesem Artikel beispielhaft an der Einbindung der dynamischen Navigation durchgeführt.
  
−
Sie sehen hier im Kontakt zwei Artikel. Einer davon ist als Gästebuch bereits integriert. Unabhängig davon erstellen wir einen neuen Artikel, damit Sie dies gleich von Beginn weg mitverfolgen können.
+
== Anlegen des Artikels ==
 +
Um die Funktion eines bestimmten Moduls in einen Artikel einzubinden, müssen Sie zuerst in die Ansicht für das [[Artikel erstellen|Erstellen von Artikeln]] des Backends wechseln. Im Texteditor für den Inhalt müssen Sie nun lediglich den Platzhalter für das Modul, welches Sie einbinden wollen, einfügen.
  
−
Nachfolgend sehen Sie die Artikelliste mit Artikel 22, dem Gästebuch (siehe rote Markierung):
+
Um zum Beispiel die [[dynamische Navigation]] in den Artikel zu integrieren, klicken Sie in der Werkzeugleiste des [[Texteditor|Texteditors]] auf das [[Image:Dynpg_dynamic_menu.gif]]"Dynamisches Menü einfügen"-Symbol. Daraufhin erscheint im Editor ein Platzhalter für dieses Modul. Je nach Modul kann gleichzeitig auch ein neues Fenster erscheinen, in dem Sie weitere Einstellungen vornehmen können. Die Einzelheiten der Einstellungen können Sie der [[:Kategorie:Module|Moduldokumentation]] entnehmen.
  
−
[[Image:artikelliste.png]]
+
{{Note
 +
|Für alle Module erscheint in der Ansicht des Texteditors nur ein ''Platzhalter''. Die Funktion des eigentlichen Moduls wird erst im Frontend der Webseite angezeigt.}}
  
−
=== Neuen Artikel erstellen ===
+
Sobald der Platzhalter erschienen ist, können Sie den Artikel speichern. Den Artikel für die dynamische Navigation werden wir der Übersichtlichkeit halber in einer [[Versteckte Gruppen|versteckten Gruppe]] "''Diverses''" in einem Unterordner speichern. Lesen Sie mehr über die sinnvolle Strukturierung von Gruppen und Artikeln in den Hinweisen zur [[Empfohlene Gruppenstruktur|empfohlenen Gruppenstruktur]].
−
Klicken Sie unterhalb "Artikel erstellen" auf das "+" (grüne Markierung)
+
  
−
[[Image:artikel_erstellen.png]]
+
In unserem Beispiel sieht der fertige Artikel wie folgt aus:
  
−
Geben Sie beim Titel "Gästebuch" ein und klicken Sie wiederum bei "Inhalt bearbeiten" auf das "+".
+
[[Image:Artikel erstellen - DynPG Navigation.png|center]]
  
−
=== Gästebuch in den Artikelinhalt einfügen ===
+
Speichern Sie diesen Artikel nun ab, indem Sie auf "Speichern" klicken.
  
−
[[Image:editor.png|830px]]
+
== Anzeigen des Artikels im Frontend ==
 +
Da es sich bei dem Artikel trotz des eingefügten DynPG Moduls immernoch um einen normalen Artikel handelt, wird dieser auch wie ein gewöhnlicher Artikel im Frontend angezeigt. An der Stelle, wo der Artikel ausgegeben werden soll, müssen wir also lediglich das Snippet für das [[Code-Schnipsel Einen einzelnen Artikel ausgeben|Ausgeben eines einzelnen Artikels]] einfügen, sofern der Artikel nicht bereits auf andere Weise (z.B. über die Navigation) erreichbar ist.
  
−
Nun sehen Sie in der dritten Symbolleiste ganz rechts diverse Icons. Eines davon ist dasjenige für das Gästebuch (rote Markierung). Sobald Sie dieses Icon anklicken wird im Editor eine Grafik mit "Gästebuch" eingefügt.
+
In unserem Beispiel fügen wir also den folgenden Code an der Stelle ein, wo die dynamische Navigation erscheinen soll:
 +
<code>[php, N]
 +
$DynPG->SetParam_A_Anytime(true); //Artikel von Anfang an anzeigen
 +
$DynPG->SetParam_A_Article(<ID>); //Artikelnr. angeben
 +
$DynPG->Write_Article();          //Artikel mit der Nr. <ID> ausgeben
 +
</code>
  
−
[[Image:icon_gaestebuch.png]]
+
{{Caution
 +
|in diesem Snippet müssen Sie die ID des anzuzeigenden Artikels angeben. Sie finden diese in der [[Gruppenverwaltung]], indem Sie zu der Gruppe navigieren, die den Artikel enthält und anschließend in der Artikelübersicht die ID des Artikels ablesen. Tragen Sie diese Nummer im Snippet anstelle von <tt><nowiki><ID></nowiki></tt> ein.}}
  
−
Je nach Modul ist es auch möglich, dass vor dem Einfügen noch ein weiteres Fenster erscheint. Nachfolgend ist z.B. die Bildergalerie, wo erst noch die entsprechende Galerie ausgewählt werden muss.
 
  
−
[[Image:galerie.png]]
+
[[Image:Artikelübersicht - DynPG Navigation.png]]
  
−
Danach muss der Artikel lediglich noch erstellt und allenfalls als Gruppeninhalt einem Navigationspunkt zugewiesen werden. Zur Erstellung und Zuweisung von Gruppeninhalten finden Sie weitere Dokumentationen bzw. Filme im Internet unter http://www.dynpg.ch/wiki.
 
  
−
=== Diese Informationen als PDF ===
+
In der Webseite sieht der angezeigte Artikel mit der dynamischen Navigation nun so aus:
−
Die Datei [[Media:Einfügen_von_Modulen.pdf|Einfügen_von_Modulen.pdf]] enthält momentan (09:14, 23. Mär 2009 (CET)) den gleichen Informationsstand, dies kann sich in Zukunft aber ändern.
+
 
 +
[[Image:DynPG Navigation Beispiel.png]]

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

Module sind Plugins, welche entweder bereits kostenlos enthalten sind oder später erworben werden können. Als Module gelten z.B. die Navigation, das Gästebuch, der Blog, die Bildergalerie, der e-Shop etc. In diesem Artikel erfahren Sie, wie Sie diese DynPG Module in Ihre Webseite einbinden.

Grundsätzlicher Ablauf

Der prinzipielle Ablauf zur Einbindung eines Moduls ist immer gleich. Er besteht aus den folgenden zwei Schritten:

  1. Erstellen eines neuen Artikels mit dem Platzhalter für das Modul.
  2. Anzeigen des Artikels in Frontend.

Diese Schritte sind für alle Module gleich und werden in diesem Artikel beispielhaft an der Einbindung der dynamischen Navigation durchgeführt.

Anlegen des Artikels

Um die Funktion eines bestimmten Moduls in einen Artikel einzubinden, müssen Sie zuerst in die Ansicht für das Erstellen von Artikeln des Backends wechseln. Im Texteditor für den Inhalt müssen Sie nun lediglich den Platzhalter für das Modul, welches Sie einbinden wollen, einfügen.

Um zum Beispiel die dynamische Navigation in den Artikel zu integrieren, klicken Sie in der Werkzeugleiste des Texteditors auf das Dynpg dynamic menu.gif"Dynamisches Menü einfügen"-Symbol. Daraufhin erscheint im Editor ein Platzhalter für dieses Modul. Je nach Modul kann gleichzeitig auch ein neues Fenster erscheinen, in dem Sie weitere Einstellungen vornehmen können. Die Einzelheiten der Einstellungen können Sie der Moduldokumentation entnehmen.

Note.png Bemerkung: Für alle Module erscheint in der Ansicht des Texteditors nur ein Platzhalter. Die Funktion des eigentlichen Moduls wird erst im Frontend der Webseite angezeigt.

Sobald der Platzhalter erschienen ist, können Sie den Artikel speichern. Den Artikel für die dynamische Navigation werden wir der Übersichtlichkeit halber in einer versteckten Gruppe "Diverses" in einem Unterordner speichern. Lesen Sie mehr über die sinnvolle Strukturierung von Gruppen und Artikeln in den Hinweisen zur empfohlenen Gruppenstruktur.

In unserem Beispiel sieht der fertige Artikel wie folgt aus:

Artikel erstellen - DynPG Navigation.png

Speichern Sie diesen Artikel nun ab, indem Sie auf "Speichern" klicken.

Anzeigen des Artikels im Frontend

Da es sich bei dem Artikel trotz des eingefügten DynPG Moduls immernoch um einen normalen Artikel handelt, wird dieser auch wie ein gewöhnlicher Artikel im Frontend angezeigt. An der Stelle, wo der Artikel ausgegeben werden soll, müssen wir also lediglich das Snippet für das Ausgeben eines einzelnen Artikels einfügen, sofern der Artikel nicht bereits auf andere Weise (z.B. über die Navigation) erreichbar ist.

In unserem Beispiel fügen wir also den folgenden Code an der Stelle ein, wo die dynamische Navigation erscheinen soll: 

$DynPG->SetParam_A_Anytime(true); //Artikel von Anfang an anzeigen
$DynPG->SetParam_A_Article(<ID>); //Artikelnr. angeben
$DynPG->Write_Article();          //Artikel mit der Nr. <ID> ausgeben
Caution.png Achtung: in diesem Snippet müssen Sie die ID des anzuzeigenden Artikels angeben. Sie finden diese in der Gruppenverwaltung, indem Sie zu der Gruppe navigieren, die den Artikel enthält und anschließend in der Artikelübersicht die ID des Artikels ablesen. Tragen Sie diese Nummer im Snippet anstelle von <ID> ein.


Datei:Artikelübersicht - DynPG Navigation.png


In der Webseite sieht der angezeigte Artikel mit der dynamischen Navigation nun so aus:

DynPG Navigation Beispiel.png

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