Live-Seiten - Versionsgeschichte

Veltrup: /* PHP Integration */

2009-11-12T11:22:14Z

PHP Integration

Sed am 18. August 2009 um 11:21 Uhr

2009-08-18T11:21:06Z

Jankowski am 12. Februar 2009 um 15:20 Uhr

2009-02-12T15:20:48Z

Änderungen zeigen

Veltrup: /* SPML-Seiten mit benutzerdefinierten Templates */

2008-11-24T12:37:57Z

SPML-Seiten mit benutzerdefinierten Templates

Veltrup: /* SPML-Seiten mit Fullpage-Template */

2008-11-24T12:03:38Z

SPML-Seiten mit Fullpage-Template

Veltrup: /* SPML-Seiten mit benutzerdefinierten Templates */

2008-11-24T12:01:37Z

SPML-Seiten mit benutzerdefinierten Templates

Sed: /* PHP integration */

2008-11-11T12:38:41Z

PHP integration

Sed: /* Artikel anlegen und ändern */

2008-11-11T12:22:12Z

Artikel anlegen und ändern

Sed: /* Daten über Liveseiten erzeugen, ändern und löschen */

2008-11-11T12:20:41Z

Daten über Liveseiten erzeugen, ändern und löschen

Sed: /* Login über ein Formular */

2008-11-11T12:19:56Z

@@ Zeile 226: / Zeile 226: @@
 Für diese Art der Integration sind noch ein paar PHP-Besonderheiten zu beachten.
-;Gleichnamige Request-Parameter bzw. Formularfelder
+===Gleichnamige Request-Parameter bzw. Formularfelder===
-:Werden an eine PHP-Seite zwei gleichnamige Request-Parameter bzw. Formularfelder gesendet, wird von PHP immer nur der letzte Parameter verwendet. Wird also z.B. die URL
+Werden an eine PHP-Seite zwei gleichnamige Request-Parameter bzw. Formularfelder gesendet, wird von PHP immer nur der letzte Parameter verwendet. Wird also z.B. die URL
 <source lang="xml">
 http://www.domain.de/test.php?test=1&test=2
@@ Zeile 239: / Zeile 239: @@
 Siehe hierzu auch http://www.php.net/manual/de/faq.html.php#faq.html.arrays
-;Modifikationen von Request-Parametern und Formularfeldern durch PHP
+===Modifikationen von Request-Parametern und Formularfeldern durch PHP===
-:Enthalten Namen von Request-Parametern oder Formularfeldern bestimmte Zeichen, wird der Name von PHP modifiziert. Aufgrund der oben genannten Array-Regel werden z.B. alle Zeichen nach einem <code>[]</code> abgeschnitten. Wird z.B. ein Request-Parameter mit dem Namen
+Enthalten Namen von Request-Parametern oder Formularfeldern bestimmte Zeichen, wird der Name von PHP modifiziert. Aufgrund der oben genannten Array-Regel werden z.B. alle Zeichen nach einem <code>[]</code> abgeschnitten. Wird z.B. ein Request-Parameter mit dem Namen
 <source lang="xml">
 sp_mainIterator[0].sp_text
@@ Zeile 294: / Zeile 294: @@
 Dadurch wird verhindert, dass PHP die Formularfeldnamen modifiziert. Der weiter unten beschriebene <code>RequestDispatcher.class.php</code> bietet Methoden, mit denen über den originalen Formularfeldnamen auf die Parameter zugegriffen werden kann.
 ===RequestDispatcher.class.php===

← Nächstältere Version		Version vom 18. August 2009, 11:21 Uhr
Zeile 1:		Zeile 1:
		+	__TOC__
	==Beschreibung==		==Beschreibung==
	Als Live-Seiten werden SPML-Seiten bezeichnet, die in einem Publikationsbereich generiert werden und somit, wie auch PHP-Seiten, in einer Website aufgerufen werden.		Als Live-Seiten werden SPML-Seiten bezeichnet, die in einem Publikationsbereich generiert werden und somit, wie auch PHP-Seiten, in einer Website aufgerufen werden.

@@ Zeile 23: / Zeile 23: @@
 So ist es möglich Teile, die zur Generierungszeit fest stehen, schon beim Erzeugen der Seite zu ermitteln und nur die 'echten' Liveanteile der SPML-Seite beim Aufruf auszuführen.
-Im Out-Teil des Templates muss als erstes der Tag [[spt:spml]] eingebunden werden, da dieses den notwendigen SPML-Header in die Seite schreibt. Hierbei ist es wichtig, das vor dem [[spt:spml]]-Tag kein Zeichen generiert wird.
+Im Out-Teil des Templates muss als erstes der Tag [[spt:spml]] eingebunden werden, da dieses den notwendigen SPML-Header in die Seite schreibt. Hierbei ist es wichtig, das vor dem [[spt:spml]]-Tag kein Zeichen generiert wird. In den so generierten Seiten kann mit <code>system.page</code> auf das [[Page]]-Objekt zugegriffen werden.
 <source lang="xml">

← Nächstältere Version		Version vom 24. November 2008, 12:03 Uhr
Zeile 14:		Zeile 14:

	Publizieren Sie den Artikel und rufen sie die generierte Seite auf. In der Seite ist nun der Name des Artikels enthalten.		Publizieren Sie den Artikel und rufen sie die generierte Seite auf. In der Seite ist nun der Name des Artikels enthalten.
		+	Das Objekt <code>system.page</code> steht nur in generierten SPML-Seiten zur Verfügung.

	Bei der Erzeugung von SPML-Seiten über das Fullpage-Template ergibt sich jedoch ein Nachteil. Der in dem Textfeld eingetragene SPML-Code wird 1 zu 1 in die zu generierende SPML-Seite geschrieben. SPML-Code der zum Generierungszeitpunkt ausgeführt werden soll, kann nicht angegeben werden. Ist dies jedoch notwendig, müssen die SPML-Seite über andere Templates erzeugt werden.		Bei der Erzeugung von SPML-Seiten über das Fullpage-Template ergibt sich jedoch ein Nachteil. Der in dem Textfeld eingetragene SPML-Code wird 1 zu 1 in die zu generierende SPML-Seite geschrieben. SPML-Code der zum Generierungszeitpunkt ausgeführt werden soll, kann nicht angegeben werden. Ist dies jedoch notwendig, müssen die SPML-Seite über andere Templates erzeugt werden.

@@ Zeile 22: / Zeile 22: @@
 So ist es möglich Teile, die zur Generierungszeit fest stehen, schon beim Erzeugen der Seite zu ermitteln und nur die 'echten' Liveanteile der SPML-Seite beim Aufruf auszuführen.
-Im Out-Teil des Templates sollte als erstes das Template SPML Standard Output (Anchor: <code>template.spml.standard.output</code>) mit einem <code>include</code> eingebunden werden, da dieses den notwendigen SPML-Header in die Seite schreibt.
+Im Out-Teil des Templates muss als erstes der Tag [[spt:spml]] eingebunden werden, da dieses den notwendigen SPML-Header in die Seite schreibt. Hierbei ist es wichtig, das vor dem [[spt:spml]]-Tag kein Zeichen generiert wird.
 <source lang="xml">
 <sp:io type="in">
     ...
-</sp:io><sp:io type="out"><sp:include anchor="template.spml.standard.output"/>
+</sp:io><sp:io type="out"><spt:spml/>
     ...
     <sp:code>

@@ Zeile 238: / Zeile 238: @@
 ;Modifikationen von Request-Parametern und Formularfeldern durch PHP
-:Enthalten Namen von Request-Parametern oder Formularfeldern bestimmte Zeichen wird der Name von PHP modifiziert. Aufgrund der oben Array-Regel werden z.B. alle Zeichen nach einem <code>[]</code> abgeschnitten. Wird z.B. ein Request-Parameter mit dem Namen
+:Enthalten Namen von Request-Parametern oder Formularfeldern bestimmte Zeichen wird der Name von PHP modifiziert. Aufgrund der oben genannten Array-Regel werden z.B. alle Zeichen nach einem <code>[]</code> abgeschnitten. Wird z.B. ein Request-Parameter mit dem Namen
 <source lang="xml">
 sp_mainIterator[0].sp_text
@@ Zeile 246: / Zeile 246: @@
 sp_mainIterator
 </source>
-zugreifbar. Desweiteren werden alle Punkte, die in einem Request-Parameternamen oder einem Formularfeldnamen enthalten sind durch Unterstriche ersetzt. Wird z.B. ein Request-Parameter mit dem Namen
+zugreifbar. Des weiteren werden alle Punkte, die in einem Request-Parameternamen oder einem Formularfeldnamen enthalten sind durch Unterstriche ersetzt. Wird z.B. ein Request-Parameter mit dem Namen
 <source lang="xml">
 sp_text.de_DE
@@ Zeile 258: / Zeile 258: @@
 Siehe hierzu auch http://www.php.net/manual/de/faq.html.php#faq.html.form-image
-Der IES verwendet Punkte und Eckige Klammern in mit <code>sp:text</code>, <code>sp:textarea</code>, <code>sp:checkbox</code>, <code>sp:select</code>, <code>sp:hidden</code>, <code>sp:upload</code>, <code>sp:password</code> und <code>sp:radio</code> erzeugten Formularfeldern. Würden diese so an eine PHP-Seite gesendet werden, gingen nötige Informationen verloren. Um dies zu umgehen, können mit dem Attribute <code>nameencoding</code> des Tags <code>sp:form</code> die Formularfeldnamen encodet werden. Aus einem mit <code>sp:form</code> definiertem Formular
+Der IES verwendet Punkte und Eckige Klammern in mit <code>sp:text</code>, <code>sp:textarea</code>, <code>sp:checkbox</code>, <code>sp:select</code>, <code>sp:hidden</code>, <code>sp:upload</code>, <code>sp:password</code> und <code>sp:radio</code> erzeugten Formularfeldern. Würden diese so an eine PHP-Seite gesendet werden, gingen nötige Informationen verloren. Um dies zu umgehen, können mit dem Attribut <code>nameencoding</code> des Tags <code>sp:form</code> die Formularfeldnamen encodet werden. Aus einem mit <code>sp:form</code> definiertem Formular
 <source lang="xml">
 <sp:form uri="test.php">
@@ Zeile 310: / Zeile 310: @@
 <source lang="xml">$dispatcher->setEncoding("ISO-8859-15");</source>
-Die Methode <code>absorb()</code> liest alle Request-Parameter, Request-Uploads Cookies, Session-Parameter und Server-Variablen ein, um sie mit der <code>dispatch()</code>-Methode weiterzuleiten. Alternativ können auch z.B. nur Request-Parameter mit der Methode <code>absorbRequestParameter()</code> übernommen werden. Weitere Methoden sind <code>absorbRequestUploads()</code>, <code>absorbSessionVariables()</code>, <code>absorbCookies()</code> und <code>absorbServerVariables()</code>. Einzelnen Werte können mit <code>setParameter()</code>, <code>setFile()</code> und <code>setCookie()</code> setzten. Server- und Session-Variablen werden als HTTP-Parameter gesendet.
+Die Methode <code>absorb()</code> liest alle Request-Parameter, Request-Uploads, Cookies, Session-Parameter und Server-Variablen ein, um sie mit der <code>dispatch()</code>-Methode weiterzuleiten. Alternativ können auch z.B. nur Request-Parameter mit der Methode <code>absorbRequestParameter()</code> übernommen werden. Weitere Methoden sind <code>absorbRequestUploads()</code>, <code>absorbSessionVariables()</code>, <code>absorbCookies()</code> und <code>absorbServerVariables()</code>. Einzelnen Werte können mit <code>setParameter()</code>, <code>setFile()</code> und <code>setCookie()</code> setzten. Server- und Session-Variablen werden als HTTP-Parameter gesendet.
 <source lang="xml">$dispatcher->absorb();</source>
@@ Zeile 354: / Zeile 354: @@
 ;<code>getJSessionId()</code>
-:Liefert vor dem <code>dispatch()</code>-Aufruf die <code>JSESSIONID</code> mit der der Request gesendet wird. Nach dem <code>dispatch()</code>-Aufruf wird die vom Request zurückgeliefert <code>JSESSIONID</code> zurückgeliefert.
+:Liefert vor dem <code>dispatch()</code>-Aufruf die <code>JSESSIONID</code> mit der der Request gesendet wird. Nach dem <code>dispatch()</code>-Aufruf wird die vom Request zurückgelieferte <code>JSESSIONID</code> ausgegeben.
-Soll für mehrere Aufrufe von SPML-Seite die gleiche Session verwendet werde, muß das dafür notwendige Cookie <code>JSESSIONID</code> vom Dispatcher an die aufrufende PHP-Seite weitergegeben werden. Ist dies erwünscht, ist das vor dem <code>dispatch()</code>-Aufruf mit der Methode <code>setWriteCookies(true)</code> einzuschalten.
+Soll für mehrere Aufrufe von SPML-Seiten die gleiche Session verwendet werde, muß das dafür notwendige Cookie <code>JSESSIONID</code> vom Dispatcher an die aufrufende PHP-Seite weitergegeben werden. Ist dies erwünscht, ist das vor dem <code>dispatch()</code>-Aufruf mit der Methode <code>setWriteCookies(true)</code> einzuschalten.
-Das Schreiben des Cookies vom Dispatcher ist standardmässig deaktiviert. Der Grund dafür ist, das der Dispatcher das Cookie nur setzen kann, wenn noch keine Daten an den Client gesendet wurden (Cookies liegen im HTTP-Header). Soll der Dispatcher Cookies an den Client weite reichen, muß die <code>disptach()</code>-Methode aufgerufen werden bevor PHP Daten an den Client sendet (z.B. mit <code>echo</code>).
+Das Schreiben des Cookies vom Dispatcher ist standardmässig deaktiviert. Der Grund dafür ist, dass der Dispatcher das Cookie nur setzen kann, wenn noch keine Daten an den Client gesendet wurden (Cookies liegen im HTTP-Header). Soll der Dispatcher Cookies an den Client weiter reichen, muß die <code>disptach()</code>-Methode aufgerufen werden bevor PHP Daten an den Client sendet (z.B. mit <code>echo</code>).
 <source lang="xml">

@@ Zeile 108: / Zeile 108: @@
 Um einen Artikel über eine Liveseite anzulegen, muß der <code>InformationHandler</code> verwendet werden. Dieser wird über seinen vollen Klassennamen <code>com.sitepark.ies.control.jsp.handler.InformationHandler</code>  angesprochen. Siehe [[InformationHandler]].
-Die Artikeldaten können z.B. in Formularen eingegeben und über Submit an den IES gesendet werden. Der Handler führt die Aktionen aus, Die SPML-Seite stellt anschließend die Ergebnisse dar.
+Die Artikeldaten können z.B. in einem Formular eingegeben und anschließend an den IES gesendet werden. Der Handler führt dann die notwendigen Aktionen aus. Die SPML-Seite stellt anschließend die Ergebnisse dar.
 Die Minimalanforderungen, um einen Artikel anzulegen oder zu ändern sind:

@@ Zeile 103: / Zeile 103: @@
 ==Daten über Liveseiten erzeugen, ändern und löschen==
-Wie auch IES-Module können auch Liveseiten Daten im IES erzeugen, ändern und löschen. Dazu werden Handler angesprochen, die über <code>HTTP GET</code>- bzw. <code>POST</code>-Parameter gesteuert werden.
+Wie IES-Module können auch Liveseiten Daten im IES erzeugen, ändern und löschen. Dazu werden Handler angesprochen, die über <code>HTTP GET</code>- bzw. <code>POST</code>-Parameter gesteuert werden.
 ===Artikel anlegen und ändern===

@@ Zeile 85: / Zeile 85: @@
 ;<security-constrains>
-:Hier wird definiert welche Seiten ohne Login aufgerufen werden dürfen.
+Hier wird definiert welche Seiten ohne Login aufgerufen werden dürfen:
-<code><allowed pattern="/login.spml" /></code> aufruf von <code>login.spml</code> ist immer erlaubt.
+<code><allowed pattern="/login.spml" /></code>
-<code><denied pattern="/.*" /></code> alle anderen Seiten dürfen nicht aufgerufen werden.
+Der Aufruf von <code>login.spml</code> ist immer erlaubt.
-Hierbei ist noch zu beachten, daß nur die Seiten geschützt werden, die vom IES ausgeführt/ausgeliefert werden (HTML-Seiten, PHP-Seiten, Bilder, CSS, ... gehören in der Regeln nicht dazu). Je nach gesetzten JkMount's <code>(mod_jk)</code> sind das möglicherweise nur <code>*.spml</code> und <code>*.jsp</code> Dateien.
+<code><denied pattern="/.*" /></code>
-Nach dem sie die Datei <code>ies-module.xml</code> geändert haben, muß das Modul des Publikationsbereiches neu geladen werden, damit die Änderungen wirksam werden (Siehe Administration des IES).
+Alle anderen Seiten dürfen nicht aufgerufen werden.
 ==Daten über Liveseiten erzeugen, ändern und löschen==