wDocumentData::replaceCurrentObjectdata

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

Funktionsaufruf

String replaceCurrentObjectdata(String & str)

Parameter

str

zu ersetztende Zeichenkette (z.B. wObjectdata:title, wMetadata:keywords oder wEnvdata:projectPath)

disableOutputEscaping

[|true] - falls die Maskierung der Ausgabe deaktiviert werden soll

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. Sofern nachfolgend PHP-Beispiele aufgeführt sind, ist dies entsprechend zu beachten.

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!