Vor der Installation: config.inc.php anpassen
Beitrag aktualisiert am 01.08.2009
In der Voreinstellung ist die Datei config.inc.php immerhin schon für den Offlinetest mit dem lokalen Webserver XAMPP (Apachefriends) eingerichtet. Sie können also CMBasic ohne weitere Anpassungen offline (auf Ihrem eigenen Rechner) für Testzwecke installieren. Wenn Sie das XAMPP-System einsetzen. (XAMPP ist ein Paket, das einen lokalen Webserver mit PHP und MySQL auf dem lokalen Rechner einrichtet. XAMPP schafft also eine Testumgebung.)
So sieht die config.inc.php aus
Hier zeige ich Ihnen die wichtigsten Details dieser Datei. Die einleitenden und abschaltenden PHP-Tags schreibe ich aus technischen Gründen nicht mit.
Außerdem habe ich die längeren erklärenden Kommentare - also die Texte nach dem Doppelslash // - gekürzt, um die Übersicht zu bewahren. Die Nummerierung ist ebenfalls nicht in der Originaldatei enthalten. Die hilft Ihnen lediglich beim Finden der passenden Zeile.
Gute Texteditoren wie z.B. Weaverslave oder Notepad2 zeigen jedoch die Zeilennummern an.
(1) öffnendes PHP-Tag
(2) $dbname = "cdcol"; // Name der Datenbank
(3) $dbhost = "localhost"; // Datenbankhost, meist localhost
(4) $dbuser = "root"; // Benutzername für MySQL
(5) $dbpassword = ""; // Passwort für MySQL
(6) $fulltree = 1; // voller Navigationsbaum? 1 für ja, 0 für nein
(7) $htmleditor = 1; // HTML-Editor TinyMCE anzeigen? 1 für ja ...
(8) $pfx = "cmb_"; // Tabellenpräfix -- ändern ...
(9) $cssfolder = "gruenau"; // CSS-Ordner
(10) $friendlyURL = 0; // freundliche URLs? Nur mit ...
(11) $frontlogin = 1; // Loginmodul im Frontend?
(12) // 0 für nein, 1 für ja, URL-Anhang in "" wenn ...
(13) define('CMBASICLOG', 'Login'); // Mehrere CMBasics pro Datenbank?
(14) // Wenn der Wert für 'Login' ...
(15) // in alle CMBasics der selben Datenbank ...
(16) // define('SPLASH', 'splash.html'); // Splashpage einbinden ...
(17) // statt splash.html einfach Namen der gewünschten ...
(18)
(19) define('STATS', TRUE); // Statistikfunktionen ein?
(20)
(21) // Minibots einbinden (neu ab 1.6)
(22) define('METADESC', TRUE); // Meta-Description einbinden
(23) define('METAKEY', TRUE); // Meta-Keywords einbinden
(24) define('CODE', TRUE); // Code-Konverter
(25) define('FEEDBACK', TRUE); // Feedbackformular
(26) define('HIDEMAIL', TRUE); // E-Mail-Verschleierer
(27) define('LIGHTBOX', TRUE); // Lightbox-Galerie
(28) define('AUDIO', TRUE); // Audioplayer
(29) define('FLV', TRUE); // entweder JW FLV Videoplayer*
(30) // define('VIDEO', TRUE); // oder freier Videoplayer*
(31) define('MAPCREATOR', TRUE); // MapCreator (Google-Maps)
(32) define('SITEMAP', TRUE); // Sitemap
(33)
(34) // Typ des Frontend-Logins
(35) $frontlogintyp = "link"; // Wenn weggelassen oder iframe ...
(36)
(37) // Blogansicht steuern - am besten unverändert lassen
(38) $blogheadlink = 0; // 1 wenn der Head des Blogs zusätzlich ...
(39) $newblog = 0; // 1 wenn der Inhalt des 2. Tagpaars komplett ...
(40) $nohead = 0; // 1 wenn erstes Tagpaar zur Meta-Description ...
(41) schließendes PHP-Tag
Variablen und Konstanten
Schauen Sie sich erst einmal um. Das Prinzip ist einfach: In den ersten Zeilen steht links die sogenannte Variable, die den Wert speichert. Dann folgt ein Gleichheitszeichen als Zuweisungsoperator. Und rechts wird der entsprechende Wert notiert.
Ist es eine Zeichenfolge? Dann sitzt diese in Gänsefüßchen. Ist es nur eine Zahl? Dann können Sie die Gänsefüßchen weglassen.
In Zeile 16, 19 und 22 bis 32 gibt es dagegen keine Variablen, sondern sogenannte Konstanten. Da sieht die Zuweisung anders aus. Sie erfolgt innerhalb der runden Klammern. Der Wert TRUE sorgt dafür, dass eine Eigenschaft eingeschaltet ist. Wenn Sie die Eigenschaften deaktivieren wollen, schreiben Sie FALSE.
Semikolon und Kommentare
Jede Zeile wird dann durch ein Semikolon abgeschlossen. Die // reservieren Platz für eine Erklärung, es handelt sich dabei um einen Kommentar. Dieser kann auch entfallen.
Sicherheitsfeature: Seit Version 1.5 von CMBasic habe ich den Ordner edit zusätzlich mit einer .htaccess-Datei geschützt. Sofern Ihr Dienstleister mitspielt - und das sollten die meisten tun - ist dieser Ordner komplett für den Zugriff von außen gesperrt! Diese sensible Konfigurationsdatei ist also optimal geschützt. Safety first!
Wie öffnen Sie die Datei?
Das hängt von Ihrem Betriebssystem ab. Nehmen Sie einen einfachen Editor, unter Windows empfiehlt sich der Windows-Editor namens Notepad. Rechtsklicken sie auf die Datei und wählen Sie Senden an/Editor. Sie können auch Öffnen mit/Editor auswählen. Oder Sie ziehen die Datei in das Editorfenster.
Ich persönlich bevorzuge einen Spezialeditor wie den Weaverslave oder Notepad2 aber den müssen Sie natürlich erst einmal installieren. Der zeigt dann auch die Zeilennummerierung an.
Im Prinzip funktioniert jeder einfache Texteditor.
Erforderlich: Zugangsdaten eintragen (Zeile 2-5:)
So, jetzt kommen die Dinge, die Sie anpassen müssen. In Zeile 2-5 notieren Sie den Namen der Datenbank, den Datenbankhost und Ihre MySQL-Zugangsdaten. Die per Voreinstellung dargestellten Werte funktionieren nur, wenn Sie CMBasic lokal mit dem Webserver XAMPP einrichten. Die müssen Sie also ändern.
Hier eine Beispielkonfiguration für einen fiktiven Dienstleister:
(2) $dbname = "dx3498212"; // Name der Datenbank
(3) $dbhost = "localhost"; // Datenbankhost, meist localhost
(4) $dbuser = "dx3498212"; // Benutzername für MySQL
(5) $dbpassword = "ZudXTckS3r_s"; // Passwort für MySQL
Noch einmal zusammengefasst: Welche Daten Sie eintragen müssen, erfahren Sie von Ihrem Dienstleister.
Bitte achten Sie darauf, nur die Werte innerhalb der Gänsefüßchen anzupassen. Sie dürfen keine weiteren Zeichen ergänzen oder löschen!
Das sind die wichtigen Zeilen. Alles andere können Sie dagegen vorerst so belassen! Sie wollen sofort starten? Installieren Sie CMBasic jetzt. Und passen Sie die anderen Variablen und Konstanten einfach nachträglich an! Sie können die Datei config.inc.php ja später erneut bearbeiten und hochladen.
Bei Bedarf: Weitere Einstellungen anpassen
Lust, das Weitere zu prüfen bzw. einzustellen? Na dann geht es einfach los!
Voller Navigationsbaum? (Zeile 6)
Sie möchten, dass das Hauptmenü stets voll aufgeklappt erscheint? Das ist die Voreinstellung! Belassen Sie bei $fulltree einfach die 1. Ansonsten tragen Sie dort eine 0 ein. Dann bleiben die Unterzweige eingeklappt und klappen erst aus, wenn Sie das dazugehörige Obermenü anklicken.
Hinweis: Auf dieser Präsenz habe ich $fulltree auf 0 gesetzt!
HTML-Editor TinyMCE anzeigen? (Zeile 7)
Entscheiden Sie sich hier, ob Sie den HTML-Editor TinyMCE sehen wollen oder nicht. Ich würde diese Einstellung auf 1 belassen. Die 1 ist voreingestellt und steht für anzeigen. Sie können dann trotzdem außer der Reihe den Texteditor wählen. Haken Sie beim Bearbeiten die Checkbox HTML ab.
Tabellenpräfix ändern? (Zeile 8)
Hier können Sie den Tabellenpräfix ändern. Das ist vor allem dann wichtig, wenn Sie mehrere CMBasic-Instanzen in einer Datenbank speichern wollen. Jede Version sollte dann einen anderen Präfix erhalten.
CSS-Ordner einstellen für anderes Template? (Zeile 9)
In Zeile 9 wählen Sie eins der vielen Templates aus. Welches gefällt Ihnen am besten? Tippen Sie in Gänsefüßchen einfach den Ordnernamen dieses Templates ein.
Die Templateordner finden Sie unter dem Pfad templates/css. Sie können hier natürlich nur einen Ordner eintragen, den es auch gibt. Voreingestellt ist
Tipp: Jedes Template bringt eine eigene index.php mit. Die liegt im Template-Stammordner und kann beliebig angepasst werden.
Diese index.php wird bei Auswahl des entsprechenden Templates eingelesen. Passen Sie diese Datei und die dazugehörigen CSS-Dateien an, wenn Sie ein Template individualisieren möchten. Einen Templateworkshop finden Sie hier.
Freundliche URLs einstellen? (Zeile 10)
Suchmaschinenfreundliche URLs sind eine feine Sache. So wie hier auf cmbasic.de! Per Voreinstellung sind dagegen dynamische URLs eingestellt. Aus Sicherheitsgründen, da nicht jeder Webhoster suchmaschinenfreundliche URLs unterstützt.
Sie wollen suchmaschinenfreundliche URLs einstellen? Das gelingt, wenn Ihr Webhoster das Modul mod_rewrite unterstützt. Dann setzen Sie den Wert 0 auf 1. Außerdem müssen Sie die Datei htaccess.txt aus dem CMBasic-Stammordner umbenennen in .htaccess.
Mehr zu dieser Problematik erfahren Sie in einem extra Beitrag zum Einstellen suchmaschinenfreundlicher URLs.
Wo soll das Loginmodul angezeigt werden? (Zeile 11)
Um sich in CMBasic einzuloggen, hängen Sie normalerweise /backend an Ihre URL an. Es gibt aber zusätzlich auch eine Loginmöglichkeit im Frontend, also direkt auf der Website. Per Voreinstellung ist es ein Hyperlink.
Hinweise für Profis: Das Frontend-Loginmodul wird nur angezeigt, wenn im Template der Einschub {felog} verwendet wird. Bei den mitgelieferten Templates ist das jedoch in aller Regel der Fall. Wo dieses Modul angezeigt wird, bestimmt der Ersteller des Templates. Hier finden Sie einen Workshop zum Erstellen bzw. Anpassen der CMBasic-Templates.
Doch zurück zum Frontend-Loginmodul. Sie wollen keins? Ersetzen Sie die voreingestellte 1 durch eine 0.
Frontend-Loginmodul nur auf einer Seite anzeigen
Sie wollen dieses Frontend-Loginmodul nur auf einer ausgewählten Unterseite einblenden? Damit es nicht sofort ins Auge fällt? Dann notieren Sie statt 0 oder 1 einfach den URL-Anhang der entsprechenden Seite. Bitte in Gänsefüßchen.
So sieht es aus, wenn sich das Loginmodul auf der Unterseite für das Impressum befindet und der URL-Anhang impressum lautet:
$frontlogin = "impressum"; // ...Frontend-Loginmöglichkeit als Formular statt als Link
Per Voreinstellung verbirgt sich hinter dieser Loginmöglichkeit ein Hyperlink. Das ist in Zeile 35 so voreingestellt:
$frontlogintyp = "link";Sie wollen daraus ein Formular machen? Schreiben Sie:
$frontlogintyp = "iframe";Dadurch wird ein Loginformular in einem Inline-Frame dargestellt.
Der Link ist die sicherste Variante. Ich empfehle, auf das Formular zu verzichten!
Mehrere CMBasics pro Präsenz? (Zeile 13)
Zeile 13 ist nur interessant, wenn Sie mehrere CMBasics auf Ihrer Präsenz installiert haben. Hier können Sie eine interessante Einstellung vornehmen.
Sie möchten, dass ein einmal angemeldeter Nutzer in alle CMBasics eintreten kann? Praktisch, wenn alle CMBasics eine Einheit bilden und zusammenhängen!
Dann ändern Sie nichts!
Sie wollen dagegen, dass jedes CMBasic ein eigenständiger Bereich ist? Dann müssen Sie einen abweichenden Wert eintragen. Das könnte im zweiten CMBasic dann so aussehen:
define('CMBASICLOG', 'ZweitesLogin'); // ...Alternative Startseite (Splashpage) einbinden? (Zeile 16)
Sie wollen eine alternative, statische Startseite einbinden? Um einen ganz individuellen »Eingang« in CMBasic zu schaffen?
Erstellen Sie diese Seite, nennen Sie sie beispielsweise splash.html und legen Sie diese im Stammordner von CMBasic ab. Entfernen Sie nun das Kommentarzeichen // am Anfang der Zeile 16. Dann sieht es so aus:
define('SPLASH', 'splash.html'); // ...Statistikfunkion ein oder aus? (Zeile 19)
Die nächste Option ist sicher selbsterklärend. Zeile 19 steuert, ob das Statistikmodul ein- oder ausgeschaltet werden soll. Per Voreinstellung ist es an:
define('STATS', TRUE); // ...Wenn Sie es ausschalten wollen, ersetzen Sie TRUE durch FALSE.
Wie kommen Sie an die statistischen Daten? Das gelingt über das Backend. Wählen Sie den Punkt Skripte und klicken Sie dann auf Zugriffsstatistik.
Beachten Sie, dass diese Zugriffsstatistik nur eine ungefähre Übersicht über die Anzahl der Seitenabrufe pro Monat und pro Jahr gibt.
Kleine Helfer: Die neuen Minibots
Zeile 21 bis 32 kümmern sich um die neuen Minibots, die in CMBasic 1.6 Einzug gehalten haben. Sie steuern die Meta-Tags für Beschreibung und Stichworte, verschleiern die E-Mail-Adresse oder aktivieren eine Lightbox-Galerie. Auch Audio- und Videodateien lassen sich per Minibot abspielen und eine Sitemap gibt es ebenfalls.
Per Voreinstellung sind (fast) alle Minibots aktiv und das ist auch gut so.
Wie Sie diese per Minibot gesteuerten Funktion nutzen, erfahren Sie in der Anleitung zu den neuen Features von CMBasic 1.6.
Welchen Videoplayer möchten Sie sehen?
Für die Anzeige der Videos gibt es zwei konkurrierende Minibots. In der Voreinstellung ist der FLV-Videoplayer eingestellt. Das ist ein kommerzieller Videoplayer, den Sie nur bei privaten, nicht-gewerblichen Websites lizenzfrei nutzen können.
(29) define('FLV', TRUE); // entweder JW FLV Videoplayer*
(30) // define('VIDEO', TRUE); // oder freier Videoplayer*
Die Zeile für den alternativen, freien Videoplayer dagegen habe ich auskommentiert.
Falls Sie lieber Lizenzkosten sparen und den freien Videoplayer verwenden wollen, kommentieren Sie Zeile 29 aus und entfernen die Kommentarzeichen vor Zeile 30.
(29) // define('FLV', TRUE); // entweder JW FLV Videoplayer*
(30) define('VIDEO', TRUE); // oder freier Videoplayer*
Optionen zur Steuerung der Blogansicht
Last but not least schauen wir uns Zeile 38 bis 40 an. Sie sehen komplizierter aus, als sie sind!
... to be continued.