উইজেট ডকুমেন্টেশন
আপনার ওয়েবসাইটে Currency.Wiki মুদ্রা রূপান্তর উইজেট এম্বেড ও কাস্টমাইজ করার সম্পূর্ণ গাইড।
সূচিপত্র
1 শুরু করুন
আপনার ওয়েবসাইটে মুদ্রা রূপান্তর উইজেট যোগ করা সহজ। এই সহজ ধাপগুলো অনুসরণ করুন:
- উইজেট বিল্ডার পেজে যান এবং উইজেটের চেহারা কাস্টমাইজ করুন
- আপনার পছন্দের উইজেট স্টাইল, মুদ্রা ও থিম নির্বাচন করুন
- তৈরি হওয়া এম্বেড কোড (স্ক্রিপ্ট বা আইফ্রেম) কপি করুন
- আপনার ওয়েবসাইটের HTML-এ কোডটি পেস্ট করুন যেখানে উইজেটটি দেখাতে চান
টিপ: উইজেট বিল্ডারের কুইক স্টার্ট প্রিসেট ব্যবহার করে দ্রুত একটি প্রি-কনফিগারড উইজেট দিয়ে শুরু করুন।
2 এম্বেড পদ্ধতি
স্ক্রিপ্ট এম্বেড (সুপারিশকৃত)
স্ক্রিপ্ট এম্বেড পদ্ধতিতে উইজেট সরাসরি আপনার পেজে ইনজেক্ট হয়। মুদ্রার ড্রপডাউন মেনু সহজ নির্বাচনের জন্য আশেপাশের কনটেন্টের সামনে দেখাবে।
<div id="currency-wiki-widget"></div>
<script src="https://widget.currency.wiki/v3/script.js?style=compact&theme=light&from=USD&to=EUR"></script>
- ড্রপডাউন উইজেট কন্টেইনারের বাইরে দেখায়
- ইন্টারঅ্যাকটিভ মুদ্রা নির্বাচনের জন্য সেরা
- আপনার পেজের সাথে নির্বিঘ্ন সংযোগ
আইফ্রেম এম্বেড
আইফ্রেম এম্বেড পদ্ধতিতে উইজেটের জন্য একটি আইসোলেটেড কন্টেইনার তৈরি হয়। এই পদ্ধতি নিরাপদ এবং কঠোর কনটেন্ট পলিসি পরিবেশে কাজ করে।
<iframe src="https://widget.currency.wiki/v3/embed?style=compact&theme=light&from=USD&to=EUR"
width="300" height="180" frameborder="0"></iframe>
- আপনার পেজ স্টাইল থেকে সম্পূর্ণ আলাদা
- কঠোর কনটেন্ট সিকিউরিটি পলিসিতে কাজ করে
- সহজ ও নিরাপদ ইমপ্লিমেন্টেশন
নোট: সম্পূর্ণ ইন্টারঅ্যাকটিভিটির জন্য স্ক্রিপ্ট এম্বেড ব্যবহার করুন (ড্রপডাউন কনটেন্টের ওপরে দেখায়)। আইফ্রেম এম্বেড ব্যবহার করুন যখন আইসোলেশন দরকার বা CSP সীমাবদ্ধতা আছে।
3 উইজেট স্টাইল
আপনার ওয়েবসাইটের ডিজাইনের সাথে মিলিয়ে নিতে ১১টি ভিন্ন উইজেট স্টাইল থেকে বেছে নিন। প্রতিটি স্টাইল বিভিন্ন ব্যবহারের জন্য অপ্টিমাইজড।
mini
250x140px
কমপ্যাক্ট এক-লাইন রূপান্তরকারী। হেডার বা ছোট জায়গার জন্য উপযুক্ত।
square
250x250px
১:১ অনুপাতের উইজেট সোয়াপ বাটনসহ। সাইডবারের জন্য চমৎকার।
compact
300x180px
ছোট জায়গার জন্য সব জরুরি ফিচারসহ রূপান্তরকারী।
inline
480x56px
অনুভূমিক লেআউট। কনটেন্ট বা ন্যাভিগেশনে এম্বেড করার জন্য আদর্শ।
tall
200x280px
ভার্টিকাল সাইডবার লেআউট ক্লাসিক লেবেলসহ।
mini-chart
250x260px
কমপ্যাক্ট রূপান্তরকারী স্পার্কলাইন চার্টসহ রেট ইতিহাস দেখায়।
multi-expandable
300x320px
মাল্টি-কারেন্সি রূপান্তরকারী। ব্যবহারকারীরা মুদ্রা যোগ/সরাতে পারে।
multi-fixed
300x300px
নির্দিষ্ট এক্সচেঞ্জ রেটের নির্দিষ্ট তালিকা।
rates-compact
250x320px
সংক্ষিপ্ত এক্সচেঞ্জ রেট তালিকা সর্বশেষ আপডেট সময়সহ।
rates-viewer
300x500px
সম্পূর্ণ চার্ট ভিউ বিস্তারিত রেট তথ্যসহ।
rates-viewer-compact
300x400px
চার্টসহ রেটস ভিউয়ারের কমপ্যাক্ট সংস্করণ।
4 URL প্যারামিটার
URL প্যারামিটার ব্যবহার করে আপনার উইজেট কাস্টমাইজ করুন। এই প্যারামিটারগুলো স্ক্রিপ্ট ও আইফ্রেম উভয় এম্বেড পদ্ধতিতে কাজ করে।
| প্যারামিটার | ডিফল্ট | বর্ণনা |
|---|---|---|
| style | compact | উইজেট স্টাইল (mini, square, compact, inline, tall, mini-chart, multi-expandable, multi-fixed, rates-compact, rates-viewer, rates-viewer-compact) |
| theme | light | রঙের থিম (light, dark, বা auto) |
| from | USD | সোর্স মুদ্রা কোড (যেমন, USD, EUR, GBP) |
| to | EUR | টার্গেট মুদ্রা কোড (যেমন, EUR, USD, JPY) |
| amount | 1000 | রূপান্তরের জন্য ডিফল্ট পরিমাণ |
| accent | #2563eb | অ্যাকসেন্ট রঙ হেক্স ফরম্যাটে (# ছাড়া) |
| lang | en | উইজেট ভাষা কোড (যেমন, en, es, fr, de) |
| flags | 1 | দেশের পতাকা দেখান (1=দেখান, 0=লুকান) |
| display | iso | মুদ্রা ডিসপ্লে ফরম্যাট (iso=USD, symbol=$) |
| lock | 0 | মুদ্রা লক করুন (1=লক, 0=আনলক) |
| currencies | EUR,GBP,JPY | মাল্টি-কারেন্সি উইজেটের জন্য কমা-সেপারেটেড মুদ্রা তালিকা |
| dropdown | all | ড্রপডাউনে মুদ্রা (all, top10, top20, বা কমা-সেপারেটেড তালিকা) |
| branding | 1 | ব্র্যান্ডিং দেখান (1=দেখান, 0=লুকান) |
| brandinglink | 1 | ব্র্যান্ডিং ক্লিকযোগ্য করুন (1=লিংক, 0=শুধু টেক্সট) |
| format | auto | সংখ্যা ফরম্যাট (auto, us, eu, french, indian) |
| decimals | 2 | দশমিক স্থানের সংখ্যা (0-6) |
| chart | 0 | চার্ট চালু করুন (1=চালু, 0=বন্ধ) |
| chartperiod | 7d | চার্ট সময়কাল (7d, 14d, 30d, 90d) |
উদাহরণ
ডার্ক থিম কমপ্যাক্ট রূপান্তরকারী:
?style=compact&theme=dark&from=USD&to=EUR
মাল্টি-কারেন্সি এক্সচেঞ্জ রেট:
?style=multi-fixed&from=USD¤cies=EUR,GBP,JPY,CAD
৩০-দিনের চার্টসহ মিনি রূপান্তরকারী:
?style=mini-chart&from=EUR&to=USD&chartperiod=30d
কোডের পরিবর্তে মুদ্রার প্রতীক দেখান:
?style=compact&display=symbol&from=USD&to=EUR
কাস্টম পরিমাণসহ লকড মুদ্রা:
?style=compact&from=GBP&to=USD&lock=1&amount=100
5 কাস্টমাইজেশন অপশন
থিম অপশন
- light - হালকা ব্যাকগ্রাউন্ডে গা darkা টেক্সট
- dark - গা darkা ব্যাকগ্রাউন্ডে হালকা টেক্সট
- auto - স্বয়ংক্রিয়ভাবে ব্যবহারকারীর সিস্টেম পছন্দ অনুসরণ করে
মুদ্রা ডিসপ্লে ফরম্যাট
- iso - USD, EUR, GBP-এর মতো ISO কোড দেখায়
- symbol - $, €, £-এর মতো মুদ্রার প্রতীক দেখায়
সংখ্যা ফরম্যাট
- auto - স্বয়ংক্রিয়ভাবে ভিজিটরের ব্রাউজার সেটিং শনাক্ত করে
- us - US ফরম্যাট: ১,২৩৪.৫৬
- eu - ইউরোপীয় ফরম্যাট: ১.২৩৪,৫৬
- french - ফরাসি ফরম্যাট: ১ ২৩৪,৫৬
- indian - ভারতীয় ফরম্যাট: ১,২৩,৪৫৬.৭৮
ড্রপডাউন মুদ্রা অপশন
- all - সব ১৭০+ সমর্থিত মুদ্রা
- top10 - শীর্ষ ১০ সবচেয়ে জনপ্রিয় মুদ্রা
- top20 - ট্রেডিং ভলিউম অনুযায়ী শীর্ষ ২০ মুদ্রা
- USD,EUR,GBP,... - নির্দিষ্ট মুদ্রার কাস্টম তালিকা
টিপ: উইজেট বিল্ডার ব্যবহার করে এসব অপশন ভিজ্যুয়ালি কনফিগার করুন এবং এম্বেড কোড স্বয়ংক্রিয়ভাবে তৈরি করুন।
6 সমস্যা সমাধান
উইজেট দেখাচ্ছে না
আপনার HTML-এ এম্বেড কোডটি সঠিকভাবে বসানো হয়েছে কিনা নিশ্চিত করুন। স্ক্রিপ্ট এম্বেডের জন্য, কন্টেইনার ডিভ সঠিক ID-সহ আছে কিনা দেখুন। কোনো জাভাস্ক্রিপ্ট এরর আছে কিনা ব্রাউজার কনসোলে দেখুন।
ড্রপডাউন কাজ করছে না
আইফ্রেম এম্বেড ব্যবহার করলে ড্রপডাউন উইজেট এলাকায় স্ক্রল করবে। সম্পূর্ণ ড্রপডাউন ফিচার ও ওভারলে চাইলে স্ক্রিপ্ট এম্বেড ব্যবহার করুন।
স্টাইল কনফ্লিক্ট
আপনার ওয়েবসাইটের CSS উইজেটের চেহারায় প্রভাব ফেললে, আইফ্রেম এম্বেড ব্যবহার করুন যা উইজেটের স্টাইল আলাদা রাখে।
কনটেন্ট সিকিউরিটি পলিসি সমস্যা
আপনার কড়া CSP থাকলে, currency.wiki-কে script-src ও frame-src-এ অনুমোদিত তালিকায় যোগ করতে হতে পারে। উদাহরণ: script-src 'self' currency.wiki; frame-src 'self' currency.wiki;
সাহায্য দরকার?
আপনি যা খুঁজছেন তা পাচ্ছেন না? আমাদের সাপোর্ট টিম সাহায্য করতে প্রস্তুত।
