Wtyczka CURCY – WooCommerce Multi Currency – Currency Switcher - 2.4.2

CURCY – WooCommerce Multi Currency Premium to wtyczka VillaTheme, która dodaje do WooCommerce obsługę wielu walut. Klient przegląda ceny i płaci w wybranej walucie, właściciel zarządza kursami automatycznie lub ręcznie. Wtyczka trafia do małych i średnich sklepów sprzedających międzynarodowo.

Przełącznik walut i formy wyświetlania cen

CURCY udostępnia przełącznik walut w kilku formach: pasek walut z wyborem stylu (kod, symbol, flaga, flaga z kodem lub flaga z symbolem), Currency Price Switcher oraz zestaw shortcode’ów, które wstawiają selektor w dowolnym miejscu strony. Sam pasek ustawia się po lewej lub prawej krawędzi, zwija przy dużej liczbie walut, przyjmuje własne kolory i niestandardowe symbole walut.

Pasek walut, style i kolory

Pasek walut (Currencies bar) konfiguruje się w zakładce Design. Pięć stylów prezentacji do wyboru: sam kod waluty (np. EUR), symbol, flaga kraju, flaga z kodem oraz flaga z symbolem.

Położenie paska – lewa lub prawa krawędź ekranu – kolory tekstu i tła oraz własny CSS pozwalają dopasować element do szablonu sklepu. Widocznością paska na poszczególnych stronach sterują Conditional Tags, czyli warunkowe tagi WooCommerce, które ograniczają wyświetlanie do wybranych podstron.

Shortcody przełącznika, kursów i konwertera

Poza paskiem CURCY udostępnia zestaw shortcode’ów, które osadzają elementy walutowe niezależnie od buildera. Podstawowy [woo_multi_currency] wstawia selektor walut, [woo_multi_currency_rates] wyświetla tabelę bieżących kursów, [woo_multi_currency_convertor] dodaje konwerter kwot, a [woo_multi_currency_current] pokazuje aktualnie wybraną walutę. Dostępne są warianty układu poziomego i pionowego oraz parametry rozmiaru flagi i symbolu.

Zwijanie paska i własne symbole walut

Przy dużej liczbie aktywnych walut przydaje się Collapse Currencies Bar – pasek pokazuje jedną walutę, a pozostałe rozwija po najechaniu kursorem.

• Ponad 200 walut – wtyczka pozwala aktywować dowolną ich liczbę, a wybrane można ukryć na froncie sklepu.
• Niestandardowe symbole – ten sam dolar można wyświetlić jako „USD”, „US$” lub „$”, zależnie od rynku.
• Własne flagi – przydają się, gdy kilka krajów dzieli tę samą walutę i domyślne oznaczenie jest mylące.

Automatyczne kursy wymiany, ceny sztywne i formatowanie cen

CURCY aktualizuje kursy wymiany automatycznie z wielu API finansowych – serwera VillaTheme, Xe, Wise, Openexchangerates, Exchangerate API i Currencyapi – w interwałach od 30 minut do miesiąca. Kursy można też wpisać ręcznie. Zamiast przeliczania z kursu wtyczka przyjmie cenę sztywną per waluta, z masowym importem z pliku CSV, a format ceny końcowej dopracują reguły zaokrąglania.

Automatyczne API kursów i interwały aktualizacji

Automatyczna aktualizacja pobiera kursy z wybranego źródła w cyklu co 30 minut, godzinę, 6 godzin, dzień, 2 dni, 3 dni, tydzień lub miesiąc. Źródłem może być serwer VillaTheme, Xe, Wise (dawniej TransferWise), Openexchangerates, Exchangerate API lub Currencyapi.

Po każdej udanej aktualizacji administrator może otrzymać powiadomienie e-mail. Starsze źródła w rodzaju Google czy Yahoo Finance są przestarzałe i nie stanowią już wiarygodnej opcji.

Ceny sztywne per waluta i import z CSV

Fixed price nadpisuje przeliczenie kursowe stałą ceną wpisaną wprost w danej walucie – na przykład 11,99 EUR zamiast przeliczonego 12,37 EUR. Cenę regularną i promocyjną ustawia się osobno dla każdej waluty. Przy dużym katalogu ceny sztywne wgrywa się masowo z pliku CSV, co pozwala zaktualizować setki produktów jednym importem zamiast edytować je pojedynczo.

Opłata wymiany i „beautify” cen końcowych

Exchange Fee dolicza do kursu stałą marżę, która pokrywa różnicę kursową banku lub operatora płatności. Price Format odpowiada za „upiększanie” ceny końcowej – reguły zaokrąglania zamieniają wynik przeliczenia na czytelną kwotę (np. 9,87 na 9,99), a każda waluta może mieć własne separatory tysięcy i miejsc dziesiętnych.

Auto-detekcja waluty po kraju i dopasowanie do języka

CURCY wykrywa kraj klienta po adresie IP i pokazuje przypisaną mu walutę, korzystając z wybranego źródła geolokalizacji – WooCommerce (ipinfo.io lub ip-api.com), geoPlugin albo MaxMind. W sklepach wielojęzycznych na WPML lub Polylang wtyczka dobiera walutę do aktywnego języka strony, na przykład GBP na wersji angielskiej i EUR na hiszpańskiej, bez ręcznego przełączania przez klienta.

Wykrywanie kraju po IP i wybór Geo API

Auto-detekcja rozpoznaje lokalizację odwiedzającego na poziomie kraju, nie regionów czy stanów w jego obrębie. Źródło geolokalizacji wybiera się spośród trzech opcji: wbudowana geolokalizacja WooCommerce (ipinfo.io lub ip-api.com), zewnętrzny geoPlugin oraz MaxMind Geolocation. Poprawne działanie wymaga dostępu serwera do wychodzących zapytań HTTP do tych usług.

Waluta wg języka na WPML i Polylang

W sklepach wielojęzycznych CURCY wiąże walutę z aktywnym językiem strony. Na WPML i Polylang – obu wspieranych oficjalnie – wersja angielska może domyślnie pokazywać GBP, a hiszpańska EUR, bez proszenia klienta o wybór. W changelogu pojawiają się też wzmianki o współpracy z TranslatePress.

Cena przybliżona i ręczne przypisanie waluty do kraju

Zamiast od razu przełączać widok na walutę klienta, opcja Approximate price pokazuje cenę w walucie bazowej, a pod nią orientacyjną kwotę w walucie odwiedzającego. Ręczne przypisanie waluty do kraju (Currency by country) nadpisuje automatyczne dopasowanie tam, gdzie domyślny wybór nie pasuje. Funkcja Change currency follow wymusza zmianę waluty przy zmianie kraju rozliczeniowego lub dostawy.

Płatność w wybranej walucie i sterowanie bramkami

CURCY pozwala klientowi zapłacić w wybranej walucie, o ile bramka płatności ją obsługuje – sama wtyczka jest przede wszystkim przełącznikiem i konwerterem wyświetlania, a realne rozliczenie zależy od operatora płatności. W wersji premium można sterować tym, które bramki pojawiają się na checkoucie zależnie od waluty, wskazać osobne waluty checkoutu oraz wymusić walutę zamówienia.

Kiedy klient płaci w wybranej walucie, a kiedy w bazowej

Opcja „Allow multi currency payment” przekazuje wybraną przez klienta walutę do procesu płatności. Jeśli bramka tę walutę obsługuje, klient płaci dokładnie widzianą kwotę; jeśli nie – rozliczenie następuje w walucie bazowej sklepu.

Zgłaszane w recenzjach przypadki przekazania niewłaściwej waluty do operatora wynikają zwykle z konfiguracji bramki, dlatego zestaw waluta–bramka wymaga testu przed startem sprzedaży.

Metody płatności i waluty checkoutu per waluta

Funkcja metod płatności per waluta decyduje, która bramka pojawia się na checkoucie w zależności od aktywnej waluty – operatorzy nieobsługujący danej waluty zostają ukryci. Osobno definiuje się dozwolone waluty checkoutu, więc sklep może wyświetlać ceny w czterech walutach, a przyjmować płatność tylko w dwóch. To ogranicza ryzyko nieudanych transakcji, gdy część bramek działa wyłącznie w jednej walucie.

Wymuszanie waluty zamówienia i tryb SESSION

Force currency to checkout wymusza ustaloną walutę zamówienia po kliknięciu „Place order” i synchronizuje walutę koszyka z walutą checkoutu. Opcja Use SESSION zapisuje wybraną walutę w sesji zamiast w ciasteczkach, co pomaga na stronach z cache, gdzie waluta wcześniej wracała do domyślnej. Przełączanie waluty przez JavaScript działa bez doklejania parametru do adresu URL.

Dla jakich sklepów CURCY ma sens

CURCY sprawdza się najlepiej w małych i średnich sklepach WooCommerce sprzedających międzynarodowo, którym zależy na auto-detekcji waluty, automatycznych kursach i „ładnych” cenach sztywnych per rynek bez rozbudowanego budżetu. Mniej pasuje tam, gdzie liczy się rzeczywiste rozliczanie i księgowanie w walucie klienta albo raportowanie po walutach – w takich przypadkach częściej wskazuje się Aelia lub WCML.

Sklepy międzynarodowe, wielojęzyczne i z cenami per rynek

Dla kogo CURCY sprawdza się najlepiej:

• Małe i średnie sklepy WooCommerce prowadzące sprzedaż do klientów z różnych krajów.
• Sklepy z osobnymi, „ładnymi” cenami katalogowymi per rynek zamiast surowego przeliczenia kursowego.
• Sklepy wielojęzyczne na WPML lub Polylang, gdzie waluta ma podążać za językiem strony.
• Sklepy sterujące metodami płatności zależnie od waluty, by pokazać tylko obsługujące ją bramki.

Dla kogo CURCY nie jest najlepszym wyborem (settlement, cache, analityka)

Dla kogo CURCY nie jest najlepszym wyborem:

• Sklepy wymagające prawdziwego rozliczania i księgowania w walucie klienta (settlement) – tu bliżej rozwiązaniom pokroju Aelia czy WCML.
• Sklepy zobowiązane do liczenia po urzędowym kursie, np. średnim NBP z tabeli A – wtyczka nie ma udokumentowanego natywnego źródła NBP.
• Sklepy na agresywnym cache bez możliwości konfiguracji wykluczeń, gdzie auto-detekcja waluty bywa zawodna.
• Sklepy, dla których rozbudowana analityka sprzedaży per waluta jest wyróżnikiem decydującym.

Polski kontekst — bramki płatności i kursy walut

CURCY w polskim sklepie działa poprawnie z PLN i innymi walutami, ale realna płatność w wybranej walucie zależy od tego, czy konkretna bramka ją obsługuje – PayU przyjmuje m.in. PLN, EUR, GBP i USD, a część polskich integracji działa głównie w PLN. Wtyczka nie ma udokumentowanego natywnego źródła kursów NBP; pobiera je z Xe, Wise, Openexchangerates lub serwera VillaTheme.

Które bramki obsłużą daną walutę

Realna płatność w danej walucie zależy od możliwości bramki, nie samej wtyczki. Wśród polskich i europejskich integracji zakres bywa różny: PayU obsługuje m.in. PLN, EUR, GBP, USD, DKK, NOK i SEK, natomiast Autopay z BLIK oraz część integracji Przelewy24 i Tpay działa przede wszystkim w PLN. Tu wchodzi w grę funkcja metod płatności per waluta – pozwala pokazać na checkoucie tylko bramkę zdolną obsłużyć wybraną walutę.

Kursy walut a brak natywnego źródła NBP

CURCY nie udostępnia natywnego pobierania kursów z tabeli NBP. Kursy pochodzą z zewnętrznych API – serwera VillaTheme, Xe, Wise, Openexchangerates, Exchangerate API lub Currencyapi – więc sprzedawca liczący po urzędowym kursie NBP nie znajdzie tego źródła „z pudełka”. Ceny sztywne per waluta bywają w takiej sytuacji obejściem, gdy liczy się przewidywalna kwota, a nie zgodność z konkretnym kursem dnia.

Wymagania i zgodność z WooCommerce, WordPress oraz cache

CURCY wymaga aktywnego WooCommerce w wersji 7.x lub nowszej – zgodność potwierdzono z liniami 9.x i 10.x – oraz WordPressa od wersji 5.x (testowany na 6.8 i 6.9) i PHP 7.x lub nowszego. Wtyczka obsługuje HPOS, integruje się z Elementorem i Gutenbergiem, współpracuje z WPML i Polylang, a na stronach z cache udostępnia tryb SESSION.

WordPress, PHP i WooCommerce — wersje i HPOS

CURCY wymaga WooCommerce w wersji 7.x lub nowszej; zgodność potwierdzono z liniami 9.x i 10.x. Po stronie WordPressa minimalna wersja to 5.x, a testy obejmują 6.8 i 6.9. Wtyczka działa na PHP 7.x lub nowszym, ze wzmiankami o zgodności z PHP 8 w changelogu. Obsługa HPOS (High-Performance Order Storage) została dodana w wersji 2.3.0 i jest utrzymywana w kolejnych wydaniach.

Buildery, wielojęzyczność i cache

Przełącznik walut występuje jako widget Elementora oraz z podglądem w edytorze Gutenberg, a jako shortcode działa niezależnie od buildera. Wielojęzyczność obsługują WPML i Polylang, ze wzmiankami o TranslatePress. Wśród integracji czyszczenia cache znajdują się LiteSpeed, WP Rocket, WP Fastest Cache i Autoptimize.

Uwaga o cache: auto-detekcja kraju po IP bywa zawodna na stronach z agresywnym cache – poprawne działanie przełącznika wymaga wtedy trybu SESSION i skonfigurowanych wykluczeń cache.

Najczęściej zadawane pytania