Nerkh Live

Description

Nerkh Live is a professional WordPress plugin that allows you to display real-time Gold, Currency, Coin, and Cryptocurrency prices on your website.

The plugin receives live financial data from an API web service and automatically displays the rates on your website using a customizable sticky bar.

Users can easily connect the plugin to the API by entering their API Token/Key from the main website.

The plugin is completely free and compatible with both WordPress and WooCommerce.

External Services

This plugin relies on the following third-party/external service to function:

Nerkh.IO API (api.nerkh.io)

• What the service is: Nerkh.IO provides real-time financial market data (gold, currency, coin, and cryptocurrency prices) via a REST API.
• What it is used for: Fetching live price data that is displayed on your website via a shortcode widget and/or a sticky price bar.
• What data is sent and when:
  – Your API key (for authentication) is sent with every request to api.nerkh.io.
  – A request is made when an admin manually triggers a “Test” or “Connect” action in the plugin settings.
  – Automatic requests are made on a recurring schedule (every 10, 30, or 60 minutes) via WordPress cron jobs to keep prices up to date.
  – No personal user or visitor data is transmitted.
• API endpoint used: https://api.nerkh.io/v1/prices/json/all
• Service provider: Nerkh.IO
• Website: https://nerkh.io
• Terms of Service: https://nerkh.io/terms
• Privacy Policy: https://nerkh.io/privacy

Nerkh.IO Website (nerkh.io)

• What the service is: The main website of the Nerkh.IO service.
• What it is used for: A link to “نرخ ❤” (brand attribution) is displayed in the frontend sticky price bar, linking back to https://nerkh.io. This is required by the API terms of use.
• What data is sent: No data is sent from the plugin to nerkh.io. The link is only rendered in the browser for end-users to click.
• Service provider: Nerkh.IO
• Website: https://nerkh.io
• Terms of Service: https://nerkh.io/terms
• Privacy Policy: https://nerkh.io/privacy

Main Features

• Real-time Gold prices
• Real-time Currency exchange rates
• Real-time Coin prices
• Real-time Cryptocurrency prices
• Automatic API price updates

• Update interval settings:

  • Every 10 minutes
  • Every 30 minutes
  • Every 60 minutes
• Sticky bar display
• Display at top or bottom of website
• Full style customization
• Background color customization
• Dark mode and light mode support
• Custom colors for each financial item
• Price color customization
• Separator color customization
• Financial symbol color customization
• Font size customization
• Select which items to display
• Support for more than 23 financial items
• API connection testing
• API response testing
• Easy installation and setup
• WooCommerce compatible
• Lightweight and optimized

Supported Financial Items

The plugin supports various financial categories including:

• Gold
• Coins
• Dollar
• Euro
• Foreign currencies
• Bitcoin
• Tether
• Cryptocurrencies
• Digital currencies

توضیحات

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

ویژگی‌های اصلی

• نمایش قیمت لحظه‌ای طلا
• نمایش قیمت لحظه‌ای ارز
• نمایش قیمت لحظه‌ای سکه
• نمایش قیمت لحظه‌ای رمزارزها
• دریافت خودکار قیمت از API
• تنظیم فاصله زمانی بروزرسانی:
  • هر ۱۰ دقیقه
  • هر ۳۰ دقیقه
  • هر ۶۰ دقیقه
• نوار چسبان قیمت
• نمایش در بالای یا پایین سایت
• سفارشی‌سازی کامل استایل
• تنظیم رنگ پس‌زمینه
• پشتیبانی از حالت تیره و روشن
• رنگ‌بندی دلخواه برای هر آیتم
• تنظیم رنگ قیمت
• تنظیم رنگ جداکننده
• تنظیم رنگ نماد واحد
• تنظیم اندازه فونت
• انتخاب آیتم‌های نمایش
• پشتیبانی از بیش از ۲۳ آیتم مالی
• تست اتصال API
• تست دریافت پاسخ API
• نصب و راه‌اندازی آسان
• سازگار با ووکامرس
• سبک و بهینه

آیتم‌های پشتیبانی شده

پلاگین دسته‌بندی‌های مختلف مالی را پشتیبانی می‌کند:

• طلا
• سکه
• دلار
• یورو
• ارزهای خارجی
• بیت‌کوین
• تتر
• رمزارزها
• ارزهای دیجیتال

نصب

۱. فایل‌های پلاگین را در پوشه /wp-content/plugins/ آپلود کنید.
۲. پلاگین را از منوی ‘افزونه‌ها’ در وردپرس فعال کنید.
۳. صفحه تنظیمات نرخ زنده را باز کنید.
۴. کلید وب‌سرویس خود را وارد کنید.
۵. تنظیمات را ذخیره کنید.
۶. استایل نمایش و فاصله بروزرسانی را تنظیم کنید.
۷. تمام! قیمت‌های زنده اکنون در سایت شما نمایش داده می‌شود.

پرسش‌های متداول

آیا پلاگین رایگان است؟

بله. نرخ زنده کاملاً برای کاربران وردپرس و ووکامرس رایگان است.

چگونه پلاگین را به API متصل کنم؟

کلید وب‌سرویس خود را از سایت اصلی دریافت کرده و در صفحه تنظیمات پلاگین وارد کنید.

آیا می‌توانم طراحی را سفارشی کنم؟

بله. می‌توانید رنگ‌ها، فونت‌ها، موقعیت نوار چسبان و استایل نمایش را کاملاً سفارشی‌سازی کنید.

آیا می‌توانم آیتم‌های نمایش را انتخاب کنم؟

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

آیا پلاگین از بروزرسانی خودکار پشتیبانی می‌کند؟

بله. پلاگین می‌تواند قیمت‌ها را هر ۱۰، ۳۰ یا ۶۰ دقیقه یک‌بار به‌صورت خودکار بروزرسانی کند.

اسکرین‌شات

۱. نوار چسبان قیمت زنده
۲. پنل تنظیمات پلاگین
۳. بخش تست اتصال API
۴. انتخاب آیتم‌های مالی
۵. تنظیمات سفارشی‌سازی نمایش

تغییرات

2.1.5

• فارسی‌سازی کامل صفحه تنظیمات پلاگین در وردپرس

2.1.4

• رفع مشکل فریز شدن قیمت‌های نوار چسبان توسط افزونه‌های کش (LS Cache, WP Rocket و…)
• نوار چسبان اکنون قیمت‌ها را از طریق Ajax دریافت می‌کند تا از کش صفحه عبور کند
• قیمت‌های نوار چسبان بر اساس فاصله زمانی کرون به‌صورت خودکار بروزرسانی می‌شوند
• عنصر نوار به document.body اضافه می‌شود به جای document.documentElement

2.1.1

• Updated external service documentation — full disclosure of third-party API communication, terms of service, and privacy policy links in readme
• Replaced inline script echo with proper wp_enqueue_script() and wp_localize_script() for debug page JavaScript

2.1.0

• Security hardening — all output properly escaped
• Fixed database query warnings
• Improved PHPCS compliance
• Code quality improvements

1.0.6

• Fixed plugin structure
• Added automatic update intervals
• Added API connection testing
• Added customizable sticky bar
• Improved WooCommerce compatibility
• Performance improvements
• UI and settings improvements