Gandke & Schubert GS-SHOP : Anpassung bestehender Templates

Transkript

1 Seite 1 Einleitung Bei dem vorliegenden Dokument handelt es sich lediglich um eine Kurzreferenz, in der sämtliche die HTML- Templates betreffende Änderungen von GS-SHOP 2.00 kurz aufgeführt und erläutert werden. Eine ausführliche Beschreibung zu den neuen Funktionen (und natürlich auch zu den alten) finden Sie im Dokument Anleitung zur Template-Gestaltung. Grundsätzlich sind alle GS-SHOP 1.90-Templates weiterhin voll funktionsfähig, es wurden keine Funktionen oder Makros entfernt. Da jedoch einige wichtige Neuerungen, wie z.b. die Versandarten, hinzugekommen sind, sollten Sie dieses Dokument einmal durcharbeiten. 1. Varianten (detail, warenkorb, bestellung) Variantenartikel dürfen nicht direkt in den Warenkorb gelegt werden, sondern es muss immer erst eine Detailseite aufgerufen werden, in der man dann das gewünschte Modell (Kombination der Ausprägungen) auswählen kann. Daher sollte man beim "in den Warenkorb legen"-knopf bzw. link unterscheiden: <VARIANTEN_VORHANDEN> HTML-Code um die Artikel-Detailseite aufzurufen <ELSE_VARIANTEN_VORHANDEN> HTML-Code um den Artikel in den Warenkorb zu legen </ELSE_VARIANTEN_VORHANDEN> </VARIANTEN_VORHANDEN> Den Anwender kann man dann zum Beispiel mit einer MessageBox informieren, warum nun die Detailseite aufgerufen wird: Alert ('Dieser Artikel ist in mehreren Ausführungen erhältlich. Bitte wählen Sie das gewünschte Modell aus!'); Zusätzlich kann man den Text "Artikel in den Warenkorb legen" dynamisch z.b. in "Variante auswählen" ändern. Auf der Detailseite muss dann die Möglichkeit gegeben werden, die einzelnen Varianten auszuwählen. Zur Variantenauswahl steht dazu die neue Funktion VARIANTE zur Verfügung. Man könnte das z.b. so realisieren (es wird für jede Variante eine eigene Auswahlbox ausgegeben): <VARIANTENAUSWAHL> <tr> <td> [TXT_VARIANTE_BEZEICHNUNG] </td> <td> <SELECT name="varianten" onchange="variante(this.options[this.selectedindex].value);absenden();"> <AUSPRAEGUNGENAUSWAHL> <option value="[txt_auspraegung_varianteid]" <AUSPRAEGUNG_GEWAEHLT>selected</AUSPRAEGUNG_GEWAEHLT>> [TXT_AUSPRAEGUNG_BEZEICHNUNG] </option> </AUSPRAEGUNGENAUSWAHL> </select> </td> </tr> </VARIANTENAUSWAHL> Nach Auswahl einer neuen Kombination aus Ausprägungen mittels der neuen Funktion VARIANTE, sollte die Detailseite neugeladen werden. Denn es könnten ja nun unter Umständen andere Preise oder ein anderes Bild zur Verfügung stehen. Außerdem kann es ja sein, dass bei der neuen Auswahl nicht alle aktuell angezeigten Kombi-

2 Seite 2 nationen zur Verfügung stehen. Der Bereich <AUSPRAEGUNGENAUSWAHL> steht übrigens nur dann in der Artikelliste zur Verfügung, wenn die Auswahl auf einen Artikel mittels der Bestellnummer eingeschränkt ist. Um zum Beispiel schon in der Artikelliste die verschiedenen Varianten anzuzeigen können Sie z.b. verwenden. <VARIANTENAUSWAHL> - [TXT_VARIANTE_BEZEICHNUNG] </VARIANTENAUSWAHL> Ist der Artikel einmal im Warenkorb, so lassen sich die Ausprägungen nicht mehr verändern, man muß den Artikel dann schon löschen und neu auswählen. Natürlich kann man die ausgewählten Ausprägungen jedoch anzeigen: <VARIANTENAUSWAHL> - [TXT_VARIANTE_BEZEICHNUNG]: [TXT_AUSPRAEGUNG_BEZEICHNUNG] </VARIANTENAUSWAHL> 2. Zubehör (detail) Zu jedem Artikel kann nun eine beliebig lange Liste an Zubehörartikeln angelegt werden. Natürlich lässt sich diese Funktion auch anders verwenden, z.b. Kunden die Artikel X gekauft haben, kaufen auch Artikel Y. Die Implementierung ist äußerst einfach: <ZUBEHOER_VORHANDEN> [TXT_BEZEICHNUNG_ZUBEHOER]: <ZUBEHOER_AUSWAHL> [TXT_ZUBEHOER_ID] [TXT_ZUBEHOER_BESTELLNR] : [TXT_ZUBEHOER_BEZEICHNUNG] <ZUBEHOER_BILD_VORHANDEN> <IMG SRC= [URL_ZUBEHOER_BILD_KLEIN] HEIGHT= [ HOEHE_ZUBEHOER_BILD_KLEIN] WIDTH= [ BREITE_ZUBEHOER_BILD_KLEIN] > </ZUBEHOER_BILD_VORHANDEN> </ZUBEHOER_AUSWAHL> </ZUBEHOER_VORHANDEN> Bitte beachten Sie, dass lediglich der Thumbnail, nicht aber das große Bild der Zubehörartikel zur Verfügung steht. Es empfiehlt sich natürlich, die Zubehörartikel nicht nur anzuzeigen, sondern auch direkt auf deren Detailseite zu linken (BestellNr; Seite; Absenden;). Das Shopmakro TXT_BEZEICHNUNG_ZUBEHOER gilt für alle Artikel und bezeichnet die Art der dargestellten Artikel (z.b. Zubehör oder Alternativartikel ). 3. Newsletter (adresse) Ihre Kunden können bei Ihren Adressdaten nun auch angeben, ob sie einen Newsletter erhalten wollen oder nicht. Fügen Sie dafür einfach die Marke [CHK_NEWSLETTER] ein.

3 Seite 3 4. Neue Makros (---) Weiterhin stehen nun die folgenden neuen Shopmakros zur Verfügung: <BOOL_LIEFERBARKEIT_ZEIGEN> <BOOL_DIREKTBESTELLUNG_ERLAUBEN> <BOOL_NUR_LIEFERBARE_ZEIGEN> <BOOL_AGBS_ZEIGEN> Außerdem gibt es nun für die Lieferbarkeitsanzeige (siehe auch Genauer Lagerbestand ) die vier Makros: <TXT_NICHT_LIEFERBAR> <TXT_Z_ZT_NICHT_LIEFERBAR> <MELD_NICHT_LIEFERBAR> <MELD_Z_ZT_NICHT_LIEFERBAR> Die ersten beiden können frei zur Anzeige verwendet werden. Die beiden letzten sind Meldungen, die vom Shop automatisch ausgegeben werden, wenn versucht wird Artikel in den Warenkorb zu legen, die nicht lieferbar bzw. zur Zeit nicht lieferbar (siehe Genauer Lagerbestand ) sind. 5. Alternative Artikelbeschreibung (liste, details) Zusätzlich zu der normalen Artikelbeschreibung steht nun auch eine alternative Artikelbeschreibung zur Verfügung. Über das Makro <BOOL_BESCHREIBUNG_ZEIGEN> lässt sich steuern, ob grundsätzlich der normale oder der alternative Test angezeigt werden soll. Sie müssen darauf jedoch im Template reagieren: <BOOL_BESCHREIBUNG_ZEIGEN> [TXT_LANG_ANFANG] [TXT_LANG] <ELSE_BOOL_BESCHREIBUNG_ZEIGEN> [TXT_LANG_ALTERNATIV_ANFANG] [TXT_LANG_ALTERNATIV] </ELSE_BOOL_BESCHREIBUNG_ZEIGEN> </BOOL_BESCHREIBUNG_ZEIGEN> Grundsätzlich ist diese Art der Verwendung des Alternativtextes natürlich nicht besonders sinnvoll, aber durch die flexible Konzeption können Sie mit den Texten quasi machen was Sie wollen Alternative Lieferanschrift (bestellung) Ihren Shopkunden steht nun auch die Möglichkeit zur Verfügung eine alternative Lieferanschrift mit anzugeben. Dafür müssen Sie das Makro: [MEMO_LIEFERANSCHRIFT] mit aufnehmen. Auf die Eingabe in dieses Feld können Sie mittels zugreifen. [TXT_LIEFERANSCHRIFT]

4 Seite 4 7. Katalog- und Warengruppenbeschreibungen (liste) Sie können nun zu jedem Katalog und zu jeder Warengruppe eine Beschreibung hinterlegen, diese lässt sich dann in Ihrem Shop leicht mittels [TXT_AKTKATALOG_BESCHREIBUNG] [TXT_AKTWG_BESCHREIBUNG] ausgeben. Diese Funktion steht sowohl in der Katalog- bzw. Warengruppenliste als auch überall sonst im Shop zur Verfügung. Im letzteren Fall wird natürlich die Beschreibung der aktuell ausgewählten WG/Katalog ausgegeben. 8. Katalog- und Warengruppenbilder (liste) Neben den Beschreibungen steht nun zu jedem Katalog bzw. jeder Warengruppe nun auch ein Bild zur Verfügung. Dazu gibt es dann die folgenden neuen Makros: und <WG_BILD_VORHANDEN> [URL_WG_BILD_KLEIN] [HOEHE_WG_BILD_KLEIN] [BREITE_WG_BILD_KLEIN] [URL_WG_BILD_GROSS] [HOEHE_WG_BILD_GROSS] [BREITE_WG_BILD_GROSS] <KATALOG_BILD_VORHANDEN> [URL_KATALOG_BILD_KLEIN] [HOEHE_KATALOG_BILD_KLEIN] [BREITE_KATALOG_BILD_KLEIN] [URL_KATALOG_BILD_GROSS] [HOEHE_KATALOG_BILD_GROSS] [BREITE_KATALOG_BILD_GROSS] Diese stehen in den Bereichen <WARENGRUPPENAUSWAHL>, <ALLEKATALOGE> und <KATALOGAUSWAHL> zur Verfügung, nicht aber im Bereich <KATALOGHIERARCHIE>. Außerdem können Sie ansonsten überall auf diese Makros zugreifen und erreichen dann jeweils das Bild bzw. die Daten der aktuellen Warengruppe bzw. Katalog. So können Sie z.b. das Bild der aktuellen Warengruppe ausgeben: <WG_BILD_VORHANDEN> <IMG border=0 height="[ HOEHE_WG_BILD_KLEIN]" width="[breite_wg_bild_klein]" src="[url_wg_bild_klein]"> </WG_BILD_VORHANDEN>

5 Seite 5 9. Eingeschränkte Kataloge/WG (adresse, anmeldung, bestellung) GS-SHOP bietet die Möglichkeit bestimmten Kundengruppen nur eine eingeschränkte Auswahl an Warengruppen oder Katalogen zur Verfügung zu stellen. Sie brauchen dafür in Ihrem Temp-late nicht viel zu tun, Sie müssen lediglich dafür sorgen, dass die Liste der Warengruppen/Kata-loge immer dann aktualisiert wird, wenn sich die Kundengruppe des Anwenders geändert hat. Dieses kann bei den Aktionen AnwenderSpeichern, AnwenderLookup und AnwenderAbmelden geschehen. Ganz einfach kann man dieses implementieren, in dem man in die Seiten, in denen einer drei oben genannten Aktionen ausgeführt wird (im Normalfall adresse.htm, anmeldung.htm und auch bestellung.htm, da diese meistens automatisch nach dem erfolgreichen Login/Anmelden aufgerufen wird) folgenden Code einfügt: <script> if (getcookie('neueranwender')!= '') { setcookie('neueranwender', ''); parent.frames['inhalt'].location.reload(); </script> Anstatt inhalt sollten Sie dort den Namen des Frames eintragen, in dem in Ihrem Template die Warengruppen/Katalogliste angezeigt wird. Natürlich können Sie auch mehrere Frames neuladen. Bei Aufruf der oben genannten Aktionen sollten Sie dann das Cookie neueranwender setzen, z.b. so: <a href="javascript:setcookie('neueranwender','1');aktion('anwenderlookup'); Seite('bestellung.htm');Absenden();">Anmelden</a> Einsatz eines Framesets Wenn Sie ein Frameset einsetzen, dann kann es bei oben angegebener Weise zu Problemen kommen. Aus Sicherheitsgründen können nur Frames miteinander kommunizieren, die über dasselbe Protokoll geladen wurden. Wenn Ihr Shopbesucher jedoch die Cookies aktiviert hat, so wird die adresse.htm im Normalfall via HTTPS (also mit SSL) und die warengruppe.htm via HTTP (also ohne SSL) geladen. In diesem Fall können Sie nicht von der adresse.htm auf die warengruppe.htm zugreifen und umgekehrt. In diesem Fall müssen wir nun der warengruppe.htm (oder wie immer bei Ihnen diese Seite oder diese Seiten auch heißen mögen) mit einem Cookie mitteilen, dass sie neugeladen werden soll. In die warengruppe.htm sollte man also folgenden Code z.b. direkt nach dem <HEAD> einfügen: <script> function _getcookie(cookiename) { var WholeCookie = ''; WholeCookie = document.cookie; var index = WholeCookie.indexOf(CookieName + "="); var index1 = WholeCookie.indexOf(" " + CookieName + "="); if(index1 > index) index = index1; if (index == -1) return ''; index = WholeCookie.indexOf("=", index) + 1; var endstr = WholeCookie.indexOf(";", index); if (endstr == -1) endstr = WholeCookie.length; var IndividualCookie = unescape(wholecookie.substring(index, endstr)); if (IndividualCookie == null IndividualCookie == "null" IndividualCookie == "" IndividualCookie.indexOf("undefined") >= 0 IndividualCookie.lastIndexOf("=") == IndividualCookie.length - 1) IndividualCookie = ""; return IndividualCookie;

6 Seite 6 function _setcookie(name, wert) { document.cookie=name+'='+escape(wert); function checker(){ var befehl = _getcookie('wgreload') if(befehl!= ''){ _setcookie('wgreload',''); location.reload(); window.settimeout("checker()",200); window.settimeout("checker()",200); </script> Diese aufwendige Konstruktion besteht hauptsächlich aus den Routinen _setcookie und _getcookie. Der eigentliche Code steht in der Funktion checker, welche alle 200 ms prüft, ob ein Cookie namens wgreload existiert. Ist das der Fall, so wird dieses Cookie wieder entfernt und die Seite neugeladen. Somit können wir nun in den anderen Seiten durch Setzen dieses Cookies ein Neuladen der warengruppe.htm veranlassen. Jetzt muss noch der oben erwähnte Code zum Neuladen der Seite minimal verändert werden: <script> if (getcookie('neueranwender')!= '') { setcookie('neueranwender', ''); if (bcookies) setcookie('wgreload', '1'); else parent.frames['inhalt'].location.reload(); </script> Hier wird nun einfach bei aktivierten Cookies das Cookie wgreload gesetzt und bei deaktivierten Cookies auf die klassische, oben beschrieben Art und Weise die Seite neu geladen. 10. Bestand & Bestellt (details) In den Artikeldaten können Sie nun angeben, ob Sie nur mit dem Schalter LIEFERBAR (wie bisher auch) oder aber mit einer genauen Bestandsführung arbeiten wollen. Im letzteren Fall wird auf die beim Artikel hinterlegten Werte BESTAND und BESTELLT zurückgegriffen, um zu ermitteln, ob ein Artikel lieferbar ist oder nicht. Wenn Sie die erste Methode wählen, so bleibt alles wie gehabt. Mittels <GENAUE_BESTANDSFUEHRUNG> </GENAUE_BESTANDSFUEHRUNG> erfahren Sie, welche Methode ausgewählt ist, um Ihr Template für beide Möglichkeiten vorzubereiten. Weiterhin stehen einem im Shopclient nun die folgenden neuen Makros in diesem Zusammenhang zur Verfügung: [TXT_NICHT_LIEFERBAR] [TXT_Z_ZT_NICHT_LIEFERBAR] Hierbei wird _NICHT_LIEFERBAR verwendet, wenn der Bestand = 0 ist und Z_ZT_NICHT_LIEFERBAR, wenn der Bestand = 0, aber Bestellt > 0 ist. Wird versucht einen Artikel in den Warenkorb zu legen, der in dieser Menge nicht mehr lieferbar ist, dann prüft GS-SHOP, ob Bestand + Bestellt > Gewünschte_Bestell_Menge und gibt abhängig davon unterschiedliche Meldungen aus.

7 Seite 7 Wenn Sie mit Ihrem Shop eine B2B-Lösung erstellen wollen, so können Sie auch auf die aktuellen Bestandswerte des gewählten Artikels direkt zugreifen: [TXT_BESTAND] [TXT_BESTELLT] [NUM_BESTAND] [NUM_BESTELLT] Natürlich sorgt GS-SHOP bei eingeschalteter Bestandsführung für eine automatische Aktualisierung des Lagerbestandes bei Bestellung. 11. Freie Variablen GS-SHOP bietet ab Version 2.00 die Möglichkeit eigene Variablen innerhalb der Templateseiten zu verwenden. Alle Formulatfelder, die mit VAR_ beginnen werden von GS-SHOP gespeichert und stehen während der gesamten Session zur Verfügung. Anders als die ANM_-Formularfelder, werde diese nicht an den Shopclient übergeben. 12. Versandart Neben der Zahlweise existieren in GS-SHOP nun auch Versandarten. Im Template ist jedoch nicht viel zu tun, die komplette Funktionalität liegt in der shop.dll. Sie brauchen lediglich die Auswahl der Versandart mittels zu erlauben. [SELECT_VERSANDART] 13. Zahlweisen Die Zahlweise SELBSTABHOLER existiert nicht mehr, dafür gibt es jetzt die neue Zahlweise PAYBOX. In diesem Zusammenhang fallen folgende Makros weg: [RADIO_SELBSTABHOLER] [TXT_SELBSTABHOLER ] <SELBSTABHOLER> <ZW_SELBSTABHOLER_DEFINIERT> Und folgende Makros kommen hinzu: [RADIO_PAYBOX] [TXT_PAYBOX ] <PAYBOX> <ZW_PAYBOX_DEFINIERT> [FLD_PAYBOX_NUMMER] [TXT_PAYBOX_NUMMER] 14. Weiteres Zusätzlich zu den genannten Neuerungen gab es in der Vergangenheit folgende Erweiterungen, die teilweise noch nicht in der SHOPHTML.PDF aufgeführt sind: <KEINE_LIEFERZEIT> bei Liefertage = 0 <PREIS_RABATTIERT>, <PREIS_NICHT_RABATTIERT> Mit Sprache( SP ) stehen nun auch spanische Shopmeldungen zur Verfügung Mit SEITEARTIKELLISTE (0) kann auf die erste Seite gesprungen werden

8 Seite 8 [TXT_MWST_EP], [NUM_MWST_EP] (Warenkorb, Artikeldetails) [TXT_MWST_GP], [NUM_MWST_GP] (Warenkorb) [NUM_MWST_SUMME (Warenkorb) TrustedShop: <TRUSTED_SHOP>, [TXT_TRUSTED_SHOP_ID] [TXT_SEITE] liefert den Namen der aktuellen Templateseite Über [INCLUDE="header.htm"] können nun mehrere Bereiche in eine Templateseite integriert werden (Diese Funktion sollte nur bei eigenem Shopserver oder bei aktiviertem TemplateCache verwendet werden) [TXT_DATEI] liefert dann den Namen der aktuellen Datei (nur in Verwendung mit INCLUDE interessant) [FLD_KPN] und [TXT_KPN] für die Kreditkartenprüfnummer Sie können in Ihren Mailtemplates auch HTML-Code verwenden. Sie müssen in diesem Fall aber den Mailtext in <HTML>... </HTML> einfassen Neue Makros: [TXT_SCHEMA], [TXT_FARBE], [TXT_SPRACHE]