Dokumentasyon ng WordPress Plugin
Alamin kung paano mag-install, mag-configure, at mag-customize ng iyong currency converter widget
Talaan ng Nilalaman
1 Pag-install
Paraan 1: Mag-install mula sa WordPress (Inirerekomenda)
- Pumunta sa iyong WordPress admin dashboard
- Mag-navigate sa Plugins > Add New
- Hanapin ang "Currency.Wiki Converter"
- I-click ang "Install Now" at pagkatapos ay "Activate"
Paraan 2: Manu-manong Pag-install
- I-download ang plugin mula sa WordPress.org
- Pumunta sa Plugins > Add New > Upload Plugin
- Piliin ang na-download na ZIP file at i-click ang "Install Now"
- I-activate ang plugin pagkatapos ng pag-install
2 Paggamit ng Gutenberg Block
Pinakamadaling paraan para idagdag ang currency converter sa iyong mga pahina:
- I-edit ang anumang pahina o post gamit ang Gutenberg editor
- I-click ang + button para magdagdag ng bagong block
- Hanapin ang "Currency Converter" o tingnan ang Widgets category
- I-configure ang widget gamit ang sidebar panel sa kanan
Tip: Makikita mo ang live preview ng iyong widget habang binabago mo ang mga setting sa block editor.
3 Paggamit ng Shortcode
Maaari mo ring idagdag ang widget gamit ang shortcodes sa mga post, pahina, o theme templates:
Pangunahing Paggamit
[currencywiki_converter]
Mga Available na Attribute
| Katangian | Karaniwan | Paglalarawan |
|---|---|---|
| style | compact | Estilo ng widget (compact, inline, tall, mini-chart, atbp.) |
| theme | auto | Tema ng kulay (auto, light, dark) |
| from | USD | Default na source currency (3-letter ISO code) |
| to | EUR | Default na target currency (3-letter ISO code) |
| amount | 1 | Default na halaga para i-convert |
| accent | #3b82f6 | Accent na kulay (hex code gaya ng #3b82f6) |
| embed | script | Paraan ng pag-embed (script o iframe) |
| width | auto | Custom na lapad sa pixels |
| height | auto | Custom na taas sa pixels |
Mga Halimbawa
Widget na dark theme:
[currencywiki_converter theme="dark"]
Custom na mga currency at halaga:
[currencywiki_converter from="GBP" to="JPY" amount="100"]
Mini chart na estilo:
[currencywiki_converter style="mini-chart"]
Paggamit ng iframe embed (para sa theme compatibility):
[currencywiki_converter embed="iframe"]
4 Mga Estilo ng Widget
Pumili mula sa iba't ibang estilo ng widget para bumagay sa disenyo ng iyong website:
mini
Minimal na converter, perpekto para sa masisikip na espasyo (250x140px)
square
Parisukat na 1:1 na tagapagpalit (250x250px)
compact
Maliit at tipid sa espasyo na converter (280x200px)
inline
Horizontal na layout, maganda para sa headers (450x120px)
tall
Vertical na layout na may klasikong label (220x360px)
mini-chart
Compact na converter na may historical chart (250x260px)
multi-expandable
Mag-convert sa maraming currency, maaaring magdagdag/magbawas ang user (300x400px)
multi-fixed
Fixed na listahan ng maraming currency conversions (280x360px)
rates-compact
Simpleng listahan ng exchange rates (260x260px)
rates-viewer
Buong rates viewer na may chart (350x420px)
rates-viewer-compact
Compact rates viewer na may chart (300x340px)
Tip: Gamitin ang Widget Builder sa iyong WordPress admin para makita ang preview ng lahat ng estilo bago idagdag sa iyong site.
5 Mga Opsyon sa Konfigurasyon
Ang settings page ng plugin sa iyong WordPress admin ay nagbibigay-daan para i-configure ang default na mga opsyon:
Mga Opsyon sa Tema
- auto - Awtomatikong tumutugma sa color scheme ng iyong site
- light - Laging gumamit ng light background
- dark - Laging gumamit ng dark background
Paraan ng Pag-embed
- script - Default. Naglo-load ang widget nang inline na may buong functionality. Ang currency dropdowns ay lumalabas sa ibabaw ng ibang content.
- iframe - Fallback na opsyon. Naglo-load ang widget sa hiwalay na iframe. Gamitin kung may style conflicts sa iyong tema.
Tandaan: Kung ang currency dropdowns ay lumilitaw sa likod ng ibang elemento o napuputol, subukang lumipat sa iframe embed mode.
6 Pagsasaayos ng Problema
Hindi lumalabas ang widget?
Siguraduhing naka-activate ang plugin. Tingnan kung may caching plugins na kailangang i-clear. Subukang gamitin ang iframe embed method kung hindi gumagana ang script embed.
Sirang itsura ng widget o may conflict sa style?
Maaaring mag-conflict ang ilang WordPress themes sa widget script. Lumipat sa iframe embed mode sa pamamagitan ng pagdagdag ng embed="iframe" sa iyong shortcode.
Nakatago o napuputol ang currency dropdown?
Maaaring mangyari ito kapag ang container elements ay may overflow:hidden. Subukang gamitin ang iframe embed mode, o ayusin ang CSS ng iyong tema para payagan ang overflow sa widget container.
Lumang rates ang lumalabas sa widget?
Awtomatikong nag-a-update ang exchange rates. Kung gumagamit ka ng caching plugin, siguraduhing hindi kasama sa caching ang widget scripts o i-clear ang cache pagkatapos ng pagbabago.
Kailangan ng Tulong?
Hindi mo makita ang hinahanap mo? Narito ang aming support team para tumulong.
