Dokumentacja wtyczki WordPress
Dowiedz się, jak zainstalować, skonfigurować i dostosować swój widget konwertera walut
Spis treści
1 Instalacja
Metoda 1: Instalacja z poziomu WordPress (zalecane)
- Przejdź do panelu administracyjnego WordPress
- Przejdź do Wtyczki > Dodaj nową
- Wyszukaj "Currency.Wiki Converter"
- Kliknij "Zainstaluj teraz", a następnie "Aktywuj"
Metoda 2: Instalacja ręczna
- Pobierz wtyczkę z WordPress.org
- Przejdź do Wtyczki > Dodaj nową > Prześlij wtyczkę
- Wybierz pobrany plik ZIP i kliknij "Zainstaluj teraz"
- Aktywuj wtyczkę po instalacji
2 Użycie bloku Gutenberg
Najprostszy sposób dodania konwertera walut do swoich stron:
- Edytuj dowolną stronę lub wpis za pomocą edytora Gutenberg
- Kliknij przycisk +, aby dodać nowy blok
- Wyszukaj "Currency Converter" lub przejrzyj kategorię Widgety
- Skonfiguruj widget w panelu bocznym po prawej stronie
Wskazówka: Możesz zobaczyć podgląd na żywo swojego widgetu podczas zmiany ustawień w edytorze bloków.
3 Użycie shortcode
Możesz także dodać widget za pomocą shortcode w postach, stronach lub szablonach motywu:
Podstawowe użycie
[currencywiki_converter]
Dostępne atrybuty
| Atrybut | Domyślne | Opis |
|---|---|---|
| style | compact | Styl widgetu (compact, inline, tall, mini-chart itp.) |
| theme | auto | Motyw kolorystyczny (auto, light, dark) |
| from | USD | Domyślna waluta źródłowa (3-literowy kod ISO) |
| to | EUR | Domyślna waluta docelowa (3-literowy kod ISO) |
| amount | 1 | Domyślna kwota do przeliczenia |
| accent | #3b82f6 | Kolor akcentu (kod hex, np. #3b82f6) |
| embed | script | Metoda osadzenia (script lub iframe) |
| width | auto | Własna szerokość w pikselach |
| height | auto | Własna wysokość w pikselach |
Przykłady
Widget w ciemnym motywie:
[currencywiki_converter theme="dark"]
Własne waluty i kwota:
[currencywiki_converter from="GBP" to="JPY" amount="100"]
Styl mini wykresu:
[currencywiki_converter style="mini-chart"]
Użycie osadzenia iframe (dla zgodności z motywem):
[currencywiki_converter embed="iframe"]
4 Style widgetu
Wybierz spośród wielu stylów widgetu, aby dopasować go do wyglądu swojej strony:
mini
Minimalny konwerter, idealny do małych przestrzeni (250x140px)
square
Konwerter o proporcjach 1:1 (250x250px)
compact
Mały, oszczędzający miejsce konwerter (280x200px)
inline
Układ poziomy, świetny do nagłówków (450x120px)
tall
Układ pionowy z klasycznymi etykietami (220x360px)
mini-chart
Kompaktowy konwerter z wykresem historycznym (250x260px)
multi-expandable
Przeliczanie na wiele walut, użytkownik może dodawać/usuwać (300x400px)
multi-fixed
Stała lista wielu przeliczeń walut (280x360px)
rates-compact
Prosta lista kursów walut (260x260px)
rates-viewer
Pełny podgląd kursów z wykresem (350x420px)
rates-viewer-compact
Kompaktowy podgląd kursów z wykresem (300x340px)
Wskazówka: Użyj Kreatora Widgetów w panelu WordPress, aby zobaczyć podgląd wszystkich stylów przed dodaniem ich na stronę.
5 Opcje konfiguracji
Strona ustawień wtyczki w panelu WordPress pozwala skonfigurować opcje domyślne:
Opcje motywu
- auto - Automatycznie dopasowuje się do kolorystyki strony
- light - Zawsze używaj jasnego tła
- dark - Zawsze używaj ciemnego tła
Metoda osadzenia
- script - Domyślnie. Widget ładuje się wewnątrz strony z pełną funkcjonalnością. Listy walut wyświetlają się nad inną treścią.
- iframe - Opcja awaryjna. Widget ładuje się w odizolowanym iframe. Użyj, jeśli występują konflikty stylów z motywem.
Uwaga: Jeśli listy walut pojawiają się pod innymi elementami lub są ucinane, spróbuj przełączyć się na tryb osadzenia iframe.
6 Rozwiązywanie problemów
Widget się nie wyświetla?
Upewnij się, że wtyczka jest aktywna. Sprawdź, czy należy wyczyścić cache innych wtyczek. Spróbuj użyć metody osadzenia iframe, jeśli osadzenie przez script nie działa.
Widget wygląda niepoprawnie lub style się gryzą?
Niektóre motywy WordPress mogą powodować konflikty ze skryptem widgetu. Przełącz się na tryb iframe, dodając embed="iframe" do shortcode.
Lista walut ukryta lub ucięta?
Może się to zdarzyć, gdy elementy kontenera mają overflow:hidden. Spróbuj użyć trybu iframe lub zmodyfikuj CSS motywu, aby umożliwić overflow dla kontenera widgetu.
Widget pokazuje stare kursy?
Kursy walut aktualizują się automatycznie. Jeśli używasz wtyczki cache, wyklucz skrypty widgetu z cache lub wyczyść cache po zmianach.
Potrzebujesz pomocy?
Nie możesz znaleźć tego, czego szukasz? Nasz zespół wsparcia jest do Twojej dyspozycji.
