G3 REST - Versionsgeschichte

B2m: /* Unteralben aus Album (alle) */

2011-07-08T09:50:39Z

‎Unteralben aus Album (alle)

B2m: /* Fehlermeldungen */ Links

2011-07-08T09:48:32Z

‎Fehlermeldungen: Links

B2m: /* Einfaches Beispiel für Bilder oder Album */ fehlende Klammer

2011-06-14T08:47:28Z

‎Einfaches Beispiel für Bilder oder Album: fehlende Klammer

B2m am 8. Juni 2011 um 10:06 Uhr

2011-06-08T10:06:52Z

B2m: /* Lösungsansätze */

2011-06-08T10:02:19Z

‎Lösungsansätze

B2m: Erweiterung nun auch im ER

2011-06-08T09:50:13Z

Erweiterung nun auch im ER

Manitougs: Kleine Korrekturen

2011-05-01T10:00:43Z

Kleine Korrekturen

B2m: Fehlermeldungen hinzugefügt

2011-04-23T05:26:20Z

Fehlermeldungen hinzugefügt

B2m am 22. April 2011 um 18:21 Uhr

2011-04-22T18:21:18Z

Änderungen zeigen

B2m: Installationshinweise hinzugefügt

2011-04-22T16:05:41Z

Installationshinweise hinzugefügt

@@ Zeile 96: / Zeile 96: @@
 <nowiki>{{g3_rest::item?id=5&type=album&scope=all}}</nowiki>
-Einbindung der aller Unteralben des Albums mit der id 5.
+Einbindung aller Unteralben des Albums mit der id 5.
 === Mehrere Bilder und Alben ===

@@ Zeile 133: / Zeile 133: @@
 Die variabel gesetzten Werte sind mit '''$''' gekennzeichnet. Variablen mit '''$_''' werden anhand der von Gallery übermittelten Daten bestimmt. Die anderen sind über Parameter in den InsertTags beeinflussbar. Der Text ist in Contao Sprachdateien hinterlegt und kann somit auch updatesicher angepasst werden.
 ==Fehlermeldungen==
-Entdeckt ''g3_rest'' einen Verarbeitungsfehler, so wird der InsertTag durch einen leeren String ersetzt und die Fehlermeldung in das Systemlog von Contao geschrieben. Sollte also der InsertTag scheinbar keine Wirkung zeigen, dann sollte das Systemlog auf Meldungen der Kategorie '''ERROR''' geprüft werden.
+Entdeckt ''g3_rest'' einen Verarbeitungsfehler, so wird der InsertTag durch einen leeren String ersetzt und die Fehlermeldung in das [[System-Log]] von [[Einsteiger|Contao]] geschrieben. Sollte also der InsertTag scheinbar keine Wirkung zeigen, dann sollte das [[System-Log]] auf Meldungen der Kategorie '''ERROR''' geprüft werden.
 ==Parameter für die InsertTags==

@@ Zeile 58: / Zeile 58: @@
 Die Bilder werden in Contao über einen InsertTag eingebunden. Hier sind einige Beispiele gelistet.
 === Einfaches Beispiel für Bilder oder Album ===
-<nowiki>{{g3_rest::item?id=125}</nowiki>
+<nowiki>{{g3_rest::item?id=125}}</nowiki>
 Einbindung des Bildes/Albums mit der id 125 mit den Standardwerten.

@@ Zeile 42: / Zeile 42: @@
 # Contao liefert den HTML-Code der angeforderten Seite aus.
 # Der von Contao ausgelieferte HTML-Code enthält einen img-Tag mit einem Link auf das verkleinerte Bild. Dieses wird vom Browser des Besuchers von dem Server der Gallery Installation nachgeladen und angezeigt.
 ===Lösungsansätze===
 Über die Parameter der InsertTags des ''g3_rest'' Moduls lässt sich nicht nur die Größe des Bildes bestimmen, sondern auch welches der drei zur Verfügung stehenden Bilder (Thumbnail, Resize, Original) eingebunden werden soll. Wenn man also nicht gerade das Originalbild auf Thumbnailgröße verkleinert anzeigen lässt, sind die paar Kilobyte mehr durchaus für den Besucher zu verschmerzen.
@@ Zeile 50: / Zeile 51: @@
 Möchte man trotz aktivierter Cachefunktionen zum Beispiel Zufallsbilder anzeigen lassen, so kann ab TYPOLight 2.8 das Cachen eines InsertTags verhindert werden, indem ein '''cache_''' vorangestellt wird (siehe auch Beispielsektion). Das Modul ''g3_rest'' unterstützt diesen Mechanismus.
-{{Anmerkung|Dieser ganze Ablauf ist von zwei Servern/Installationen abhängig und es werden Daten zwischen diesen Servern/Installationen übertragen}}
 == Verarbeitung von Bildern mit ''g3_rest'' ==

@@ Zeile 50: / Zeile 50: @@
 Möchte man trotz aktivierter Cachefunktionen zum Beispiel Zufallsbilder anzeigen lassen, so kann ab TYPOLight 2.8 das Cachen eines InsertTags verhindert werden, indem ein '''cache_''' vorangestellt wird (siehe auch Beispielsektion). Das Modul ''g3_rest'' unterstützt diesen Mechanismus.
 == Verarbeitung von Bildern mit ''g3_rest'' ==
 {{msgInfo|Die Gallery kann neben Bildern auch Videos verarbeiten und darstellen. Dies wird von ''g3_rest'' in der aktuellen Version jedoch nicht unterstützt.}}

@@ Zeile 1: / Zeile 1: @@
 Dieses Modul erweitert Contao um die Möglichkeit über InsertTags Bilder aus einer Menalto Gallery 3 Installation einzufügen.
 [[Category:Extensions]]
@@ Zeile 5: / Zeile 4: @@
 | Dev=Benjamin Meier
 | DevSite=http://www.meier-benjamin.de
-| ExtVersion=0.0.1
+| ExtVersion=0.1.0
 | Version=2.9
-| ERLink=https://github.com/b2m/g3_rest/
+| ERLink=http://www.contao.org/erweiterungsliste/view/g3_rest.html
 | DonateLink=http://www.amazon.de/registry/wishlist/2VDXQUM2K10V5/?sort=priority
 | TrackerLink=https://github.com/b2m/g3_rest/issues
 }}
 ==Allgemeine Informationen==
 Die [http://codex.gallery2.org/Gallery3:About Gallery 3] ist die aktuelle Version des [http://gallery.menalto.com/ Gallery Project] und bietet ein umfangreiches [[w:en:Representational_State_Transfer_REST_API|Representational State Transfer REST API]]  an. Mit ''g3_rest'' ist es möglich verschiedene GET Requests auszuführen und somit die Daten aus der Gallery innerhalb von Contao zu verwenden.
 {{msgInfo|Das [http://codex.gallery2.org/Gallery3:API:REST REST API der Gallery] kennt GET, PULL, DELETE und CREATE Requests. Somit lässt sich eine vollständige Anwendung schreiben, die Daten auslesen, löschen, hochladen&hellip; kann. Das Modul ''g3_rest'' beschränkt sich  in der aktuellen Version jedoch auf GET Requests und kann somit nur Daten darstellen.}}
 == Installation ==
-# Herunterladen der Dateien aus dem GitHub Repository
+# Installation aus dem Erweiterungsverzeichnis heraus, oder von Hand
-# Gegebenenfalls entpacken und in den Ordner ''~/system/modules/g3_rest/'' verschieben
 # In den Einstellungen von Contao die Adresse zum REST Service der Gallery Installation angeben
 # In den Einstellungen den Zugriffstoken für den REST Service der Gallery Installation angeben

@@ Zeile 13: / Zeile 13: @@
 ==Allgemeine Informationen==
 {{Achtung|Dieses Modul ist noch in einer aktiven Entwicklungsphase und deshalb '''nicht''' im ER-Repository zu finden und '''nicht''' für den produktiven Gebrauch zu empfehlen!}}
-Die [http://codex.gallery2.org/Gallery3:About Gallery 3] ist die aktuelle Version des [http://gallery.menalto.com/ Gallery Project] und bietet ein umfangreiches [[w:Representational_State_Transfer REST API]]  an. Mit ''g3_rest'' ist es möglich verschiedene GET Requests auszuführen und somit die Daten aus der Gallery innerhalb von Contao zu verwenden.
+Die [http://codex.gallery2.org/Gallery3:About Gallery 3] ist die aktuelle Version des [http://gallery.menalto.com/ Gallery Project] und bietet ein umfangreiches [[w:en:Representational_State_Transfer_REST_API|Representational State Transfer REST API]]  an. Mit ''g3_rest'' ist es möglich verschiedene GET Requests auszuführen und somit die Daten aus der Gallery innerhalb von Contao zu verwenden.
 {{msgInfo|Das [http://codex.gallery2.org/Gallery3:API:REST REST API der Gallery] kennt GET, PULL, DELETE und CREATE Requests. Somit lässt sich eine vollständige Anwendung schreiben, die Daten auslesen, löschen, hochladen&hellip; kann. Das Modul ''g3_rest'' beschränkt sich  in der aktuellen Version jedoch auf GET Requests und kann somit nur Daten darstellen.}}
 == Installation ==
@@ Zeile 41: / Zeile 41: @@
 # Mr. Blue ruft eine Webseite auf. Diese Anfrage wird von dem Webserver an Contao weitergegeben.
 # Contao entdeckt einen InsertTag von ''g3_rest'' und started die registrierten Prozeduren.
-# Das Modul ''g3_rest'' verarbeitet die Parameter des InsertTags und stellt einen REST Request an die Gallery Installation. Dies erfolgt über normale [[w:Hypertext Transfer Protocol|HTTP-Anfragen]] und somit kann die Gallery Installation auch auf einem anderen Server liegen. Die von Gallery übermittelten Daten werden von ''g3_rest'' verarbeitet und eventuell daraus eine neue Anfrage erstellt, deren Ergebnis verarbeitet und daraus weitere Anfragen erstellt&hellip; Beispiel: Ermittle Bilder im Album x, Lade Daten zu Bildern, Lade Tags der Bilder. Dies kann je nach Erreichbarkeit des Servers mit der Gallery Installation durchaus Zeit in Anspruch nehmen!
+# Das Modul ''g3_rest'' verarbeitet die Parameter des InsertTags und stellt einen REST Request an die Gallery Installation. Dies erfolgt über normale [[w:en:Hypertext Transfer Protocol|HTTP-Anfragen]] und somit kann die Gallery Installation auch auf einem anderen Server liegen. Die von Gallery übermittelten Daten werden von ''g3_rest'' verarbeitet und eventuell daraus eine neue Anfrage erstellt, deren Ergebnis verarbeitet und daraus weitere Anfragen erstellt&hellip; Beispiel: Ermittle Bilder im Album x, lade Daten zu Bildern, lade Tags der Bilder. Dies kann je nach Erreichbarkeit des Servers mit der Gallery Installation durchaus Zeit in Anspruch nehmen!
 # Das Verkleinern des Bildes auf die angegebene Größe entfällt, da Gallery schon eine verkleinerte Version gespeichert hat und es zu viel Zeit kosten würde das Bild nachzuladen. Es wird lediglich der HTML-Code mit den Bildlinks und entsprechenden Größenangaben im img-Tag an Contao zurückgegeben.
 # Contao liefert den HTML-Code der angeforderten Seite aus.

@@ Zeile 131: / Zeile 131: @@
 </source>
 Die variabel gesetzten Werte sind mit '''$''' gekennzeichnet. Variablen mit '''$_''' werden anhand der von Gallery übermittelten Daten bestimmt. Die anderen sind über Parameter in den InsertTags beeinflussbar. Der Text ist in Contao Sprachdateien hinterlegt und kann somit auch updatesicher angepasst werden.
 ==Parameter für die InsertTags==
 {{msgWarning|Der WYSIWYG-Editor von Contao fügt (je nach Einstellung) automatisch p-Tags um alleine stehende InsertTags. Da ''g3_rest'' aber je nach Parameter einen div-Container zurückgibt sorgt dies für invalides HTML. Daher ist es eventuell notwendig den InsertTag in einen div-Tag zu schreiben um das automatische einbetten in einen p-Tag durch den WYSIWYG-Editor zu verhindern.}}