CODEX
Shortcodes, Hooks & Functions
Vollständige Referenz für FOX – WooCommerce Currency Switcher
- SC [[woocs]] Der Haupt-Shortcode für den Währungswechsler: Fügt das Dropdown-Menü, Flaggen oder eine Linkliste auf jeder Seite, in jedem Widget oder jeder Vorlage ein. Attribute steuern die Ansicht, das Styling und welche Währungen angezeigt werden. →
- SC [[woocs_converter]] Fügt einen WooCommerce-Währungsrechner zu jeder Seite hinzu – ein kleiner AJAX-Rechner, der einen Betrag zwischen zwei Währungen umrechnet, ohne Ihre Produktpreise zu beeinflussen. Attribute: exclude, precision. →
- SC [[woocs_geo_hello]] Diagnose-Shortcode für Geo IP. Platzieren Sie ihn auf einer Seite oder in einem Widget, um zu sehen, ob die Geolokalisierung funktioniert, welches Land erkannt wurde und auf welche Währung die Regeln aufgelöst wurden. →
- SC [[woocs_get_sign_rate]] Gibt den aktuellen Wechselkurs einer Währung gegenüber der Shop-Basiswährung als Klartext aus – überall in Ihren Inhalten. →
- SC [[woocs_price]] Zeigt den Preis eines einzelnen Produkts anhand seiner ID in der vom Besucher ausgewählten Währung an – für Landingpages und Texte außerhalb der WooCommerce-Schleife. →
- SC [[woocs_rates]] Zeigt Ihren Kunden die Wechselkurse des Shops als Tabelle an. Mit Attributen können Sie Währungen ausschließen und das Layout ändern. →
- SC [[woocs_show_current_currency]] Gibt die Währung aus, in der der Besucher gerade surft, mit optionalem Text davor und danach. →
- SC [[woocs_show_custom_price]] Macht jeden Betrag in Ihrem Werbetext umschaltbar. Geben Sie den Wert in der Basiswährung ein und er folgt der vom Besucher gewählten Währung. →
- do_action woocs_before_settings_update Aktion, die in wp-admin direkt nach der Nonce-Prüfung und unmittelbar bevor FOX seine Optionen aus dem übermittelten Formular speichert, ausgelöst wird. Verwenden Sie sie, um zusätzliche Felder zu speichern, die zur Plugin-Einstellungsseite hinzugefügt wurden. →
- do_action woocs_exchange_value Einstiegspunkt in das Plugin: Übergeben Sie einen beliebigen Betrag in der Basiswährung an diese Aktion und erhalten Sie ihn in der vom Besucher ausgewählten Währung zurück. Der einfache Weg, um eigene Zahlen umschaltbar zu machen. →
- do_action woocs_force_pay_bygeoip_rules Wird auf der Checkout-Seite ausgelöst, wenn "Checkout by GeoIP rules" aktiviert ist, sodass Sie überschreiben können, welche Währung für die Bestellung für ein bestimmtes Land erzwungen wird. →
- do_action woocs_freemius_loaded Aktion, die ausgelöst wird, sobald das Freemius SDK initialisiert wurde, der sichere Punkt, an dem die Lizenzierungs-API verfügbar ist. →
- do_action woocs_sheduler_rates_updated Wird ausgelöst, nachdem die geplante Wechselkursaktualisierung abgeschlossen ist. Verwenden Sie es, um den Kursverlauf zu protokollieren, ein externes System zu benachrichtigen oder etwas neu zu berechnen, das von den neuen Kursen abhängt. Ab v.2.4.5 / 1.4.5. →
- do_action woocs_update_rates_wpcron Das geplante Ereignis, an das FOX seine Kursaktualisierung anhängt. Wenn es ausgelöst wird, wird sofort eine vollständige Wechselkursaktualisierung durchgeführt. So können Updates von einem echten Server-Cron statt von WordPress-Cron gesteuert werden. →
- apply_filters woocs_add_aggregator_processor Registriert den Code, der Kurse von Ihrer eigenen Wechselkursquelle abruft. Funktioniert zusammen mit woocs_announce_aggregator. Ab v.2.3.1 / 1.3.1. →
- apply_filters woocs_add_custom_rate Ändert einen Währungskurs spontan oder ersetzt das Abrufen von Kursen vollständig durch Ihre eigene Logik. Ab v.2.3.1 / 1.3.1. →
- apply_filters woocs_announce_aggregator Fügt Ihren eigenen Aggregator zur Liste hinzu, aus der der Shop-Betreiber in den Einstellungen wählen kann. Funktioniert zusammen mit woocs_add_aggregator_processor. Ab v.2.3.1 / 1.3.1. →
- apply_filters woocs_back_convert_price Einstiegspunkt in das Plugin: Konvertiert einen Betrag von der aktuell ausgewählten Währung zurück in die Shop-Basiswährung. Die Lösung für Drittanbieterregeln, die konvertierte Gesamtsummen mit Basiswährungsschwellenwerten vergleichen. →
- apply_filters woocs_bank_polski_table Wählt aus, welche Kurstabelle des Narodowy-Bank-Polski-Aggregators gelesen werden soll. Standard ist Tabelle A. Ab v.2.3.1 / 1.3.1. →
- apply_filters woocs_capability_allows_change_order Ermöglicht ausgewählten Benutzern, Bestellwährungsdaten zu bearbeiten, ohne ihnen die volle manage_options-Fähigkeit zu gewähren. →
- apply_filters woocs_convert_price Einstiegspunkt in das Plugin: Konvertiert einen Betrag von der Basiswährung in die aktuell ausgewählte. Die Standardmethode für ein Drittanbieter-Plugin, um währungsbewusst zu werden, ohne eine harte Abhängigkeit von FOX zu haben. →
- apply_filters woocs_convert_price_wcdp Einstiegspunkt in das Plugin für Rabatt-Engines: Konvertiert einen Betrag von der Basiswährung in die aktuelle, jedoch nur, wenn das dritte Argument discount__amount ist. →
- apply_filters woocs_cookie Filter, der den Namen des FOX-Sitzungs-Cookies ändert. Durch Umbenennen wird verhindert, dass Caches, die jedes Cookie mit wp_-Präfix als angemeldeten Benutzer behandeln, den Cache umgehen. Muss aus mu-plugins registriert werden. →
- apply_filters woocs_currency_data_manipulation Filtert die gesamte Währungstabelle, bevor das Plugin sie verwendet – Wechselkurse, Symbole, Dezimalstellen und Positionen –, sodass Währungsdaten von jeder beliebigen Quelle stammen können. →
- apply_filters woocs_currency_manipulation_before_show Filtert die Währungsliste unmittelbar vor dem Zeichnen des Umschalters, sodass Sie Währungen pro Seite, pro Benutzer oder nach einer beliebigen Regel ausblenden, neu anordnen oder umbenennen können. →
- apply_filters woocs_currency_symbol_on_order Filter, der FOX anweist, das Währungssymbol auf den Bestellbestätigungs- und Kontoseiten unverändert zu lassen, sodass eine Quittung das Symbol der Währung behält, in der die Bestellung bezahlt wurde. Standardmäßig false. →
- apply_filters woocs_currency_symbols Fügt Währungssymbole hinzu oder ersetzt sie. Der Hook, der für ein benutzerdefiniertes Währungssymbol in WooCommerce oder für eine Währung ohne standardmäßiges Zeichen verwendet wird. →
- apply_filters woocs_currname_in_option Ändert den Text einer Währungszeile im Dropdown-Menü des Umschalters, wenn der Standardcode plus Symbol nicht das ist, was Ihre Kunden sehen sollen. →
- apply_filters woocs_cut_cart_price_format Entfernt das benutzerdefinierte Preisformat auf der Warenkorb- und der Kasse-Seite, wo ein dekoriertes Format manchmal mit anderen Plugins kollidiert. →
- apply_filters woocs_disable_backend_refund_calculation Deaktiviert die Währungsumrechnung während der Bearbeitung einer Rückerstattung im wp-admin, für Shops, die Rückerstattungen gemäß Richtlinie in der Basiswährung speichern. →
- apply_filters woocs_drop_down_view Wechselt das Skin des Währungsumschalter-Dropdowns dynamisch, sodass verschiedene Seiten oder Benutzergruppen unterschiedliche Umschalter-Designs erhalten können. →
- apply_filters woocs_fixed_price_user_rope Filter, der den vom Feature 'Preise basierend auf Benutzerrolle' ermittelten Preis zusammen mit der Produkt-ID, dem Preistyp und den Benutzerrollen übergibt. Hinweis: Der Tippfehler im Hook-Namen: rope, nicht role. →
- apply_filters woocs_fixed_raw_woocommerce_price Filtert den Rohpreis, wenn feste Preise pro Währung aktiv sind. Der übliche Anknüpfungspunkt, um ein Preissystem von Drittanbietern dazu zu bringen, feste Preise zu respektieren. →
- apply_filters woocs_form_method Ändert die Formularmethode des Umschalters von POST zu GET, was einige Caching-Konfigurationen und Page Builder benötigen. Ab Version 2.2.0 / 1.2.0. →
- apply_filters woocs_geobone_ip Filter, der das Verhalten der Geo-IP-Regeln für den ersten Besuch steuert. Die Rückgabe von false deaktiviert das Flag, das eine Geo-Regel einmal pro Besucher anwendet. Standardmäßig true. →
- apply_filters woocs_get_approximate_amount_text Ändert den Wortlaut um den ungefähren Betrag, der auf der Warenkorb- und Kasse-Seite angezeigt wird, wenn die Option 'Ungefähren Betrag anzeigen' aktiviert ist. →
- apply_filters woocs_init_compatibility_woo_subscriptions Aktiviert die Kompatibilität mit WooCommerce Subscriptions, sodass Verlängerungsbeträge die Währung behalten, in der das Abonnement erstellt wurde. →
- apply_filters woocs_order_formatted_prices Steuert die Preisformatierung auf der Bestell- und der Dankesseite. Geben Sie false zurück, um die WooCommerce-Formatierung vollständig zu belassen. →
- apply_filters woocs_precision_on_calc Erhöht die interne Berechnungsgenauigkeit. Erforderlich, wenn Stückpreise sehr klein sind – bei vier Dezimalstellen wird ein Artikel mit 0,000423 auf null gerundet. →
- apply_filters woocs_price_decimal_sep Setzt das Dezimaltrennzeichen pro Währung oder nach einer beliebigen anderen Regel, sodass jeder Markt die Preise so liest, wie er es erwartet. →
- apply_filters woocs_price_format Filtert die gesamte WooCommerce-Preisformatzeichenfolge, um volle Kontrolle darüber zu haben, wo das Symbol steht und was die Zahl umgibt. →
- apply_filters woocs_price_html Filtert das fertige Preis-Markup eines Produkts. Der Hook zum Hinzufügen eines benutzerdefinierten Währungssymbols, eines Hinweises oder eines eigenen Markups zu jedem Preis im Shop. →
- apply_filters woocs_price_html_tail Fügt nach einem Produktpreis auf Shop- und Kategorieseiten Text oder Markup hinzu – einen ungefähren Betrag, einen Steuerhinweis oder einen Hinweis pro Einheit. →
- apply_filters woocs_price_shortcode Filtert den vom Shortcode [woocs_price] erzeugten Preis, sodass ein außerhalb der Produktschleife gedruckter Preis einer eigenen Regel folgen kann. →
- apply_filters woocs_price_thousand_sep Setzt das Tausendertrennzeichen pro Währung oder nach einer beliebigen anderen Regel, sodass 1.299,00 und 1 299,00 im selben Shop existieren können. →
- apply_filters woocs_product_fixed_price_data_simple_types Deklariert, für welche Produkttypen feste Preise pro Währung gelten, sodass ein benutzerdefinierter Produkttyp teilnehmen kann. →
- apply_filters woocs_raw_woocommerce_price Filtert den rohen numerischen Preis vor der Formatierung. Hier leben die Preisrundungsregeln – auf 50 Cent, auf 99 Cent, auf eine ganze Einheit. →
- apply_filters woocs_redraw_cart Deaktiviert das Neuladen des Mini-Warenkorbs nach einem Währungswechsel, was Konflikte mit Themes und Skripten löst, die den Warenkorb selbst neu aufbauen. →
- apply_filters woocs_show_side_swither Filter mit der endgültigen Entscheidung, ob der schwebende Seitenumschalter auf der aktuellen Seite gerendert wird, angewandt nach den eigenen Einstellungen und Ausnahmen des Plugins. Beachten Sie den Tippfehler im Hook-Namen: swither. →
- apply_filters woocs_side_switcher_data Filter, der das gesamte Konfigurations-Array des Seitenumschalters übergibt – Skin, Seite, Abstand, Farben und Feldvorlagen – bevor das Panel gerendert wird. →
- apply_filters woocs_woocommerce_available_variation Filter, der das Datenarray einer einzelnen Variation übergibt, nachdem FOX seine Preise umgerechnet hat, einschließlich price_html, auf dem Weg zum Frontend als JSON. →
- apply_filters woocs_woocommerce_variation_prices Filtert die Preisspanne eines variablen Produkts, sodass die Von-bis-Zeile bei einem variablen Produkt Ihrer eigenen Währungslogik folgt. →
- fn() $WOOCS->back_convert() Konvertiert einen Betrag von der aktuell ausgewählten Währung zurück in die Shop-Basiswährung – die Lösung für Drittanbieter-Code, der einen umgerechneten Betrag mit einem Basiswährungs-Schwellenwert vergleicht. →
- fn() $WOOCS->convert_from_to_currency($value, $from_currency, $to_currency) Konvertiert einen Betrag direkt zwischen zwei beliebigen Währungen, ohne die Basiswährung zu durchlaufen. Verfügbar ab Version 2.4.0 / 1.4.0. →
- fn() $WOOCS->current_currency Die Eigenschaft, die die Währung enthält, in der der Besucher gerade surft. Der Ausgangspunkt für fast jede benutzerdefinierte Währungslogik. →
- fn() $WOOCS->default_currency Die Eigenschaft, die die Shop-Basiswährung speichert – diejenige, mit der WooCommerce selbst konfiguriert ist und gegen die jeder Kurs berechnet wird. →
- fn() $WOOCS->get_checkout_page_id() Gibt die ID der Checkout-Seite zurück, damit Ihr eigener Code zuverlässig erkennen kann, ob es sich bei der aktuellen Anfrage um den Checkout handelt. →
- fn() $WOOCS->get_currencies($suppress_filters = false) Gibt jede in den Plugin-Einstellungen konfigurierte Währung mit Kurs, Symbol, Dezimalstellen und Position zurück – die gesamte Währungstabelle als Array. →
- fn() $WOOCS->get_currency_by_country() Gibt die Währung zurück, die die Geo-IP-Regeln für das Land des Besuchers ermitteln. Funktioniert nur, wenn die Geo-IP-Option aktiviert ist. →
- fn() $WOOCS->get_currency_price_num_decimals() Gibt die Anzahl der Dezimalstellen zurück, die eine bestimmte Währung anzeigen soll, damit Ihre eigene Preisausgabe mit dem Rest des Shops übereinstimmt. →
- fn() $WOOCS->get_geo_rules() Gibt das Geo-IP-Regelarray zurück – welches Land welcher Währung zugeordnet ist – zum Lesen oder Verwenden aus Ihrem eigenen Code. →
- fn() $WOOCS->get_welcome_currency() Gibt die Begrüßungswährung zurück: diejenige, die ein Erstbesucher sieht, bevor er eine eigene Wahl trifft. →
- fn() $WOOCS->is_multiple_allowed Die Eigenschaft, die angibt, ob der Multiwährungs-Checkout aktiviert ist, d. h., ob Kunden in der von ihnen ausgewählten Währung bezahlen können. →
- fn() $WOOCS->is_use_geo_rules() Gibt true zurück, wenn die Geo-IP-Option aktiviert ist, damit Ihr Code darauf verzweigen kann, ob Länderregeln überhaupt angewendet werden. →
- fn() $WOOCS->make_rates_auto_update() Führt sofort eine vollständige Wechselkursaktualisierung durch – dieselbe, die der integrierte Cron ausführt. Verwenden Sie sie, um Aktualisierungen von einem echten Server-Cron aus anzustoßen. →
- fn() $WOOCS->reset_currency() Setzt den Besucher zurück auf die Shop-Basiswährung – nützlich, wenn ein Drittanbieterprozess im Basiswährungskontext ausgeführt werden muss. →
- fn() $WOOCS->set_currency() Setzt die Währung für den aktuellen Besucher aus Ihrem eigenen Code, je nach Bedarf. Verfügbar ab Version 2.1.8 / 1.1.8. →
- fn() $WOOCS->storage->get_val() Liest einen Wert aus der FOX-Speicherschicht — unter anderem die ausgewählte Währung — unabhängig davon, mit welchem Speicher-Backend der Shop konfiguriert ist. →
- fn() $WOOCS->storage->set_val() Schreibt einen Wert in die FOX-Speicherschicht, sodass benutzerdefinierter Code Zustand parallel zum Plugin speichern kann, anstatt eine eigene Sitzung zu verwalten. →
- fn() $WOOCS->woocs_exchange_value() Konvertiert einen Betrag von der Shop-Basiswährung in die vom Besucher ausgewählte Währung — der alltägliche Umrechnungsaufruf. →
- fn() REST API REST-API-Endpunkte zum programmatischen Lesen von Währungsdaten und Produktpreisen, für Headless-Frontends, mobile Apps und externe Integrationen. →