CMS-Variablen

Aus MAXcms

CMS-Variablen sind Werte die an verschiedenen Stellen definiert sein können und innerhalb von Templates oder auch Modulen zum Einsatz kommen können.

Inhaltsverzeichnis 1 Definieren von Variablen 1.1 zentrale Definition 1.2 Definition innerhalb einer CMS-Seite 1.3 Definition innerhalb eines PHP-Codes 1.4 Definition über Parameter 1.5 Definition über CMS-HTML-Erweiterung 2 Abfragen von CMS-Variablen 3 Verwenden der Variablen in IF-Bedingungen 4 Vordefinierte CMS-Variablen

[bearbeiten] Definieren von Variablen

[bearbeiten] zentrale Definition

Über den Menüpunkt "Hauptmenü"->"Projekt"->"Variablen" gelangt man auf ein Eingabefeld in das selbst definierte Variablen eingegeben werden können. Dazu wählen Sie einen Bezeichner und weisen diesem mit einem Gleichheitszeichen einen Wert zu.

Beispiel

Bezeichner=abc

oder

Bezeichner2="abc 123"

[bearbeiten] Definition innerhalb einer CMS-Seite

Im Konfigurations-Dialog jeder Seite findet sich ein Eingabefeld in das nach obigem Schema Variablen definiert werden können.

[bearbeiten] Definition innerhalb eines PHP-Codes

Mittels der Funktion addMAXcmsVar($name, $value); können CMS-Variablen auch in jedem Tag oder Modul erzeugt werden.

[bearbeiten] Definition über Parameter

Alle GET und POST-Parameter werden in CMS-Variablen übernommen.
Wird eine Seite mit /de/test.html?abc=123 aufgerufen wird daraus eine CMS-Variable _GET_abc erzeugt mit dem Wert 123.
In einem Template könnte diese dann z.B. wie folgt eingefügt werden:

Es wurde $_GET_abc$ als Parameter übergeben!

POST-Parameter werden entsprechend in _POST_name übernommen.

[bearbeiten] Definition über CMS-HTML-Erweiterung

Innerhalb eines HTML-Templates kann ein Bereich in eine CMS-Variable kopiert oder verschoben werden.

<!-- copy2var:VARNAME -->
 HTML-Code
<!-- /copy2var -->

oder

<!-- move2var:VARNAME -->
 HTML-Code
<!-- /move2var -->

Es kann dann über $VARNAME$ wieder in ein Template eingebunden werden. Zusätzlich wird auch die Variable $VARNAME_strlength$ mit der Länge des Variableninhaltes belegt.

[bearbeiten] Abfragen von CMS-Variablen

Jede Variable kann innerhalb von PHP mit der Funktion $value = getMAXcmsVar($name); abgefragt werden.

In ein Template wird es mit umschließenden $-Zeichen eingefügt.

Beispiel:

Dies ist <b>ein Test: $Bezeichner$</b>

Wird dieses Template angezeigt wird folgendes ausgegeben:

Dies ist ein Test: abc

[bearbeiten] Verwenden der Variablen in IF-Bedingungen

Da das Abarbeiten der IF-Bedingungen innerhalb von Template nach dem Einfügen der CMS-Variablen erfolgt, können die Variablen genutzt werden, um die Bedingungen zu beeinflussen.

Beispiel:

<!-- if:$Bezeichner$==abc -->Ausgaben wenn Variable = abc beinhaltet<!-- /if -->

[bearbeiten] Vordefinierte CMS-Variablen

Bei der Initialisierung des CMS werden zahlreiche Variablen vordefiniert, die dann innerhalb der Seite verwendet werden können.

_CMS_page 

Gibt die ID der aktuellen Seite aus.

_CMS_language 

Gibt das Sprachkürzel der aktuellen Seite aus: z.B. de oder en

_CMS_path 

_CMS_file 

gibt den Dateinamen der aktuellen Seite aus. Z.B. 5.html

_CMS_projectpath 

_CMS_inpath_file 

_CMS_inpath_dir 

_CMS_inpath 

_CMS_topfile 

_CMS_secondfile 

_CMS_thirdfile 

_CMS_menudepth 

_CMS_login 

Gibt 1 zurück, wenn der User gerade im CMS eingeloggt ist.

_DATE_day 

_DATE_month 

_DATE_year 

_DATE_hour 

_DATE_minute 

_DATE_second 

_DATE_time 

_BROWSER_ie 

1 oder 0, je nach, ob die Seite gerade mit dem IE aufgerufen wird, oder nicht.

_BROWSER_win 

1 oder 0, je nach, ob die Seite gerade von einem Windows-PC aufgerufen wird, oder nicht.

_BROWSER_safari 

1 oder 0, je nach, ob die Seite gerade mit dem Safari aufgerufen wird, oder nicht.

zurück zu MAXcms-Dokumentation