Spml (SPT-Tag)

Aus SiteparkWiki
Version vom 24. Februar 2010, 12:56 Uhr von Schleusner (Diskussion | Beiträge) (Hob den Schutz von „Spml (SPT-Tag)“ auf)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Zur Navigation springen Zur Suche springen

Name

<spt:spml> - schreibt den Header für SPML-Live Seiten

Syntax

<spt:spml/>

Beschreibung

In einem Publikationsbereich herausgeschriebene SPML-Seite die Live ausgeführt werden sollen, benötigen Header-Informationen, die vor Beginn des eingentlichen SPML-Codes in der Seite stehen müssen. Dies ist nötig, um z.B. mit system.publisher abfragen zu können, in welchem Publikationsbereich die SPML-Seite liegt. Dieser Tag schreibt den benötigten Code in die Seite. Hierbei ist zu beachten, dass nicht der Tag selber herausgeschrieben werden darf. Dieser Tag wird in den Out-Teil eines Templates vor allen anderen Zeichen geschrieben. Das Template muß so aufgebaut sein, dass der <spt:spml>-Tag das erste Byte in die generierte Seite schreibt (Leerzeichen und Zeilenumbrüche dürfen nicht schon herausgeschrieben worden sein. Ist dies doch der Fall, schreibt der <spt:spml>-Tag die Fehlermeldung:

can't execute <spt:spml>, spml-file must start with <spt:spml>

Zu den Headerinformationen gehören auch Import-Anweisungen. Diese werden allerdings nur benötigt, wenn Scriptlet-Code in der SPML-Seite aufgenommen werden soll. Mit dem Attribut api können kommasepariert Namen der APIs angegeben werden, desses Packages mit Import-Anweisungen eingebunden werden sollen.

Attribute

Name Type Required Default ab IES Version
api String Nein None 2
api
Kommaseparierte Liste von APIs, dessen Packages mit Import-Anweisungen eingebunden werden sollen. Mögliche APIs sind:
log4j
Siehe http://logging.apache.org/log4j/1.2/apidocs/index.html
jdom
Siehe http://www.jdom.org/docs/apidocs/index.html
mail
Siehe http://java.sun.com/products/javamail/javadocs/index.html

Beispiele

Fullpage-Template für SPML-Code

Template Quelltext

<sp:io type="in">
<h1>Administrations-Template - Fullpage</h1>
<div class="editorblock">
  <h2>SPML-Fullpage-Code</h2>
  <em>Mit diesem Template können Sie den Code einer ganzen Seite erfassen.<br>
  <br>
  Eingabe<br>
  <spt:textarea name="sp_code" style="width: 100%;" cols="85" rows="20" wrap="off"/>
</div>
</sp:io><sp:io type="out"><spt:spml/><sp:print name="sp_code"/></sp:io>