تومنیفای (Tomanify) – مدیر هوشمند قیمت‌گذاری تومان و ریال

توضیحات

تومنی‌فای به فروشگاه‌های ووکامرسی کمک می‌کند که محصولات خود را با ارزهای خارجی (دلار / یورو / درهم / لیر / یوان) خریداری یا ثبت می‌کنند و نیاز دارند قیمت نهایی فروش را به تومان یا ریال ایران ذخیره کنند.

این افزونه طوری طراحی شده که برای فروشگاه‌های واقعی امن، قابل‌پیش‌بینی و کاربردی باشد:

• هیچ URL خارجی‌ای به‌صورت پیش‌فرض داخل افزونه پر نشده است.
• درخواست‌های خارجی فقط زمانی انجام می‌شوند که مدیر سایت آدرس‌ها را به‌صورت صریح وارد کرده باشد.
• قیمت‌های تبدیل‌شده بر پایه یک پایه تومانی ذخیره می‌شوند تا هنگام جابه‌جایی بین تومان و ریال تبدیل دوباره و اشتباه رخ ندهد.
• برای استفاده از روند اصلی افزونه لازم نیست API پولی بخرید. بسیاری از فروشگاه‌ها می‌توانند با یک فید JSON سازگارِ بازار آزاد شروع کنند و بعداً RSS/XML رسمی، نرخ‌های دستی یا تخمین آفلاین را به‌عنوان لایه‌های پشتیبان اضافه کنند.

از اینجا شروع کنید

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

ویدیوی ۲ دقیقه‌ای نصب و راه‌اندازی سریع

چه چیزی افزونه تومنیفای را متفاوت می‌کند؟

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

تومنیفای دقیقاً برای همین سناریو طراحی شده است:

• برای هر محصول خارجی، یک قیمت پایه نهایی به تومان ذخیره می‌کند.
• این افزونه آن قیمت پایه را در متای محصول ذخیره می‌کند و از آن برای بازنویسی قیمت‌های ووکامرس استفاده می‌کند.
• به شما اجازه می‌دهد بدون دریافت دوباره نرخ‌ها، بین تومان و ریال جابه‌جا شوید.
• به‌جای اجبار به یک سرویس خارجی، از چندین روش تأمین نرخ پشتیبانی می‌کند.

ویژگی‌های کلیدی

• قیمت‌گذاری ارزی برای هر محصول: علامت گذاری محصول بعنوان وارداتی + نوع ارز + مقدار قیمت خرید ارزی + درصد حاشیه سود
• تبدیل خودکار به قیمت پایه تومانی و ذخیره در متای قیمت ووکامرس
• تغییر واحد نمایش (تومان/ریال) بدون دریافت دوباره نرخ‌ها (بازنویسی بر اساس قیمت پایه)
• Rate sources (admin configurable):
  • آدرس JSON زنده بازار آزاد (با مقادیر به تومان)
  • RSS/XML نرخ رسمی یا دولتی (برای هر ارز) + یا ضریب تبدیل premium (بازار آزاد/دولتی)
  • نرخ‌های دستی (به تومان)
  • مدل تخمین آفلاین (مبتنی بر مرجع)
• ویرایش گروهی همه محصولات خارجی (تب محصولات)
• شورتکد ویجت فرانت‌اند: [tomanify_rates] (فایل‌های فرانت‌اند فقط در صورت استفاده از شورتکد بارگذاری می‌شوند)
• یکپارچه‌سازی اختیاری برای پاک‌سازی کش (به‌صورت پیش‌فرض غیرفعال)
• پشتیبان‌گیری/بازیابی (خروجی/ورودی JSON) + گزینه پاک‌سازی هنگام حذف افزونه
• زبان مستقل افزونه (fa_IR / en_US) بدون وابستگی به زبان سایت
• رابط کاربری پنل مدیریت و فرانت‌اند با پشتیبانی راست به چپ/چپ به راست نویس
• دسترسی سریع‌تر در پنل مدیریت با زیرمنوهای مستقیم، راهنمای آشنایی سریع، و لینک‌های تنظیمات، مستندات، مستندات API و پشتیبانی انجمن در صفحه افزونه‌ها

ارزهای پشتیبانی‌شده

USD, EUR, AED, TRY, CNY

نحوه کار (در یک خط)

قیمت ارزی × نرخ (تومان) × (1 + سود/100) ← گرد کردن به نزدیک‌ترین ۱۰۰۰ تومان ← ذخیره قیمت پایه ← نوشتن قیمت ووکامرس با واحد انتخاب‌شده.

مستندات عمومی

برای راهنماهای ساده‌فهم، آموزش راه‌اندازی و توضیح‌های کاربردی، این بخش را ببینید:

• مستندات اصلی
• شروع سریع
• راهنمای JSON بازار آزاد (بدون نیاز به ارائه‌دهنده داخلی)
• حالت‌های منبع نرخ
• رفع اشکال

شروع سریع (پیشنهادشده)

گزینه الف: JSON (پیشنهادشده برای بسیاری از فروشگاه‌ها)

1. در تب منابع نرخ در تومنیفای، لینک فایل جیسون را وارد کنید.

2. آدرسی که معرفی می‌کنید باید این ساختار را برگرداند (مقادیر باید عدد صحیح و بر پایه تومان باشند):

   {“values”:{“USD”:60000,”EUR”:130000,”AED”:30000,”TRY”:2500,”CNY”:22550}}

3. روی بروز رسانی نرخ ها کلیک کنید.

4. محصول را به‌عنوان محصول خارجی علامت بزنید و مبلغ ارزی، نوع ارز و حاشیه سود آن را وارد کنید.

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

برای بسیاری از فروشگاه‌ها، یک فید JSON سازگار از بازار آزاد کاملاً کافی است. اگر کسب‌وکار شما به زمان‌بندی دقیق‌تر یا نوسان‌های کوچک نرخ حساس‌تر است، می‌توانید آن را با حاشیه سود، RSS/XML رسمی به‌عنوان پشتیبان، یا منبع پولی/اختصاصی خودتان ترکیب کنید.

گزینه ب: نرخ‌های رسمی (RSS/XML)

1. در تب منابع نرخ در تومنی فای، آدرس RSS/XML رسمی هر ارز (HTTPS) را وارد کنید.
2. این افزونه ریال رسمی را با استفاده از فرمول زیر به تومان بازار آزاد تبدیل می‌کند:
   ضریب تبدیل = نرخ بازار آزاد / نرخ دولتی
   نرخ بازار آزاد (تومان) = نرخ دولتی (ریال) / (10 × ضریب تبدیل)

اگر آدرس فید RSS/XML را ندارید، صفحه رسمی نرخ‌ها را باز کنید و لینک RSS مربوط به هر ارز را از ردیف همان ارز کپی کنید.

(کنار هر ارز یک آیکن RSS می‌بینید. آن را باز کنید و آدرس XML را در فیلد مربوط به همان ارز کپی کنید.)

گزینه سوم: دستی / آفلاین

اگر نمی‌خواهید همیشه به یک URL زنده وابسته باشید، می‌توانید از این گزینه‌ها هم استفاده کنید:

• نرخ دستی برای تعیین مقادیر ثابت تومان به ازای هر ارز
• پیشبینی آفلاین برای تخمین مبتنی بر مرجع

این روش‌ها فقط برای شرایط اضطراری نیستند؛ می‌توانند به‌عنوان لایه‌های پشتیبان هم مفید باشند.

لینک‌های پیشنهادی برای منبع نرخ (کپی/پیست اختیاری)

مهم:
این لینک‌ها فقط پیشنهادهای اختیاری هستند. تومنیفای آن‌ها را به‌صورت خودکار از قبل پر نمی‌کند.
شما می‌توانید از هر منبع HTTPS معتبر و قابل‌اعتمادی که می‌خواهید استفاده کنید.

۱) نمونه ساختار آدرس JSON

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

https://raw.githubusercontent.com////data.json

یک URL اختیاری برای JSON که توسط جامعه کاربران نگهداری می‌شود (تا زمانی که گیت‌هاب و منابع رایگانِ پشت آن در دسترس باشند، استفاده از آن رایگان است):

https://raw.githubusercontent.com/rate-json/default/main/data.json

۲) RSS/XML بانک مرکزی (کپی/پیست برای هر ارز)

USD — دلار آمریکا

https://cbi.ir/ExRatesRSS.aspx?cid=1

EUR — یورو

https://cbi.ir/ExRatesRSS.aspx?cid=94

AED — درهم امارات متحده عربی

https://cbi.ir/ExRatesRSS.aspx?cid=14

TRY — لیر ترکیه

https://cbi.ir/ExRatesRSS.aspx?cid=38

CNY — یوان چین

https://cbi.ir/ExRatesRSS.aspx?cid=85

نحوه استفاده

علامت‌گذاری محصول به‌عنوان خارجی

صفحه ویرایش محصول را باز کنید ← باکس محصول وارداتی (تومنی فای):

• گزینه این محصول خارجی است را فعال کنید
• قیمت خرید خارجی را وارد کنید
• واحد ارزی را انتخاب کنید
• درصد سود را وارد کنید

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

ویرایش گروهی محصولات خارجی

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

ویجت شورتکد

این شورتکد را در هر برگه یا نوشته‌ای اضافه کنید:

[tomanify_rates]

این ویجت موارد زیر را نمایش می‌دهد:

• عنوان + زمان آخرین به‌روزرسانی (اختیاری)
• واحد (تومان/ریال)
• جدول ارزهای انتخاب‌شده

فایل‌های CSS/JS فرانت‌اند فقط زمانی بارگذاری می‌شوند که شورتکد در همان صفحه وجود داشته باشد.

سرویس‌های خارجی

تومنیفای هیچ‌گونه داده مشتری، داده سفارش یا اطلاعات هویتی اشخاص را ارسال نمی‌کند.
این افزونه فقط از آدرس‌های خارجی‌ای که خود شما در تب «منابع نرخ» وارد می‌کنید، داده نرخ ارز را دریافت می‌کند (JSON و/یا RSS/XML).
این درخواست‌ها فقط زمانی انجام می‌شوند که نرخ‌ها را به‌روزرسانی کنید (دستی یا از طریق کرون زمان‌بندی‌شده).

مهم:

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

مجوز

GPL-2.0 یا نسخه های جدیدتر.