woocs_convert_price

Der woocs_convert_price-Filter ist ein Einstiegspunkt in das Plugin: Sie rufen ihn auf, FOX antwortet. Er wandelt einen Betrag von der Shop-Basiswährung in die vom Besucher ausgewählte Währung um. Dies ist die Standardmethode für Drittanbieter-Code, um währungsbewusst zu werden. Da es sich um einen Filter handelt, ist der Aufruf auch dann sicher, wenn FOX nicht installiert ist – der Wert wird unverändert durchgereicht, was genau das ist, was Kompatibilitätscode benötigt.

global $WOOCS;

$converted = apply_filters('woocs_convert_price', $amount, false);

Parameter:

$amount - der Betrag in der Shop-Basiswährung
$is_cond_multi (bool) - standardmäßig false. Wenn true, erfolgt die Umrechnung nur, wenn die Option "Is multiple allowed" aktiviert ist, sodass der Aufruf bei Shops, die nur in der Basiswährung abrechnen, keine Wirkung zeigt.

Rückgabe:

den Betrag in der aktuellen Währung

Die andere Richtung ist woocs_back_convert_price, der einen Betrag, der bereits in der Währung des Besuchers vorliegt, zurück in die Basiswährung umwandelt. Diesen greift man dann, wenn ein Plugin einen Warenkorb-Gesamtbetrag mit einem Schwellenwert vergleicht, den es in der Basiswährung gespeichert hat – Mindestbestellwerte für kostenlosen Versand, Geschenkregeln, gestaffelte Rabatte. Der Vergleich eines umgerechneten Betrags mit einem Schwellenwert in Basiswährung ist die häufigste Ursache dafür, dass 'die Regel funktioniert in USD, aber nicht in EUR'.

Referenz zu Shortcodes, Funktionen, Actions und Filtern für FOX WooCommerce Currency Switcher