Die Funktion CB_RAW() arbeitet anders als CB_DATA(). Der Unterschied liegt darin, dass man mit CB_RAW() alle oder definierte Felder eines Beitrags auslesen und verarbeiten kann.
Es ist nicht möglich innerhalb dieser Funktion die Daten zu formatieren. Der Zweck der Funktion ist es, dass man mit nur einer Datenbank-Abfrage alle oder bestimmte Felder auszulesen.
Es ist standardmäßig kein Wert notwendig.
Optional können als Array die Felder fields und/oder eine ID id mit übergeben werden.
Felder müssen Komma-separiert übergeben werden.
Wenn man eine ID übergibt werden die Daten des Beitrags mit der übergebenen ID ausgelesen.
Grundlegende Syntax
Es sind keine Parameter erforderlich. Die Funktion muss an eine Variable übergeben werden, sonst liefert sie nichts zurück.
- <?php
- CB_RAW();
- ?>
Um die Daten auszulesen muss die Funktion an eine Variable übergeben werden. Die Funktion CB_RAW() liefert in diesem Fall nur Daten zurück, wenn eine URL mit ID aufgerufen wird. Wird nur ein Templete aufgerufen und keine ID als Parameter übergeben erfolgt keine Abfarge und Ausgabe.
- <?php
- $var = CB_RAW();
- ?>
Beispiel 1:
Es soll nur der Inhalt der Felder title und online_date ausgelesen werden. Die Felder werden als Array mit dem Schlüssel fields als komma-separierter Wert übergeben.
- <?php
- $var = CB_DATA(array('fields' => 'title,online_date'));
- ?>
Beispiel 2:
Es sollen alle Inhalte des Beitrags mit der ID 45 ausgelesen werden.
- <?php
- $var = CB_DATA(array('id' => 45));
- ?>
Beispiel 3:
Es sollen die Felder vorname und strasse des Beitrags mit der ID 66 ausgelesen werden.
- <?php
- $var = CB_DATA(array(
- 'fields' => 'vorname,strasse',
- 'id' => 66
- ));
- ?>
Ausgabe:
Die Ausgabe erfolgt als Array. Für die Abfrage aus Beispiel 3 sieht das Ergebnis wie folgt aus.
- <?php
- $var['vorname'] = 'Michael';
- $var['strasse'] = 'Parkstraße';
- ?>