Dokumentasi Plugin WordPress
Pelajari cara memasang, mengkonfigurasi, dan menyesuaikan widget penukar mata wang anda
Kandungan
1 Pemasangan
Kaedah 1: Pasang dari WordPress (Disyorkan)
- Pergi ke papan pemuka admin WordPress anda
- Navigasi ke Plugins > Add New
- Cari "Currency.Wiki Converter"
- Klik "Install Now" dan kemudian "Activate"
Kaedah 2: Pemasangan Manual
- Muat turun plugin dari WordPress.org
- Pergi ke Plugins > Add New > Upload Plugin
- Pilih fail ZIP yang dimuat turun dan klik "Install Now"
- Aktifkan plugin selepas pemasangan
2 Menggunakan Blok Gutenberg
Cara paling mudah untuk menambah penukar mata wang ke halaman anda:
- Edit mana-mana halaman atau pos menggunakan editor Gutenberg
- Klik butang + untuk menambah blok baharu
- Cari "Currency Converter" atau semak kategori Widgets
- Konfigurasikan widget menggunakan panel sisi di sebelah kanan
Petua: Anda boleh melihat pratonton langsung widget anda semasa menukar tetapan dalam editor blok.
3 Penggunaan Shortcode
Anda juga boleh menambah widget menggunakan shortcode dalam pos, halaman, atau templat tema:
Penggunaan Asas
[currencywiki_converter]
Atribut Tersedia
| Atribut | Lalai | Penerangan |
|---|---|---|
| style | compact | Gaya widget (compact, inline, tall, mini-chart, dll.) |
| theme | auto | Tema warna (auto, light, dark) |
| from | USD | Mata wang sumber lalai (kod ISO 3 huruf) |
| to | EUR | Mata wang sasaran lalai (kod ISO 3 huruf) |
| amount | 1 | Amaun lalai untuk ditukar |
| accent | #3b82f6 | Warna aksen (kod hex seperti #3b82f6) |
| embed | script | Kaedah embed (script atau iframe) |
| width | auto | Lebar tersuai dalam piksel |
| height | auto | Tinggi tersuai dalam piksel |
Contoh
Widget tema gelap:
[currencywiki_converter theme="dark"]
Mata wang dan amaun tersuai:
[currencywiki_converter from="GBP" to="JPY" amount="100"]
Gaya carta mini:
[currencywiki_converter style="mini-chart"]
Menggunakan embed iframe (untuk keserasian tema):
[currencywiki_converter embed="iframe"]
4 Gaya Widget
Pilih daripada pelbagai gaya widget untuk dipadankan dengan reka bentuk laman web anda:
mini
Penukar minimal, sesuai untuk ruang sempit (250x140px)
square
Penukar nisbah aspek 1:1 (250x250px)
compact
Penukar kecil dan jimat ruang (280x200px)
inline
Susun atur mendatar, sesuai untuk header (450x120px)
tall
Susun atur menegak dengan label klasik (220x360px)
mini-chart
Penukar padat dengan carta sejarah (250x260px)
multi-expandable
Tukar ke pelbagai mata wang, pengguna boleh tambah/buang (300x400px)
multi-fixed
Senarai tetap penukaran pelbagai mata wang (280x360px)
rates-compact
Senarai kadar tukaran ringkas (260x260px)
rates-viewer
Paparan kadar penuh dengan carta (350x420px)
rates-viewer-compact
Paparan kadar padat dengan carta (300x340px)
Petua: Gunakan Widget Builder dalam admin WordPress anda untuk pratonton semua gaya sebelum menambah ke laman anda.
5 Pilihan Konfigurasi
Halaman tetapan plugin dalam admin WordPress anda membolehkan anda mengkonfigurasi pilihan lalai:
Pilihan Tema
- auto - Padankan secara automatik dengan skema warna laman anda
- light - Sentiasa gunakan latar belakang cerah
- dark - Sentiasa gunakan latar belakang gelap
Kaedah Embed
- script - Lalai. Widget dimuatkan secara inline dengan fungsi penuh. Dropdown mata wang dipaparkan di atas kandungan sekeliling.
- iframe - Pilihan sandaran. Widget dimuatkan dalam iframe terasing. Guna jika anda mengalami konflik gaya dengan tema anda.
Nota: Jika dropdown mata wang muncul di belakang elemen lain atau terpotong, cuba tukar ke mod embed iframe.
6 Penyelesaian Masalah
Widget tidak dipaparkan?
Pastikan plugin diaktifkan. Semak jika ada plugin cache yang perlu dikosongkan. Cuba gunakan kaedah embed iframe jika embed script tidak berfungsi.
Widget kelihatan rosak atau gaya bercanggah?
Sesetengah tema WordPress mungkin bercanggah dengan skrip widget. Tukar ke mod embed iframe dengan menambah embed="iframe" pada shortcode anda.
Dropdown mata wang tersembunyi atau terpotong?
Ini boleh berlaku apabila elemen kontena mempunyai overflow:hidden. Cuba gunakan mod embed iframe, atau laraskan CSS tema anda untuk membenarkan overflow pada kontena widget.
Widget memaparkan kadar lama?
Kadar tukaran dikemas kini secara automatik. Jika anda menggunakan plugin cache, pastikan skrip widget dikecualikan daripada cache atau kosongkan cache selepas membuat perubahan.
Perlukan Bantuan?
Tidak jumpa apa yang anda cari? Pasukan sokongan kami sedia membantu.
