Dient zum Einbinden externer Daten in Templates.

Hinweis:

Das Tag darf max. 20 mal auf einem Template verwendet werden, jedoch nicht innerhalb einer Schleife (Loop).

Im Argument dieses Tags geben Sie die URL (http://....) des externen Programms an. Dieses Tag unterstützt Tag-in-Tag-Verwendung, d. h. Sie können im Argument auch WEBSALE V8s-Tags angeben. Dann müssen Sie die normalen Tag-Kennungen (Tilde-Zeichen) durch Dollar-Zeichen ersetzen.

Die externen Includes arbeiten analog auf einem Proxy-Server. Im Hintergrund wird eine Socket-Verbindung auf Port 80 (HTTP) zur angegebenen URL aufgebaut. Dabei werden alle eventuell vorhandenen Formular-Parameter, die per <form action=..."> ...</form> im Shop aufgenommen wurden, dem externen Programm per Post-Methode übergeben.

Alle eventuell vorhandenen GET- und POST-Parameter werden "zusammengehängt" und mittels der Parameter "getbuf" und "postbuf" übergeben.

Beispiel:

Übergabe des aktuellen Produktnamens sowie des Parameters "param" mit festem Wert an das externe System "konfigurator.php":

~WS-ExternInclude(http://.../konfigurator.php?produktname=$PR-Name$&param=Wert)~

Der Shop übergibt die beiden Parameter "produktname" und "param" durch den Parameter "getbuf" URL-codiert:

getbuf=produktname%3dName%26param%3dWert

Die Ausgaben des externen Programms werden dann direkt in das Shop-Template integriert. Diese Ausgaben können selbst wiederum WEBSALE V8s-Tags beinhalten. Somit lassen sich beliebige Shop-Daten innerhalb von Shop-fremden Inhalten anzeigen.

Rückgaben des externen Systems

Wenn in den Daten vom externen System z. B. das Bereichs-Tag {WS-Include}...{/WS-Include} vorhanden ist, dann zeigt WEBSALE V8s nur die Daten an, die innerhalb dieses Bereichs stehen. Damit lassen sich z. B. doppelte HTML-Header vermeiden. Diese Klammerung innerhalb des HTML-Outputs des externen Programms mit WS-Include ist also in fast jedem Fall notwendig.

Referenz: WS-Include

Wenn z. B. in den Rückgabe-Daten eines externen Produktkonfigurators das Tag PR-Number enthalten ist, ersetzt WEBSALE V8s dieses Tag bei der Ausgabe der Shopseite wie gewohnt durch die aktuelle Produktnummer.

Referenz: PR-Number

 

Wenn Sie lediglich die übergebene URL einbinden möchten, jedoch kein Parameterumschreiben, gesicherte Parameterübergabe und keine Formulardaten benötigen, verwenden Sie das Tag WS-URLInclude().

Referenz: WS-URLInclude()
Wegweiser: Externe Includes verwenden

Wegweiser: Funktionsweise von WEBSALE AJAX-Integrationen

Verwendbar als …

Einzel-Tag

+

Bereichs-Tag

–

negatives Bereichs-Tag

–

Schleifen-Tag

–

Zulässig in Templates …

Alle