ایزی ریت
ورود / ثبت‌نامورود

قرار دادن قیمت ارز در سایت با کد HTML؛ آموزش برای هر سایت‌ساز و قالب

قرار دادن قیمت ارز در سایت با یک خط کد HTML: ساخت ویجت در پنل، جای‌گذاری در وردپرس، سایت‌سازها و فروشگاه‌سازها، ویژگی‌های زبان و واحد و رفع مشکلات رایج.

عرفان فضلی
· کارشناس توسعه و برنامه نویسی
انتشار ۳۰ مهر ۱۴۰۵، ۱۶:۰۰ · ۲ دقیقه مطالعه
قرار دادن قیمت ارز در سایت با کد HTML
خلاصه در سه خط
  • ویجت را در پنل کاربری بسازید و کد آن را (یک div و یک تگ script) در هر جای سایت که می‌خواهید بچسبانید.
  • ویجت بدون iframe داخل صفحهٔ شما رندر می‌شود، هر ۶۰ ثانیه تازه می‌شود و کلید API نمی‌خواهد.
  • با ویژگی‌های data-lang و data-currency همان ویجت را به زبان یا واحد پول دیگر نشان دهید.

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

★
پاسخ کوتاه
در پنل کاربری بخش ویجت را باز کنید، دارایی‌ها و نوع نمایش را انتخاب کنید و کد را کپی کنید. کد شامل یک <div class="ezrate-widget" data-ezrate="…"> در جای نمایش و یک <script src=".../widget.js" async> است. هر دو را در صفحه بچسبانید.

این آموزش بخشی از راهنمای ابزارهای نمایش قیمت ارز و طلا است. اگر سایت وردپرسی دارید، نمایش قیمت ارز در وردپرس با افزونه ساده‌تر است.

گام ۱: ساخت ویجت

  1. در EZRate ثبت‌نام و وارد پنل کاربری شوید.
  2. بخش ویجت را از منو سمت راست باز کنید و ویجت جدید بسازید.
  3. دارایی‌ها را انتخاب کنید؛ مثلاً دلار، یورو، طلای ۱۸، سکه امامی و تتر.
  4. نوع نمایش را انتخاب کنید: نوار ثابت، زیرنویس متحرک، کارت‌ها یا نمودار.
  5. زبان، واحد پول و تم روشن یا تیره را تنظیم کنید و پیش‌نمایش را ببینید.
  6. روی دکمه ساخت ویجت و دریافت کد بزنید و کد را کپی کنید.
سازندهٔ ویجت در پنل کاربری با پیش‌نمایش و کد
ساخت ویجت و دریافت کد

شکل کد

html
<!-- جای نمایش ویجت -->
<div class="ezrate-widget" data-ezrate="WIDGET_ID"><a href="https://ezrate.me/fa">قیمت ارز — EZRate</a></div>

<!-- یک‌بار در هر صفحه، ترجیحاً قبل از </body> -->
<script src="https://ezrate.me/widget.js" async></script>

لینک داخل div تا لحظهٔ بارگذاری ویجت دیده می‌شود و بعد جای خود را به قیمت‌ها می‌دهد. اگر چند ویجت در یک صفحه دارید، تگ script را فقط یک‌بار بگذارید.

گام ۲: جای‌گذاری در پلتفرم‌های مختلف

صفحهٔ HTML ساده

div را در جایی از بدنه که می‌خواهید قیمت دیده شود و script را قبل از </body> بگذارید.

وردپرس بدون افزونه

در ویرایشگر گوتنبرگ یک بلوک «HTML سفارشی» اضافه کنید و هر دو بخش کد را در آن بچسبانید. برای نمایش در همهٔ صفحه‌ها، از «نمایش › ابزارک‌ها» یک ابزارک HTML در ستون کناری یا فوتر بسازید.

سایت‌سازها و فروشگاه‌سازها

بیشتر سایت‌سازهای ایرانی و خارجی بخشی برای «کد سفارشی»، «HTML» یا «اسکریپت سفارشی» دارند. نام این بخش در پلتفرم‌ها متفاوت است، اما اصل یکی است: div را در بلوک HTML صفحه و script را در بخش «کد پایان صفحه» یا همان بلوک بگذارید. اگر پلتفرم شما فقط اجازهٔ کد در هدر می‌دهد، چون script با async بارگذاری می‌شود، در هدر هم کار می‌کند.

فریم‌ورک‌های جاوااسکریپتی (React، Vue)

script را یک‌بار در قالب اصلی (index.html) بگذارید. در صفحه‌هایی که بعد از بارگذاری اولیه ساخته می‌شوند، بعد از قرار گرفتن div در DOM، window.EZRateWidgets?.scan() را صدا بزنید تا ویجت‌های جدید پیدا و پر شوند.

ویژگی‌های اختیاری روی div

ویژگیمقادیرکاربرد
data-langfa en ar ru trهمان ویجت به زبان دیگر، مثلاً در نسخهٔ انگلیسی سایت
data-currencyirt usd eur try aed rubنمایش قیمت‌ها به واحد پول دیگر
html
<!-- همان ویجت در صفحهٔ انگلیسی سایت، با قیمت به دلار -->
<div class="ezrate-widget" data-ezrate="WIDGET_ID" data-lang="en" data-currency="usd"></div>

این یعنی برای نسخه‌های چندزبانهٔ سایت لازم نیست چند ویجت جدا بسازید.

کجای صفحه بهتر است؟

  • نوار ثابت بالای صفحه: برای سایت‌های خبری و فروشگاه‌هایی که می‌خواهند قیمت دلار در همهٔ صفحه‌ها دیده شود.
  • کارت‌ها در ستون کناری: برای وبلاگ‌ها و سایت‌های شرکتی.
  • نمودار داخل مقاله: برای تحلیل‌ها؛ نمودار کنار متن، ماندگاری خواننده را بیشتر می‌کند.
  • زیرنویس متحرک بالای فوتر: وقتی نمی‌خواهید بالای صفحه شلوغ شود.

رفع مشکلات رایج

مشکلعلت محتملراه حل
فقط لینک «قیمت ارز» دیده می‌شودscript بارگذاری نشدهوجود تگ script و آدرس آن را بررسی کنید
ویجت در صفحه‌های بعدی سایت تک‌صفحه‌ای ظاهر نمی‌شودdiv بعد از اسکن اولیه ساخته شدهEZRateWidgets.scan() را صدا بزنید
استایل ویجت به‌هم ریختهCSS قالب روی همه‌چیز اعمال می‌شودویجت استایل‌های خود را ایزوله می‌کند؛ اگر مشکل ماند، تم را عوض کنید یا به پشتیبانی خبر دهید
افزونهٔ بهینه‌سازی، اسکریپت را حذف یا ترکیب کردهترکیب یا تأخیر JSآدرس widget.js را از ترکیب و تأخیر مستثنا کنید
ویجت کارت قیمت در ستون کناری یک وبلاگ
نمونهٔ ویجت کارت‌ها در ستون کناری

برای تنظیمات ظاهری بیشتر، شخصی‌سازی ویجت قیمت ارز و برای سرعت، ویجت سبک قیمت ارز را بخوانید.

نرخ‌های لحظه‌ای مرتبط با این مطلب: قیمت دلار، قیمت طلای ۱۸ عیار، قیمت سکه امامی.

قرار دادن قیمت ارز در سایت هزینه دارد؟
نه. ویجت رایگان است و کلید API نمی‌خواهد.
ویجت هر چند وقت به‌روز می‌شود؟
هر ۶۰ ثانیه، بدون نیاز به رفرش صفحه.
آیا ویجت سایت را کند می‌کند؟
نه. اسکریپت با async و بدون iframe بارگذاری می‌شود و جلوی نمایش بقیهٔ صفحه را نمی‌گیرد.
می‌توانم چند ویجت در یک صفحه بگذارم؟
بله. چند div با شناسه‌های مختلف بگذارید و script را فقط یک‌بار.
عرفان فضلی
من در حوزه توسعه نرم‌افزار و برنامه‌نویسی فعالیت می‌کنم و به طراحی و پیاده‌سازی راهکارهای کاربردی و بهینه علاقه‌مندم. تمرکز من بر توسعه قابلیت‌های جدید، بهبود عملکرد سیستم‌ها و حل چالش‌های فنی با استفاده از فناوری‌های روز است. در مسیر کاری خود تلاش می‌کنم با یادگیری مستمر و به‌کارگیری روش‌های نوین برنامه‌نویسی، محصولات نرم‌افزاری کارآمد، پایدار و قابل‌اعتماد توسعه دهم.
همهٔ مطالب نویسنده ←

نظرات (۰)

نظرها پس از تأیید نمایش داده می‌شوند؛ برای ارسال، ورود به حساب لازم است.

مطالب مرتبط

ابزار صرافی و طلافروشی
نمایش قیمت طلا روی تلویزیون طلافروشی؛ آموزش قدم‌به‌قدم و بدون خرید نرم‌افزار
ابزار صرافی و طلافروشی
ابزار نمایش قیمت ارز و طلا برای سایت، تلگرام، مغازه و فروشگاه؛ راهنمای جامع
طلا و سکه
فرمول محاسبهٔ قیمت طلا با اجرت، سود فروشنده و مالیات؛ فاکتور طلافروشی را خط به خط بخوانید