Installations- Hilfe

Installations- Hilfe
Anleitungen zur Administration des CMS "Self!Service lite" - www.cms-self-service-lite.at
Installations- Hilfe
1
Self!Service lite - Installationshilfe
1.1
Schnellstart - Anleitung
4
1.2
Schnelleinstieg zur manuellen Installation
7
1.3
Inhalt des Download- Paketes / Upload
9
1.4
Einbindung des CMS
12
1.5
Erweiterte Menüeinbindung
16
1.6
Klassen der Menüs zur Formatierung mit CSS
20
1.7
Die relevanten CSS- Dateien
22
1.8
Snippets - das Erstellen von "Code- Fragmenten"
25
1.9
Anpassung diverser Bezeichnungen - die "Sprache- Dateien"
30
1.10 Anpassung des Formulares zu "Bestellung abschließen" / Online- Shop
32
1.11 Der Ordner "customized" - für Anpassungen und Änderungen
34
1.12 Templates
36
1.13 Weiteres
38
Self!Service lite - Installationshilfe
Installations- Hilfe - 3
www.cms-self -serv ice-lite.at
Schnellstart - Anleitung
Dateien hochladen
Alle Dateien (entpackt) auf den eigenen Server- Account hochladen.
Schreibrechte vergeben
Dem Ordner "self_service_lite" und der Datei "self_service_lite.php" die
Dateischreibrechte (CHMOD) 777 zuweisen.
Installations- Hilfe - 4
www.cms-self -serv ice-lite.at
Ordner öffnen > Schreibrechte vergeben
Den Ordner "self_service_lite" öffnen und der darin befindlichen Datei "update.php" die
Dateischreibrechte (CHMOD) 777 zuweisen.
"update.php" aufrufen - Installation starten
Die Seite "http://ihre-domain.com/self_service_lite/update.php" im Browser aufrufen:
1. MD5- Prüfsumme holen - mit Klick auf diesen Link wird die CMS- Downloadseite
geöffnet, dort ist die MD5- Prüfsumme zu finden. Diese kopieren und in das
2. Eingabefeld einfügen
3. Danach die Installation starten. Nach erfolgreiche Installation erscheint die
Erfolgsmeldung "Vorgang erfolgreich abgeschlossen"
4. Rufen Sie nun die soeben installierte Seite auf
Installations- Hilfe - 5
www.cms-self -serv ice-lite.at
Seite aufrufen - Admin aufrufen - Zugangsdaten eingeben
Beachten Sie bitte den kurzen Willkommenstext.
Danach die Admin- Zugangsdaten definieren:
1. klick auf "Admin" (meist unten zu finden, je nach Template)
2. Zugansdaten eingeben
3. speichern
Nach erfolgreichem Speichern der Zugansdaten werden Sie aufgefordert, sich mit diesen
soeben definierten Zugansdaten anzumelden.
FERTIG - das CMS ist bereit zur Befüllung!
Installations- Hilfe - 6
www.cms-self -serv ice-lite.at
Schnelleinstieg zur manuellen Installation
Ist die "automatische Installation" nicht möglich oder nicht gewünscht, kann das CMS auch
manuell installiert werden. Hierfür ist auf der CMS Download- Seite unter "weitere
Downloads" die Datei "CMS Gesamtsystem" als Download zu finden.
Hier die Vorgehensweise zur manuellen Installation:
1) Upload
Upload des Ordners "self_service_lite" sowie der Datei "self_service_lite.php".
Und natürlich upload der PHP- Datei(en) in der das CMS eingebunden ist...
2) Dateischreibrechte vergeben
Dateischreibrechte (CHMOD) 777 benötigen die Ordner "_temp_gallery_files", "content",
"preferences" und (wenn ein RSS Feed betrieben werden soll) "rss".
FERTIG
Installations- Hilfe - 7
www.cms-self -serv ice-lite.at
Danach...
Die Site aufrufen: www.ihre_domain.com/index.php (absoluter Speicher- Pfad des Systems).
Sie werden aufgefordert, Benutzername und Passwort zu vergeben.
Danach mit den eben definierten Zugangsdaten anmelden und die administrative Ebene wird
aufgerufen!
Installations- Hilfe - 8
www.cms-self -serv ice-lite.at
Inhalt des Download- Paketes / Upload
Was beinhaltet die Download- Datei des CMS? Was wird auf den Server hochgeladen?
Hier sind alle Ordner und Dateien aufgelistet, welche mittels der "automatischen Installation"
nachgeladen bzw. bei "manueller Installation" hochgeladen werden müssen.
Inhalt des Download- Paketes "CMS Gesamtsystem"
Inhalt des Ordners "self_service_lite"
1.
2.
3.
4.
5.
6.
7.
8.
Ordner für die temporäre Speicherung der Bilder aus dem "Galerie Editor"
CSS- und JavaScript- Dateien sowie "Sprach- Datei" für das "Backend"
Script für Generierung des CAPTCHA Spamschutzes
Inhalt der Seiten - Text, Bild, Downloaddateien
dieser Ordner enthält vom Benutzer geänderte und angepasste Dateien
CSS- und Sprach- Datei für "Frontend"
Script für die "Lightbox bzw. Greybox"
die "Hilfe- Datei" zur Administration
Installations- Hilfe - 9
www.cms-self -serv ice-lite.at
9.
10.
11.
12.
13.
Seiten und Scripte für den "Multiuploader" des Galerie Editors
Dateien mit Grundeinstellungen, Lizenz- Keys, Passwörter,...
der RSS 2.0 Feed
diverse Hilfe- Scripte
der Text- Editor "TinyMCE"
Dateischreibrechte (CHMOD) 777 benötigen die Ordner 1, 4, 10 und 11
Bei Updates NIEMALS 4, 5, 10 und 11 überschreiben!
NIEMALS Änderungen in Dateien außerhalb "customized" durchführen!
Mindestupload für jede Anwendung
... sowie die PHP- Datei in der das CMS eingebunden ist (index.php) und geg. die eigene
CSS- Datei
Dateischreibrechte im Ordner "self_service_lite" beachten!
Upload mit "Menüeditor"
Wie "Mindestupload" plus (optional):
1. wenn URL- Design erwünscht ist
2. wenn "Suchmaschinen- Sitemap generieren" erwünscht ist. Die Datei "sitemap.xml"
benötigt Dateischreibrechte 777
Installations- Hilfe - 10
www.cms-self -serv ice-lite.at
3.
wenn 2) dann in der Datei "robots.txt" die Adresse der Datei "sitemap.xml" eintragen
Installations- Hilfe - 11
www.cms-self -serv ice-lite.at
Einbindung des CMS
Welche Einbindungen ("includes") sind nötig?
WICHTIG:
Die PHP- Datei, in der das CMS eingebunden wird darf im Datei- Namen KEINEN Bindestrich
enthalten!
Mindestaufwand
1.
2.
3.
Einbindung des gesamten "Systems" VOR dem Doctype. Genauer Wortlaut: <?php
include ("self_service_lite.php"); ?> Vor dem <?php darf absolut nichts geschrieben
stehen, auch keine Leerzeichen oder Leerzeilen!
Einbindung der Datei "self_service_head.php" - alle für den Betrieb relevante CSS- und
JavaScript- Dateien - DANACH Einbindung der eigenen CSS- Datei. Genauer Wortlaut:
<?php include ("self_service_lite/backend/self_service_head.php"); ?>
Einbindung der mit dem CMS generierten Inhalte. Genauer Wortlaut: <?php echo
$self_service_content; ?>
Installations- Hilfe - 12
www.cms-self -serv ice-lite.at
Einbindung der Navigation
An beliebiger Stelle wird eine "ungeordnete Liste (<ul>)" generiert. Genauer Wortlaut: <?php
echo self_service_menue(); ?>
Mehr Möglichkeiten und Einstellungen zur Einbindung der Navigation siehe "Erweiterte
Menüeinbindung"
Installations- Hilfe - 13
www.cms-self -serv ice-lite.at
Weitere Einbindungen
Nur bei Einsatz des Menü Editors sind auch folgende Einbindungen möglich:
1. Generiert eine "Liste" der gewählten Menü Punkte (ähnlich wie (3)), hier für den "title"- Tag,
z.B.: Kontakt - Team (die Unterseite "Team" der Hauptseite "Kontakt" wurde gewählt). Auch
für andere Tags, z.B.: "meta / description" einstetzbar. Wird im Menüeditor ein eigener Text
als "Seitentitel" angegeben erscheint stattdessen der dort definierte Text. Genauer
Wortlaut: <?php echo $ssl_title_tag ?>
Installations- Hilfe - 14
www.cms-self -serv ice-lite.at
2.
3.
4.
5.
6.
Generiert Klassen- Bezeichnung analog zum gewählten Menüpunkt, z.B.: "index
sub_kontakt sub_team". Diese Klassen sind für diverse Sonder- CSS- Formatierungen
nützlich. Zusätzlich wird die Klasse "ssl_admin" dazugeschrieben wenn man sich zur
Administration angemeldet hat - Admin- Mode. Im Menüeditor sind dort auch
"Sonderklassen" für jeden Menüpunkt definierbar. Diese Sonderklasse wird ebenso hier
vermerkt. Genauer Wortlaut: <?php echo $ssl_body_class ?>
"Brotkrumen- Navigation": es wird eine "unsortierte Liste" generiert. Anzeige z.B.: Index >
Kontakt > Team". Genauer Wortlaut: <?php echo self_service_breadcrumb(); ?>
Auch ohne Menü Editor einsetzbar: "Suche"- Funktion": es wird ein Formular mit einem
Text- Input und einem Submit- Button generiert. Genauer Wortlaut: <?php echo
self_service_search(); ?>
Einbindung der "Sidebar". Genauer Wortlaut: <?php echo self_service_sidebar(); ?>
Anmeldeformular "für Besucher geschützte Seiten": soll das Anmeldeformular für
geschützte Seiten ("Mitglieder") nicht im Inhaltsbereich liegen sondern ständig z.B.: links
unter dem Menü liegen ist dieses mit dieser Syntax einbindbar. Genauer Wortlaut: <?php
include ("self_Service_lite/frontend/self_service_userlogin_form.php"); ?>
Weitere mögliche Sidebar Einbindungen:
•
self_service_sidebar('kontakt.php') : "Master- Sidebar" einer anderen Stammdatei (hier
"kontakt.php") einbinden.
•
self_service_sidebar('',1) : es werden immer beide Sidebars (Mastersidebar und Sidebar
für Unterseiten) angezeigt, die Mastersidebar oben
•
self_service_sidebar('',1,1) : es werden immer beide Sidebars (Mastersidebar und
Sidebar für Unterseiten) angezeigt, die Mastersidebar unten
Installations- Hilfe - 15
www.cms-self -serv ice-lite.at
Erweiterte Menüeinbindung
Allgemeines zur Syntax
<?php echo self_service_menue(1,'2','3','4','5'); ?>
•
•
•
Zur Zeit existieren in der Klammer 5 Variablen zur genaueren Definition jeder Einbindung
einer Navigation.
Ausgenommen die erste Variable sind alle in einfachen Anführungszeichen zu schreiben
und werden mittels Beistrich getrennt.
Werden nicht alle 5 Variablen benötigt, sind immer die "vorigen"mit anzugeben - Bsp.:
wird die dritte Variable benötige sind ebenso die erste und die zweite anzugeben, die
vierte und fünfte sind nicht nötig - <?php echo self_service_menue(1,'2','3'); ?>
Standardeinbindung:
<?php echo self_service_menue(); ?>
Die Standard- Einbindung: das gesamte Menü samt aller Unterebenen wird angezeigt.
1) nur eine Ebene anzeigen:
<?php echo self_service_menue(1); ?>
Nur die erste Ebene des Menüs wird angezeigt, es ist jede Ebene mit der passenden Zahl
einzeln einbindbar.
Anwendungsbeispiel: oben wird die erste Ebene des Menüs angezeigt, die andere/n Ebene/n
an anderer Stelle.
2) einzelnen Menüstrang oder Menü aus anderer Stammdatei anzeigen:
<?php echo self_service_menue(1,'index.php?g=produkte') ?>
Wird eine eigene Stammdatei (z.B. zur Anzeige diverser externer Scripte) verwendet oder soll
nur ein bestimmter Menüstrang angezeigt werden, wird dies in der zweiten Variablen
angegeben.
Anwendungsbeispiel: hier oben werden alle Untermenüpunkte des Hauptmenüpunktes
"Produkte" (ohne dem Hauptmenüpunkt "Produkte") der Stammdatei "index.php" angezeigt.
Weiteres Anwendungsbeispiel: Soll in einer eigenen Stammdatei das Menü der Stammdatei
"index.php" angezeigt werden, wäre dies die gleiche Syntax wie oben, nur ohne
"?g=produkte".
Installations- Hilfe - 16
www.cms-self -serv ice-lite.at
3) Eine Ebene mit Submenüs:
<?php echo self_service_menue(2,'','submenues'); ?>
Durch Eingabe von "submenues" als dritte Variable werden alle weiteren Unterebenen (falls
vorhanden) ebenfalls angezeigt. Wird diese Variable leer gelassen, werden die Untermnüs
nicht angezeigt.
Anwendungsbeispiel: unter 1) wurde die erste Ebenen oben angezeigt, mit dieser Syntax wird
die zweite Ebene plus alle vorhandenen Unterebenen angezeigt. Die zweite Variable wird hier
nicht benötigt, sie besteht aus zwei einfachen Anführungszeichen inkl. Beistriche als
Abgrenzung.
4) Alle oder nur aktive Submenüs offen
<?php echo self_service_menue(2,'','submenues','all_open'); ?>
Die Angabe von "all_open" als vierte Variable gibt an, ob vorhandene Unterebenen immer
vorhanden sein sollen oder nur wenn der darüberliegende Menüpunkt aktiv (also gewählt) ist.
Mit der Eingabe von "all_open" sind alle Unterebenen immer vorhanden, wird diese Variable
leer gelassen sind nur die aktiven Untermenüs vorhanden. Dies verhält sich gleich wie die
Menü- Einstellung in den "Grundeinstellungen" des CMS, überschreibt diese aber.
Anwendungsbeispiel: sollen die Unterebenen per "DropDown"- Funktion eingeblendet
werden, müssen dies immer vorhanden sein - hier "all_open" angeben.
5) Sichtbarkeit des Menü
<?php echo
self_service_menue(2,'index.php?g=rechtliches','submenues','all_open','all_visible'); ?>
Übertrumpft das "unsichtbar stellen" eines Menü(stranges) im Menüeditor - mit dieser
Angabe ist dieses Menü immer sichtbar.
Anwendungsbeispiel: siehe Beispiel unten - ""
WEITERE ANWENDUNGSBEISPIELE:
Drei unabhängige Menüs - oben, links und unten:
<?php echo self_service_menue(2,'index.php?g=oben'); ?>
<?php echo self_service_menue(2,'index.php?g=links','submenues'); ?>
<?php echo self_service_menue(2,'index.php?g=unten'); ?>
Im Menüeditor werden drei Hauptmenüpunkte erstellt - "oben", "links", "unten". In den
Installations- Hilfe - 17
www.cms-self -serv ice-lite.at
Grundeinstellungen wird "Nur aktive Untermenues anzeigen" angehakt. Die erste Syntax zeigt
das einfache Menü oben ohne Submenüs (für z.B "Impressum", oder "AGB"). Die zweite Syntax
zeigt das "große" Menü auf der linken Seite - für z.B. "Produkte" oder "Team" samt ev.
vorhandener Untermenüs. Unter wird mit der dritten Syntax eine weitere unabhängige
Menüebene angezeigt.
Die erste Hauptebene mit den Menüpunkten "oben", "links" und "unten" wird nirgends
angezeigt.
Oben Hauptmenü mit DropDown für Submenüs, rechts nur (zusätzlich) das Menü der
Produkte- Palette:
<?php echo self_service_menue(); ?>
<?php echo self_service_menue(1,'index.php?g=produkte','submenues',''); ?>
Die erste Syntax bindet das gesamte Menü ein (inkl. "Produkte"), inkl. aller Submenüs als
DropDown. In den Grundeinstellungen ist hierfür "Nur aktive Untermenues anzeigen" nicht
angehakt (alternativ ließe sich hier auch die 4te Variable verwenden...). Die zweite Syntax zeigt
nur den Menüstrang des Hauptmenüpunktes "Produkte" an. Sind Unterebenen vorhanden
werden diese - dank der leeren vierten Variable - nur dann angezeigt wenn auf einen der
darüber liegenden Punkte geklickt wurde.
Einfache zweisprachige Seite:
<?php echo self_service_menue(1); ?>
<?php echo self_service_menue(2,'','submenues'); ?>
Im Menüeditor werden zwei Hauptmenüpunkte erstellt - "Deutsch", "English". In den
Grundeinstellungen wird "Nur aktive Untermenues anzeigen" angehakt. Die erste Syntax zeigt
die beiden Hauptmenüpunkte "Deutsch" und "English" an, z.B. oben rechts auf der Site. Die
zweite Syntax zeigt an beliebiger Stelle die Untermenüpunkte zum gewählten Hauptmenüpunkt
an, also das Menü für die deutsche oder die englische Ausgabe.
Werden Formulare, der Shop und ähnliches verwendet - alles was Sprachvariablen aus den
Language- Dateien benötigt - ist eine zweisprachige Seite mit einer eigenen Stammdatei
besser realisierbar.
Installations- Hilfe - 18
www.cms-self -serv ice-lite.at
"AGB" und "Impressum" rechts oben, die Hauptnavigation links:
<?php echo self_service_menue(); ?>
<?php echo self_service_menue(1,'index.php?g=rechtliches','','all_open','all_visible'); ?>
Die erste Syntax zeigt die gesamte Navigation auf der linken Seite an, in den
Grundeinstellungen ist "Nur aktive Untermenues anzeigen" angehakt. In dieser Navigation
befindet sich ein Hauptmenüpunkt namens "Rechtliches" mit den dazugehörigen
Untermenüpunkten "AGB" und "Impressum". Der Hauptmenüpunkt "Rechtliches" ist im
Menüeditor unsichtbar gestellt (samt Untermenüpunkte) und erscheint somit im Menü auf der
linken Seite nicht. Die zweite Syntax zeigt nun die Punkte "AGB" und "Impressum" an. Variable
2 gibt hierbei den Menüstrang an, Variable 3 ist leer da kein Unteruntermenü zu erwarten ist,
Variable 4 bewirkt die ständige Anzeige (auch wenn der übergeordnete Menüpunkt nicht aktiv
ist) und die Variable 5 übertrumpft die Einstellung aus dem Menüeditor und macht die beiden
Menüpunkte sichtbar.
Installations- Hilfe - 19
www.cms-self -serv ice-lite.at
Klassen der Menüs zur Formatierung mit CSS
Erklärung des generierten HTML- Codes bei Menüs - inkl. Klassen zur CSS- Formatierung
Der HTML- Code - eine verschachtelte "unordered list"
1.
2.
3.
4.
5.
6.
7.
8.
jede <ul>- Liste, egal welcher Ebenen, erhält die Klasse "sslmenue"
Klasse der ersten Ebene - "sub1" - das Hauptmenü
Name der Stamm- Datei (ohne .php)
die <li> - Listenelemente erhalten eine Klasse zusammengesetzt aus dem Prefix "sub_"
und einer standardkonformen Umwandlung des Namens des Menüpunktes (keine
Sonderzeichen, aus Leerzeichen werden "_",...)
der Link zur gerade ersichtlichen Seite bekommt die Klasse "sslmenueactive" - in allen
beteiligten Ebenen (im Bsp. ist die Seite "Kabel" als Untermenü- Punkt von "Produkte" zu
sehen)
das erste "Untermenü" erhält die Klasse "sub2", zusätzlich zu "sslmenue" und "index" siehe 1) und 3)
das <li> - Element des Submenüs erhält die Klasse des "Mutter- <li> - Elementes" (hier
"sub_produkte") sowie die dementsprechende aufbereitete
Bezeichnung der Menü- Punkte
Installations- Hilfe - 20
www.cms-self -serv ice-lite.at
Sämtliche Klassen- Zuweisungen setzen sich in dieser Art fort, somit sollten sämtliche
Ebenen und Links per CSS "ansprechbar" und formatierbar sein. Bei Zweifel den HTML- Code
der zu formatierenden Seite aufrufen. Weitere Infos und Anwendungen sind als kostenlose
Templates auf unseren Seiten zu finden.
Im Menüeditor ist für jeden Menüpunkt zusätzlich die Vergabe einer "Sonderklasse" möglich.
Diese befindet sich nach 4) und ermöglicht die separate Darstellung dieses Listenelementes
bzw. dessen Inhalt.
ACHTUNG: diese "Sonderklasse" wird geg. auch in den "body- Tag" geschrieben. Für
Formatierungen die nur für das Menü gelten bitte die vollständige Kaskade verwenden, z.B.:
ul.sslmenue li.sonderklasse { padding-top:15px; }
Installations- Hilfe - 21
www.cms-self -serv ice-lite.at
Die relevanten CSS- Dateien
Im Ordner "self_service_lite" befinden sich die CSS- Dateien für "Frontend" sowie für
"Backend" - Vorgehensweise bei Anpassungen
CSS- Dateien für "Frontend"
Diese CSS- Dateien regeln bereits den Großteil des Layouts der Besucheransicht.
1. "main.css" bindet alle nötigen CSS- Dateien ein und regelt die Ansicht beinahe aller
Frontend- Element
2. "ie_frontend.css" beinhaltet Sonderformatierungen für den "Microsoft Internet Exploerer"
3. "admin_login.css": regelt die Ansicht des Anmeldeformulares für den Administrator
NIEMALS CSS- Dateien im Ordner "frontend" bzw. "backend" ändern!
Bei System- Updates werden diese Dateien ersetzt, es würden von Ihnen hier getätigte
Änderungen überschreiben werden!
Die Gewichtungen der Kaskaden sind bewußt hoch gewählt. Bei Änderungswünschen bitte
den gesamten relevanten Block in die passende CSS im Ordner "customized" kopieren
und dort umschreiben:
Installations- Hilfe - 22
www.cms-self -serv ice-lite.at
Beispiel: Änderung des Aussehens des "Send- Buttons" eines Formulares:
Der Abschnitt aus der Datei "self_service_lite/frontend/main.css". Es soll Rahmenfarbe und
Hintergrundfarbe geändert werden.
Formatierungen kopieren
Den gesamten Formatierungsblock in die CSS- Datei "customized/frontend.css" kopieren.
Rahmenfarbe und Hintergrundfarbe ändern, der Rest kann gelöscht werden.
Installations- Hilfe - 23
www.cms-self -serv ice-lite.at
Die Änderungen
Die CSS- Datei mit diesen geänderten Formatierungen ("customized/frontend.css") ist
NACH den Original- CSS- Dateien im "head" eingebunden und überschreiben somit die
ursprünglichen Angaben.
CSS- Dateien für "Backend"
1.
2.
Die Haupt- Css- Datei mit allen für die Administration wichtigen Formatierungen.
Sonderformatierungen für den Galerie Editor
Änderungen und Erweiterungen der CSS- Definitionen für das Backend bitte NUR in
"customized/backend.css" eintragen - Vorgehensweise wie bei Frontend- CSS ("Kopieren Ändern - ...")
Installations- Hilfe - 24
www.cms-self -serv ice-lite.at
Snippets - das Erstellen von "Code- Fragmenten"
Das Erstellen von "Code- Fragmenten", welche mit dem TinyMCE ausgewählt werden können.
Grundlegendes:
Die Datei, welche die in Folge erklärten Daten und Syntaxe enhält, muß die Bezeichnung
"template.html" tragen.
PHP- Code wird aus Sicherheitsgründen nicht ausgeführt, JavaScript ist nat. jederzeit möglich.
Der gesamte Ordner mit dem Snippet wird als gepackte ZIP- Datei über den "Snippet
Manager" in das CMS geladen und ist so auch für Administratoren verwaltbar.
Beim Aufbau einer Website werden alle im Ordner "self_service_lite/customized/ssl_snippets"
befindlichen Snippets aufgerufen, das Vorhandensein eines oder mehrer dieser Snippets
geprüft und diese dargestellt bzw. geladen. Aus Performancegründen wird daher empfohlen,
nur die Snippets in den genannten Ordner zu laden, welche auch wirklich verwendet werden.
Beispiel: ein mp3- Player mit Angabe zweier Größen bzw. Bezeichnungen (Variablen).
Ansicht im PopUpfenster:
Bitte mit der Nummerierung in der übernächsten Abbildung vergleichen.
Installations- Hilfe - 25
www.cms-self -serv ice-lite.at
Ansicht im Texteditor
Die Syntax:
WICHTIG: jede der ersten drei Anweisungen muss/darf in EINER Zeile stehen.
Bitte mit der Nummerierung in der ersten Abbildung vergleichen.
1.
2.
3.
4.
Die Bezeichnung des Snippets. Scheint im DropDown- Menü des Texteditors auf. Bitte
kurz und bündig, keine Sonderzeichen!
Beschreibung des Snippets und Erklärung der Eingabemöglichkeiten. Erscheint nach
Auswahl aus dem eben genannten DropDown. Sonderzeichen maskieren, einfaches
HTML (<b>, <br>, ...) möglich.
Syntax zur Variablenübergabe, Beschreibung folgt.
Das eigentliche Snippet, hier der HTML- Code eines Flash- mp3- Players.
Installations- Hilfe - 26
www.cms-self -serv ice-lite.at
Die Syntax
1.
2.
3.
4.
Einleitung eines jeden Snippets, muß immer exakt dieser Wortlaut sein.
interne und einmalige Bezeichnung des Snippets, nur Buchstaben, Zahlen und "_". Keine
Bindestriche, Leerzeichen Sonderzeichen o.ä., Kleinschreibung.
Variblen, immer mit "{" und "}" umschlossen, mehrere mit Leerzeichen getrennt.
der Abschluß der Syntax.
zu 4):
Es können beliebig viele Variablen vorgegeben werden. In der Reihenfolge, in der sie hier
aufgelistet sind, werden sie dann im "eigentlichen Snippet" (z.B. im obigen Flash- mp3Player) als mit "{" umschlungene Zahlen eingebunden (siehe nächstes Bild).
Spezial- Variablen:
{ssl:download}: die Adresse der im gleichen Datensatz hochgeladenen Datei
{ssl:url}: die absolute Adresse der gerade aufgerufenen Seite
{ssl:id}: die ID des Datensatzes, in der das Snippet sich befindet
Weiter Spezial- Variablen können folgen, bitte regelmässig die CMS- Site besuchen oder RSSFeed abonnieren.
Die Variablen
Die Zeile mit der Syntax enthält hier 3 Variablen, welche teilweise vom Admin im Texteditor
eingegeben werden können.
Installations- Hilfe - 27
www.cms-self -serv ice-lite.at
1.
2.
3.
Die hier notierte Spezial- Syntax ist die erste Syntax in der Reihe. Sie besagt: "schreibe die
Adresse der Upload- Datei an die passende Stelle in den Flash- Player - {1}
Die zweite Variable wird hier für die Angabe der Breite genutzt ( {2} ), also 400.
Die dritte Variable schreibt einen optionalen Songtitel in den Player ( {3} ).
Die Zeile mit der Syntax gibt die Reihenfolge vor, die Einbindung in den darunterliegenden
HTML- Code muß nur inhaltlich der obigen Reihenfolge entsprechen.
Ein weiteres Beispiel: Einbindung eines iFrames
1.
2.
3.
4.
5.
die Webadresse der Seite, welche in den iFrame geladen werden soll
die Breite des iFrame
die Höhe des iFrame
Breite des Frame- Rahmens
Scrollbalken - Ja oder Nein
Snippets ohne Variablen
Für immer wieder benötigte Elemente läßt sich auch ein Snippet ohne Variablen definieren.
Verwendung findet dies z.B. für Tabellen zu Seminaren (Ort, Zeit, Referent,...) oder Infos zum
Autor eine Beitrages (Name, Beschreibung, Domain).
Installations- Hilfe - 28
www.cms-self -serv ice-lite.at
Wird ein solches Snippet in den Texteditor geladen erscheint der Inhalt sofort im Klartext und
kann dort ev. geändert oder ergänzt werden.
Anstatt der oben beschriebenen Syntax steht in der dritten Zeile des Templates nur: []
Installations- Hilfe - 29
www.cms-self -serv ice-lite.at
Anpassung diverser Bezeichnungen - die "SpracheDateien"
Diverse aus dem CMS generierten Bezeichnungen sind in Sprach- Dateien ausgelagert.
Allgemeines, Wichtiges
Sonderzeichen (Umlaute, &, ...) müssen maskiert werden (z.B.: Ü wird zu &Uuml;)
HTML- Tags sind möglich (z.B.: <em>Preis</em>)
NIEMALS Dateien direkt in den Ordnern "frontend" bzw. "backend" ändern!
Frontend
Die Datei "self_service_lite/frontend/frontend_language.php" in einem Texteditor öffnen.
Texte ändern
Beispiel: "bestellen" soll zu "jetzt bestellen" geändert werden. Die gesamte markierte Zeile in
die Datei "customized/frontend_languge.php" kopieren und dort anpassen.
Installations- Hilfe - 30
www.cms-self -serv ice-lite.at
Backend
Gleiche Vorgehensweise wie oben - kopieren der gesamten Zeile in
"customized/backend_language.php" und dort anpassen.
Installations- Hilfe - 31
www.cms-self -serv ice-lite.at
Anpassung des Formulares zu "Bestellung abschließen" /
Online- Shop
Anpassung und Erweiterung des Formulares zum "Abschluß der Bestellung" - Name,
Adresse,...
Das Formular:
Um bei diesem Formular die Abfrage der Besteller- Daten zu erweitern die Datei
"self_service_lite/customized/frontend_language.php" öffnen und mit folgende
Sprachvariablen ergänzen:
Pflichtfeld:
$LANGUAGE_CART_FORMFIELDS['extra_input1_mandatory'] = ""; /* pflicht - mandatory - no
label > no input */
Kein Pflichtfeld:
$LANGUAGE_CART_FORMFIELDS['extra_input1'] = ""; /* no label > no input */
Installations- Hilfe - 32
www.cms-self -serv ice-lite.at
Diese Eingaben können beliebig oft wiederholt werden, es muß jedoch die darin
erscheinende Zahl erhöht werden.
Dies kann dann z.B so aussehen:
1.
2.
3.
Durchnummerierung der neuen Eingabefelder
"_mandatory" als Variablenanhang generiert ein "Pflichtfeld", welches vom Besteller
ausgefüllt werden muss.
der "Feldname" - bitte kurz halten, Sonderzeichen geg. maskieren.
Installations- Hilfe - 33
www.cms-self -serv ice-lite.at
Der Ordner "customized" - für Anpassungen und
Änderungen
Dateien zur eigenen Bearbeitung.
Nur hier sollten Anpassungen und Änderungen passieren!
Etwaigen Updates und Erweiterungen des Systems können auch Erweiterungen diverser
Dateien nach sich ziehen und würden von Ihnen getätigte Änderungen wieder
überschreiben!
Es wird daher dringend empfohlen, keinerlei Dateien direkt zu Ändern sondern die
relevanten Passagen in einer der unten stehenden Dateien zu kopieren und Änderungen
dort vorzunehmen. Diese persönlichen Anpassungen überschreiben die in den OriginalDateien befindlichen Definitionen.
1.
2.
3.
4.
5.
6.
backend.css: für Anpassungen der CSS- Anweisungen der Admin- Ansicht
backend_language.php: für Änderungen der Sprachdatei der Administration
classes.txt: zeigt die für den Menüeditor sowie dem Hauptformular definierte Klassen an.
Der Inhalt dieser Datei wird auf den Hilfe- Seiten an passender Stelle verlinkt. Bitte mit
den definierten Klassen- Bezeichnungen konform halten! Eingabe von HTML- Code
möglich.
format_headline.css: CSS- Definitionen für das "DropDown Format" im Text- Editor im
Bereich "Überschrift"
format_text.css: CSS- Definitionen für das "DropDown Format" im Text- Editor im Bereich
"Standardansicht" und "Detailansicht"
für Anpassungen der CSS- Anweisungen der Besucher- Ansicht
Installations- Hilfe - 34
www.cms-self -serv ice-lite.at
7.
8.
frontend_language.php: für Änderungen der Sprachdatei der Besucheransicht
heading_headline.css: CSS- Definitionen für das "DropDown Absatz" im Text- Editor im
Bereich "Überschrift" - "Überschrift 1 bis 6" entspricht "h1 bis h6"
Installations- Hilfe - 35
www.cms-self -serv ice-lite.at
Templates
"Installation" der kostenlosen Templates.
Herunterladen der Templates
Auf der Seite "Self!Service lite - kostenlose Templates" stehen verschiedene kostenlose
Templates zum Download bereit. Diese bestehen meist aus einer "index.php", eine CSSDatei und der "_readme.txt".
Geg. befinden sich noch in einem Ordner diverse Bilder oder andere benötigte Dateien.
Geg. Einstellungen tätigen - hochladen
Je nach Template sind im Head- Bereich der index.php diverse Einstellungen möglich Farben, Abmessungen und mehr...
Sind die Einstellungen getätigt alle Dateien auf den Server hochladen und somit
existierende ersetzen - fertig!
Das Vorhandensein der "System- Dateien" (der Ordner "self_service_lite" sowie die Datei
"self_service_lite.php") wird vorausgesetzt!
Installations- Hilfe - 36
www.cms-self -serv ice-lite.at
Ein Template als Ausgangsdatei für eigene Kreationen
Selbstverständlich sind die Templates auch als Ausgangsversion für eigene Seiten- Layouts
einsetzbar. So gut wie alles läßt sich über die gelieferte CSS- Datei ändern. Vor allem der
Abschnitt mit den CSS- Definitionen der Navigation sollte als Grundlage nützlich sein.
Templates in Verbindung mit Fremd- Anbietern
Diverse Templates verwenden "Free HTML- Templates" von Fremdanbietern. Bei diesen
Angeboten bitte zuerst die Original- Dateien des Fremdanbieters herunterladen. Danach
diese Dateien mit unseren Anpassungen ergänzen. Das Vorhandensein der "SystemDateien" (der Ordner "self_service_lite" sowie "self_service_lite.php") wird auch hier
vorausgesetzt!
Siehe auch mitgelieferte "_readme.txt"!
Installations- Hilfe - 37
www.cms-self -serv ice-lite.at
Weiteres
Diverse Abfragen, praktische Variablen, weitere Informationen ...
Aufruf der Administration
Der Aufruf des Admin- Anmeldeformulares ist in mehreren Varianten möglich. Bei jeder
Variante ist man automatisch auf allen Seiten des Systems angemeldet.
1) Manuelle Eingabe: an die Web- Adresse der zu administrierenden Seite "?rc=login"
anhängen (z.B.: http://www.example.org/index.php?rc=login )
2) Verlinkung bei Einzelseiten: <a
href="http://www.example.org/index.php?rc=login">beliebiger Wortlaut</a>
3) Verlinkung in einem vollständigen CMS: <?php echo "<a
href='$centerpage?g=$g&amp;rc=login&amp;show=$show'>beliebiger Wortlaut</a>"; ?>
Feststellen ob ein Submenü für diese Seite existiert
1.
2.
Abfrage: existiert auf dieser Seite ein Submenue mit den obigen Param etern dann
schreibe diesen HTML- Code (oder setze eine Variable oder...)
Die Parameter/Syntax bitte der Anleitung "erweiterte Menüeinbindung" entnehmen.
Die kann genutzt werden um layouttechnische o.a. Elemente zu laden NUR wenn ein
Submenü existiert.
Diese Abfrage ist natürlich nur bei Verwendung des Menü- Editors möglich!
Einfachere Variante der Abfrage "Submenü: Ja/Nein"
1.
Hier wird nur nach Vorhandensein eines "-" in der "g- Variable" abgefragt. Die "gVariable" ist die Zeichenkette die die Navigationsstruktur beschreibt. Dies kann u.U. nicht
immer aussagekräftig sein.
Installations- Hilfe - 38
www.cms-self -serv ice-lite.at
Diese Abfrage ist natürlich nur bei Verwendung des Menü- Editors möglich!
Abfrage "Admin- Modus: Ja/Nein"
Die Abfrage eines existierenden Wertes der Variable "$ssl_adminmode" kann für diverse
Einbindungen speziell für den Admin- Modus verwendet werden. Der Admin- Modus ist auch
gegeben wenn man im Haupt- Menü auf "Besucheransicht" klickt! Verwendet wird diese
Abfrage z.B. in der Datei "self_service_lite/backend/self_service_head.php".
Abfrage bzw. Ausgabe der "manuell definierten Menü- Klassen"
Die im Menüeditor in das Eingabefeld "Klasse" eingegebene Bezeichnung kann durch
Abfrage der Variable $ssl_menue_class zur Weiterverarbeitung genutzt werden.
Anwendungsbeispiel: ein externes Reservierungsscript eines Hotels soll nur auf einer
bestimmten Seite (außerhalb des CMS- Inhaltsbereiches) angezeigt werden. Der Menüpunkt
dieser Seite bekommt die Klasse "reservierung":
<?php if (strstr($ssl_menue_class ,'reservierung')) { ?>
das Reservierungsscript
<?php } ?>
Abfrage bzw. separate Anzeige des "Zusatztextes" zu Menüpunkten
Die im Menüeditor eingegebenen "Zusatztexte" lassen sich auch separat anzeigen, z.B. in der
"Meta-Description" oder im "title"- Tag. Die Variable "$ssl_menue_subtext" liefert den reinen
Text, ohne umgebendes Element oder Formatierung.
Installations- Hilfe - 39
www.cms-self -serv ice-lite.at
Abfrage ob ein Produkt im Warenkorb liegt
Um z.B. einen externen Warenkorb- Link nur anzuzeigen wenn ein Produkt im Warenkorb
liegt wird die Variable "$ssl_items_in_cart" abgefragt.
Beispiel:
<?php
if ($ssl_items_in_cart) {
echo "<a href='$centerpage?g=$g&amp;rc=add&amp;show=$show'>Warenkorb</a>";
}
?>
Einbindung des "Mini- Warnkorb"
Syntax: <?php echo self_service_minicart("Artikel: <b>EUR</b>"); ?>
Ausgabe: 5 Artikel: EUR 25,50
Der in der Syntax in Klammer angeführte Text (HTML ist möglich) wird nach der Stückzahl und
vor dem Warenwert (beides in grün bei "Ausgabe") angezeigt. Das umschließende Element (P
oder Div) wird direkt vor bzw. nach dieser Ausgabe geschrieben.
Die Anzeige läßt sich nat. auch mit der eben erklärten Abfrage "ob ein Produkt im Warenkorb
liegt" kombinieren:
<?php
if ($ssl_items_in_cart) {
echo self_service_minicart("Artikel: <b>EUR</b>");
} ?>
Erweitertes und einfach änderbares Beispiel:
<?php if ($ssl_items_in_cart) { ?>
<div id="miniwarenkorb">
<?php echo self_service_minicart("Artikel: <b>EUR</b>"); ?>
</div>
<?php } ?>
Abfrage ob Anzeige "in Facebook"
Unter Umständen sollen diverse Layoutelemente nicht in der Facebook- Page angezeigt
werden (nicht verwechseln mit den "Sichtbarkeits- Einstellungen" der Datensätze!).
Diese PHP- Abfrage lautet für "Ansicht in Facebook":
Installations- Hilfe - 40
www.cms-self -serv ice-lite.at
if ($sslclient == 'facebook')
bzw. für "nicht in Facebook":
if ($sslclient != 'facebook')
Inhalte einer anderen Stammdatei einbinden
Um die gesamten Inhalte einer Site in einem anderen Template anzeigen zu lassen (wie z.B.
beim Template für die Anzeige der gesamten Seite in Facebook) wird diese Variable VOR der
Einbindung im Head ("include ("self_service_lite.php");") in der Stammdatei des "anderen
Templates" gesetzt:
$_ssl['content_from_page'] = 'index.php';
index.php geg. durch den echten Dateinamen ersetzen.
Ausblenden von Menüpunkten im Hauptmenü
Sollen diverse Menüpunkte im Hauptmenü ausgeblendet werden ist dies mit CSS möglich.
Im Bild links ist das Hauptmenü zu sehen, rechts davon der Quellcode mit den relevanten IDs.
CSS: div#self-service-lite div.sslmainmenue ul li#id_des_listenpunktes {display:none;}
Die Menüpunkte "Shopeinstellungen" und "Menüeditor" sind nur vorhanden wenn in den
Grundeinstellungen aktiviert.
Installations- Hilfe - 41
www.cms-self -serv ice-lite.at
Anpassungen im Shop- Formular "Bestellung abschließen - Lieferadresse"
Die beiden Textfelder "Rechnungsadresse (falls abweichend von Lieferadresse" sowie
"Textmitteilung" können auch ausgeblendet werden. Hierzu in die Datei
"self_service_lite/customized/frontend_language.php" die folgenden beiden SprachVariablen kopieren:
$LANGUAGE['cart_userform_address_invoice'] = "";
$LANGUAGE['cart_userform_note'] = "";
Dadurch dass diesen Sprachvariablen kein Inhalt zugewiesen wurde erscheinen auch die
beiden Textfelder nicht.
Installations- Hilfe - 42
www.cms-self -serv ice-lite.at