افزونه هم‌نرخ؛ قیمت‌گذاری ارز و طلا در ووکامرس

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

پنل فارسی و راست‌چین، نمایش نرخ بازار، هشت ابزارک المنتور، ویرایش گروهی، محافظت از قیمت و API اختصاصی در یک افزونه مستقل فراهم شده‌اند. نسخه این بسته ۱٫۱٫۰ و قیمت خرید آن ۷۰۰٬۰۰۰ تومان است. فایل نصب و راهنمای فارسی داخل بسته قرار دارند.

افزونه قیمت‌گذاری ارز و طلا برای چه فروشگاه‌هایی مناسب است؟

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

• محصول دلاری: مقدار پایه ۱۹٫۹۹ دلار، سود ۱۰ درصد، کارمزد ۵٬۰۰۰ تومان و گرد کردن با گام هزار تومان.
• طلای وزنی: وزن ۲٫۵ گرم × نرخ طلای ۱۸ عیار + اجرت قابل تنظیم.
• محصول متغیر: یک مدل با ۱۵ دلار و مدل دیگر با ۱۲ یورو؛ تنظیم هر تنوع مستقل است.

این مثال‌ها روش محاسبه را نشان می‌دهند. اجرت، سود، مالیات و شیوه فروش را مدیر فروشگاه تعیین می‌کند؛ افزونه قاعده مالیاتی یا قیمت معاملاتی تضمین‌شده ارائه نمی‌کند.

پنل مدیریت فارسی؛ یازده بخش برای کنترل قیمت

منوی هم‌نرخ شامل پیشخوان، دارایی‌ها، منابع، سرویس‌های اشتراکی، فرمول‌ها، ویرایش گروهی، تنظیمات، اتصال API، انتقال تنظیمات، گزارش و راهنما است. پیشخوان وضعیت دریافت نرخ‌ها، دارایی‌های فعال، فرمول‌ها و زمان‌بندی را نشان می‌دهد. فونت استعداد به‌صورت محلی بارگذاری می‌شود و رابط راست‌چین برای استفاده فارسی آماده است.

کاتالوگ ۱۱۶ دارایی و تنظیم مستقل هر دارایی

کاتالوگ آماده شامل ارزهای رایج، گروه‌های سنا و نیما، طلای ۱۸ و ۲۴ عیار، انواع آبشده و مثقال، سکه امامی و بهار آزادی، نیم‌سکه، ربع‌سکه و سکه گرمی، نقره و گروه‌های فلزات جهانی و انرژی است. واحدهایی مانند گرم، مثقال، اونس و بشکه کنار دارایی تعریف می‌شوند.

برای هر دارایی می‌توانید وضعیت فعال، نام و کد، گروه، واحد، منبع، نماد یا مسیر پاسخ، ضریب تبدیل، نرخ دستی و پارامترهای سود و هزینه را تنظیم کنید. نرخ‌های دستی و آزمایشی نیز برای کنترل و بررسی در دسترس‌اند. وجود دارایی در کاتالوگ به معنی دریافت خودکار آن از همه منابع نیست. نمادهای فعال باید در منبع انتخابی نرخ معتبر داشته باشند؛ در نصب آزمایش، ۱۲ دارایی پیش‌فرض با نرخ واقعی بارگذاری شده‌اند.

دریافت نرخ ارز، طلا و سکه از منابع ایرانی

هشت آداپتر عمومی برای TGJU، ایران‌جیب، الان چند، زروان، اتحادیه طلا و جواهر تهران، صرافی یاران، طلا و عیار پیاده‌سازی شده‌اند. نرخ هر دارایی از منبع تنظیم‌شده آن دریافت می‌شود. پروفایل‌های نوسان، TGN و زربها نیز در مجموع ۱۱ پروفایل منبع در دسترس‌اند؛ منابع قراردادی به کلید و اطلاعات همان سرویس نیاز دارند.

• دریافت در سرور و استفاده از نرخ ذخیره‌شده؛ دریافت شبکه برای تک‌تک محصولات انجام نمی‌شود.
• تنظیم نشانی HTTPS عمومی، نماد، مسیر JSON و ضریب تبدیل برای منابع قابل پیکربندی.
• ذخیره نرخ خام به ریال و نمایش یا محاسبه در تومان یا ریال؛ هماهنگی واحد با ووکامرس الزامی است.
• تبدیل نرخ صد واحد ین یا دینار به یک واحد در نگاشت‌های آماده و تبدیل قیمت جهانی دلاری با دلار معتبر.
• ثبت جداگانه زمان دریافت و زمان اعلام‌شده منبع؛ برای منابع فاقد تاریخ مستقل، فقط زمان دریافت کنترل می‌شود.

ساختار و دسترسی منابع عمومی ممکن است تغییر کند. مدیر فروشگاه می‌تواند منبع و ضریب را کنترل یا اصلاح کند. نرخ صفر، داده ناسازگار یا نرخ خارج از محدوده اعتبار، جای قیمت قبلی محصول ذخیره نمی‌شود.

اتصال اختیاری نوسان و TGN با کلید API

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

نوسان؛ نگاشت آماده و کنترل سهمیه

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

TGN؛ تنظیمات مطابق قرارداد تأمین‌کننده

تابان گوهر نفیس ـ TGN سرویس اشتراکی و دموی یک‌هفته‌ای معرفی کرده است. نشانی دقیق API، واحد قیمت، جدول نمادها و مسیر پاسخ را از تأمین‌کننده بگیرید. احراز هویت با هدر اختصاصی، Bearer یا کلید در نشانی و مسیرهای JSON قابل تنظیم هستند. برای دمو، تاریخ پایان اعتبار تعیین می‌شود.

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

قیمت‌گذاری محصولات ساده، حراج و تنوع‌ها

در ویرایشگر محصول ووکامرس، هم‌نرخ را فعال کنید، دارایی را انتخاب و مبلغ پایه را وارد کنید. سود درصدی، سود ثابت، کارمزد، مبلغ اضافه، روش گرد کردن، حداقل قیمت و حاشیه نوسان قابل تنظیم‌اند. مبلغ عادی و مبلغ حراج می‌توانند مبنای ارزی داشته باشند؛ برنامه زمانی حراج ووکامرس حفظ می‌شود.

هر تنوع محصول تنظیم مستقل دارد و بعد از محاسبه، قیمت والد محصول متغیر همگام می‌شود. پیش‌نمایش محاسبه به شما کمک می‌کند قبل از ذخیره نتیجه را ببینید. قابلیت معادل‌سازی نیز قیمت موجود را به مقدار ارزی متناظر تبدیل می‌کند تا شروع استفاده، مبلغ جاری را بی‌دلیل تغییر ندهد.

amount * rate * (1 + profit_percent / 100)
+ profit_fixed + fee + extra

فرمول اختصاصی در افزونه قیمت‌گذاری ارز و طلا

فرمول‌ها را در کتابخانه ذخیره کنید و در تنظیم محصول به کار ببرید. متغیرهای مقدار، نرخ، وزن، طول، عرض، ارتفاع، سود و هزینه در دسترس‌اند. متغیر دلخواه مانند اجرت یا مالیات و نرخ دارایی دیگر مانند rate_EUR نیز قابل استفاده است.

• عملگرهای جمع، تفریق، ضرب، تقسیم، باقیمانده و توان با پرانتز.
• توابع min، max، round، ceil، floor و abs.
• ماشین‌حساب برای بررسی فرمول و ورودی‌ها پیش از اعمال روی محصولات.
• پردازش عبارت بدون اجرای PHP یا JavaScript؛ خطای فرمول یا تقسیم بر صفر باعث حفظ قیمت قبلی می‌شود.

گرد کردن قیمت و جلوگیری از تغییر نامعتبر

علاوه بر حالت غیرفعال، چهار الگوی گرد کردن صفر، ۹، ترکیب ۹ و صفر و ترکیب ۹۸ و صفر با گام قابل تنظیم وجود دارد. برای قیمت ۳٬۵۸۶٬۲۰۶ و گام هزار، خروجی‌ها به ترتیب ۳٬۵۸۷٬۰۰۰، ۳٬۵۸۶٬۹۹۹، ۳٬۵۸۹٬۰۰۰ و ۳٬۵۹۸٬۰۰۰ هستند.

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

ویرایش گروهی و به‌روزرسانی در پس‌زمینه

محصولات را با شناسه یا دسته انتخاب کنید و تنظیم دارایی، سود، کارمزد، گرد کردن و محافظت قیمت را گروهی اعمال کنید. پردازش در بسته‌های ۲۵تایی و با قفل صف انجام می‌شود. دریافت نرخ زمان‌بندی‌شده، مدت کش و حداکثر عمر نرخ قابل تنظیم‌اند.

در بازدید محصول، محاسبه از نرخ معتبر محلی انجام می‌شود و دریافت لازم در پس‌زمینه زمان‌بندی می‌شود. برای اجرای منظم بدون وابستگی به بازدید، باید زمان‌بند سرور یا WP-Cron درست تنظیم شده باشد. فایل‌های پنل و نمایش در محل استفاده بارگذاری می‌شوند.

هشت نمایش نرخ و هشت ابزارک المنتور

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

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

اتصال فروشندگان دکان و ثبت اطلاعات سفارش

فرم ویرایش محصول در دکان رایگان با کنترل مالکیت و nonce پشتیبانی می‌شود. فروشنده فقط محصول مجاز خود را ویرایش می‌کند؛ تنظیم مستقل تنوع‌ها در ویرایشگر ووکامرس در دسترس است. اطلاعات نرخ و محاسبه هنگام سفارش با روش CRUD ووکامرس ثبت می‌شود و مسیر سفارش کلاسیک، Store API و HPOS در نظر گرفته شده‌اند.

رابط تنوع‌های Dokan Pro و اتصال اختصاصی رمزیار بدون نسخه مجاز آن‌ها آزموده نشده‌اند. بسته هم‌نرخ شامل کد یا مجوز Elementor Pro، Dokan Pro و رمزیار نیست.

API اختصاصی افزونه قیمت‌گذاری ارز و طلا

بخش API کلید مستقلی برای اتصال برنامه شما به فروشگاه دارد. مدیر می‌تواند آن را روشن یا خاموش کند، کلید بسازد، کلید را تعویض یا لغو کند. کلید فقط هنگام ساخت نمایش داده می‌شود و هش SHA-256 آن ذخیره می‌شود. این کلید با کلید منابع نرخ متفاوت است.

GET /wp-json/hamnerkh/v1/rates
GET /wp-json/hamnerkh/v1/rates/USD
POST /wp-json/hamnerkh/v1/calculate
Header: X-Hamnerkh-Key

API نرخ‌ها را می‌خواند و قیمت را محاسبه می‌کند؛ محصول را ویرایش نمی‌کند. محدودیت داخلی ۱۲۰ درخواست در دقیقه برای هر کلید اعمال می‌شود. نمونه بدنه محاسبه در راهنمای فارسی وجود دارد. در حالت خاموش، حتی کلید صحیح هم دسترسی ندارد.

انتقال تنظیمات، گزارش و امکان توسعه

تنظیمات، دارایی‌ها و فرمول‌ها را با JSON صادر و وارد کنید. کلیدهای محرمانه در خروجی پیش‌فرض حذف می‌شوند و ورودی پیش از ذخیره یکپارچه اعتبارسنجی می‌شود. این انتقال برای تنظیمات افزونه است و سفارش‌ها، کاربران و محصولات را جابه‌جا نمی‌کند.

گزارش دریافت و محاسبه، دلیل رد نرخ یا توقف تغییر قیمت را نشان می‌دهد و اطلاعات حساس کلیدها پوشانده می‌شوند. دسترسی مدیریتی و درخواست‌های تغییر دارای کنترل مجوز و nonce هستند. فیلترهای hn_rate_value، hn_product_config و hn_price_result برای توسعه اتصال اختصاصی در دسترس‌اند. غیرفعال کردن افزونه، تنظیمات و قیمت‌های ثبت‌شده را پاک نمی‌کند.

نصب، پیش‌نیازها و محتویات بسته

• حداقل: وردپرس ۶٫۴ و PHP ۸٫۱؛ ووکامرس برای بخش محصول و المنتور برای ابزارک‌های صفحه‌ساز.
• محیط آزموده‌شده: WordPress 7.1.2، PHP 8.3، WooCommerce 11.1.2، Elementor رایگان 4.3.3 و Dokan Lite 5.2.1 با پوسته Twenty Twenty-Five.
• داخل بسته: فایل نصب استاندارد ZIP، کد افزونه، فایل‌های نمایشی و فونت محلی، راهنمای فارسی، مستند منابع، گزارش آزمون و مجوزها.
• شروع استفاده: نصب ZIP از بخش افزونه‌های وردپرس، هماهنگ کردن تومان یا ریال، دریافت نرخ معتبر، تنظیم محصول و بررسی پیش‌نمایش.

هشت منبع عمومی با دریافت واقعی و بخش‌های قیمت‌گذاری، پنل، API، ابزارک‌ها و برگشت از اشتراک با آزمون‌های اجرایی بررسی شده‌اند. اتصال واقعی نوسان، TGN و زربها با کلید خریداری‌شده هنوز آزموده نشده است؛ برای TGN و زربها اطلاعات قرارداد فنی نیز لازم است. سازگاری همه نسخه‌ها و پوسته‌ها از محیط آزمون نتیجه نمی‌شود؛ پیش از استفاده در فروشگاه اصلی، تنظیمات را روی نسخه آزمایشی بررسی کنید.

دو نمونه واقعی قیمت‌گذاری در ووکامرس

در تصاویر زیر، قیمت محصول از نرخ ذخیره‌شده و تنظیمات هم‌نرخ محاسبه شده است. تصویر اول محصول دلاری با سود و کارمزد و تصویر دوم محصول طلا با وزن و اجرت را نشان می‌دهد. این محصولات در سایت آزمایش محلی ساخته شده‌اند.

پرسش‌های رایج درباره خرید هم‌نرخ

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

بله؛ منابع عمومی قابل تنظیم‌اند و اشتراک نوسان یا TGN اختیاری است. با خاموش کردن اشتراک، افزونه از روش قبلی استفاده می‌کند.

آیا قیمت ۷۰۰ هزار تومان شامل کلید نوسان و TGN است؟

خیر؛ این مبلغ برای بسته هم‌نرخ است. حساب، کلید و طرح تأمین‌کننده نرخ را جداگانه از سایت رسمی تهیه می‌کنید.

اگر نرخ منبع قطع یا قدیمی شود چه اتفاقی می‌افتد؟

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

آیا هر تنوع محصول می‌تواند ارز جدا داشته باشد؟

بله؛ تنظیم مستقل تنوع‌ها در ویرایشگر ووکامرس پیاده‌سازی شده است.

آیا برای نمایش نرخ به ووکامرس یا المنتور Pro نیاز دارم؟

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

تصاویر گالری چه چیزی را نشان می‌دهند؟

گالری شامل هشت تصویر واقعی و تمام‌عرض از پنل افزونه و دو تصویر واقعی از محصول دلاری و طلای وزنی در سایت آزمایش محلی است. نرخ‌ها و قیمت‌ها مربوط به زمان ثبت تصویر هستند.

برای بررسی گزینه‌های دیگر نیز می‌توانید افزونه‌های وردپرس کدنما را ببینید.