ویجت یک تابلوی نرخ کوچک و زیباست که با یک تگ script در سایت شما می‌نشیند، خودش تازه می‌شود و به لطف قفل دامنه فقط روی دامنهٔ ثبت‌شدهٔ اپ نمایش داده می‌شود. برای وبلاگ، فروشگاه، سایت خبری یا پنل داخلی.

نصب

HTML

<script src="https://netarz.ir/fx/widget.js"
        data-key="fx-ntz-v1-..."
        data-codes="USD,EUR,AED,TRY,GBP"
        data-theme="light"
        async></script>

اسکریپت یک iframe درست بعد از خودش می‌سازد و ارتفاعش را خودکار با محتوا تنظیم می‌کند.

خط منبع زیر تابلو

زیر تابلو یک خط کوچک «نرخ ارز از نِت اَرز» در صفحهٔ خود شما نوشته می‌شود تا خواننده بداند عددها از کجا آمده‌اند. لینکش به تابلوی نرخ ارز می‌رود. این خط اختیاری است:

اگر نمی‌خواهیدش، data-credit="0" را به تگ اسکریپت اضافه کنید.
اگر می‌خواهید خودتان بنویسیدش، مثلاً تا بدون جاوااسکریپت هم دیده شود یا با قلم سایت‌تان هماهنگ باشد، همین تکه را بعد از اسکریپت بگذارید. اسکریپت خط شما را می‌بیند و خط دوم نمی‌سازد.

HTML

<script src="https://netarz.ir/fx/widget.js" data-key="fx-ntz-v1-..." async></script>
<p class="netarz-fx-credit">نرخ ارز از <a href="https://netarz.ir/rates">نِت اَرز</a></p>

متن و لینک را هر طور که با سایت‌تان جور است تغییر بدهید. شرط طرح رایگان فقط لینک داخل خود ویجت است و به این خط ربطی ندارد.

گزینه‌ها

ویژگی	مقدار	پیش‌فرض
`data-key`	کلید اپ (الزامی)	—
`data-codes`	کدها با کاما، حداکثر ۱۲	ارزهای پیش‌فرض اپ در پنل
`data-theme`	`light` / `dark` / `gold`	`light`
`data-compact`	`1` برای ردیف‌های فشرده	خیر
`data-change`	`0` برای مخفی‌کردن ستون تغییر	نمایش
`data-title`	عنوان تابلو (تا ۴۰ حرف)	«نرخ ارز»
`data-width`	حداکثر عرض CSS	`420px`
`data-credit`	`0` برای حذف خط منبع زیر تابلو	نمایش

تازه‌شدن و برندینگ

طرح رایگان: نرخ با تأخیر طرح، تازه‌شدن هر ۵ دقیقه، و خط «نرخ از نِت اَرز» با لینک.
طرح پرو: نرخ زنده، تازه‌شدن هر ۶۰ ثانیه، و می‌توانید برندینگ را در پنل خاموش کنید.
هر بار بارگذاری ویجت یک درخواست و هر تازه‌سازی یک درخواست از سهمیهٔ روزانه است (widget و widget.data در آمار).

امنیت

کلید در HTML شما دیده می‌شود ولی به دامنه‌تان قفل است: ویجت Referer صفحهٔ میزبان را با دامنه‌های اپ می‌سنجد و برای تازه‌سازی از یک توکن کوتاه‌مدت امضاشده استفاده می‌کند، نه از کلید. اگر صفحهٔ شما با Referrer-Policy: no-referrer سرو می‌شود، ویجت نمی‌تواند دامنه را تشخیص دهد؛ روی تگ اسکریپت خودمان strict-origin-when-cross-origin تنظیم شده که کافی است.

وردپرس

ساده‌ترین راه در وردپرس افزونهٔ نرخ ارز نِت اَرز است: نصبش کنید، کلید را در تنظیمات افزونه بگذارید و کد کوتاه (شورت‌کد) [netarz_rate] را در هر نوشته یا برگه بنویسید. اگر افزونه نمی‌خواهید، همین shortcode را در functions.php قالب بگذارید:

shortcode

// functions.php — یا از افزونهٔ «Insert Headers and Footers» / ویجت HTML سفارشی
add_shortcode('netarz_fx', function ($atts) {
    $a = shortcode_atts(['codes' => 'USD,EUR,AED', 'theme' => 'light'], $atts);
    return '<script src="https://netarz.ir/fx/widget.js" data-key="fx-ntz-v1-..." data-codes="'
        . esc_attr($a['codes']) . '" data-theme="' . esc_attr($a['theme']) . '" async></script>';
});
// در نوشته: [netarz_fx codes="USD,EUR" theme="dark"]

بدون جاوااسکریپت

iframe

<!-- بدون جاوااسکریپت: iframe مستقیم (ارتفاع را خودتان تنظیم کنید) -->
<iframe src="https://netarz.ir/fx/embed?key=fx-ntz-v1-...&codes=USD,EUR&theme=gold"
        style="width:100%;max-width:420px;height:320px;border:0;border-radius:16px"
        loading="lazy" referrerpolicy="strict-origin-when-cross-origin" title="نرخ ارز"></iframe>
<p class="netarz-fx-credit">نرخ ارز از <a href="https://netarz.ir/rates">نِت اَرز</a></p>

ویجت نرخ ارز