Währungen
Definieren Sie zuerst die in Ihren Shops benötigten Währungen. Über Ihren Online-Servicebereich im Dienst Konfiguration können Sie bequem und schnell neue Währungen definieren, die Ihren Kunden im Onlineshop angezeigt oder sogar zur Auswahl angeboten werden können. Nutzen Sie mehrere Subshops, können jedem Subshop individuelle Währungen zugewiesen werden.
Im Folgenden erklären wir Ihnen detailliert, wie Sie Ihre Basiswährung und weitere Währungen für Ihren Shop definieren.
Inhalt
3 Währungsformatierung für automatisch erzeugte Elemente
4 Rundungslogik für die Schweiz (Rappenrundung)
Die Basiswährung eines Shops ist die Währung, in der die Preise der Produkte und andere Kosten (z. B. Versandkosten, Zahlungskosten) hinterlegt sind.
Schritt 1: Definieren der Basiswährung in der Shopkonfiguration
Die Basiswährung wird in der Shopkonfiguration shop.config im Abschnitt <Currency-Txt> festgelegt.
Beispiel:
Die Basiswährung des Shops soll Euro sein.
<Currency-Txt>
Name-! = EUR
Symbol = €
</Currency-Txt>
Referenz: Abschnitt <Currency-Txt>
Schritt 2: Anzeige der Basiswährung im Shop
Bei der Anzeige der Basiswährung im Shop haben Sie zwei Möglichkeiten: Die Anzeige als Wort, z. B. EUR oder als Symbol, z. B. €.
Anzeige der Währung als Wort: ~WS-Currency~
Anzeige der Währung als Symbol: ~WS-CurrencySymbol~
Tipp: |
|
|
Verwenden Sie für die Anzeige der Basiswährung in Ihrem Shop immer diese beiden Tags. Dadurch können Sie die Basiswährung bei Bedarf mit einer einzigen Einstellung in der Shopkonfiguration shop.config ändern. Eine Anpassung der Templates ist dann nicht mehr notwendig. |
Referenz: WS-Currency
Referenz: WS-CurrencySymbol
Neben Preisen in der Basiswährung können im Shop zur Information des Käufers Preise in anderen Währungen angezeigt werden. Für die Anzeige von Preisen in anderen Währungen greift WEBSALE V8s auf eine Umrechnungstabelle zu, die am häufigsten benötigte Umrechnungskurse enthält. Diese Tabelle ist stets tagesaktuell. Sie können jedoch auch eine shopspezifische Umrechnungstabelle verwenden.
Die Preisangabe in einer alternativen Währung dient lediglich zur Information Ihres Käufers. Im Shop wird weiterhin in der Basiswährung fakturiert, die in Schritt 1 gewählt wurde.
Sie können Ihrem Kunden entweder eine Auswahlliste mit verschiedenen Währungen (Währungswechsel) anbieten, aus der er seine Wunsch-Währung auswählen kann. Nach der Auswahl werden Ihrem Kunden alle relevanten Kosten zusätzlich informativ angezeigt.
Oder Sie ermitteln anhand der GeoIP die Herkunft Ihres Kunden und zeigen mit Aufruf des Shops alle relevanten Kosten in der Herkunfts-Währung an. Bei dieser Art der Anzeige kann nicht garantiert werden, dass immer die zutreffende Währung des Käufers bestimmt wird, da die Ermittlung der GeoIP nicht hundertprozentig genau ist.
Schritt 1: Freischaltung
Die alternative Währungsanzeige muss für Ihren Shop von der WEBSALE AG freigeschaltet werden. Bitte wenden Sie sich an Ihren WEBSALE-Ansprechpartner.
Schritt 2: Einstellungen in der Shopkonfiguration
In Abschnitt der <AlternativeCurrency> Ihrer Shopkonfiguration shop.config legen Sie grundsätzlich fest, ob die Anzeige einer alternativen Währung möglich ist oder nicht.
Über den Parameter GeoIP-Allow können Sie festlegen, ob die automatische Anzeige der Währung auf Basis der Herkunft Ihres Kunden angezeigt werden soll.
Mit den Unterabschnitten <+Entry> ... </+Entry> definieren Sie die alternativen Währungen, die in Ihrem Shop zur Auswahl stehen sollen und angezeigt werden können. Wie bei der Basiswährung können Sie die alternative Währung sowohl als Text, z. B. US-Dollar oder als Symbol, z. B. $ anzeigen lassen. Hinterlegen Sie hier Ihre gewünschten Werte hinter den Parametern Txt und Symbol.
Beispiel:
Die Anzeige der alternativen Währung soll nicht automatisch über die Ermittlung der GeoIP gesteuert werden.
Als alternative Währungen sollen US-Dollar (USD) und Englische Pfund (GBP) angeboten werden:
<AlternativeCurrency>
Allow = yes
GeoIP-Allow = no
SelectBoxMode = Text
SelectBoxOnchange = submit();
NoAlternativeCurrency-Txt = Keine alternative Währung anzeigen
<+Entry>
ISO = USD
Txt = US-Dollar
Symbol = $
</+Entry>
<+Entry>
ISO = GBP
Txt = Englische Pfund
Symbol = £
</+Entry>
</AlternativeCurrency>
Referenz: Abschnitt AlternativeCurrency
Schritt 3: Integration der Auswahlliste
Die Auswahlliste für die alternative Währung kann auf der Produktdetailansicht (ws_product.htm) und der Warenkorbseite (ws_basket.htm) integriert werden.
Fügen Sie das Tag WS-AltCurrencyList für die Anzeige der Auswahlliste innerhalb der <form> der beiden Templates ein.
Das Tag WS-AltCurrencyList generiert automatisch eine Auswahlliste <select>. Diesem HTML-Element ist die Klasse select_alternative_currency zugewiesen. Fügen Sie diese Klasse in Ihre Styles-Datei ein und vergeben Sie Ihre gewünschten CSS-Eigenschaften.
Als <option>-Einträge werden die Daten aus den Unterabschnitten <+Entry> des Abschnittes <AlternativeCurrency> der Shopkonfiguration shop.config verwendet.
<form action="Form des Templates" method="POST">
{WS-AltCurrencyList}
~WS-AltCurrencyList~
<noscript><input type="submit" name="~BT-AltCurrency~" value="Währung auswählen"></noscript>
{/WS-AltCurrencyList}
</form>
Referenz: FORM-Basket
Referenz: FORM-Product
Referenz: Spezielle Tags für Anzeige von Preisen in alternativer Währung
Schritt 4: Anzeige der alternativen Währung
Bei der Anzeige der alternativen Währung im Shop haben Sie zwei Möglichkeiten: Die Anzeige als Wort, z. B. USD oder als Symbol, z. B. $.
Anzeige der alternativen Währung als Wort: {WS-AltCurrency}~WS-AltCurrency~{/WS-AltCurrency}
Anzeige der alternativen Währung als Symbol: {WS-AltCurrencySymbol}~WS-AltCurrencySymbol~{/WS-AltCurrencySymbol}
Referenz: Spezielle Tags für Anzeige von Preisen in alternativer Währung
Schritt 5: Anzeige der alternativen Preise
Neben der Währung muss natürlich auch der umgerechnete Preis angezeigt werden. Dazu ist es notwendig, die speziellen alternativen Preis-Tags an den gewünschten Stellen zu integrieren. Welche Preise als alternative Preise angezeigt werden können, finden Sie in der Auflistung Spezielle Tags für Anzeige von Preisen in alternativer Währung.
Beispiel:
Anzeige des Produktpreise in der Basis- und alternativen Währung
Anzeige des Produktpreises in der Basiswährung:
~PR-Price~ ~WS-CurrencySymbol~
{WS-AltCurrency}
Anzeige des Produktpreises in alternativer Währung:
~PR-AltCurrencyPrice~ ~WS-AltCurrencySymbol~
{/WS-AltCurrency}
Wegweiser: Versandkosten in der alternativen Währung anzeigen
Wegweiser: Zahlungskosten in der alternativen Währung anzeigen
Wegweiser: Kostenpflichtige Zusatzleistungen in der alternativen Währung anzeigen
Referenz: Spezielle Tags für Anzeige von Preisen in alternativer Währung
Referenz: PR-Price
Referenz: WS-CurrencySymbol
Schritt 6: Test für die Anzeige der alternativen Währungsanzeige anhand der GeoIP
Um die Anzeige der alternativen Währung anhand der GeoIP zu testen, müssen Sie den Shop direkt von der gewünschten IP-Adresse öffnen. Möchten Sie also testen, ob die alternative Währung Schweizer Franken (CHF) beim Besuch eines Schweizer Kunden korrekt angezeigt wird, müssen Sie den Shop von einer Schweizer IP-Adresse öffnen.
Ein Test mithilfe des GeoIP-Testmodus ist nicht möglich. Mit diesem Testmodus können nur die Klammerungen WS-GeoIPCountryCode() der Länderprüfung getestet werden.
Wegweiser: Testmodi des Shops ein-/ausschalten
Referenz: WS-GeoIPCountryCode()
3 Währungsformatierung für automatisch erzeugte Elemente
Durch die freie Positionierung der Tags für die Anzeige der Währung haben Sie die Möglichkeit, selbst zu bestimmen, ob die Währung vor dem Preis oder danach angezeigt werden soll. Zudem haben Sie durch die Tags die freie Wahl, ob Sie die Währung als Text oder als Symbol anzeigen lassen möchten. Diese Aussagen treffen in der Regel auf alle Preis- und Währungsanzeigen von WEBSALE V8s zu.
In Ausnahmefällen kann es aber sein, dass Sie sowohl die Tags für die Währung als auch für den Preis nicht selbst auf dem Template platzieren können. In diesen Fällen generiert der Shop diese Elemente automatisch.
Damit Sie trotzdem die Möglichkeit haben, die Positionierung des Währungssymbols zu beeinflussen, gibt es eine Einstellungsmöglichkeit in Ihrer Shopkonfiguration shop.config.
Im Abschnitt <PriceFormat> können Sie mit den Parameter JoinCurrency und JoinCurrencySymbol festlegen, ob die Währung vor dem Preis oder dahinter angezeigt werden soll.
Beispiel:
Die Währung soll immer vor dem Preis angezeigt werden.
<PriceFormat>
...
JoinCurrency = ~WS-Currency~ ~WS-Price~
JoinCurrencySymbol = ~WS-CurrencySymbol~ ~WS-Price~
...
</PriceFormat>
Referenz: Abschnitt PriceFormat
Referenz: WS-Currency
Referenz: WS-CurrencySymbol
Referenz: WS-Price
4 Rundungslogik für die Schweiz (Rappenrundung)
Wenn Sie einen Shop betreiben, in dem die Währung Schweizer Franken (CHF) gilt, können Sie die Rundung der Endsummen auf die in der Schweiz gebräuchliche Rundungslogik umstellen.
Dabei wird die Endsumme mit 20 multipliziert, danach wird das Ergebnis kaufmännisch auf 0 Kommastellen gerundet und dann durch 20 dividiert.
Diese Rundungslogik wird nur auf die Endsumme angewandt. Alle anderen Preise, Zwischensummen, Rabatte, MwSt.-Beträge etc. bleiben davon unberührt.
Ergänzen Sie hierfür in der Shopkonfiguration shop.config den Parameter TotalSumSwissRounding-Allow und weisen Sie ihm den Wert yes zu:
<OrderConditions>
...
TotalSumSwissRounding-Allow = yes
...
</OrderConditions>
Referenz: Abschnitt OrderConditions