Mehrwährungsdarstellung im Shop WyRu Online-Shop

Größe: px

Ab Seite anzeigen:

Download "Mehrwährungsdarstellung im Shop WyRu Online-Shop"

Ruth Schulz
vor 6 Jahren
Abrufe

1 Mehrwährungsdarstellung im Shop WyRu Online-Shop Team WyRu Christian Wyk / Günter Rubik SCS Bürocenter B1, A-2334 Vösendorf Internet

2 Diese Dokumentation beschreibt die Möglichkeit mit dem WyRu Online-Shop, Artikel in verschiedenen Währungen, abhängig vom angemeldeten Benutzer, anzuzeigen. Die entsprechenden Funktionen werden in der Bibliothek /shopproc/currency.asp zusammengefasst, die in jede Shop-Seite inkludiert werden muß (zumindest in jede, die die Mehrwährungsdarstellung benutzt). Die Bibliothek bietet nur die Funktion für die Darstellung mehrerer Währungen an, zeigt diese aber auf den ASP-Seiten des Shops nicht an. Der Aufruf der entsprechenden Funktionen muß in die Templates des Shops inkludiert werden. Ab Erscheinen dieses Dokumentes steht die Bibliothek allen Nutzern des Mietshops bzw. allen Käufern des Shops ohne weitere Kosten zur Verfügung. Das Mehrwährungspaket mit entsprechend angepassten Templates für die Darstellung von Artikeldetails, Suchergebnissen, Administrationsseiten für Artikel mit mehreren Währungen und Seiten zur Auswahl einer Währung durch den Besucher des Shops steht den Käufern der Profi- Version kostenlos zur Verfügung bzw. kann von anderen Benutzern als Upgrade erworben werden.

3 Ermittlung des Preises für einen Artikel Der Preis eines Artikels in einer anderen Währung kann auf zwei Arten von der Mehrwährungs-Bibliothek ermittelt werden: - der Preis ist in dieser Währung in den Stammdaten des Artikels hinterlegt. Dies ist bei allen psychologischen Preisen notwendig, die sich nicht alleine durch Umrechnung ergeben. - der Preis wird anhand einer Umrechnungstabelle von der Bibliothek errechnet.

4 Vorraussetzungen der Datenbank Damit die Mehrwährungs-Bibliothek auf dem Shop eingesetzt werden kann, müssen folgende Vorraussetzungen an der Datenbank des Shops erfüllt sein. Datenbank ItemData Tabelle Items Für jede Währung, in der der Preis beim Artikel hinterlegt werden soll, muß ein Feld der Art price_xxx vorhanden sein, wobei XXX für den ISO-Code der Währung steht. Ist beispielsweise der Preis in österreichischen Schillingen beim Artikel hinterlegt, muß ein Feld price_ats vorhanden sein, da ATS der ISO-Code für österreichische Schillinge ist. Außerdem muß ein Feld für den Preis in Euro vorhanden sein, das den Namen price_eur trägt. Von diesem Preis erfolgt die Umrechnung in alle nicht manuell erfassten Währungen. Da alle Datenbanken des WyRu Online-Shop seit Version 1.0 die Felder price_ats und price_eur besitzen, sind alle derzeit laufenden Shops mit dieser Forderung kompatibel. Soll trotz vorhandenem Feld eine automatische Umrechnung stattfinden, so muß das entsprechende price_xxx Feld auf 0,00 gesetzt werden. Eine 0,00 im price_eur Feld wird laut Umrechnungstabelle in 0,00 jeder anderen Währung umgerechnet. Datenbank ItemData Tabelle currencys Alle erlaubten Währungen müssen in der Tabelle currencys hinterlegt werden. Eine Währung die hier nicht hinterlegt ist, sollte der Benutzer nicht auswählen können (bzw. kann sie auch nicht auswählen, wenn die Templates des Upgrades zum WyRu Online- Shop verwendet werden). Die Tabelle benötigt folgende Struktur: iso Text der ISO-Code der Währung, z.b. ATS name Text der ausgeschriebene Name der Währung, z.b. österr. Schilling symbol Text eine Kurzform für die Währung, z.b. ös change Währung ein Umrechnungskurs zum Euro (1000 Euro =), z.b ,30 Datenbank CustomerData Tabelle customers Damit die Bibliothek die gewählte Währung eines Kunden speichern kann, benötigt die Tabelle ein Feld currency in das der ISO-Code der gewählten Währung eingetragen wird.

5 Parameter in der Konfigurationsdatei Global.asa Zum Konfigurieren der Bibliothek werden im Bereich der Prozedur Application_OnStart neue Parameter eingeführt. Application( "CurrencyISO" ) = "ATS" Sollte der Besucher noch nicht als Kunde registriert sein bzw. hat sich noch nicht angemeldet, arbeitet der Shop mit einer Standardwährung. Zusätzliche Session-Variablen Für ASP-Programmierer besonders interessant ist, dass die Bibliothek zwei zusätzliche Session-Variablen mitführt, die im eigenen Programmcode eingesetzt werden können. Session( "CurrencyISO" ) = "ATS" In dieser Variable wird die Standardwährung der aktuellen Benutzersession also entweder die Standardwährung oder die Währung aus seinem Benutzerkonto gehalten. Ist die Variable leer, wird sie beim nächsten Aufruf einer Bibliotheksfunktion auf die Standardwährung des Shops gesetzt. Session( "CurrencySymbol" ) = "ös" In dieser Variable wird das aus dem ISO-Code resultierende Kurzzeichen der Währung gehalten, damit Formatierungsaufgaben entsprechend effizienter abgearbeitet werden können.

6 Funktionen der currency.asp Bibliothek Damit die Funktionen zur Verfügung stehen, muß die Zeile am Beginn jeder ASP-Seite stehen.  Wenn in den folgenden Funktionen ein Parameter für eine Währung vorgesehen ist, so muß für diesen Parameter der ISO-Code der Währung als String übergeben werden. Function formatprice(value, targetcurrency) Formatiert den übergebenen Betrag als die gewünschte Währung. Es erfolgt keine Umrechnung. Function formatdefprice( value ) Formatiert den übergebenen Betrag als die Währung, die in der aktuellen Benutzersession gerade aktiviert ist. Es erfolgt keine Umrechnung. Function getitemprice(itemnr, targetcurrency) Gibt den Preis eines Artikels in der gewünschten Währung zurück. Function getitemdefprice( itemnr ) Gibt den Preis eines Artikels in der Währung der aktuellen Benutzersession zurück. Function ISO2EUR( value, isocurrency ) Rechnet einen gegebenen Betrag in Euro um. Die Währung des Betrages wird als zweiter Parameter übergeben. Function EUR2ISO( value, isocurrency ) Rechnet einen Euro-Betrag in die Zielwährung um. Die gewünschte Währung wird als zweiter Parameter übergeben. Function convertcurrency(value, targetcurrency) Rechnet den übergebenen Betrag in die gewünschte Währung um. Der Betrag wird in der Währung angenommen, die in der aktuellen Benutzersession aktiviert wurde. Function loadcustomercurrency( customernr ) Lädt aus dem Kundensatz seine ausgewählte Währung und macht sie zur aktiven Währung dieser Benutzersession.

7 Function setcustomercurrency( customernr, currency ) Setzt eine bestimmte Währung zur aktiven Währung dieser Benutzersession. Function getcustomercurrency( customernr ) Fragt die aktive Währung dieser Benutzersession ab. Function getdefaultcurrency() Ermittelt die Default-Währung des Shops. Function saveusercurrency( customernr ) Schreibt die aktive Währung dieser Benutzersession in den Kundendatensatz. Function ISO2Name( currency ) Ermittelt zu einem ISO-Code den Namen der Währung. Function ISO2Symbol( currency ) Ermittelt für einen ISO-Code die Kurzschreibweise der Währung (z.b. ös). Function nextcurrency() Ermittelt in einer Schleife alle vorhandenen Währungen. Die Funktion schaltet auf die nächste Währung weiter und gibt TRUE zurück, falls noch eine Währung existiert. Function getcurrencyiso() Gibt nachdem nextcurrency() aufgerufen wurde, das ISO-Symbol der Währung zurück. Function getcurrencyname() Gibt nachdem nextcurrency() aufgerufen wurde, den Namen der Währung zurück. Function getcurrencysymbol() Gibt nachdem nextcurrency() aufgerufen wurde, den Kurznamen der Währung zurück. Sub writecurrencys( fieldname, selectedcurrency ) Erzeugt HTML-Code für ein Kombinationsfeld, in dem der Benutzer die möglichen Währungen anzeigen kann.

8 Ersatzfunktionen für andere Bibliotheken Die currency.asp Bibliothek enthält zusätzlich Funktionen, die nur in Zusammenhang mit anderen Bibliotheken (z.b. Suche, Warenkorb, etc.) funktionieren und nach dem Aufruf der entsprechenden next...() Funktionen anstelle des normalen Preises des Artikels, diesen Preis in der Währung der aktuellen Benutzersession zurückgeben. Function getgrplistprice() Function getdetailprice() Function getsearchprice() Function getbasketprice() Function getitemofthedayprice() Function getitemoftheweekprice() Function sendcurrencyordermail() Function sendcurrencyconfirmmail()

9 Geänderte bzw. neue Seiten aus dem Mehrwährungs-Upgrade Neben der Mehrwährungs-Bibliothek /shopproc/currency.asp stellt Team WyRu auch einen kompletten Satz an Templates zur Verfügung, die die Mehrwährungsfunktionen in Verwendung zeigen und die bereits fertig in den eigenen Shop übernommen werden können. Informationen zur Verfügbarkeit dieses Moduls finden Sie am Anfang dieser Unterlage. Folgende Seiten sind ergänzt oder neu aufgenommen worden: basket.asp grplist.asp searchlist.asp prosearch.asp checkout.asp Summe und Versandkosten werden ebenfalls in Euro und in dieser Währung errechnet. choosecurrency.asp Erlaubt es dem Benutzer eine Währung für die Anzeige der Artikel zu wählen.

Ähnliche Dokumente

Kundenspezifische Preise im Shop WyRu Online-Shop

Kundenspezifische Preise im Shop WyRu Online-Shop Team WyRu Christian Wyk / Günter Rubik SCS Bürocenter B1, A-2334 Vösendorf Internet http://www.wyru.at Kundenspezifische Preise sind ein Feature des WyRu