سؤالات متداول

چگونه افزونه را نصب کنم؟

فایل zip افزونه را از مسیر «افزونه‌ها ← افزودن ← بارگذاری افزونه» در پیشخوان وردپرس نصب و سپس فعال کنید.

نرخ‌ها هر چند وقت یک‌بار به‌روزرسانی می‌شوند؟

به‌صورت پیش‌فرض هر ۱۵ دقیقه از طریق WP-Cron. این مدت را می‌توانید از بخش تنظیمات بین ۵ تا ۶۰ دقیقه تغییر دهید.

چگونه نرخ‌ها را در سایت نمایش دهم؟

از شورت‌کد `[currencies_in_iran]` در برگه یا نوشته استفاده کنید. گزینه‌هایی مانند `currency`، `show_average`، `format` و `decimal_places` نیز پشتیبانی می‌شوند.

چگونه منبع‌های فعال را مدیریت کنم؟

از پیشخوان به «نرخ روز ارز ← منابع» بروید و منبع‌ها را برای هر ارز روشن یا خاموش کنید.

قیمت‌ها به ریال هستند یا تومان؟

از بخش تنظیمات می‌توانید واحد نمایش را بین ریال (IRR) و تومان (IRT) انتخاب کنید.

تاریخچه تغییرات

0.2.7

• نصب افزونه‌ی همراه (مخزن خالقی) پایدارتر شد: اگر نصب اولیه ناموفق باشد، در مراجعه‌ی بعدی به پیشخوان دوباره تلاش می‌شود و دیگر به‌دلیل خطای دسترسی به فایل‌سیستم به‌صورت بی‌صدا شکست نمی‌خورد.
  
• افزونه‌ی همراه اکنون پیش از اولین نمایش صفحات تنظیمات نصب/فعال می‌شود؛ در بازدیدهای فرانت‌اند فقط حالت «نصب‌شده ولی غیرفعال» به‌صورت خودکار اصلاح می‌شود.
  



0.2.6




• صفحه‌ی «نرخ‌های تفصیلی» بازطراحی شد: به‌جای فهرست مقادیر هر منبع، اکنون برای هر ارز جهت و میزان تغییر (بالا/پایین/ثابت با فلش و درصد)، قیمت جاری، بازترین/بالاترین/پایین‌ترین و نمودار روندِ ۲۴ ساعت گذشته نمایش داده می‌شود.
  
• داده‌ی این صفحه از نقطه‌ی پایانی جدید `GET /v1/rates/{currency}/history` سمت API گرفته می‌شود (پنجره‌ی ۲۴ ساعته، حداکثر ۷۲ ساعت)؛ سرور تنها منبع داده است و در صفحه هیچ اشاره‌ای به منبع/خراش دادن نمایش داده نمی‌شود.
  
• روش دریافت: پاسخ به‌صورت کش‌شده (transient به‌همراه ETag، سقف ۱۰ دقیقه) برای هر ارز ذخیره و فقط در صورت نیاز شبکه فراخوانی می‌شود؛ هنگام پاک‌سازی کش، داده‌ی تاریخچه نیز پاک می‌شود.
  



0.2.4




• فهرست ارزهای پشتیبانی‌شده دیگر فقط در کد افزونه نیست: افزونه فهرست رسمی (کد، نام، نوع دارایی، واحد و دقت نمایش) را از `GET /v1/currencies` سمت سرور دریافت می‌کند. افزودن ارز جدید در سرور، بدون نیاز به بروزرسانی افزونه، در نام، دسته‌بندی (ارز/کریپتو/طلا)، واحد و رقم اعشار نمایش اعمال می‌شود.
  
• کش فهرست به صورت روزانه و فقط هنگام رفرش بورد پر می‌شود؛ رندر صفحات هرگز منتظر شبکه نمی‌ماند (تا زمانی که فهرست در دسترس نباشد، نگاشت‌های داخلی فعلی به‌کار می‌روند).
  



0.2.3




• گسترش ارزهای پشتیبانی‌شده بر اساس جست‌وجوی کاربران ایرانی: ارزهای خارجی بیشتر (لیر ترکیه، دینار عراق، دلار کانادا، دلار استرالیا، یوان چین، منات آذربایجان، ریال عمان، افغانی، فرانک سوئیس)، ارزهای دیجیتال بیشتر (تتر، دوج‌کوین، شیبا اینو با واحد دلار) و طلا و سکه (طلای ۲۴ عیار، مثقال طلا، سکه امامی، سکه بهار آزادی).
  
• منبع جدید «الان چند» (alanchand) برای ارزهای جدید و سکه‌ها؛ سکه امامی و بهار آزادی در TGJU صفحه ندارند، بنابراین از الان‌چند گرفته می‌شوند.
  
• تتر (USDT) به‌صورت واحد و هماهنگ با دیگر رمزارزها (USD) از TGJU سرو می‌شود.
  
• پنجره‌های اعتبارسنجی (sanity windows) سمت API و افزونه برای همه‌ی ارزهای جدید اضافه شد.
  
• نمایش واحد (unit) از پاسخ فید به تمام مسیرهای نمایش منتقل شد؛ رمزارزهای کوچک (دوج‌کوین/شیبا) رقم‌اعشار حداقلی می‌گیرند تا ۰ نمایش داده نشوند.
  



0.2.2




• SDK جاسازی‌شده به نسخه‌ی 2.0.0 به‌روزرسانی شد: بررسی افزونه‌ی همراه (مخزن خالقی) از `admin_init` به `plugins_loaded` (اولویت ۵) منتقل و در هر درخواست تکرار می‌شود تا غیرفعال‌سازی هرچه زودتر شناسایی شود.
  
• در درخواست‌های فرانت‌اند، اگر افزونه‌ی مخزن خالقی نصب ولی غیرفعال باشد، خودکار (با سنجش مجوز «فعال‌سازی افزونه») فعال می‌شود؛ دانلود/نصب همچنان فقط از پنل مدیریت انجام می‌شود.
  



0.2.1




• هنگام ذخیره‌ی تنظیمات، همه‌ی کش‌ها (بورد نرخ، توکن فید، ETag و زمان آخرین به‌روزرسانی) پاک می‌شوند و وضعیت مجوز در facade مخزن خالقی تازه‌سازی می‌شود؛ پس از فعال‌سازی مجوز، فید دارای مجوز بلافاصله (و نه پس از پایان کش) در دسترس قرار می‌گیرد.
  



0.2.0




• مدیریت اعتبارسنجی مجوز (لیسانس) به افزونه‌ی همراه «مخزن خالقی» (Khaleghi Repository) سپرده شد: این افزونه دیگر به‌صورت مستقل مجوز نمی‌گیرد و از facade یعنی `\Khaleghi\WP\Repository\License` استفاده می‌کند.
  
• SDK جاسازی‌شده به نسخه‌ی 2 به‌روزرسانی شد که فقط نصب/فعال‌سازی خودکار افزونه‌ی مخزن خالقی را تضمین می‌کند؛ تأیید مجوز و به‌روزرسانی‌ها به مخزن خالقی واگذار شد.
  
• فید دارای مجوز فقط وقتی استفاده می‌شود که وضعیت مجوز طبق مخزن خالقی «فعال» باشد؛ در غیر این صورت به‌صورت خودکار فید عمومی (رایگان) سرو می‌شود.
  
• صفحه‌ی تنظیمات: ذخیره‌ی کلید از طریق `License::verify` انجام و نتیجه در پیام ذخیره نمایش داده می‌شود؛ کنار فیلد کلید، وضعیت زنده‌ی مجوز (فعال تا تاریخ … یا دلیل رد) نمایش داده می‌شود.
  



0.1.34




• هیچ تغییری در رفتار افزونه؛ فقط نسخه برای انتشار مجدد.
  



0.1.33




• بازطراحی کامل به مدل «فقط فید»: زیرسیستم خراش دادن (scraping) محلی به‌طور کامل حذف شد — دایرکتوری `includes/sources/` و کلاس `SourceManager` دیگر وجود ندارند؛ همه‌ی نرخ‌ها از API نرخ CII (currencies.khaleghi.info) دریافت می‌شوند.
  
• ترتیب دریافت: ابتدا فید دارای مجوز (لیسانس) `GET /v1/rates`، سپس ضرورتاً فید عمومی «رایگان» `GET /v1/free/rates`، و اگر هر دو ناموفق بودند فقط خطا ثبت می‌شود (دیگر هیچ عقب‌نشینی به خراشیدن محلی وجود ندارد).
  
• صفحه‌ی مدیریت «منابع» (Sources) به همراه ساب‌منو، تب، AJAX، استایل و اسکریپت‌های آن حذف شد.
  
• ویژگی `sources=` در شورت‌کد منسوخ (deprecated) شد و نادیده گرفته می‌شود؛ برای سازگاری نگه داشته شده است.
  
• متن‌های رابط توضیحی (تنظیمات، داشبورد) به مدل فید به‌روز شدند؛ شمارنده‌ی «N منبع» در داشبورد با نشان «فید زنده CII» جایگزین شد.
  
• گزینه‌ی قدیمی `alikhalghi_cii_enabled_sources` هنگام شناسایی نسخه‌ی جدید یک بار پاک‌سازی می‌شود.
  



0.1.31




• هیچ تغییری در رفتار افزونه؛ فقط نسخه برای انتشار مجدد.
  



0.1.30




• بازطراحی اعلان‌ها: فهرست خطاها که در پنجره‌ی تمام‌صفحه (modal) روی هدر صفحه باز می‌شد و بسته نمی‌شد، با یک فهرست درون‌صفحه‌ای مستقیماً زیر هدر جایگزین شد (رده‌ی `notice` بومی وردپرس، قابل بستن با کلید بستن، و دکمه‌ی «پاک‌کردن همه‌ی خطاها»).
  
• دکمه‌ی «مشاهده خطاها» در پانل کناری حالا به جای بازکردن modal، به همان فهرست زیر هدر اسکرول می‌کند.
  
• رفع جابه‌جایی اعلان‌ها به داخل هدر: اسکریپت بومی وردپرس (`wp-admin/js/common.js`) هر عنصر `div.notice` را هنگام بارگذاری صفحه به بعد از نخستین `h1` داخل `.wrap` منتقل می‌کند؛ یعنی اعلان بعد از «عنوان هدر» قرار می‌گرفت. با افزودن کلاس `inline` (که وردپرس برای جلوگیری از همین جابه‌جایی تعریف کرده) به هر دو اعلان پایدار و اعلان‌های موقت، دیگر جابه‌جا نمی‌شوند و زیر هدر می‌مانند.
  
• حذف فایل `messages.mo` مزاحم از ریشه‌ی پروژه (آرتیفکت ساخت از `msgfmt`).
  



0.1.29




• رفع اشکال اصلی ذخیره‌سازی: در تابع AJAX، داده‌ی فرم (`serialize`) با `$.extend` ترکیب می‌شد که رشته‌ی کوئری را نادیده می‌گرفت و فقط `action` و `nonce` ارسال می‌شد. نتیجه: تنظیمات همیشه به پیش‌فرض برمی‌گشت و در صفحه «منابع» همه‌ی منابع غیرفعال می‌شدند (و سپس «no data returned» رخ می‌داد). اکنون داده‌ی فرم به‌درستی به پیلود پیوست می‌شود.
  
• حذف لاگ تشخیصی موقتی از ذخیره‌سازی تنظیمات.
  



0.1.28




• سخت‌سازی ذخیره‌سازی تنظیمات: نوشتن بولی به‌صورت رشته امن کش (`1`/`0`)، و افزودن بررسی‌گر تشخیص پس از ذخیره که مقدار واقعی در پایگاه‌داده (نادیده‌گرفتن کش) و از طریق `get_option` را ثبت می‌کند تا علت ذخیره‌نشدن (کش شیء یا بسته‌شدن نوشتن) مشخص شود.
  



0.1.27




• ذخیره‌سازی صفحات «تنظیمات» و «منابع» به روش ایجکس (admin-ajax) منتقل شد تا خطای «پیوند منقضی شده» در ارسال کامل فرم (options.php و admin-post.php) برطرف شود؛ اعتبارسنجی با همان nonce مشترک دکمه‌های به‌روزرسانی/کش انجام می‌شود.
  
• بازطراحی پنل «وضعیت کش» به‌صورت فهرست تعریف‌شده (شبکه دو ستونه) که در ستون باریک کناری به‌درستی جا می‌گیرد و سرریز نمی‌شود.
  



0.1.26




• رفع ذخیره‌سازی صفحه «تنظیمات»: فرم دیگر به `options.php` پست نمی‌شود (که باعث خطای «پیوند منقضی شده» و عدم ذخیره می‌شد)؛ اکنون از طریق `admin-post.php` همراه با اعتبارسنجی nonce، ذخیره و هدایت پاک انجام می‌شود.
  
• رفع واقعی ذخیره‌سازی صفحه «منابع»: نام دکمه ذخیره به `submit_sources` تنظیم شد تا پردازش فرم فعال شود (پیش از این به‌صورت `submit` ارسال و هرگز ذخیره نمی‌شد).
  
• افزودن اعلان موفقیت پس از ذخیره تنظیمات.
  



0.1.25




• ترجمه کامل افزونه: استخراج و بازسازی کامل کاتالوگ ترجمه (POT) با تمام رشته‌های جدید رابط، و تکمیل ترجمه‌های فارسی (fa_IR) و آلمانی (de_DE) برای ۱۰۷ رشته + ترجمه‌های چندگانه (جمع) + فایل‌های `.mo` کامپایل‌شده.
  



0.1.24




• رفع مشکل ذخیره‌سازی صفحه «منابع» (نام دکمه ذخیره `submit_sources` برای فعال شدن پردازش).
  
• رفع چک‌باکس «همه» در صفحه منابع که چک/آنچک فرزندان را انجام نمی‌داد.
  
• وسط‌چین کردن کانتینر اصلی صفحات مدیریت (حذف فضای خالی کنار صفحه).
  



0.1.23




• رفع باگ نمایش کد PHP در پایین صفحه داشبورد (بستن زودهنگام تگ PHP).
  
• اصلاح عدم بارگذاری استایل و اسکریپت در صفحات فرعی (نرخ‌های تفصیلی، منابع، تنظیمات) با بارگذاری مطمئن دارایی‌ها در تمام صفحات پلاگین.
  



0.1.22




• بازطراحی کامل و از نو تمام صفحات مدیریتی افزونه با ظاهری جدید و خاص، کاملاً متفاوت از نسخه‌های قبل.
  
• طراحی سیستم اختصاصی با الگوها و رنگ‌های پیشخوان وردپرس: هدر قهرمان (Hero) با نشان پلاگین، وضعیت زنده، و دکمه به‌روزرسانی فوری.
  
• نوار پیمایش داخلی (تب) برای جابه‌جایی میان داشبورد، نرخ‌های تفصیلی، منابع و تنظیمات.
  
• داشبورد با کارت‌های آماری ارزها (KPI)، جدول خلاصه بازار، پنل وضعیت کش، اعلان‌ها و میانبرها.
  
• صفحه نرخ‌های تفصیلی با انتخاب‌گر ارز (تب) و نمایش منبع‌به‌منبع به‌همراه نمودار بازه کم/میانگین/زیاد.
  
• صفحه منابع با نوار خلاصه، کارت‌های ارزی و چک‌باکس‌های بومی + امکان فعال‌سازی/غیرفعال‌سازی کلی هر ارز.
  
• صفحه تنظیمات بازطراحی‌شده با کارت‌ها و بخش‌بندی تمیز.
  
• افزودن اسپینر بارگذاری، اعلان‌های بومی، مودال اعلان‌ها و دسترس‌پذیری (ARIA، فوکوس، کلید Esc).
  
• سازگاری کامل راست‌به‌چپ (RTL) با استایل‌شیت اختصاصی.
  
• بازنویسی JavaScript تعاملی (تب‌ها، تازه‌سازی بدون بارگذاری مجدد، جابجایی چک‌باکس‌های کلی).
  



0.1.21




• بازطراحی کامل رابط کاربری مدیریت مطابق الگوها و کامپوننت‌های استاندارد پیشخوان وردپرس (تبلت‌های wp-list-table، کارت‌ها، دکمه‌ها و اعلان‌های بومی).
  
• سازگاری کامل با جهت راست‌به‌چپ (RTL) با افزودن استایل‌شیت اختصاصی admin-rtl.css و فعال‌سازی خودکار بر اساس is_rtl().
  
• حفظ مودال اعلان‌ها و منوی بازشوی وضعیت کش اما بازطراحی آن‌ها با رنگ‌ها و ظاهر بومی وردپرس.
  
• جایگزینی سوئیچ‌های سفارشی با چک‌باکس‌های بومی وردپرس در صفحه منابع.
  



0.1.20




• افزودن سه منبع جدید از Tgju: بیت‌کوین (crypto-bitcoin)، اتریوم (crypto-ethereum) و طلای ۱۸ عیار (geram18).
  
• نرخ‌های بیت‌کوین و اتریوم به دلار و طلا به ریال استخراج، اعتبارسنجی و کش می‌شوند.
  
• استفاده از فیلد قیمت لحظه‌ای استاندارد Tgju (PDrCotVal) برای استخراج دقیق‌تر.
  
• رفع عدم‌فعال بودن منابع جدید در نصب‌های موجود به‌طور پیش‌فرض (منابع تازه فعال می‌شوند).
  
• نمایش واحد صحیح: BTC/ETH به دلار (USD) و سایر ارزها مطابق تنظیم ریال/تومان؛ سوئیچ IRR/IRT دیگر روی ارزهای دیجیتال اثر ندارد.
  



0.1.19




• هماهنگ‌سازی مانیفست و بازانتشار.
  



0.1.18




• هماهنگ‌سازی مانیفست و بازانتشار.
  



0.1.17




• هماهنگ‌سازی مانیفست و بازانتشار.
  



0.1.16




• هماهنگ‌سازی مانیفست و بازانتشار نسخه ۰.۱.۱۵.
  



0.1.15




• رفع باگ‌های مهلک فضای‌نام (\WP_Error / \Exception) در SourceManager و تمام کلاس‌های اسکرپر.
  
• صفحه منابع: افزودن بررسی سطح دسترسی و انتقال پردازش POST از ویو به هندلر با الگوی PRG.
  
• تنظیم «مدت کش» اکنون واقعاً کار می‌کند؛ مشکل ازدحام کش در تازه‌سازی اجباری برطرف شد.
  
• صفحه «نرخ‌های تفصیلی» پیشخوان اکنون استایل خود را بارگذاری می‌کند.
  
• خطاهای مجوز AJAX به‌جای HTML، پاسخ JSON برمی‌گردانند.
  
• افزودن sanitize_callback به تمام تنظیمات ثبت‌شده.
  
• اعلان‌های جاوااسکریپت پیشخوان امن از نظر XSS و بومی‌سازی شدند؛ استایل‌های سراسری تزریق‌شده حذف گردید.
  
• گزینه گزارش خطا دیگر در هر درخواست autoload نمی‌شود؛ آدرس‌های URI پیش از ذخیره پاک‌سازی می‌شوند.
  
• کلیدهای تاگل با دسترس‌پذیری بهتر (برچسب و حلقه فوکوس) و انیمیشن صحیح RTL برای مدیران فارسی‌زبان.
  
• پاک‌سازی CSSهای بلااستفاده، قوانین تکراری و رنگ hex نامعتبر؛ جایگزینی ایموجی‌ها با Dashicons.
  



0.1.14




• هماهنگ‌سازی شماره نسخه بین هدر، ثابت و مانیفست.
  



۰.۱.۱۳




• اولین انتشار تحت مدیریت kwp.
  



نسخه 0.1.6 (۸ دسامبر ۲۰۲۵)


• افزوده: پشتیبانی کامل بین‌المللی‌سازی با ترجمه‌های فارسی و آلمانی
  
• ایجاد شده: فایل‌های زبان کامل .po/.mo برای locales fa_IR و de_DE
  
• به‌روزرسانی: افزونه برای استفاده از بارگذاری استاندارد text domain وردپرس
  
• بهبود: رابط کاربری مدیریتی و نمایش چندزبانه
  
• بهتر: تجربه کاربری برای کاربران غیرانگلیسی زبان
  
• استاندارد: معماری آماده ترجمه پیروی بهترین شیوه‌های وردپرس
  



نسخه 0.1.5 (۸ دسامبر ۲۰۲۵)


• رفع: اسکرپر اقتصادنیوز با سلکتورهای دقیق هدف‌گیری ساختار price-tables
  
• بهبود: الگوهای اقتصادنیوز برای استخراج سطر اصلی "دلار" (حذف انواع دیگر دلار)
  
• افزوده: تبدیل تومان به ریال برای اقتصادنیوز (۱ تومان = ۱۰ ریال)
  
• بهبود: الگوریتم امتیازدهی برای اولویت‌بخشی الگوهای دقیق ساختار جدول
  
• به‌روزرسانی: سلکتورها برای حذف "دلار کانادا"، "دلار در صرافی ملی"، و غیره
  
• تست شده: تأیید کار با داده‌های زنده استخراج نرخ صحیح (۱,۲۴۲,۵۰۰ ریال)
  
• نتیجه: هر دو اسکرپر اکنون با نرخ‌های سازگار در محدوده ۲,۰۰۰ ریال تفاوت کار می‌کنند
  



نسخه 0.1.4 (۸ دسامبر ۲۰۲۵)


• رفع: عملکرد AJAX برای دکمه‌های تازه‌سازی و پاک کردن کش
  
• رفع: متدهای گمشده در کلاس CacheManager که باعث خطاهای مهلک می‌شد
  
• بهبود: اسکرپر دنیای اقتصاد با سلکتورهای هدف‌گیری "نرخ فعلی" (نرخ فعلی)
  
• تقویت: اعتبارسنجی نرخ برای محدوده‌های واقعی USD (1.1M-1.5M IRR)
  
• افزوده: حالت‌های بارگذاری جاوااسکریپت و اعلان‌های کاربری
  
• افزوده: مدیریت خطا و ثبت جامع
  
• بازسازی: انتقال CurrencyInterface به دایرکتوری منابع برای سازماندهی بهتر
  
• افزوده: سیستم اعتبارسنجی منبع با ثبت اشکال‌زدایی
  
• بهبود: داشبورد مدیریت با بازخورد بصری بهتر
  



نسخه 0.1 (۸ دسامبر ۲۰۲۵)


• انتشار اولیه: استخراج نرخ پایه USD از اقتصادنیوز و دنیای اقتصاد
  
• افزوده: داشبورد مدیریت وردپرس برای مدیریت نرخ
  
• افزوده: سیستم شورت‌کد برای نمایش رابط کاربری
  
• افزوده: سیستم کش با انقضای ۱۵ دقیقه
  
• افزوده: یکپارچه‌سازی WP-Cron برای به‌روزرسانی‌های خودکار
  
• افزوده: ثبت خطا و اعتبارسنجی
  
• افزوده: استایل‌دهی واکنش‌گرا CSS برای مدیریت و رابط کاربری
  
• افزوده: معماری منبع گسترش‌پذیر با استفاده از اینترفیس‌ها