wDocumentData::replaceCurrentObjectdata

Ersetzt Objektdaten der aktuellen Seite
(verfügbar ab CMS-Version 14)

Funktionsaufruf

String replaceCurrentObjectdata(String str, Boolean disableOutputEscaping = false)

Parameter

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 Juni 2022):

  • wEnvdata:documentPath
    Aktueller Datei-Pfad
  • wEnvdata:requestURL
    Aktuelle URL
  • 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)
  • 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)


Allgemeine Funktionen:

  • disableOutputEscaping
    Verhindert ein Maskieren bestimmter Zeichen (z.B. HTML-Tags)


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!

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.