گذاشتن قیمت لحظهای طلا، دلار و تتر در سایت دیگر کار برنامهنویس نیست. خانه سرمایه یک کد قیمت طلا و دلار برای سایت آماده کرده که با کپی و چسباندن کار میکند: در وردپرس، سایت اختصاصی، فروشگاهساز یا یک صفحهٔ HTML ساده. قیمتها هر ۳۰ ثانیه خودکار بهروز میشوند، استفاده رایگان است و ثبتنام لازم ندارد. در این راهنما ۹ ویجت قیمت و کاربرد هر کدام را میبینید، یاد میگیرید کد را چطور بسازید و کجا بگذارید، ظاهرش را چطور با سایتتان هماهنگ کنید و چه شرطی برای استفادهٔ رایگان هست.

ویجت قیمت خانه سرمایه چیست
ویجت قیمت یک تکه کد کوتاه است که در صفحهٔ سایت شما قیمت روز را نشان میدهد و خودش آن را بهروز نگه میدارد. قیمتها از سرویس دادهٔ بازار خانه سرمایه میآیند؛ همان قیمتهایی که در صفحههای قیمت سایت و اپلیکیشن تتر چند میبینید. بیش از ۱۳۰ دارایی در دسترس است: ارزها مثل دلار، یورو، درهم و لیر، طلا و سکه مثل گرم طلای ۱۸ عیار، سکه امامی، نیم و ربع سکه، و ارزهای دیجیتال مثل تتر، بیتکوین و اتریوم. کد را در ویجتساز خانه سرمایه میسازید و همان لحظه پیشنمایشش را میبینید.

۹ ویجت قیمت و کاربرد هر کدام
هر ویجت برای جای خاصی از سایت مناسبتر است. جدول زیر کمک میکند ویجت درست را انتخاب کنید. روی نام هر ویجت بزنید تا صفحهٔ آن با ویجتساز آماده باز شود.

ساخت کد ویجت قیمت در سه قدم
- ویجت را انتخاب کنید: در ویجتساز نوع ویجت و داراییها را انتخاب کنید. دارایی را با جستجو پیدا میکنید؛ مثلاً «دلار»، «سکه» یا «btc».
- ظاهر را تنظیم کنید: سبک، رنگ، حالت روشن یا تیره و گزینههای نمایش را عوض کنید. پیشنمایش زنده را میتوانید در حالت روشن و تیره و در اندازهٔ دسکتاپ و موبایل ببینید.
- کد را کپی کنید: دکمهٔ «کپی کد» را بزنید و کد را در HTML صفحه بگذارید. جای گذاشتن کد در وردپرس و سایتسازها را پایینتر توضیح دادهایم.

نمونه کد قیمت تتر و تیکر قیمت
کدی که ویجتساز میدهد دو بخش دارد: یک تگ div که جای ویجت و تنظیماتش را مشخص میکند و یک تگ script که ویجت را میسازد. این کد یک کارت قیمت تتر با نمودار ۲۴ ساعته است:
<div class="khs-widget" data-type="card" data-symbol="usdt" data-chart="24h">
<a href="https://khanesarmaye.com/symbol/usdt/" target="_blank">خانه سرمایه</a>
</div>
<script async src="https://khanesarmaye.com/widgets/v1/embed.js" charset="utf-8"></script>
و این یکی تیکر قیمت دلار، یورو، تتر، طلا، سکه، بیتکوین و اتریوم:
<div class="khs-widget" data-type="ticker" data-symbols="usd,eur,usdt,geram18,sekee,btc,eth">
<a href="https://khanesarmaye.com/markets/" target="_blank">خانه سرمایه</a>
</div>
<script async src="https://khanesarmaye.com/widgets/v1/embed.js" charset="utf-8"></script>
اگر چند ویجت در یک صفحه دارید، تگ script را فقط یک بار بگذارید؛ همهٔ ویجتهای صفحه با یک درخواست قیمت میگیرند. تنظیمات هر ویجت در ویژگیهای data- همان div است، پس اگر بعداً خواستید مثلاً تیکر را تیره کنید، کافی است data-theme="dark" را به آن اضافه کنید. پرکاربردترین ویژگیها اینهاست:
گذاشتن کد ویجت در وردپرس و سایتسازها
- ویرایشگر بلوک وردپرس: بلوک «HTML سفارشی» را اضافه کنید و کد را داخلش بچسبانید.
- المنتور: ویجت «HTML» را در صفحه بکشید و کد را در آن بگذارید.
- ستون کناری و فوتر وردپرس: از «نمایش ← ابزارکها» ابزارک «HTML سفارشی» را اضافه کنید.
- سایت اختصاصی یا صفحهٔ HTML: کد را همانجای قالب بگذارید که ویجت باید دیده شود.
- بلاگسازها و سایتهایی که script نمیپذیرند: در ویجتساز تب «iframe» را بزنید و کد iframe را بگذارید.
نسخهٔ iframe بدون script کار میکند و برای بلاگسازهایی مثل بلاگفا مناسب است. ارتفاع iframe ثابت است و اگر ویجت بریده شد، عدد height را بیشتر کنید:
<iframe src="https://khanesarmaye.com/widgets/v1/frame.html?type=card&symbol=usdt&chart=24h" title="ویجت قیمت خانه سرمایه" width="100%" height="360" style="border:0;max-width:100%" loading="lazy"></iframe>
اگر سایت وردپرسی دارید و میخواهید قیمتها داخل HTML خود صفحه چاپ شوند تا برای سئو هم به کار بیایند، افزونه قیمت طلا و ارز وردپرس را ببینید. آن افزونه ویجتساز داخل پیشخوان، ویجت المنتور و شورتکد دارد.
هماهنگ کردن ظاهر ویجت با سایت
هر ویجت چهار سبک کلاسیک، مینیمال، گرادیانت و شیشهای دارد و میتواند روشن، تیره یا خودکار باشد. حالت خودکار از تنظیم روشن یا تیرهٔ دستگاه بازدیدکننده پیروی میکند. رنگ اصلی را از رنگهای آماده انتخاب میکنید یا کد رنگ برندتان را میدهید، و گردی گوشهها را از صفر تا ۲۴ پیکسل تنظیم میکنید.
ارقام را میتوانید فارسی یا انگلیسی نشان دهید و اگر سایتتان انگلیسی است، زبان ویجت را هم انگلیسی کنید. ویجت بهطور پیشفرض فونت سایت شما را میگیرد و اگر قالبتان فونت فارسی ندارد، فونت وزیرمتن را انتخاب کنید. نمایش درصد تغییر، آیکونها، حباب تتر، بهروزرسانی زنده و لینک نام هر دارایی به صفحهاش در خانه سرمایه را هم با یک کلید روشن یا خاموش میکنید. در تیکر سرعت حرکت و در ویجت تتر در صرافیها تعداد صرافیها (۳ تا ۱۶) قابل تنظیم است.
سرعت، امنیت و سئوی سایت
- سبک: یک اسکریپت async و کششده، بدون کتابخانهٔ اضافه. بارگذاری صفحهٔ شما منتظر ویجت نمیماند.
- بدون پرش صفحه: جای ویجت از قبل رزرو میشود تا محتوای صفحه هنگام بارگذاری جابهجا نشود.
- بهروزرسانی هوشمند: قیمتها هر ۳۰ ثانیه تازه میشوند، ولی فقط وقتی ویجت روی صفحه دیده میشود و تب باز است. ویجت تتر در صرافیها هر یک دقیقه بهروز میشود.
- جدا از استایل سایت: هر ویجت در محیطی جداگانه (Shadow DOM) ساخته میشود؛ نه استایل سایت شما آن را به هم میریزد و نه برعکس.
- امن: ویجت کوکی نمیسازد و اطلاعات بازدیدکننده را جمع نمیکند. دادهها فقط بهصورت متن نمایش داده میشوند و هیچ کدی از سرور به صفحهٔ شما تزریق نمیشود.
اگر سایت شما Content-Security-Policy دارد، دامنهٔ khanesarmaye.com را به script-src، connect-src و font-src و دامنهٔ market-pulse.khanes.app را به img-src اضافه کنید. ویجت به inline style نیازی ندارد.
شرط استفادهٔ رایگان از ویجتها
ویجتها رایگاناند و تنها شرط، باقی ماندن لینک «خانه سرمایه» داخل کد است؛ همان تگ a که در نمونهها دیدید. اگر این لینک حذف، مخفی یا به جای دیگری تغییر داده شود، ویجت بهجای قیمت پیامی با لینک منبع نشان میدهد. جزئیات کامل در صفحهٔ شرایط استفاده از ویجتها آمده است.
پرسشهای رایج دربارهٔ کد قیمت برای سایت
برای استفاده از ویجت باید ثبتنام کنم؟
نه. کد را از ویجتساز کپی میکنید و در سایت میگذارید؛ حساب کاربری یا کلید لازم نیست.
چند ویجت میتوانم در یک صفحه بگذارم؟
هر تعداد که لازم دارید. فقط تگ script را یک بار در صفحه بگذارید تا همهٔ ویجتها با هم و با یک درخواست بهروز شوند.
حباب تتر در ویجتها چطور حساب میشود؟
حباب برابر است با قیمت تتر منهای قیمت دلار آزاد، و درصد حباب همین اختلاف تقسیم بر قیمت دلار است. حباب مثبت یعنی تتر گرانتر از دلار آزاد معامله میشود و حباب منفی یعنی ارزانتر. فرق دلار آزاد با نرخهای دیگر را در انواع نرخ دلار در ایران توضیح دادهایم.
برچسب «ویژه» کنار بعضی صرافیها یعنی چه؟
یعنی آن صرافی همکار تبلیغاتی خانه سرمایه است. ترتیب فهرست ویجت تتر در صرافیها فقط بر اساس قیمت خرید است.
قیمتهای ویجت برای خرید و فروش معتبرند؟
قیمتها جنبهٔ اطلاعرسانی دارند و پیشنهاد سرمایهگذاری نیستند. پیش از هر معامله، قیمت نهایی را از فروشنده یا صرافی که با آن معامله میکنید بپرسید.
اولین ویجت را همین حالا بسازید
اگر نمیدانید از کدام ویجت شروع کنید، برای ستون کناری کارت قیمت تتر یا دلار، برای هدر تیکر قیمت و برای صفحهٔ قیمت سایت جدول طلا و سکه را امتحان کنید. به ویجتساز خانه سرمایه بروید، ظاهر را با سایتتان هماهنگ کنید و کد را بچسبانید. برای دیدن همهٔ قیمتها هم به قیمت طلا و سکه، قیمت ارز و قیمت ارزهای دیجیتال سر بزنید.
سؤال یا مشکل در نصب ویجتاگر کد ویجت در سایتتان درست نمایش داده نشد، به info@khanesarmaye.com ایمیل بزنید یا با شمارهٔ ۰۲۱-۹۱۰۰۷۵۹۰ تماس بگیرید.












نظر شما درباره این مقاله چیست؟
شما چه امتیازی میدهید؟