Foo Webshop Handbuch
********************

Dieses Handbuch dokumentiert die Installation und Konfiguration von Foo Webshop 1.0, ein Shopping-System für das World Wide Web. Dies ist die Ausgabe 0.1 Beta des Handbuchs, zuletzt aktualisiert am 27. Januar 2005.

Copyright © 2005 Foo.

     Lizenztext

Einleitung
**********

Foo Webshop ist ein leicht zu bedienendes Shopping-System für das World Wide Web.  Es ermöglicht Ihren Kunden auf einfache Weise in Ihrem Waren-Angebot zu stöbern und Bestellungen aufzugeben.  Dazu benötigen Sie lediglich einen Web-Browser und einen Internet-Zugang.

Dieses Handbuch soll Ihnen bei der Installation auf einem Server sowie der Einrichtung und Anpassung des Foo Webshop an Ihre Wünsche behilflich sein.

Installation
************

Um Foo Webshop auf einem Web-Server zu installieren, müssen Sie die Dateien und Verzeichnisse des Shops auf den Server übertragen und anschließend die Setup-Routine ausführen.  Dabei werden notwendige Umgebungsbedingungen des Servers überprüft und die Datenbankstruktur eingerichtet.  Wenn die Setup-Routine erfolgreich beendet wurde, müssen Sie noch einige grundlegende Konfigurationsoptionen anpassen. Die nachfolgenden Abschnitte erläutern jeden dieser Schritte detailliert.

Voraussetzungen
===============

Für die Verwendung von Foo Webshop benötigen Sie Zugriff auf einen Server, auf welchem folgende Software installiert sein muss (Wobei die MySQL Datenbank nicht zwangsläufig auf demselben Rechner laufen muss, wie der HTTP-Server.):

  * HTTP-Server (z.B. Apache HTTP Server, http://httpd.apache.org/)

  * PHP (mindestens Version 4.3.x, http://www.php.net/)

  * MySQL (mindestens Version 4.0.x, http://www.mysql.de/products/mysql/)

Weiterhin benötigen Sie auf Ihrem eigenen Computer folgende Software:

  * Dateitransfer-Programm (z.B. SFTP- oder FTP-Client)

  * Web-Browser

  * Text-Editor

Darüberhinaus müssen Sie folgende Informationen bereit halten:

  * Internet-Adresse Ihres Servers (z.B. www.IHR-SHOP.de)

  * sftp- bzw. FTP-Zugangsdaten (Benutzername und Passwort)

  * MySQL-Datenbank-Zugangsdaten (Host, Datenbankname, Benutzername und Passwort)

Dateitransfer
=============

Auf Ihrem Installationsmedium befindet sich ein Verzeichnis namens shop, welches sämtliche Dateien des Foo Webshop enthält. Der Inhalt dieses Verzeichnisses wird komplett auf den Server übertragen.  Vorher müssen Sie allerdings noch das Setup-Passwort in der Datei setup.php ändern.

Öffnen Sie dazu mit einem Text-Editor die Datei setup.php im Verzeichnis shop.  Am Anfang der Datei steht folgende Zeile:

     $password = "default";

Ersetzen Sie dort die Zeichenkette default durch Ihr gewünschtes Passwort, welches aus mindestens acht Zeichen bestehen, und sowohl normale Buchstaben und Zahlen als auch Sonderzeichen enthalten sollte. Achten Sie darauf, dass die doppelten Anführungszeichen und das Semikolon erhalten bleiben.  Um in Ihrem Passwort ein doppeltes Anführungszeichen ("), einen Backslash (\) oder ein Dollar-Zeichen ($) zu verwenden, müssen Sie diesen Zeichen einen Backslash voranstellen.  Wenn Ihr Passwort zum Beispiel Ga\nz"Ge$heim lauten soll, müssen Sie es wie folgt angeben:

     $password = "Ga\\nz\"Ge\$heim";

Das Passwort dient einerseits zur Absicherung der Setup-Routine und andererseits als Administrator-Passwort.

Nachdem Sie das Passwort angepasst haben, können Sie die Shop-Dateien auf den Server übertragen.  Wenn Ihr Server die Dateiübertragung per SFTP zulässt, sollten Sie in jedem Fall diese Übertragungsmethode nutzen.  Ein guter kostenloser SFTP--Client für Microsoft Windows ist zum Beispiel WinSCP, erhältlich unter http://winscp.sourceforge.net/. Auf UNIX-Systemen (inklusive GNU/Linux und Mac OS X) sollte sftp bereits standardmäßig installiert sein.  Wenn Ihr Server keinen SFTP-Zugang erlaubt, sollten Sie die kostenlose OpenSSH Suite (OpenSSH Homepage: http://www.openssh.org/) installieren bzw. Ihren Hosting-Provider damit beauftragen.  Nur in absoluten Ausnahmefällen sollten Sie FTP zum Dateitransfer verwenden, da dabei sämtliche Daten, inklusive des Passworts, im Klartext und für jeden lesbar übertragen werden. (Wenn Sie dennoch gezwungen sind, FTP zu verwenden, können Sie dazu den kostenlosen FTP-Client FileZilla für Microsoft Windows benutzen, erhältlich unter http://filezilla.sourceforge.net/.)

Übertragen Sie den kompletten Inhalt des Verzeichnisses shop auf Ihren Server, inklusive aller Unterverzeichnisse (rekursiv).  Je nach Geschwindigkeit Ihrer Netzwerkverbindung kann dieser Vorgang einige Sekunden bis mehrere Minuten dauern.

Setup
=====

Nachdem Sie die Shop-Dateien auf den Server übertragen haben, rufen Sie in Ihrem Browser (z.B. Mozilla Firefox, kostenlos erhältlich unter http://www.mozilla.org/products/firefox/) die Setup-Routine setup.php auf. Geben Sie dazu in der Adresszeile https:// gefolgt von der Internet-Adresse Ihres Severs, gefolgt von /SETUP.PHP ein, beispielsweise

     https://WWW.IHR-SHOP.DE/setup.php

Dies startet die Setup-Routine, welche Sie zuerst zur Eingabe des Passworts auffordert, welches Sie in der Datei setup.php angegeben haben (see Dateitransfer).  Nach dem erfolgreichen Login überprüft das Setup ob die Verzeichnisse unterhalb von var/ beschreibbar sind.

Wenn das nicht der Fall ist, werden Sie aufgefordert, die Berechtigungen der angegebenen Verzeichnisse entsprechend zu ändern.  Je nach verwendetem Dateitransferprogramm, können die Optionen dafür unterschiedlich lauten.  Wichtig ist, dass die Verzeichnisse sowohl für den Besitzer (owner), die Gruppe (group) als auch Andere (Jeder, Welt, world oder others) die Berechtigungen zum Lesen (read), Schreiben (write) und Ausführen (execute) besitzen.  Die symbolische Darstellung der Berechtigungen muss demnach rwxrwxrwx bzw. 0777 (auch ohne führende Null möglich) lauten.

WinSCPBerechtigungen zeigt am Beispiel von WinSCP, wie Sie die Berechtigungen setzen müssen.  Klicken Sie mit der rechten Maustaste auf das Verzeichnis var, wählen Sie aus dem erscheinenden Kontextmenü den Eintrag Eigenschaften und setzen Sie für den Eigentümer, die Gruppe und Andere jeweils ein Häkchen bei R, W und X sowie bei der Option Gruppe, Eigentümer und Rechte rekursiv setzen.  Wenn Ihr Dateitransferprogramm das rekursive Setzen der Berechtigungen nicht unterstützt, müssen Sie den Vorgang für jedes der von der Setup-Routine angezeigten Verzeichnisse wiederholen.

Nachdem Sie die Berechtigungen angepasst haben, rufen Sie die Setup-Routine so wie am Anfang dieses Abschnitts beschrieben erneut auf. Das Passwort müssen Sie nicht noch einmal eingeben.  Solange Sie das Browser-Fenster nicht schließen, bleiben Sie angemeldet. (Allerdings führt das Überschreiten einer gewissen Server-abhängigen Zeitdauer ohne Aktionen Ihrerseits auch zum automatischen Abmelden.)

Als nächstes fordert Sie das Setup zur Eingabe der Zugangsdaten Ihrer Datenbank auf.  Diese Informationen erhalten Sie von Ihrem Hosting-Provider.  Geben Sie in das Feld Host den Namen des Rechners ein, auf dem der Datenbank-Server läuft.  Geben Sie in dem Feld Benutzername und Passwort die Login-Daten zu Ihrer Datenbank---welche Sie im Feld Datenbank angeben---ein. Klicken Sie anschließend auf den Button Speichern.  Dies schreibt die Datenbank-Informationen in die Datei var/etc/settings.php und startet das Setup automatisch neu.

Abbildung: Zugriffsrechte im Eigenschaften-Dialog von WinSCP

Nachdem Sie die Datenbank-Informationen eingegeben haben, stellt die Setup-Routine eine Verbindung zur Datenbank her und erstellt die Tabellen-Struktur zur Speicherung von Einstellungen, Produktdaten, Bestellungen et cetera.  Wenn das Setup bereits eine oder mehrere von Foo Webshop benötigte Tabellen in der Datenbank vorfindet, bricht es mit einer Fehlermeldung ab und nimmt keine Änderungen vor, bietet Ihnen aber an, alle bestehenden Tabellen zu löschen und neu zu erstellen.

Warnung! Wenn Sie auf den Link Alle Tabellen unwiderruflich löschen klicken, werden sämtliche eventuell bereits vorgenommenen Einstellungen, Produkt- und Benutzerdaten, Bestellungen usw. gelöscht.  Dieser Schritt kann nicht rückgängig gemacht werden. Diese Funktion sollten Sie nur nutzen, wenn sie Foo Webshop wieder in den Auslieferungszustand versetzen möchten.

Nach erfolgreicher Erstellung der Datenbank-Struktur meldet die Setup-Routine Die Installation Ihres Shops ist beendet und Sie können mit der Konfiguration Ihres Shops fortfahren.  Geben Sie dazu in der Adresszeile Ihres Browsers die URL Ihres Shops ein, etwa https://WWW.IHR-SHOP.DE/, und melden Sie sich in dem rechts oben angezeigten Bereich ``Anmelden'' mit dem Benutzernamen admin und dem Passwort, das Sie während der Installation in der Datei setup.php angegeben haben, an (see Dateitransfer).  Am oberen Rand erscheinen daraufhin farblich hervorgehobene Verweise, über die Sie auf die verschiedenen Konfigurations-Optionen zugreifen können.

Sie sollten als nächstes unbedingt die Versandkosten (see Versandkosten) und Email-Einstellungen (see Email) anpassen, da diese zur ordnungsgemäßen Funktion des Shops zwingend erforderlich sind.  Wenn Sie in Deutschland ansässig sind, sollten Sie anschließend ein Impressum anlegen und Ihre Allgemeinen Geschäftsbedingungen zugänglich machen (see Menue- und Sidebarverwaltung).

Konfiguration
*************

Dieses Kapitel beschreibt die Konfiguration von Foo Webshop. Um Einstellungen an Ihrem Shop vorzunehmen, ist es notwendig, dass Sie sich mit einem Benutzerkonto anmelden, das über Administrator-Rechte verfügt. Nach der Installation von Foo Webshop existiert standardmäßig ein Administrator-Konto mit dem Namen admin und dem Passwort, dass Sie während der Installation angegeben haben (see Dateitransfer). Sie können jedoch jedem beliebigen Benutzerkonto Administrator-Rechte zuweisen (see Benutzerverwaltung).

Die folgenden Abschnitte erläutern die Bereiche ``Allgemeine Einstellungen'', ``Menü- und Sidebarverwaltung'', ``Benutzerverwaltung'' und ``Bestellungen'', die Sie über die gleichnamigen Links unterhalb des Hauptmenüs erreichen, wenn Sie als Administrator angemeldet sind.

Allgemeine Einstellungen
========================

In diesem Bereich können Sie Ihre angebotenen Versandarten und -kosten definieren, Adressen und Inhalt automatisch generierter Emails anpassen sowie einige weitere Einstellungen vornehmen (z.B. SSL und Startseite).

Startseite
----------

Wählen Sie hier, welches Menüelement dem Besucher beim ersten Aufruf Ihres Shops präsentiert werden soll.  Nach der Installation ist hier standardmäßig eine Seite mit einer kurzen Willkommens-Botschaft eingestellt.  Die verfügbaren Menüelemente können Sie in der Menü- und Sidebarverwaltung bearbeiten (see Menue- und Sidebarverwaltung).

Versandkosten
-------------

Hier definieren Sie die verschiedenen Versandarten und -kosten, aus denen Ihre Kunden beim Bestellvorgang genau eine auswählen können. Klicken Sie auf Versandart hinzufügen um eine neue Versandart zur Liste hinzuzufügen.  Mit einem Klick auf Löschen können Sie die jeweilige Versandart entfernen.

Geben Sie in der Spalte Bezeichnung eine kurze Beschreibung der Versandart ein (z.B. Deutsche Post Nachname).  Wenn es sich bei einer Versandart um Nachname handelt, sollten Sie dies auch deutlich in der Beschreibung kenntlich machen.

Wenn Sie für eine Versandart das Feld Nachname aktivieren, so wird dem Kunden der Zahlungshinweis nicht angezeigt (see Zahlungshinweis).  Die mit Standard markierte Versandart ist bei neuen Bestellungen voreingestellt.

Geben Sie den Preis bitte mit einem Punkt als Dezimaltrennzeichen ein.

Bestellnummer Vorsilbe
----------------------

Jede Bestellung erhält automatisch eine fortlaufende eindeutige Identifikationsnummer, die Bestellnummer.  Im Sinne einer besseren Integration in eventuell bereits vorhandene Lagerhaltungssoftware oder einfach zur Erhöhung der Übersichtlichkeit (Wenn Sie verschiedene Präfixe für z.B. Artikelnummern, Rechnungsnummern etc. verwenden, erleichtert dies die Zuordnung einer unbekannten Nummer zur entsprechenden Kategorie.) können Sie hier eine Zeichenfolge angeben, die jeder Bestellnummer voran gestellt wird.

Email
-----

Eine Bestellung löst das Versenden von zwei verschiedenen Emails aus. Sowohl der Shop-Betreiber als auch der Kunde erhalten eine Email mit allen relevanten Daten der Bestellung.

Bestellungen an
...............

Die Email-Adresse, an welche die automatisch generierten Emails mit den Details der Bestellung geschickt werden.  Geben Sie hier die Adresse einer Person an, die für die Bearbeitung von Bestellungen zuständig ist.

Absender Name
.............

Der Name des Absenders der automatisch generierten Bestätigungs-Emails, die dem Kunden nach einer Bestellung geschickt werden. Beim Kunden erscheint dann der Absender der Email als ``ABSENDER NAME <ABSENDER ADRESSE>''. Geben Sie hier z.B. den Namen Ihres Shops und eventuell einen Zusatz wie Bestellungen an.

     Beispiel:
     IHR-SHOP Bestellungen

Absender Adresse
................

Die Email-Adresse des Absenders der automatisch generierten Bestätigungs-Emails, die dem Kunden nach einer Bestellung geschickt werden. Beim Kunden erscheint dann der Absender der Email als ``ABSENDER NAME <ABSENDER ADRESSE>''. Geben Sie hier eine Adresse ein, an die sich die Kunden bezüglich ihrer Bestellung wenden können.

     Beispiel:
     bestellungen@IHR-SHOP.DE

Betreff
.......

Die Betreff-Zeile (Subject) der Bestätigungs-Email, die dem Kunden nach einer Bestellung geschickt werden. Geben Sie hier eine knappe Beschreibung des Themas der Email an.

Variablen
.........

Innerhalb des Betreff sind folgende Variablen erlaubt (see Verwendung von Variablen):

[ORDERDATE]
     Das Datum der Bestellung im Format JJJJ-MM-TT.

[ORDERDATETIME]
     Das Datum und die Uhrzeit der Bestellung im Format JJJJ-MM-TT SS:MM:SS.

[ORDERID]
     Die vom System automatisch zugewiesene Bestellnummer.

     Beispiel:
     Ihre Bestellung vom [ORDERDATE] ([ORDERID])

Zahlungshinweis
...............

Tragen Sie hier Anweisungen für den Kunden ein, wie er bei Vorkasse-Versandarten den Rechnungsbetrag zu bezahlen hat, d.h. Ihre Kontoverbindung, Verwendungszweck etc. Der Zahlungshinweis wird dem Kunden bei Vorkasse-Bestellungen sowohl am Ende des Bestellvorgangs als auch in der Bestätigungs-Email angezeigt (letzteres nur, wenn sie die Variable [PAYMENT] im Email-Text verwenden).  Bei Nachnahme-Versand wird er nicht angezeigt.

Variablen
.........

Innerhalb des Zahlungshinweis sind dieselben Variablen erlaubt, wie im Email-Text, außer [PAYMENT] (see Email-Text und Verwendung von Variablen).

     Beispiel:
     Bitte überweisen Sie den Rechnungsbetrag innerhalb
     der nächsten 14 Tage auf folgendes Konto:

     Empfänger:           IHR-SHOP
     Kontonummer:         KONTONUMMER
     BLZ:                 BANKLEITZAHL
     Kreditinstitut:      BANK
     Betrag:              [TOTAL] Euro
     Verwendungszweck:    [ORDERID]

Email-Text
..........

Der Inhalt (Body) der Bestätigungs-Email, die dem Kunden nach einer Bestellung geschickt wird.

Variablen
.........

Innherhalb des des Email-Text sind folgende Variablen erlaubt (see Verwendung von Variablen):

[ADDRESS]
     Die Lieferadresse des Kunden (und Rechnungsadresse, wenn angegeben).

[NAME]
     Anrede (Herr/Frau) sowie Vor- und Zuname des Kunden.

[ORDER]
     Tabellarische Auflistung der bestellten Artikel, inkl. Einzelpreis, Menge, Zwischensummen, Versandart und -kosten sowie der Gesamtsumme.

[ORDERDATE]
     Das Datum der Bestellung im format JJJJ-MM-TT.

[ORDERDATETIME]
     Das Datum und die Uhrzeit der Bestellung im Format JJJJ-MM-TT SS:MM:SS.

[ORDERID]
     Die vom System automatisch zugewiesene Bestellnummer.

[PAYMENT]
     Der Zahlungshinweis. Wird bei Nachname-Versandarten nicht angezeigt (see Zahlungshinweis).

[SHIPPING]
     Die Bezeichnung der gewählten Versandart (see Versandkosten).

[TOTAL]
     Der gesamte zu bezahlende Rechnungsbetrag ohne Währungsangabe.

     Beispiel:
     Sehr geehrte/r [NAME],

     vielen Dank für Ihre Bestellung. Nachfolgend finden
     Sie noch einmal eine Übersicht Ihrer Bestellung.

     Ihre Bestellnummer:  [ORDERID]

     [ORDER]

     [PAYMENT]

     Die Artikel werden so bald wie möglich per [SHIPPING]
     an folgende Adresse versandt:

     [ADDRESS]

     Freundliche Grüße
     Ihr Team von IHR-SHOP

SSL
---

SSL (Secure Sockets Layer) ist ein Übertragungsprotokoll und dient insbesondere im Web der verschlüsselten Kommunikation, da das Standard HTTP-Protokoll sämtliche Daten im Klartext überträgt (zum Beispiel auch das Passwort zur Anmeldung in Foo Webshop).  Wenn die Option SSL aktivieren eingeschaltet ist, wird am rechten oberen Rand des Shops der Bereich ``Sicherheit'' angezeigt, über den der Benutzer Ihres Shops (und Sie selbst natürlich auch) jederzeit die Verwendung von SSL ein- und abschalten kann.  Die voreingestellten Werte von Standard-Port (80) und SSL-Port (443) brauchen Sie normalerweise nicht zu ändern.

Wir empfehlen Ihnen dringend, SSL immer zu aktivieren, außer Ihr Server unterstützt keine SSL-Verbindungen.

Menü- und Sidebarverwaltung
===========================

Foo Webshop wurde mit dem Ziel entwickelt, dem Benutzer die größtmögliche Flexibilität beim Inhalt und der Gestaltung seines Shops zu bieten.  Daher gibt es zum Beispiel kein fest vorgegebenes Hauptmenü, sondern sämtliche Menüeinträge sind frei definierbar.  Um Ihnen den Einstieg zu erleichtern sind nach der Installation bereits einige typische Einträge wie zum Beispiel Startseite und Warenkorb vorhanden, die sie jedoch problemlos ändern, löschen oder an einen anderen Ort verschieben können.

Shop-Struktur zeigt eine schematische Darstellung der Oberfläche von Foo Webshop.  Das Menü dient zur Navigation.  Es enthält Links (auch Hyperlinks oder Verweise genannt), welche der Benutzer anklicken kann, um zu den verschiedenen Unter-Seiten Ihres Shops zu gelangen. Die linke und rechte Sidebar sind schmale Bereiche am Rand des Browser-Fensters, welche wiederum kleinere Bereiche, die Sidebarelemente, enthalten. Dazwischen befindet sich der Hauptbereich, in dem der eigentliche Inhalt angezeigt wird (Produkt-Beschreibungen, Warenkorb etc.).

Abbildung: Struktur der Shop-Oberfläche

Die linke Sidebar enthält als erstes immer das Kategorien-Menü, die rechte immer eine Zusammenfassung des Warenkorbs und den Login-Bereich. Darunter können beliebig viele weitere Bereiche folgen, deren Inhalt Sie frei bestimmen können.  Sidebar-Beispiel zeigt die linke Sidebar mit zwei benutzerdefinierten Elementen, welche zum Beispiel Neuigkeiten oder Werbung enthalten könnten.

Abbildung: Linke Sidebar mit zwei benutzerdefinierten Elementen

Die Informationen, die auf den Unter-Seiten und in den Sidebar-Elementen angezeigt werden, können auf zwei unterschiedliche Arten auf dem Server gespeichert werden.  Entweder Sie geben den Text direkt in das dafür vorgesehene Eingabefeld in der Menü-/Sidebarverwaltung ein, oder sie übertragen eine vollständige HTML-Datei auf den Server, welche dann in die Shop-Oberfläche eingebunden wird.  Wenn es Ihnen möglich ist, sollten Sie immer den Text direkt eingeben, denn dann ist er normaler Bestandteil der Seite, während eine externe HTML-Datei in einem eingebetteten Fenster unveränderlicher Maßeinheiten.Größe angezeigt wird, was unter Umständen zu unschönen Scrollbalken innerhalb der Seite und unerwartetem Verhalten von Verweisen führen kann.  Der Vorteil der externen Datei ist, dass Sie diese mit einem beliebigen Programm zur Webseitenerstellung kreieren können.

Wenn Sie die Menü-/Sidebarverwaltung aufrufen, wird Ihnen eine Liste mit allen vorhandenen Menü- und Sidebarelementen angezeigt. Um ein neues Element hinzuzufügen, klicken Sie bitte auf den entsprechend bezeichneten Button unterhalb der Liste.  Mit den Buttons Nach oben und Nach unten können Sie ein Element innerhalb der Liste an eine andere Position verschieben.  Die Position in der Liste bestimmt auch die Position des Elements innerhalb des Menüs bzw. der Sidebar. Um ein Element komplett zu entfernen, klicken Sie auf den Button Löschen.  Falls es sich um ein Element des Typs Externe Datei handelt, so wird die externe Datei dadurch nicht gelöscht.  Ein Klick auf den Button Bearbeiten öffnet den Dialog Seite Bearbeiten, in dem Sie die Eigenschaften des Elements ändern können.  In den nächsten Abschnitten werden die einzelnen Optionen eines Menü- oder Sidebarelements genauer beschrieben.

Position
--------

Legen Sie hier die Position des Elements fest.  Sie können Sie die Position jederzeit ändern und ein Sidebarelement zu einem Menüelement machen und umgekehrt.  Beachten Sie dabei aber, dass Sie vermutlich die Größe anpassen müssen, wenn das Element vom Typ Externe Datei ist.

Beschreibung
------------

Geben Sie hier eine knappe Beschreibung des Elements an.  Bei Sidebarelementen wird die Beschreibung als Überschrift angezeigt, bei Menüelementen als Tooltip, wenn der Benutzer mit dem Mauszeiger über dem Menüeintrag verharrt und die entsprechende Option Als Tooltip anzeigen aktiviert ist.  Die Beschreibung dient ebenfalls als Identifikation der verschiedenen Elemente in der tabellarischen Übersicht der Menü- und Sidebarverwaltung.

Externe Datei
-------------

Ein Menü-/Sidebarelement kann---wie im einführenden Text bereits beschrieben, see Menue- und Sidebarverwaltung---entweder vom Typ Externe Datei oder Text/HTML eingeben sein.  Durch Aktivieren des Radio-Buttons legen Sie den Typ des aktuellen Elements auf Externe Datei fest. Dabei wird der Radio-Button Text/HTML eingeben automatisch deaktiviert, falls er zuvor aktiv war.  Geben Sie im daneben stehenden Eingabefeld den Pfad zu der Datei an.  Achten Sie darauf, dass Sie einen normalen Schrägstrich (/) und keinesfalls einen Backslash (\) als Pfadbegrenzer verwenden.

Die Datei müssen Sie mit Ihrem Dateitransfer-Programm auf den Server übertragen. Obwohl Sie die externe Datei prinzipiell in einem beliebigen Verzeichnis unter beliebigem Namen auf dem Server speichern können, empfehlen wir aber, sämtliche externen Dateien in dem dafür vorbereiteten Unterverzeichnis pages zu speichern.  Auf diese Weise ist sichergestellt, dass Ihre Dateinamen nicht mit gleichlautenden neuen Dateien in zukünftigen Versionen von Foo Webshop in Konflikt geraten.

Geben Sie den Pfad immer relativ an, zum Beispiel pages/meine_agb.html, anstatt einer absoluten URL wie http://www.example.com/pages/meine_agb.html, da Sie dadurch flexibler bleiben, wenn Sie zum Beispiel den Shop in ein anderes Verzeichnis auf Ihrem Server verschieben oder sich Ihr Domain-Name ändert.

Einbetten
.........

Diese Einstellung ist nur für Menüelemente relevant, da Sidebarelemente immer eingebettet werden, unabhängig davon, ob Einbetten aktiviert ist oder nicht.

Wenn diese Option aktiviert ist, wird die externe Datei innerhalb eines Bereichs fester Größe in der Shop-Oberfläche angezeigt. Andernfalls füllt sie das gesamte Browserfenster aus---das Menü und die linke und rechte Sidebar sind nicht sichtbar und die nachfolgenden Optionen MIME-Typ, Breite und Höhe werden ignoriert.

MIME-Typ
........

Der MIME-Typ der externen Datei.  In MIME-Typen sehen Sie eine Zuordnung der in diesem Zusammenhang wichtigsten Dateiendungen zum jeweiligen MIME-Typ.  Es ist unbedingt notwendig, dass Sie hier den korrekten Typ eintragen, da sonst die externe Datei vom Browser nicht korrekt angezeigt werden kann. Die IANA (Internet Assigned Numbers Authority) führt eine vollständige Liste aller MIME-Typen unter http://www.iana.org/assignments/media-types/.

Tabelle: Auswahl gebräuchlicher MIME-Typen

Dateiendung

MIME-Typ

.html, .htm, .php

text/html

.png

image/png

.gif

image/gif

.jpg, .jpeg

image/jpeg

Breite und Höhe
...............

Geben Sie hier die Größe der eingebetteten Datei an.  Geben Sie in der Textbox einen Zahlenwert ein und wählen Sie aus der daneben stehenden Dropdown-Liste die gewünschte Maßeinheit aus. In Maszeinheiten wird die Bedeutung der verschiedenen Maßeinheiten erläutert.

Tabelle: Maßeinheiten

Maßeinheit   Beschreibung

cm
Zentimeter

em
die aktuelle Schriftgröße

ex
die Höhe des Buchstaben x in der aktuellen Schriftgröße

in
Zoll (ein Zoll entspricht 2,54 Zentimetern)

mm
Millimeter

%
Prozent des zur Verfügung stehenden Platzes

pc
Pica (ein Pica entspricht 12 Punkten)

pt
Punkt (ein Punkt entspricht 1/72 Zoll)

Für HTML-Dateien empfehlen wir eine Breitenangabe von 100 Prozent und eine Höhe von ungefähr 600 Pixel bei Menüelementen und 100 bis 300 Pixel bei Sidebarelementen.  So passt sich die Breite immer dem zur Verfügung stehenden Platz an, also der Größe des Browser-Fensters. Bei der Höhe ist jedoch eine prozentuale Angabe und damit die automatische Anpassung nicht möglich.

Text/HTML eingeben
------------------

Ein Menü-/Sidebarelement kann---wie im einführenden Text bereits beschrieben, see Menue- und Sidebarverwaltung---entweder vom Typ Externe Datei oder Text/HTML eingeben sein. Durch Aktivieren des Radio-Buttons legen Sie den Typ des aktuellen Elements auf Text/HTML eingeben fest. Dabei wird der Radio-Button Externe Datei automatisch deaktiviert, falls er zuvor aktiv war.

Geben Sie in der großen Textbox den Inhalt der Seite oder des Sidebarelements ein.  Sie können einfachen Text mit durch Leerzeilen getrennten Absätzen eingeben oder HTML.  Bei einfachem Text aktivieren Sie die Option Nur-Text und geben Sie im Feld Zeilenlänge die maximale Zeilenlänge an.  Bei Menüelementen empfehlen wir eine Zeilenlänge von ca. 60 Zeichen und bei Sidebarelementen ca. 20 Zeichen.

Bei der Verwendung von HTML deaktivieren Sie die Option Nur-Text und achten Sie darauf, dass Sie nur solche HTML-Tags verwenden, die innerhalb von <body> erlaubt sind. Darüberhinaus verwendet Foo Webshop ausschließlich XHTML 1.0 in der Variante ``Strict''.  Der von Ihnen eingegebene Text sollte daher ebenfalls dieser Spezifikation entsprechen, sofern Sie HTML verwenden. (Die Browser sind allerdings in der Regel recht tolerant und zeigen auch nicht ganz der Spezifikation entsprechendes HTML ``korrekt'' an.) Die deutsche Übersetzung der XHTML 1.0 Spezifikation finden Sie unter http://www.edition-w3c.de/TR/2002/REC-xhtml1-20020801/, das englische Original unter http://www.w3.org/TR/xhtml1/.

Deaktivieren
------------

Mit dieser Option können Sie ein Element vorübergehend deaktivieren, ohne es gleich komplett löschen zu müssen.  Wenn die Option Deaktivieren aktiviert ist, erscheint das Element nicht mehr im Menü bzw. der Sidebar, ist aber noch in der Menü- und Sidebarverwaltung vorhanden.

Link-Text
---------

Diese Option ist nur bei Menüelementen relevant.  Geben Sie hier die Bezeichnung des Menüeintrags ein.  Dieser Text erscheint dann als Link im Hauptmenü.

Seitentitel
-----------

Diese Option ist nur bei Menüelementen relevant. Geben Sie eine kurze Beschreibung des Inhalts der Seite an. Der Seitentitel wird beim Betrachten der Seite in der Titelleiste des Browser-Fensters angezeigt.  Auch Bookmarks bzw. Lesezeichen werden standardmäßig nach dem Seitentitel benannt.

Benutzerverwaltung
==================

In der Benutzerverwaltung können Sie sämtliche registrierten Benutzerkonten einsehen, bearbeiten und löschen.  Wenn Sie die Benutzerverwaltung das erste Mal öffnen, wird Ihnen eine Liste aller Benutzer alphabetisch sortiert nach dem Benutzernamen angezeigt. Diese Liste können Sie durch Klicken auf die Spaltenüberschriften nach der jeweiligen Spalte sortieren. Wiederholtes Klicken auf dieselbe Spaltenüberschrift kehrt die Reihenfolge der Sortierung um. Die Spalte, nach der momentan sortiert ist, wird durch einen farbigen Hintergrund der Spaltenüberschrift hervorgehoben.

Der Bearbeiten-Button in der letzten Spalte führt Sie zu der Detail-Seite des jeweiligen Benutzers, auf der Sie die Benutzerdaten bearbeiten können.  Hier können Sie dem Benutzer durch Aktivieren der Admin-Option auch Administrator-Rechte zuweisen.

Um einen Benutzer zu löschen, klicken Sie auf den entsprechend beschrifteten Button.

Bestellungen
============

Zusätzlich zu der an die unter Bestellungen an angegebene Adresse verschickten Email-Benachrichtigung speichert Foo Webshop die Daten jeder Bestellung in der Datenbank.  Im Bereich ``Bestellungen'' können Sie sich eine Liste aller offenen oder erledigten Bestellungen sowie alle Details einer Bestellung anzeigen lassen.

Unter ``Optionen'' können Sie einstellen, welche Spalten in der Liste der Bestellungen angezeigt werden sollen.  Markieren Sie dazu die Checkbox links neben der jeweiligen Spalte, die angezeigt werden soll und klicken Sie anschließend auf den Button Anwenden. Wenn Sie zusätzlich die Option Als Standard speichern aktivieren, werden die ausgewählten Spalten für den aktuell angemeldeten Benutzer dauerhaft gespeichert, so dass Sie nicht jedesmal die gewünschten Spalten erneut auswählen müssen.

Unterhalb der ``Optionen'' wird die Liste der offenen oder erledigten Bestellungen angezeigt.  Über den Link Details in der vorletzten Spalte gelangen Sie zu den Details der jeweiligen Bestellung.  In der letzten Spalte finden Sie pro Bestellung eine Checkbox, die Sie aktivieren können, um anschließend eine der

Verwendung von Variablen
************************

Verschiedene Konfigurations-Einstellungen erlauben die Verwendung von Variablen.  Variablen bestehen aus fest definierten Schlüsselwörtern, welche von eckigen Klammern umschlossen sind (z.B. [NAME]). Variablen werden stets groß geschrieben.

Wenn eine Konfigurations-Einstellung, die die Verwendung von Variablen zulässt, zur Anwendung kommt, wird die Variable durch einen bestimmten anderen Text ersetzt.  Welche Variablen erlaubt sind und durch welchen Text sie ersetzt werden, können Sie der Dokumentation der jeweiligen Einstellung entnehmen.

Zum Beispiel können Sie im Email-Text von Bestell-Bestätigungen die Variable [NAME] verwenden (see Email-Text), welche beim Versand der Email durch den Namen des Kunden ersetzt wird.

     Sehr geehrte/r [NAME],

     vielen Dank für Ihre Bestellung bei ...

     wird zu

     Sehr geehrte/r Frau Eva Schmidt,

     vielen Dank für Ihre Bestellung bei ...

Glossar
*******

Domain
     Der Name, unter dem ein Computer im Internet erreichbar ist, z.B. www.ihrshop.de.

FTP
     File Transfer Protocol, weit verbreitete Methode, Dateien über das Internet zu übertragen.

HTML
     HyperText Markup Language, die Auszeichnungssprache des Webs, um Text logisch auszuzeichnen (z.B. als Überschrift, Absatz oder Tabelle).

MIME
     Multipurpose Internet Mail Extensions, Kodierstandard, der die Struktur und den Aufbau von E-Mails und anderer Internetnachrichten festlegt.

SCP
SFTP
     Secure CoPy und Secure File Transfer Program, die empfohlene Methode Dateien über das Internet zu übertragen (ersetzt FTP).

Server
     Ein über ein Netzwerk (z.B. das Internet) erreichbarer Computer, der bestimmte Dienste zur Verfügung stellt (z.B. Datenbankzugriff oder Webseiten).

SSH
     Secure Shell, sehr sicheres Datenübertragungsprotokoll.

URL
     Uniform Resource Locator, Schema zur Angabe von Adressen von Ressourcen im Internet.

Variable
     Eine Zeichenkette, die als Platzhalter dient. Bei der Verwendung des Textes, in dem die Variable vorkommt, wird sie durch den Wert der Variable ersetzt.

Web-Browser
     Ein Programm zur Darstellung von Web-Seiten, wie z.B. den Foo Webshop.