JavaScript Dateien im HTML-Head einbinden

Veröffentlichungsdatum: 28. Januar 2018
Änderungsdatum: 14. Januar 2026

javascript Head htmlHead

Möchten Sie den Header-Bereich um eigene Skripte ergänzen, können Sie das über ein globales Template vornehmen.

Eigene HTML- oder JavaScripts können entweder direkt im HTML Seiten-Template eingebunden werden:

/[IHR-GLOBALES-PROJEKT]/wGlobal/layout/templates/standard.wDocument.php

Alternativ (und empfohlen) ist das Einbinden über das headAdditionalPost-Template, welches in einer aktuellen BASE ab CMS-Version 20 (seit ca. Mitte Dezember 2025) genutzt werden kann. Bei älteren Projekten kann dies ab der genannten Version z.B. über ein Weblic® Update der "BASE Templates" nachgerüstet werden. Auch das htmlHead-Template muss dann aktualisiert werden. Die Nutzung wird über die Projektkonfiguration aktiviert, wozu die Zeile nachgerüstet werden muss, sondern noch nicht vorhanden (vergleiche aktuelle BASE).
In der headAdditionalPost.wGlobal.php können dann zusätzliche Skripte für den Kopfbereich eingebunden werden. 

Einbinden von HTML-Skripten

Verfügen Sie bereits über ein HTML-Snippet ist es am einfachsten, diesen direkt in das Template zu kopieren. Empfehlenswert ist hierfür die Stelle nach dem Einbinden der Head-JS-Skripte ( <wsl:includeJsRessources target="head" ...)

Bitte beachten Sie:

Bevor Sie das Skript einfügen, müssen Sie sicherstellen, dass die Syntax wohlgeformt ist und die XSLT-Sonderzeichen maskiert sind.
Des Weiteren muss die Syntax XHTML konform sein, d.h. ein link oder script-Tag sollte mit entsprechendem Tag geschlossen werden.

Einbinden von JavaScript-Dateien

In Weblication Projekten werden HTML-Skripte in der Regel erst am Ende der Seite eingebunden (defer).
Dazu werden bei jedem Seitenaufruf die Skript-Dateien über die Funktion wPageCur::registerJS() registriert bzw. zum Einbinden vorgemerkt.
Über das WSL-Element wsl:includeJsRessources werden dann die Skripte entsprechend eingebunden.

Beispiel: Einbinden der jQuery.js im Head

<!-- Auszug aus der Datei htmlHead.wGlobal.php --> 

<!-- Durch den 2. Parameter 'head' im Funktionsaufruf, wird das Skript für den Head registriert -->
<xsl:value-of select="php:functionString('wPageCur::registerJs', concat($wGlobalProjectPath, '/wGlobal/layout/scripts/jquery.js'), 'head')"/>   

<!-- Durch das Attribut target="head" werden die für den Header registrierten Skripte an dieser Stelle eingebunden -->
<wsl:includeJsRessources target="head" merge="0" minimize="{php:functionString('wVariables::getValue', 'js_minimize', $wGlobalProjectPath)}" async="0" addModificationTime="0"/>