wDocumentData::replaceCurrentObjectdata
Ersetzt Objektdaten der aktuellen Seite
(verfügbar ab CMS-Version 14)
Funktionsaufruf
String replaceCurrentObjectdata(String str, Boolean disableOutputEscaping = false)
Parameter
| Parameter | Beschreibung |
|---|---|
| str | zu ersetzende Zeichenkette (z.B. wObjectdata:title, wMetadata:keywords oder wEnvdata:projectPath) |
| disableOutputEscaping | [|true] - falls die Maskierung der Ausgabe deaktiviert werden soll |
Allgemeine Hinweise
Folgende Platzhalter werden durch replaceCurrentObjectdata gesetzt (Stand September 2026):
- wEnvdata:documentPath
Aktueller Datei-Pfad - wEnvdata:includedObjectPath
Inkludierter Objektpfad - wEnvdata:projectPath
Projektpfad (z.B. /de) - wEnvdata:projectAssetsPath
Assets-Projektpfad (z.B. /default-wAssets) - wEnvdata:projectGlobalPath
Globaler Projektpfad (z.B. /default-wGlobal) - wEnvdata:projectLayoutPath
Layout Projektpfad (z.B. /multi-wGlobal) - wEnvdata:projectLanguage
Aktuelle Projektsprache (z.B. en) - wEnvdata:dirSubProject
Aktueller Projektpfad inkl. erstem Unterverzeichnis (z.B. /de/kontakt) - wMetadata:thumbnail
Vorschaubild aus den Metadaten - wMetadata:[Metadata]
Wert aus den Metadaten (z.B. wMetadata:title) - wMetadata:[Metadata]/@[Attribute]
Ein Wert aus einem Attribut der Metadaten (z.B. wMetadata:publication/@time) - wObjectdata:[Objectdata]/@[Attribute]
Ein Wert aus einem Attribut der Objektdaten (z.B. wObjectdata:date/@time) - wObjectdata:[Objectdata]
Wert aus den Objektdaten (z.B. wObjectdata:name) - wText:[textId]
Wert aus den allgemeinen Texten abhängig von dessen id - wGlobalValue:[id]
Wert der als globale Variable gesetzt wurde, z. Bsp. über wEnv::setGlobalValue
Allgemeine Funktionen:
- disableOutputEscaping
Verhindert ein Maskieren bestimmter Zeichen (z.B. HTML-Tags) - wGetCorrespondingLanguageFile([Link])
Gibt für einen Link die zugehörige Sprachdatei des aktuellen Sprachprojektes zurück
Für die Objekdaten stehen folgende Funktionen zur Verfügung:
- categoriesAsString
Liest Kategorien (wd:category) aus und gibt diese als String durch Pipe getrennt zurück - entriesAsString
Liest Mehrfacheinträge aus und gibt diese als String durch Pipe getrennt zurück
Beispiel 1: Ersetzt Objektdaten der aktuellen Seite
Beispiel:
Quelltext
<?php
/*
Beispiel Objekt-Inhalt einer Seite:
<wd:object type="default">
<wd:data id="title" type="char.text"/>
<wd:data id="description" type="char.text"/>
<wd:data id="keywords" type="char.text"/>
<wd:data id="objectData1" type="char.default">alternative Energiegewinnung</wd:data>
</wd:object>
*/
$string = "Wir entwickeln Lösungen im Bereich wObjectdata:objectData1. Unsere Leistung geht von der Forschung bis zur Entwicklung funktionsfähiger Prototypen.";
$disableOutputEscaping = false;
print wDocumentData::replaceCurrentObjectdata($string, $disableOutputEscaping);
?>Ergebnis
Wir entwickeln Lösungen im Bereich alternative Energiegewinnung. Unsere Leistung geht von der Forschung bis zur Entwicklung funktionsfähiger Prototypen.
Beispiel 2: Ersetzt Objektdaten und Umgebungsvariablen-Daten (ab CMS-Version 016.001.107.000) der aktuellen Seite
Beispiel:
Quelltext
<?php
$string = "Sie befinden sich im Projektpfad wEnvdata:projectPath!";
$disableOutputEscaping = false;
print wDocumentData::replaceCurrentObjectdata($string, $disableOutputEscaping);
?>Ergebnis
Sie befinden sich im Projektpfad /dev!
Beispiel 3: Ersetzt Links durch correspondierende Sprachdatei in Sprachprojekten (ab CMS-Version 021.004.050.000 )
/* Anwendungsfall:
Im Header einer Seite befindet sich ein Button, der auf eine Seite mit Angeboten verweist.
Im deutschen Sprachprojekt lautet der Link: /de/angebote/index.php
Im englischen Sprachprojekt lautet der Link: /en/offers/index.php
Beim Wechsel des Sprachprojekts soll der Link automatisch an die entsprechende Sprachversion angepasst werden.
*/
/* Auszug aus dem Quelltext des Link-Items für den Header */
<wd:item type="header.link">
.....
<wd:fragment id="href" type="src.default">wGetCorrespondingLanguageFile(/de/angebote/index.php)</wd:fragment>
.....
</wd:item>Hinweis
Beim Einsatz von Framework-Funktionen in eigenen Skripten beachten Sie bitte den Artikel "So verwenden Sie das PHP-Framework in eigenen Scripten".
Wenn Sie eine Funktion innerhalb einer Weblication® Seite z.B. über das PHP-Quelltext Element oder in einem XSL-Template über wsl:php einbinden, muss das Framework über die grid.php nicht mehr referenziert werden.