TAC- (Anzeige von Zahlungs- und Versandarten)

Jeder Shop braucht eine Seite, auf der Zahlungsarten und Versandkosten einmal vollständig erklärt sind. Rechtlich ist sie Pflicht, und praktisch schauen Käufer dort nach, bevor sie bestellen. Diese Seite soll alle Angaben zeigen, unabhängig davon, was gerade im Warenkorb liegt und wohin geliefert werden soll. Genau das leisten die TAC-Tags. Der Name steht für “terms and conditions”. Sie lesen die Zahlungs- und Versandarten direkt aus der Shopkonfiguration und geben sie aus, ohne eine einzige Prüfung gegen den aktuellen Vorgang. Zwei Familien teilen sich die Arbeit: TAC-P- für die Zahlungsarten und TAC-D- für die Versandarten. Wegweiser: Globale Anzeige von Zahlungs- und Versandarten Alle Tags dieser Seite sind auf allen Templates zulässig. Üblich ist ein eigenes Template, das über eine Inhaltsseite eingebunden wird. Jedes Tag außer den beiden Schleifentags TAC-P-Data und TAC-D-Data braucht die jeweilige Schleife um sich herum, außerhalb ist es ein ungültiges Tag.

Diese Tags beschreiben die Konfiguration, nicht die Auswahl im laufenden Bestellvorgang. Für die Zahlungsarten, die ein Käufer gerade tatsächlich wählen kann, gibt es die PAY-Tags, für die Versandarten die DELIV-Tags. Eine Zahlungsart, die hier erscheint, kann im Bestellvorgang trotzdem ausgeschlossen sein, beispielsweise wegen des Lieferlandes oder des Warenwerts.

Referenz: PAY- (Zahlungsarten)
Referenz: DELIV- (Versandarten)

Was überhaupt angezeigt wird

Beide Schleifen laufen nicht über alle konfigurierten Einträge, sondern nur über die, die für die Listenanzeige vorgesehen sind. Das ist ein eigener Schalter je Zahlungs- beziehungsweise Versandart in der Shopkonfiguration.

Fehlt eine Zahlungsart auf der fertigen Seite, liegt das fast immer an diesem Schalter und nicht am Template.

Die Reihenfolge der Zahlungsarten folgt der in der Shopkonfiguration vergebenen Position, nicht der Reihenfolge der Einträge in der Datei. Die Versandarten erscheinen dagegen in der Reihenfolge ihrer Einträge.

Vergeben Sie jede Position nur einmal. Haben zwei Zahlungsarten dieselbe Position, zeigt die Schleife nur die erste davon, die zweite fällt lautlos aus der Liste. Dasselbe gilt für eine Zahlungsart ohne Position.

Die Zahlungsarten

Die Schleife

TAC-P-Data kann alles drei: als Einzel-Tag die Anzahl ausgeben, als Klammerung prüfen ob es überhaupt Einträge gibt, und als Schleife über sie laufen.

{!TAC-P-Data}
   <p>Es sind derzeit keine Informationen über die Zahlungsarten verfügbar.</p>
{/!TAC-P-Data}

{TAC-P-Data}
   {@TAC-P-Data}
      ...
   {/@TAC-P-Data}
{/TAC-P-Data}

Die Angaben je Zahlungsart

Tag	Liefert
`TAC-P-Name`	den Namen der Zahlungsart
`TAC-P-Code`	den technischen Index der Zahlungsart
`TAC-P-Img`	den Pfad zur Grafik
`TAC-P-Dependencies`	den Fließtext zu sonstigen Bedingungen

{@TAC-P-Data}
   {TAC-P-Img}<img src="~TAC-P-Img~" alt="">{/TAC-P-Img}
   <h2>~TAC-P-Name~</h2>
   {TAC-P-Dependencies}<p>~TAC-P-Dependencies~</p>{/TAC-P-Dependencies}
{/@TAC-P-Data}

TAC-P-Img liefert einen vollständigen Pfad, denn das Shopsystem setzt das Verzeichnis der Navigationsgrafiken davor. Klammern Sie die Ausgabe trotzdem, denn nicht zu jeder Zahlungsart ist eine Grafik hinterlegt, und ein img-Element mit leerem src lädt die Seite selbst nach.

TAC-P-Code ist der interne Index der Zahlungsart, nicht ihre Position in der Liste. Die Zahlen laufen deshalb nicht in der Anzeigereihenfolge. Für eine fortlaufende Nummerierung zählen Sie im Template selbst.

Die Kostenstaffel

Die Kosten einer Zahlungsart hängen vom Warenwert ab und sind als Staffel hinterlegt. TAC-P-CostData läuft darüber.

{TAC-P-CostData}
   <h3>Kosten dieser Zahlungsart</h3>
   {@TAC-P-CostData}
      <p>
         ab ~TAC-P-CostData_amount(2)~ ~WS-CurrencySymbol~ Warenwert:
         {TAC-P-CostData_percentageValue}~TAC-P-CostData_value~ %{/TAC-P-CostData_percentageValue}
         {!TAC-P-CostData_percentageValue}~TAC-P-CostData_value~ ~WS-CurrencySymbol~{/!TAC-P-CostData_percentageValue}
      </p>
   {/@TAC-P-CostData}
{/TAC-P-CostData}

Tag	Liefert
`TAC-P-CostData`	die Schleife über die Staffel, als Einzel-Tag deren Länge
`TAC-P-CostData_amount()`	den Warenwert, ab dem diese Stufe gilt
`TAC-P-CostData_value`	den Betrag oder den Prozentsatz dieser Stufe
`TAC-P-CostData_percentageValue`	Klammerung: der Wert ist ein Prozentsatz

TAC-P-CostData_value liefert je nach Konfiguration einen Betrag oder einen Prozentsatz, und zwar ohne Einheit. Welches von beiden, sagt allein TAC-P-CostData_percentageValue. Schreiben Sie das Währungszeichen und das Prozentzeichen deshalb immer über die beiden Klammerungen und nie fest ins Template.

TAC-P-CostData_amount() nimmt bis zu zwei Parameter entgegen, nämlich die Zahl der Nachkommastellen und das Dezimaltrennzeichen. Ohne Parameter gibt das Tag den Wert unformatiert aus. Für Beträge ist (2) die übliche Angabe. Hat eine Zahlungsart keine Kosten hinterlegt, greift TAC-P-CostData als Klammerung nicht. Die negative Klammerung eignet sich damit für den Hinweis, dass diese Zahlungsart kostenfrei ist.

Die Länderlisten

Je Zahlungsart lässt sich festlegen, in welche Länder geliefert und für welche Länder die Rechnung ausgestellt werden darf. Beides funktioniert gleich und besteht aus zwei Schritten: Zuerst sagt eine Klammerung, welche Art von Liste vorliegt, und darin läuft eine Schleife über die Länder.

{TAC-P-BillCountryData}
   <h3>Rechnungsländer</h3>

   {TAC-P-BillCountries_completeAllow}
      <h4>Nur für diese Länder:</h4>
      {@TAC-P-BillCountryData}
         ~TAC-P-BillCountryData_Name~<br>
      {/@TAC-P-BillCountryData}
   {/TAC-P-BillCountries_completeAllow}

   {TAC-P-BillCountries_completeDeny}
      <h4>Für alle Länder außer:</h4>
      {@TAC-P-BillCountryData}
         ~TAC-P-BillCountryData_Name~<br>
      {/@TAC-P-BillCountryData}
   {/TAC-P-BillCountries_completeDeny}
{/TAC-P-BillCountryData}

Tag	Liefert
`TAC-P-BillCountries_completeAllow`	Klammerung: Liste der erlaubten Rechnungsländer
`TAC-P-BillCountries_completeDeny`	Klammerung: Liste der ausgeschlossenen Rechnungsländer
`TAC-P-BillCountryData`	die Schleife über die vorbereitete Länderliste
`TAC-P-BillCountryData_Code`	das Länderkürzel nach ISO
`TAC-P-BillCountryData_Name`	den Namen des Landes

Für die Lieferländer gibt es dieselben fünf Tags mit DeliveryCountries beziehungsweise DeliveryCountryData im Namen. Die mitgelieferten Beispieltemplates verwenden sie trotzdem, und zwar zu Recht, denn sie beantworten die Frage, die ein Käufer stellt.

Der Unterschied zu den dokumentierten _allow und _deny ist wesentlich. TAC-P-BillCountries_allow greift nur, wenn die Konfiguration als Positivliste geschrieben ist, und zeigt dann genau diese Liste. Ist sie als Negativliste geschrieben, greift es gar nicht. Die complete-Fassung dagegen baut in diesem Fall die Gegenliste aus der Länderdatei auf und beantwortet damit die eigentliche Frage. Verwenden Sie für eine Kundenseite die complete-Fassung, die schlichten _allow und _deny eignen sich eher zum Prüfen der Konfiguration.

Welche Länder in der Gegenliste stehen, kommt aus den Länderdateien des Shops. Für Rechnungsländer ist das die allgemeine Länderliste, für Lieferländer die Liste der belieferbaren Länder. Die beiden können sich unterscheiden.

Die Reihenfolge entscheidet. Die Klammerung baut die Länderliste auf, erst danach kann die zugehörige Schleife darüber laufen. Setzen Sie die Schleife deshalb immer innerhalb der Klammerung. Umgekehrt gilt: Innerhalb einer laufenden Länderschleife liefern die Klammerungen nichts, sie lassen sich dort nicht verschachteln.

Die beiden CountryData-Tags geben als Einzel-Tag die gesamte Liste als kommagetrennte Folge von ISO-Kürzeln aus. Das eignet sich für die Übergabe an eigene Skripte. Ist zu einer Zahlungsart gar keine Länderbeschränkung hinterlegt, bleiben alle Klammerungen stumm. Die äußere Klammerung TAC-P-BillCountryData eignet sich deshalb als Rahmen um den gesamten Länderblock, so wie im Beispiel oben.

Die Versandarten

Die Versandarten funktionieren genauso wie die Zahlungsarten. Drei Dinge kommen hinzu: eine zweite Kostenstaffel nach Gewicht, ein Zusatzfeld zum Land und drei Prüfungen auf besondere Bestellarten.

Die Schleife und die Angaben

{!TAC-D-Data}
   <p>Es sind derzeit keine Informationen über die Versandarten verfügbar.</p>
{/!TAC-D-Data}

{TAC-D-Data}
   {@TAC-D-Data}
      {TAC-D-Img}<img src="~TAC-D-Img~" alt="">{/TAC-D-Img}
      <h2>~TAC-D-Name~</h2>
      {TAC-D-Dependencies}<p>~TAC-D-Dependencies~</p>{/TAC-D-Dependencies}
   {/@TAC-D-Data}
{/TAC-D-Data}

Tag	Liefert
`TAC-D-Name`	den Namen der Versandart
`TAC-D-ID`	die Kennung der Versandart
`TAC-D-Img`	den Pfad zur Grafik
`TAC-D-Dependencies`	den Fließtext zu sonstigen Bedingungen
`TAC-D-Country`	das Länderfeld der Versandart

TAC-D-Img gibt den hinterlegten Wert unverändert aus, anders als TAC-P-Img, dem das Shopsystem das Verzeichnis der Navigationsgrafiken voranstellt. Hinterlegen Sie bei einer Versandart deshalb den vollständigen Pfad, sonst findet der Browser die Grafik nicht.

Es gibt das Länderfeld der Versandart aus, also eine zusätzliche Angabe aus der Konfiguration, und ist nicht mit der Länderliste darunter zu verwechseln.

Die beiden Kostenstaffeln

Versandkosten können vom Warenwert abhängen, vom Gewicht, oder von beidem. Dafür gibt es zwei getrennte Schleifen.

{TAC-D-BasicCostData}
   <h3>Versandkosten nach Warenwert</h3>
   {@TAC-D-BasicCostData}
      <p>
         ab ~TAC-D-BasicCostData_amount(2)~ ~WS-CurrencySymbol~:
         {TAC-D-BasicCostData_percentageValue}~TAC-D-BasicCostData_value~ %{/TAC-D-BasicCostData_percentageValue}
         {!TAC-D-BasicCostData_percentageValue}~TAC-D-BasicCostData_value~ ~WS-CurrencySymbol~{/!TAC-D-BasicCostData_percentageValue}
      </p>
   {/@TAC-D-BasicCostData}
{/TAC-D-BasicCostData}

{TAC-D-WeightCostData}
   <h3>Versandkosten nach Gewicht</h3>
   {@TAC-D-WeightCostData}
      <p>ab ~TAC-D-WeightCostData_amount(1)~ kg: ~TAC-D-WeightCostData_value~ ~WS-CurrencySymbol~</p>
   {/@TAC-D-WeightCostData}
{/TAC-D-WeightCostData}

{!TAC-D-BasicCostData}
   {!TAC-D-WeightCostData}
      <h3>Versandkostenfrei</h3>
   {/!TAC-D-WeightCostData}
{/!TAC-D-BasicCostData}

Tag	Liefert
`TAC-D-BasicCostData`	die Schleife über die Staffel nach Warenwert
`TAC-D-BasicCostData_amount()`	den Warenwert, ab dem diese Stufe gilt
`TAC-D-BasicCostData_value`	den Betrag oder den Prozentsatz
`TAC-D-BasicCostData_percentageValue`	Klammerung: der Wert ist ein Prozentsatz
`TAC-D-WeightCostData`	die Schleife über die Staffel nach Gewicht
`TAC-D-WeightCostData_amount()`	das Gewicht, ab dem diese Stufe gilt
`TAC-D-WeightCostData_value`	den Betrag

Die Gewichtsstaffel kennt keinen Prozentsatz. TAC-D-WeightCostData_value ist immer ein Betrag und kommt bereits im Zahlenformat des Shops. Ein Gegenstück zu _percentageValue gibt es hier nicht.

Beide _amount-Tags nehmen die Zahl der Nachkommastellen und das Dezimaltrennzeichen als Parameter entgegen. Für Gewichte ist (1) meist passend, für Beträge (2). Die Hinweiszeile “Versandkostenfrei” im Beispiel braucht beide negativen Klammerungen ineinander, denn eine Versandart ist nur dann kostenfrei, wenn weder eine Warenwert- noch eine Gewichtsstaffel hinterlegt ist.

Die Lieferländer

Die Lieferländer einer Versandart funktionieren genau wie die Länderlisten der Zahlungsarten, einschließlich des Unterschieds zwischen _allow und completeAllow.

{TAC-D-DeliveryCountryData}
   {TAC-D-DeliveryCountries_completeAllow}
      <h3>Lieferbar nach:</h3>
      {@TAC-D-DeliveryCountryData}~TAC-D-DeliveryCountryData_Name~<br>{/@TAC-D-DeliveryCountryData}
   {/TAC-D-DeliveryCountries_completeAllow}

   {TAC-D-DeliveryCountries_completeDeny}
      <h3>Lieferbar in alle Länder außer:</h3>
      {@TAC-D-DeliveryCountryData}~TAC-D-DeliveryCountryData_Name~<br>{/@TAC-D-DeliveryCountryData}
   {/TAC-D-DeliveryCountries_completeDeny}
{/TAC-D-DeliveryCountryData}

Alles zur Reihenfolge und zur Gegenliste gilt unverändert, siehe oben bei den Zahlungsarten.

Besondere Bestellarten

Drei Klammerungen sagen, für welche Art von Bestellung eine Versandart vorgesehen ist. Alle drei brauchen zwingend einen Parameter.

Tag	Prüft
`TAC-D-PrimeState()`	die Einstellung zu PrimeShopping
`TAC-D-SubSequentOrderState()`	die Einstellung zu Folgebestellungen
`TAC-D-SubscriptionOrderState()`	die Einstellung zu Abo-Bestellungen

Parameter für	Werte
`TAC-D-PrimeState()`	`use-for-all`, `only-for-prime`, `not-for-prime`
`TAC-D-SubSequentOrderState()`	`use-for-all`, `only-for-subsequentorder`, `not-for-subsequentorder`
`TAC-D-SubscriptionOrderState()`	`use-for-all`, `only-for-subscriptionorder`, `not-for-subscriptionorder`

{@TAC-D-Data}
   {TAC-D-SubscriptionOrderState(only-for-subscriptionorder)}
      <p>Diese Versandart steht ausschließlich für Abo-Lieferungen zur Verfügung.</p>
   {/TAC-D-SubscriptionOrderState(only-for-subscriptionorder)}
{/@TAC-D-Data}

Alle drei Tags sind ohne Parameter ungültig, und ein unbekannter Parameter macht sie ebenfalls ungültig. Als Einzel-Tag gibt es sie nicht.

Die drei Tags prüfen auf Gleichheit mit genau einer Einstellung. Wollen Sie etwas für alle Fälle außer einem ausgeben, nehmen Sie die negative Klammerung, nicht einen anderen Parameter.

Referenz: PRIME- (PrimeShopping)
Referenz: SUBS- (Abo abschließen)

Die Tags im Überblick

Zahlungsarten

Tag	Einzel-Tag	Bereichs-Tag	negatives Bereichs-Tag	Schleifen-Tag	Gilt in
`TAC-P-Data`	ja	ja	ja	ja	frei
`TAC-P-Name`	ja	ja	ja	–	`TAC-P-Data`
`TAC-P-Code`	ja	ja	ja	–	`TAC-P-Data`
`TAC-P-Img`	ja	ja	ja	–	`TAC-P-Data`
`TAC-P-Dependencies`	ja	ja	ja	–	`TAC-P-Data`
`TAC-P-CostData`	ja	ja	ja	ja	`TAC-P-Data`
`TAC-P-CostData_amount()`	ja	ja	ja	–	`TAC-P-CostData`
`TAC-P-CostData_value`	ja	ja	ja	–	`TAC-P-CostData`
`TAC-P-CostData_percentageValue`	–	ja	ja	–	`TAC-P-CostData`
`TAC-P-BillCountries_allow`	–	ja	ja	–	`TAC-P-Data`
`TAC-P-BillCountries_deny`	–	ja	ja	–	`TAC-P-Data`
`TAC-P-BillCountries_completeAllow`	–	ja	ja	–	`TAC-P-Data`
`TAC-P-BillCountries_completeDeny`	–	ja	ja	–	`TAC-P-Data`
`TAC-P-BillCountryData`	ja	ja	ja	ja	`TAC-P-Data`
`TAC-P-BillCountryData_Code`	ja	ja	ja	–	`TAC-P-BillCountryData`
`TAC-P-BillCountryData_Name`	ja	ja	ja	–	`TAC-P-BillCountryData`
`TAC-P-DeliveryCountries_allow`	–	ja	ja	–	`TAC-P-Data`
`TAC-P-DeliveryCountries_deny`	–	ja	ja	–	`TAC-P-Data`
`TAC-P-DeliveryCountries_completeAllow`	–	ja	ja	–	`TAC-P-Data`
`TAC-P-DeliveryCountries_completeDeny`	–	ja	ja	–	`TAC-P-Data`
`TAC-P-DeliveryCountryData`	ja	ja	ja	ja	`TAC-P-Data`
`TAC-P-DeliveryCountryData_Code`	ja	ja	ja	–	`TAC-P-DeliveryCountryData`
`TAC-P-DeliveryCountryData_Name`	ja	ja	ja	–	`TAC-P-DeliveryCountryData`

Versandarten

Tag	Einzel-Tag	Bereichs-Tag	negatives Bereichs-Tag	Schleifen-Tag	Gilt in
`TAC-D-Data`	ja	ja	ja	ja	frei
`TAC-D-Name`	ja	ja	ja	–	`TAC-D-Data`
`TAC-D-ID`	ja	ja	ja	–	`TAC-D-Data`
`TAC-D-Img`	ja	ja	ja	–	`TAC-D-Data`
`TAC-D-Dependencies`	ja	ja	ja	–	`TAC-D-Data`
`TAC-D-Country`	ja	ja	ja	–	`TAC-D-Data`
`TAC-D-BasicCostData`	ja	ja	ja	ja	`TAC-D-Data`
`TAC-D-BasicCostData_amount()`	ja	ja	ja	–	`TAC-D-BasicCostData`
`TAC-D-BasicCostData_value`	ja	ja	ja	–	`TAC-D-BasicCostData`
`TAC-D-BasicCostData_percentageValue`	–	ja	ja	–	`TAC-D-BasicCostData`
`TAC-D-WeightCostData`	ja	ja	ja	ja	`TAC-D-Data`
`TAC-D-WeightCostData_amount()`	ja	ja	ja	–	`TAC-D-WeightCostData`
`TAC-D-WeightCostData_value`	ja	ja	ja	–	`TAC-D-WeightCostData`
`TAC-D-DeliveryCountries_allow`	–	ja	ja	–	`TAC-D-Data`
`TAC-D-DeliveryCountries_deny`	–	ja	ja	–	`TAC-D-Data`
`TAC-D-DeliveryCountries_completeAllow`	–	ja	ja	–	`TAC-D-Data`
`TAC-D-DeliveryCountries_completeDeny`	–	ja	ja	–	`TAC-D-Data`
`TAC-D-DeliveryCountryData`	ja	ja	ja	ja	`TAC-D-Data`
`TAC-D-DeliveryCountryData_Code`	ja	ja	ja	–	`TAC-D-DeliveryCountryData`
`TAC-D-DeliveryCountryData_Name`	ja	ja	ja	–	`TAC-D-DeliveryCountryData`
`TAC-D-PrimeState()`	–	ja	ja	–	`TAC-D-Data`
`TAC-D-SubSequentOrderState()`	–	ja	ja	–	`TAC-D-Data`
`TAC-D-SubscriptionOrderState()`	–	ja	ja	–	`TAC-D-Data`

Die Spalte “Gilt in” nennt die Schleife, innerhalb derer das Tag stehen muss. Außerhalb ist es ein ungültiges Tag. Die beiden CountryData-Tags stehen jeweils in der Schleife ihrer eigenen Ebene, nicht in der Datenschleife darüber.

​Was überhaupt angezeigt wird

​Die Zahlungsarten

​Die Schleife

​Die Angaben je Zahlungsart

​Die Kostenstaffel

​Die Länderlisten

​Die Versandarten

​Die Schleife und die Angaben

​Die beiden Kostenstaffeln

​Die Lieferländer

​Besondere Bestellarten

​Die Tags im Überblick

​Zahlungsarten

​Versandarten

​Verwandte Themen

Was überhaupt angezeigt wird

Die Zahlungsarten

Die Schleife

Die Angaben je Zahlungsart

Die Kostenstaffel

Die Länderlisten

Die Versandarten

Die Schleife und die Angaben

Die beiden Kostenstaffeln

Die Lieferländer

Besondere Bestellarten

Die Tags im Überblick

Zahlungsarten

Versandarten

Verwandte Themen