Eigene Skripte in CMBasic einbinden
Das neue Verzeichnis scripts
Ist Ihnen schon das neue Verzeichnis scripts aufgefallen? Hier gibt es ein Unterverzeichnis namens content. Und genau dort packen Sie Ihre eigenen Skripte hinein! Der Pfad scripts/content steht für »Content-Skripte« - im Gegensatz zu »Suchen-Skripten«, die es aber (noch) nicht gibt.
Skript auf allen Seiten einbinden
Das Skript soll auf allen Seiten eingebunden werden? Dann erstellen Sie eine Datei namens allpages.inc.php und legen diese im Ordner content ab. In dieser Datei können Sie praktisch beliebige PHP-Aktionen durchführen: Datenbankabfragen, Statistikmodule, Newsticker, was auch immer ... Sie wünschen eine Ausgabe von Inhalten? Dazu dienen zwei Variablen:
- $add_before_all
- $add_after_all
Der Inhalt der ersten Variable wird oberhalb des Inhalts aller Seiten ausgegeben, der Inhalt der zweiten Variable unterhalb. (Wenn Sie jedoch nichts ausgeben wollen, lassen Sie den Inhalt der Variablen leer!)
Ein einfaches Beispiel
Machen Sie doch einmal die Probe aufs Exempel und erzeugen Sie folgende Datei namens allpages.inc.php, die PHP-Tags schreibe ich hier bewusst nicht mit:
$add_after_all = "Das aktuelle Datum: ".date('j.n.Y');
Dieses Beispiel schreibt auf jeder Seite ganz an den Anfang den Satz Hier folgt nun der Inhalt: und ganz am Schluss erscheint das aktuelle Datum. Ob das nun sehr sinnvoll ist, sei dahingestellt. Aber Sie können ja ganz eigene dynamische Inhalte mit Hilfe dieser Variablen ausgeben!
Skript für einzelne Seiten gültig machen
Sie wollen Ihr Skript nicht auf allen Seiten gleichzeitig einbinden? Kein Problem, nennen Sie die Skriptdatei einfach SeitenID.inc.php. Wenn das Skript also auf der Seite gaestebuch eingebunden werden soll, muss die Skriptdatei gaestebuch.inc.php heißen.
Auch hier arbeiten wir mit zwei Variablen. Die heißen jedoch schlicht und einfach:
- $add_before
- $add_after
Übrigens ist auch eine Kombination beider Varianten möglich. Sie können in eine Seite ein individuelles Skript einbauen und gleichzeitig das "Allseitenskript" verwenden.
Beispiel: Newsfeed auslesen
Auch hier soll Ihnen ein einfaches, aber nützliches Beispiel die Funktion zeigen, ein Feedreader. Nennen Sie die Datei beispielsweise neewsfeed.inc.php und legen Sie sie unter scripts/content ab. Dann erstellen Sie eine Seite mit dem URLAnhang newsfeed. Dort können Sie gerne eine Überschrift und einen Einleitungstext angeben. Darunter wird im Beispiel der Newsfeed des Heise-Verlags angezeigt. Sie können die Feedadresse (hier: http://www.heise.de/tp/news-xl.rdf) natürlich wunschgemäß anpassen.
Weitergabe von Variablenwerten
Wichtig zu wissen, wenn Sie beispielsweise ein Gästebuch oder einen Kleinanzeigenmarkt programmieren: Sie können Variablen per $_POST-Methode oder auch per Cookie weitergeben, nicht jedoch per $_GET. Beachten Sie das bitte!
Der Ordner »show« ...
... ist nur dann interessant, wenn Sie ein Skript mit einem Anzeigemodul programmiert haben. Das könnte ein Gästebuchskript mit Administrationsbereich oder ein Statistikmodul mit Auswertung sein. Dieses Anzeigemodul legen Sie dann im Ordner show ab. Es wird auf diese Weise automatisch in den Menüpunkt »Scripts« eingebunden. Sie finden diesen Menüpunkt ganz rechts im Backend. Sie benötigen Superadmin-Rechte, um darauf zugreifen zu können.