Dokumentation Caupo Shop 1.0
Copyright Siehe Lizenzbedingungen
Zuletzt aktualisiert: 1999-08-04
[Anwendung einrichten/anpassen] |
[Leistungsmerkmale] |
[Technische Voraussetzungen]
Anwendung für den Besucher einrichten/anpassen
Sie können für die Artikel die bestehenden PHP3-Dateien verwenden und entsprechend Ihren Wünschen ändern.
Oder Sie legen neue Dateien an.
Neue Dateien für den Shop
Wenn Sie neue Dateien anlegen wollen, ist es notwendig, folgende Zeilen in Ihrer HTML-Datei einzubauen und diese Datei dann
mit der Endung .php3 zu speichern.
<?
include ("inc/functions_shop.inc.php3");
/* Falls jemand diese seite nochmals aufruft */
if (strlen($cVID) == 0) /* Wenn Cookie leer */
{ if (strlen($VID) == 0) /* Wenn VID leer */
{ $VID = FncMakeVisitID (); /* Mache Visit-ID */
}
}
else
{ $VID = $cVID; /* andernfalls bilde Visit-ID aus Cookie */
}
?>
<a href="shop_artikel.php3?VID=<? echo $VID ?>">Caupo Shop - Artikel</a>
Hintergrund-Info: Der Caupo Shop arbeitet mit einer individuellen Besucher-Nummer, die aus der Datenbank heraus erzeugt wird.
Diese Nummer (VID) wird benutzt, um den Warenkorb zu füllen und Bestellungen auszuführen.
Vorbereitung
Um die Anwendung für den Besucher zu erstellen, stehen eine Reihe von Funktionen zur Verfügung,
die einfach an die gewünschte Stelle der HTML-Datei eingegeben werden.
Je nach Funktion werden die Artikel dargestellt.
Um eine Funktion zu benutzen, muss zunächst folgender Dateikopf in jeder Datei stehen:
<?
/* Lade allgemeinen Dateikopf */
$svTitle = "Caupo Shop - Artikel";
include ("templates/head.tpl");
echo "<meta http-equiv=\"Expires\" content=\"0\">";
echo "</head>";
include ("templates/body.tpl");
include ("inc/functions_shop.inc.php3");
?>
Die einzelnen Zeilen bedeuten folgendes:
- <?
Hiermit wird der Beginn einer PHP-Anweisung gekennzeichnet. Alles zwischen <? und ?> sind Befehle, die PHP intepretiert und als normales HTML ausgibt.
- $svTitle = "Caupo Shop - Artikel";
Innerhalb der Anführungszeichen können Sie den Titel der Seite eintragen.
- include ("templates/head.tpl");
Aus dem Verzeichnis für die Vorlagen wird die Vorlage für den Kopf der HTML-Datei eingelesen. Der zuvor festgelegte Titel wird eingfügt.
- echo "<meta http-equiv=\"Expires\" content=\"0\">";
Um bei einem Reload durch den Benutzer immer die aktuellen Daten zu haben, wird die Datei nicht aus dem Proxy, sondern
von Ihrem Server geholt. Da diese Zeile durch PHP3 ausgegeben wird (echo), ist vor den Anführungszeichen ein Backslash.
- echo "</head>";
Der in include ("templates/head.tpl"); begonnene <head>-Tag wird geschlossen
- include ("templates/body.tpl");
Hier wird die Vorlage für den <body>-Tag geladen
- include ("inc/functions_shop.inc.php3");
Die komplette Funktionsbibliothek für den Shop wird geladen
- >?
Ende der PHP-Anweisung
Sie können nun die benötigten Funktionen eintragen.
Funktion für Artikel in einer Tabelle
Die benötigte Funktion ist
FncShopArtikelTabelle (Besuchernummer, Artikel-Art, Preis, Aktion, Suchbegriff)
Diese Funktion stellt Artikel in einer Tabelle dar. Damit die von Ihnen gewünschten Artikel dargestellt werden,
werden nach der Funktion in Klammern weitere Angaben gemacht.
Die einzelnen Angaben in den Klammern bedeuten:
- Besuchernummer
Hier wird die Besuchernummer automatisch eingetragen. Dazu geben Sie ein: $VID
- Artikel-Art
Hier geben Sie in Anführungszeichen die Artikel-Art ein, wenn Sie möchten, dass Artikel ausschliesslich einer Art angezeigt werden.
Wenn alle Artikel dargestellt werden sollen, geben Sie 0 (die Zahl Null) ein.
- Preis
Da fünf Preise (A-E) zur Verfügung stehen, geben Sie hier in Anführungszeichen den gewünschten Buchstaben für den Preis an.
- Aktion
Für jeden Artikel stehen beliebig viele Aktionen (Rabatte, Schlussverkauf, Einführungspreis etc.) zur Verfügung (wenn Sie sie zuvor eingegeben haben).
Sie können in Anführungszeichen eine oder mehrere Aktionen angeben. Wenn Sie mehrere Aktionen angeben, trennen Sie diese
bitte mit einem Komma, es werden dann alle Artikel, die diese Aktionen haben, angezeigt.
Wenn Sie keine Aktion haben, lassen Sie die letzte Angabe einfach weg.
- Suchbegriff
Damit die Suche erfolgreich verlaufen lann, muss auch der vom Besucher eingegebene Suchbegriff übergeben werden können. Das geschieht an dieser Stelle.
Alle Funktionen müssen zwischen <? und ?> stehen.
Beispiele:
Hier werden alle Artikel mit Preis A dargestellt:
<? FncShopArtikelTabelle ( $VID, "0", "A") ?>
Hier sind alle Artikel der Artikel-Art Marmelade mit Preis B:
<? FncShopArtikelTabelle ( $VID, "Marmelade", "B") ?>
Und hier alle Butter-Artikel mit Preis C:
<? FncShopArtikelTabelle ( $VID, "Butter", "C") ?>
Alle Artikel der Aktion "WSV und SSV" mit Preis C:
<? FncShopArtikelTabelle ($VID, "0", "C", "WSV, SSV") ?>
Alle Artikel der Aktion "WSV" mit Preis C:
<? FncShopArtikelTabelle ($VID, "0", "C", "WSV") ?>
Sie sehen, es sind praktisch alle gewünschten Kombinationen möglich.
Wenn Sie beispielsweise einen Caupo Shop einrichten möchten, der eine eigene Startseite mit Ihren Warengruppen bekommen soll,
dann können Sie diese links einbauen:
<a href="shop_artikel.php3?svArtikelArt=Marmelade">Marmeladen</a>
<a href="shop_artikel.php3?svArtikelArt=Butter">Butter</a>
Funktion für einzelne Artikel
Eine weitere Möglichkeit ist der Aufruf eines einzelnen Artikels an beliebiger Stelle. Dazu benutzen Sie die Funktion
FncShopEinArtikel ( Besuchernummer, Artikel-Nummer, Preis)
Im Gegensatz zu der Artikel-Tabelle geben Sie nicht die Artikel-Art, sondern die Artikel-Nummer ein. Die Angabe einer Aktion ist
nicht notwendig, da diese Funktion ja den von Ihnen gewünschten Artikel darstellt.
Beispiel:
Artikel W01 mit Preis A:
<? FncShopEinArtikel ( $VID, "W01", "A") ?>
Die von Ihnen erstellte Datei muss mit der Endung .php3 gespeichert werden, damit die PHP-Anweisung ausgeführt werden.
Suchfunktion
Die Suche kann mit folgendem Html-Formular an beliebiger Stelle eingebaut werden:
<form action="shop_artikel.php3" method="POST" enctype="multipart/form-data">
<input type="Text" name="svValue" value="<? echo $svValue ?>" size="10">
<input type="Hidden" name="VID" value="<? echo $VID ?>">
<input type="Submit" name="search" value="Suche">
</form>
Der Suchbegriff wird an die Datei shop_artikel.php3 übergeben.
In welchen Feldern gesucht werden soll, können Sie in der Datei var_sql.inc.php3 festlegen.
Ändern der Vorlagen
Sie können die Vorlagen ändern, um die Artikel entsprechend Ihren Vorstellungen darstellen zu lassen.
Leistungsmerkmale
Der Shop unterteilt sich grundsätzlich in folgende Bereiche:
- Die Administration durch den Shop-Besitzer
- Die Nutzung durch einen Shop-Kunden
Administrationsmöglichkeiten:
Auswertungen
- Hitliste der Artikel (welche Artikel mit welcher Menge und Gesamtsumme)
- Hitliste der Kunden (welche Kunden mit wieviel Artikeln und Gesamtsumme)
Administration
Anlegen/ändern/kopieren/löschen von Artikeln mit je
- ID
- artikel_art
- artikel_nr (z.B. = bestellummer)
- artikel_name
- freier beschreibung
- artikel_aktion
- artikel-thumbnail (mit file-upload über browser)
- artikel-vollbild (mit file-upload über browser)
- fünf Preisen
- Mwst-Satz
- timestamp (Datum und Zeit)
Ändern der Vorlagen für die Gestaltung von
- einzelnen Artikel
- Tabellen-Kopf für die Artikel-Tabelle
- Tabellen-Zeile für den Artikel
- Tabellen-Kopf für die Warenkorb-Tabelle
- Tabellen-Zeile für den Warenkorb
- Tabellen-Kopf für die Statistik-Tabelle
- Tabellen-Zeile für die Statistik
- Ende der Warenkorb-Tabelle
- HTML-Kopf für jede Datei
- Body-Tag (Farben, background-grafik etc.)
- Adress-Formular
- Erfolgter Bestellung
- Artikel-Formular
- Bestätigungs-Email
Ändern der System-Fehlermeldungen für
- Fehler bei der Adresseingabe
- Fehler bei der Bestellung
Ändern der System-Variablen für
- Name der SQL-Tabellen
- Pfad für die Grafiken
- Dauer der Cookie-Gültigkeit
- Anzeige der Artikel-Felder im Admin-Bereich
- Versandkosten-Anteil mit Limit-Betrag
- vordefinierbare Aktionen
- Sortierreihenfolge der Artikel
Artikel können dargestellt werden als
- komplette Artikel-Liste
- Liste aller Artikel einer Art (Warengruppenfunktion)
- Alle Artikel die einer Aktion angehören
- Alle Artikel, die mehreren Aktionen angehören
- Einzel-Artikel
Jede dieser Darstellungen kann mit einem der fünf Preise versehen werden.
Wahlweise können entweder durchgehend Netto- oder Brutto-Einheitspreise verwendet werden, die Mwst-Anteile und Gesamtsummen sind über die Vorlagen auswählbar.
Aufruf aller Darstellungen durch einen Befehl, der direkt an beliebiger Stelle in HTML eingefügt werden kann.
Nutzung durch einen Shop-Kunden
Möglichkeiten für den Shop-Kunden:
- Suche nach Artikeln
- Eingabe der gewünschten Menge
- Füllen des Warenkorbs
- Falls gleicher Artikel nochmals ausgewählt wurde, erhöht sich die Menge (keine doppelte Anzeige!)
- Anzeige des Warenkorbs, dort dann möglich
- Mengenänderungen
- Löschen des Artikels
- Bestellung ausführen, dort dann möglich
(wenn bestehender Kunde)
- Eingabe von Nachname und Password, um Adress-Neueingabe zu sparen
- Eingabe von Nachname und Password, um Adresse zu ändern
(wenn Neukunde)
- Eingabe der Adresse mit
- anrede
- vorname, nachname
- firma
- strasse + nr
- plz, ort
- land
- telefon, telefax
- email
- kunden-Nr
- Zahlungsarten
- Nachnahme
- Abbuchung
- Rechnung
- Kreditkarte
- mit Überprüfung der Gültigkeit
- Lieferadresse
- Password für künftige Bestellungen
- Fehlerprüfung der Adress-Eingaben
- Bestätigungsemail an Kunden und Shop-Besitzer
Verschiedene Funktionen:
- Jeder Besucher erhält eine interne Besucher-Nummer, die in einer SQL-Tabelle gespeichert wird.
- Bei erstmaligen Füllen des Warenkorbs wird ein Cookie gesetzt. Dieser
dient ausschließlich dazu, dass bei einem Verlassen des Browsers der Kunde seinen
gefüllten Warenkorb wieder vorfindet und ist nicht zwingend erforderlich.
Technische Voraussetzungen
- PHP3 ab Ver. 3.0.2
- MySQL ab Ver. 3.21.x
Copyright: Siehe Lizenzbedingungen