AltCurrency- (Alternative Währung) - WEBSALE Dokumentation

Ein Shop rechnet in einer Währung ab, kann seine Preise dem Besucher aber zusätzlich in einer zweiten anzeigen. Genau das leisten die Tags dieser Gruppe: Sie geben Preise, Summen und Kosten umgerechnet aus, ohne an der Abrechnung etwas zu ändern. Welche zweiten Währungen zur Verfügung stehen und mit welchem Faktor umgerechnet wird, legen Sie in der shop.config im Abschnitt <AlternativeCurrency> fest. Die Tags dieser Gruppe tragen nicht alle das Präfix AltCurrency-. Sie verteilen sich auf die Präfixe WS-, FORM-, BT-, PR-, BD- und BASKET- und sind hier zusammengefasst, weil sie zusammen eine Funktion ergeben. Innerhalb der Klammerungen für Versand- und Zahlungskosten gibt es außerdem lokale Tags ohne Präfix. Wegweiser: Alternative Währung · Referenz: Abschnitt AlternativeCurrency

Zwei Regeln, die für fast alle Tags gelten

Der Währungs-Parameter

Die meisten Tags nehmen einen dreistelligen Währungs-ISO-Code als Parameter entgegen. Ohne Parameter rechnen sie in die Währung um, die der Besucher gerade gewählt hat. Mit Parameter rechnen sie in die angegebene Währung um, unabhängig von der Auswahl.

Preis in der gewählten Währung: ~PR-AltCurrencyPrice~
Preis in Schweizer Franken:     ~PR-AltCurrencyPrice(CHE)~

Die übergebene Währung muss im Abschnitt <AlternativeCurrency> der shop.config definiert sein. Ist sie es nicht, gibt es keinen Umrechnungsfaktor, und der Bereich bleibt leer.Geben Sie einen Preis mit Währungs-Parameter aus, gehört der Parameter auch an das Symbol. ~PR-AltCurrencyPrice(CHE)~ ~WS-AltCurrencySymbol~ schreibt den Frankenbetrag mit dem Symbol der gerade gewählten Währung. Richtig ist ~PR-AltCurrencyPrice(CHE)~ ~WS-AltCurrencySymbol(CHE)~.

Wann ein Bereich greift

Bei den gewöhnlichen Preis-Tags greift der Bereich, wenn ein Wert vorhanden ist. Bei den AltCurrency-Tags ist das anders: Der Bereich greift, wenn ein Umrechnungsfaktor vorliegt, und zwar auch dann, wenn der umgerechnete Betrag 0 ist.

{PR-AltCurrencyPrice}
   Preis: ~PR-AltCurrencyPrice~ ~WS-AltCurrencySymbol~
{/PR-AltCurrencyPrice}

{!PR-AltCurrencyPrice}
   Für dieses Produkt liegt kein Preis in der gewählten Währung vor.
{/!PR-AltCurrencyPrice}

Der negative Bereich beantwortet damit die Frage “keine zweite Währung eingestellt”, nicht “Preis ist null”. Das ist die richtige Bedingung für diese Tags, denn ohne Umrechnungsfaktor gibt es schlicht nichts anzuzeigen.

Ein vollständiges Beispiel

Die Auswahlliste, der Preis in beiden Währungen und die Umschaltung zusammen:

{WS-AltCurrency}

   <form action="~FORM-AltCurrency~" method="post">
      ~WS-AltCurrencyList~
      <input type="submit" name="~BT-AltCurrency~" value="Währung wechseln">
   </form>

   <p>
      ~PR-Price~ ~WS-CurrencySymbol~
      <span>entspricht ~PR-AltCurrencyPrice~ ~WS-AltCurrencySymbol~</span>
      <span>Umrechnungsfaktor: ~WS-AltCurrencyRate~</span>
   </p>

{/WS-AltCurrency}

{!WS-AltCurrency}
   ~PR-Price~ ~WS-CurrencySymbol~
{/!WS-AltCurrency}

Weisen Sie immer beide Beträge aus und kennzeichnen Sie den umgerechneten erkennbar als Umrechnung. Bestellt und abgerechnet wird in der Shopwährung. Steht der Frankenbetrag allein, hält der Besucher ihn für den Rechnungsbetrag.

Das Formular FORM-AltCurrency brauchen Sie nur, wenn die Auswahlliste außerhalb von FORM-Product oder FORM-Basket steht. Liegt sie innerhalb eines dieser beiden Formulare, genügt die Schaltfläche mit BT-AltCurrency.

Die Währung selbst

Tag	Parameter	Einzel-Tag	Bereichs-Tag	negatives Bereichs-Tag	Zulässig in
`WS-AltCurrency`	ja	ja	ja	ja	allen Templates
`WS-AltCurrencyISO`	ja	ja	ja	ja	allen Templates
`WS-AltCurrencySymbol`	ja	ja	ja	ja	allen Templates
`WS-AltCurrencyRate`	ja	ja	ja	ja	allen Templates
`WS-AltCurrencyList`	–	ja	ja	ja	Produktdetailansicht, Warenkorbseite
`FORM-AltCurrency`	–	ja	–	–	Produktdetailansicht, Warenkorbseite
`BT-AltCurrency`	–	ja	–	–	Produktdetailansicht, Warenkorbseite

Keines dieser Tags ist als Schleifen-Tag verwendbar.

WS-AltCurrency

Gibt die gewählte alternative Währung als Text aus. Mit Parameter prüfen Sie, welche Währung gewählt ist.

{WS-AltCurrency}

   Alternative Währung: ~WS-AltCurrency~

   {WS-AltCurrency(GBR)}
      Bereich, wenn die gewählte alternative Währung GBR ist.
   {/WS-AltCurrency(GBR)}

   {!WS-AltCurrency(GBR)}
      Bereich, wenn die gewählte alternative Währung nicht GBR ist.
   {/!WS-AltCurrency(GBR)}

{/WS-AltCurrency}

{!WS-AltCurrency}
   Es wurde keine alternative Währung gewählt.
{/!WS-AltCurrency}

Der äußere Bereich ist der wichtigste dieser ganzen Seite. Alles, was mit der zweiten Währung zu tun hat, gehört hinein. Ohne ihn stehen leere Beträge und ein einsames Währungssymbol auf der Seite, sobald keine zweite Währung gewählt ist.

WS-AltCurrencyISO

Gibt den dreistelligen ISO-Code der alternativen Währung aus. Mit Parameter arbeitet das Tag wie WS-AltCurrency.

ISO-Code: ~WS-AltCurrencyISO~

WS-AltCurrencySymbol

Gibt das Währungssymbol der alternativen Währung aus.

Setzen Sie hinter jeden umgerechneten Betrag dieses Tag und nicht WS-CurrencySymbol. Letzteres liefert das Symbol der Shopwährung, und dann steht hinter dem Frankenbetrag ein Eurozeichen.

WS-AltCurrencyRate

Gibt den Umrechnungsfaktor von der Shopwährung in die alternative Währung aus.

1 ~WS-CurrencySymbol~ entspricht ~WS-AltCurrencyRate~ ~WS-AltCurrencySymbol~

Der Faktor gehört sichtbar auf die Seite, wenn Sie umgerechnete Preise zeigen. Er macht nachvollziehbar, wie der zweite Betrag zustande kommt, und macht deutlich, dass es sich um eine Umrechnung und nicht um einen eigenen Preis handelt.

WS-AltCurrencyList

Gibt eine fertige Auswahlliste mit allen konfigurierten alternativen Währungen aus.

FORM-AltCurrency

Liefert die Adresse für ein eigenes Formular, in dem die Auswahlliste steht. Es wird nicht gebraucht, wenn die Auswahlliste innerhalb von FORM-Product oder FORM-Basket liegt.

BT-AltCurrency

Liefert den Namen der Schaltfläche, mit der die Währungsauswahl über FORM-Product oder FORM-Basket abgeschickt wird.

<input type="submit" name="~BT-AltCurrency~" value="Währung wechseln">

Produktpreise

Alle Tags dieser Gruppe nehmen einen Währungs-ISO-Code entgegen und sind als Einzel-Tag, Bereichs-Tag und negatives Bereichs-Tag in allen Templates zulässig, aber nicht als Schleifen-Tag.

Tag	Zweck
`PR-AltCurrencyPrice`	Preis, brutto oder netto je nach Abschnitt `<VAT>` der `shop.config`
`PR-AltCurrencyNetPrice`	Nettopreis
`PR-AltCurrencyGrossPrice`	Bruttopreis
`PR-AltCurrencyVAT`	Mehrwertsteuerbetrag des Produkts
`PR-AltCurrencySetPrice`	Preis eines Sets
`PR-AltCurrencyGrossSetPrice`	Bruttopreis eines Sets
`PR-AltCurrencySetVAT`	Mehrwertsteuerbetrag eines Sets

{PR-AltCurrencyPrice}
   ~PR-AltCurrencyPrice~ ~WS-AltCurrencySymbol~
{/PR-AltCurrencyPrice}

PR-AltCurrencyPrice folgt der Einstellung des Shops, die beiden ausdrücklichen Varianten nicht. In einem Bruttoshop zeigt PR-AltCurrencyPrice denselben Wert wie PR-AltCurrencyGrossPrice, in einem Nettoshop denselben wie PR-AltCurrencyNetPrice. Verwenden Sie die ausdrückliche Variante nur dort, wo der Wert unabhängig von der Shopeinstellung feststehen muss.

Staffelpreise

Tag	Zweck
`BD-AltCurrencyPrice`	Staffelpreis
`BD-AltCurrencyDiscount`	Staffelpreisrabatt

Beide nehmen einen Währungs-ISO-Code entgegen, sind als Einzel-Tag und in beiden Bereichsformen verwendbar und nur auf der Produktdetailansicht (ws_product.htm) zulässig. Wegweiser: Produktpreise, Abschnitt Staffelpreise

Warenkorb und Bestellung

Auch diese Tags nehmen einen Währungs-ISO-Code entgegen und sind als Einzel-Tag sowie in beiden Bereichsformen in allen Templates zulässig.

Summen des Warenkorbs

Tag	Zweck
`BASKET-AltCurrencySubTotalSum`	Warenwert
`BASKET-AltCurrencySubTotalNet`	Nettowarenwert
`BASKET-AltCurrencySubTotalGross`	Bruttowarenwert
`BASKET-AltCurrencySubTotalVAT`	Mehrwertsteuer des Warenwerts
`BASKET-AltCurrencyValueOfGoods`	Gesamtwarenwert aller Produkte im Warenkorb
`BASKET-AltCurrencyTotalVAT`	Mehrwertsteuer der gesamten Bestellung
`BASKET-AltCurrencyOrderTotal`	Endbetrag des Einkaufs

{WS-AltCurrency}
   Endbetrag: ~BASKET-OrderTotal~ ~WS-CurrencySymbol~
   (entspricht ~BASKET-AltCurrencyOrderTotal~ ~WS-AltCurrencySymbol~)
{/WS-AltCurrency}

Der Endbetrag ist die Stelle, an der eine zweite Währung am leichtesten missverstanden wird. Schreiben Sie ausdrücklich dazu, in welcher Währung abgerechnet wird, und stellen Sie den Betrag in Shopwährung voran.

Positionen im Warenkorb

Tag	Zweck
`BASKET-PR-AltCurrencyPrice`	Preis pro Stück
`BASKET-PR-AltCurrencySum`	Gesamtpreis der Position
`BASKET-PR-AltCurrencySetPrice`	Einzelpreis eines Sets
`BASKET-PR-AltCurrencySetSum`	Gesamtpreis eines Sets

{@BASKET-PR-Data}
   ~BASKET-PR-Name~
   ~BASKET-PR-AltCurrencyPrice~ ~WS-AltCurrencySymbol~ je Stück
   ~BASKET-PR-AltCurrencySum~ ~WS-AltCurrencySymbol~ gesamt
{/@BASKET-PR-Data}

Web-to-Print-Zusatzkosten

Für die Zusatzkosten einer Web-to-Print-Gestaltung gibt es dieselben vier Werte auf drei Ebenen: am Produkt, je Warenkorbposition und als Summe über den Warenkorb.

Ebene	Tags
Produkt	`PR-AltCurrencyW2PCost()`, `PR-AltCurrencyW2PNetCost()`, `PR-AltCurrencyW2PGrossCost()`, `PR-AltCurrencyW2PVAT()`
Warenkorbposition	`BASKET-PR-AltCurrencyW2PCost()`, `BASKET-PR-AltCurrencyW2PNetCost()`, `BASKET-PR-AltCurrencyW2PGrossCost()`, `BASKET-PR-AltCurrencyW2PVAT()`
Warenkorb gesamt	`BASKET-AltCurrencyW2PTotal()`, `BASKET-AltCurrencyW2PTotalNet()`, `BASKET-AltCurrencyW2PTotalGross()`, `BASKET-AltCurrencyW2PTotalVAT()`

Alle zwölf Tags sind als Einzel-Tag und in beiden Bereichsformen verwendbar, nehmen einen Währungs-ISO-Code entgegen und sind kein Schleifen-Tag. Die Bedeutung der vier Varianten ist auf jeder Ebene dieselbe: ohne Zusatz der Wert nach Shopeinstellung, Net und Gross ausdrücklich netto oder brutto, VAT der Mehrwertsteueranteil. Am Produkt:

{PR-AltCurrencyW2PCost}
   Zusatzkosten für die Gestaltung: ~PR-AltCurrencyW2PCost~ ~WS-AltCurrencySymbol~
{/PR-AltCurrencyW2PCost}

{PR-AltCurrencyW2PCost(CHE)}
   Zusatzkosten in Schweizer Franken: ~PR-AltCurrencyW2PCost(CHE)~ ~WS-AltCurrencySymbol(CHE)~
{/PR-AltCurrencyW2PCost(CHE)}

{!PR-AltCurrencyW2PCost}
   Es fallen keine Zusatzkosten an.
{/!PR-AltCurrencyW2PCost}

Je Warenkorbposition, innerhalb der Positionsschleife:

{@BASKET-PR-Data}
   {BASKET-PR-AltCurrencyW2PCost}
      Zusatzkosten: ~BASKET-PR-AltCurrencyW2PCost~ ~WS-AltCurrencySymbol~
   {/BASKET-PR-AltCurrencyW2PCost}
{/@BASKET-PR-Data}

Als Summe über den Warenkorb, innerhalb der Warenkorb-Klammerung:

{BASKET-PR-Data}
   {BASKET-AltCurrencyW2PTotal}
      Gesamtkosten der Gestaltung: ~BASKET-AltCurrencyW2PTotal~ ~WS-AltCurrencySymbol~
   {/BASKET-AltCurrencyW2PTotal}
{/BASKET-PR-Data}

Der Unterschied zwischen den beiden Warenkorb-Ebenen steckt im @. Die Positionstags gehören in die Schleife {@BASKET-PR-Data}, die Summentags in die Klammerung {BASKET-PR-Data} ohne Schleife. Wegweiser: Web-to-Print-Produkte

Lokale Tags bei Versand- und Zahlungskosten

Innerhalb der Anzeige von Versandarten und kostenpflichtigen Zusatzleistungen gelten eigene, lokale Tags ohne Präfix. Sie stehen nur dort zur Verfügung.

Tag	Einzel-Tag	Bereichs-Tag	negatives Bereichs-Tag	Zweck
`AltCurrencyCost`	ja	ja	ja	Kosten, brutto oder netto je nach `shop.config`
`AltCurrencyGrossCost`	ja	–	–	Bruttokosten
`AltCurrencyNetCost`	ja	–	–	Nettokosten
`AltCurrencyISO`	ja	–	–	ISO-Code der alternativen Währung
`AltCurrencySymbol`	ja	–	–	Währungssymbol der alternativen Währung

Daneben gibt es dieselben Werte in Shopwährung als Cost, GrossCost, NetCost, WS-Currency und WS-CurrencySymbol.

{AltCurrencyCost}
   Versandkosten: ~AltCurrencyCost~ ~AltCurrencySymbol~
{/AltCurrencyCost}

{!AltCurrencyCost}
   Versandkosten: ~Cost~ ~WS-CurrencySymbol~
{/!AltCurrencyCost}

AltCurrencyCost ist als einziges dieser Tags auch als Bereichs-Tag verwendbar. Es ist damit der Schalter, mit dem Sie die ganze Anzeige in alternativer Währung ein- und ausklammern. Die übrigen vier sind reine Einzel-Tags und liefern ohne Umrechnungsfaktor nichts.

Diese Tags nehmen keinen Währungs-Parameter entgegen. Sie rechnen immer in die gerade gewählte Währung um.

Wegweiser: Versandarten anlegen · Zahlungsarten anlegen

​Zwei Regeln, die für fast alle Tags gelten

​Der Währungs-Parameter

​Wann ein Bereich greift

​Ein vollständiges Beispiel

​Die Währung selbst

​WS-AltCurrency

​WS-AltCurrencyISO

​WS-AltCurrencySymbol

​WS-AltCurrencyRate

​WS-AltCurrencyList

​FORM-AltCurrency

​BT-AltCurrency

​Produktpreise

​Staffelpreise

​Warenkorb und Bestellung

​Summen des Warenkorbs

​Positionen im Warenkorb

​Web-to-Print-Zusatzkosten

​Lokale Tags bei Versand- und Zahlungskosten

​Verwandte Themen

Zwei Regeln, die für fast alle Tags gelten

Der Währungs-Parameter

Wann ein Bereich greift

Ein vollständiges Beispiel

Die Währung selbst

WS-AltCurrency

WS-AltCurrencyISO

WS-AltCurrencySymbol

WS-AltCurrencyRate

WS-AltCurrencyList

FORM-AltCurrency

BT-AltCurrency

Produktpreise

Staffelpreise

Warenkorb und Bestellung

Summen des Warenkorbs

Positionen im Warenkorb

Web-to-Print-Zusatzkosten

Lokale Tags bei Versand- und Zahlungskosten

Verwandte Themen