Widget Embed কোড
নিচের কোড অন্য কোনো ওয়েবসাইটে paste করলে, সেই সাইটে সোনার দামের টেবিল বা চার্ট স্বয়ংক্রিয়ভাবে দেখাবে — সবসময় লাইভ ডেটা সহ।
সোনার বর্তমান দাম একটি ছোট টেবিলে দেখাবে।
<!-- GoldBD প্রাইস টেবিল উইজেট -->
<div id="priceTable"></div>
<script src="https://goldbd.io/widget/price.js" data-target="priceTable" data-theme="light"></script>সোনার দামের ইতিহাস একটি লাইন চার্টে দেখাবে।
<!-- GoldBD হিস্টরি চার্ট উইজেট -->
<div id="goldChart"></div>
<script src="https://goldbd.io/widget/chart.js" data-target="goldChart" data-range="all" data-height="280"></script>কাস্টম আইডি ব্যবহার করতে চাইলে
(যদি কারো সাইটে priceTable আইডি আগে থেকেই ব্যবহার হয়)
<div id="my-custom-id"></div>
<script src="https://goldbd.io/widget/price.js" data-target="my-custom-id"></script>| অ্যাট্রিবিউট | প্রযোজ্য | বর্ণনা |
|---|---|---|
| data-target | price.js, chart.js | ডিফল্ট আইডির পরিবর্তে কাস্টম div id নির্দিষ্ট করে |
| data-theme | price.js | টেবিলের থিম: light, dark (ডিফল্ট: light) |
| data-range | chart.js | চার্টের সময়সীমা: 1m, 6m, 1y, all (ডিফল্ট: all) |
কেন এই Widget ব্যবহার করবেন?
আপনার ওয়েবসাইটে যদি সোনার দাম দেখানোর প্রয়োজন হয়, তাহলে নিজে API বানিয়ে বা ম্যানুয়ালি দাম আপডেট করার বদলে এই widget কোড ব্যবহার করলে কাজটি অনেক সহজ হয়ে যায়। একবার কোড বসিয়ে দিলে দাম সবসময় স্বয়ংক্রিয়ভাবে আপডেট হবে, কোনো অতিরিক্ত রক্ষণাবেক্ষণের প্রয়োজন নেই।
Widget কীভাবে কাজ করে?
প্রতিটি widget-এ দুটি অংশ থাকে — একটি div ট্যাগ যা widget-টি কোথায় দেখানো হবে তা নির্ধারণ করে, এবং একটি script ট্যাগ যা আমাদের সার্ভার থেকে লাইভ ডেটা টেনে এনে সেই div-এর ভেতরে রেন্ডার করে। স্ক্রিপ্টটি পেজ লোড হওয়ার সময় স্বয়ংক্রিয়ভাবে চালু হয়ে যায়, কোনো অতিরিক্ত কনফিগারেশনের প্রয়োজন নেই।
একাধিক Widget একই পেজে বসানো
একই পেজে একাধিক widget বসাতে চাইলে প্রতিটি widget-এর div আইডি ভিন্ন হতে হবে — অন্যথায় ব্রাউজার বুঝতে পারবে না কোন স্ক্রিপ্ট কোন বক্সে ডেটা দেখাবে। এই কারণেই কাস্টম আইডি অপশন দেওয়া হয়েছে, যা দিয়ে ডিফল্ট আইডির পরিবর্তে নিজের পছন্দের নাম ব্যবহার করা যায়।
Widget কাস্টমাইজেশন
প্রাইস টেবিল widget-এ data-theme অ্যাট্রিবিউট দিয়ে লাইট বা ডার্ক থিম নির্ধারণ করা যায়। হিস্টরি চার্ট widget-এ data-range অ্যাট্রিবিউট দিয়ে কোন সময়সীমার ডেটা দেখানো হবে তা নির্ধারণ করা যায় — গত ১ মাস, ৬ মাস, ১ বছর বা সম্পূর্ণ ইতিহাস। এই অ্যাট্রিবিউটগুলো না দিলে ডিফল্ট ভ্যালু প্রদর্শিত হবে।
সচরাচর জিজ্ঞাসা (FAQ)
Widget ব্যবহার করতে কোনো খরচ আছে কি?
না, এই widget সম্পূর্ণ ফ্রি — যে কেউ যেকোনো ওয়েবসাইটে কোনো খরচ ছাড়াই ব্যবহার করতে পারবেন।
Widget-এর দাম কি সবসময় লাইভ থাকবে?
হ্যাঁ, স্ক্রিপ্টটি সরাসরি আমাদের সার্ভার থেকে সর্বশেষ দাম টেনে আনে, তাই আলাদাভাবে কোনো ম্যানুয়াল আপডেটের প্রয়োজন নেই।
WordPress বা অন্য CMS-এ এটি কীভাবে বসাবো?
WordPress-এ একটি Custom HTML ব্লক বা উইজেট এরিয়াতে কোডটুকু পেস্ট করলেই চলবে। অন্য কোনো CMS-এ HTML সাপোর্টেড এমন কোনো সেকশনে কোডটি পেস্ট করলেই কাজ করবে।
Widget-এর স্টাইল বা রঙ পরিবর্তন করা যাবে কি?
প্রাইস টেবিল widget-এ থিম (লাইট/ডার্ক) পরিবর্তনের অপশন আছে। এর বাইরে আরও কাস্টম স্টাইলিং প্রয়োজন হলে আমাদের সাথে যোগাযোগ করতে পারেন।
এই গাইডটি কতটা সহায়ক?