توضیحات
افزونه داده‌های بازار سرویکس، سایت وردپرسیِ تحت مدیریت مشتری را به اشتراک فعال API
سرویکس متصل می‌کند. مالکان سایت می‌توانند مقادیر دارای مجوز ارز، طلا و سکه را
انتخاب کنند و آن‌ها را با بلوک گوتنبرگ یا کد کوتاه نمایش دهند.
این افزونه محیط مدیریتی با اولویت زبان فارسی، نمایش راست‌به‌چپ و چپ‌به‌راست،
چیدمان جدولی و کارتی، رنگ‌بندی و تایپوگرافی قابل تنظیم، زمان کاری اختیاری بر پایه
تقویم هجری خورشیدی، نمایش اختیاری نام سرویکس، حافظه پنهان سمت سرور و راهکار
جایگزین هنگام قدیمی‌شدن داده‌ها را فراهم می‌کند.
برای استفاده از این افزونه به حساب سرویکس، کلید API و مجوز فعال استفاده از API
نیاز دارید. سرویکس ممکن است دسترسی آزمایشیِ مدت‌دار و طرح‌های پولی با سهمیه‌های
متفاوت برای دریافت داده‌های بازار از سرویس خارجی ارائه کند.
مشتریان دارای مجوز می‌توانند طبق شرایط و طرح فعال سرویکس خود، مقادیر انتخابی را
به‌صورت متن در وب‌سایتشان نمایش دهند. کلید API روی سرور وردپرس باقی می‌ماند و در
درخواست‌های مرورگر یا کد نشانه‌گذاریِ تولیدشده قرار نمی‌گیرد.
سرویس خارجی
افزونه داده‌های بازار سرویکس به سرویس خارجی https://servix.cc وابسته است. زمانی
که مدیر اتصال را آزمایش می‌کند، ویرایشگر دارایی‌های پشتیبانی‌شده را شناسایی می‌کند
یا یکی از بخش‌های نمایشیِ تنظیم‌شده به داده تازه بازار نیاز دارد، افزونه درخواست‌های
HTTPS را مستقیماً از سرور به سرور ارسال می‌کند. صرفاً فعال‌کردن افزونه یا بازکردن
صفحه تنظیمات باعث ارتباط با سرویکس نمی‌شود.
افزونه فهرست دارایی‌های پشتیبانی‌شده را از
/api/v1/assets/supported و مقادیر فعلی بازار را از /api/v1/assets دریافت می‌کند. هر
درخواست، کلید API تنظیم‌شده در سرآیند X-API-Key، مسیر API درخواستی، نشانی سایت در
عامل کاربریِ یکپارچه‌سازی و فراداده‌های معمول اتصال، مانند نشانی IP سرور وردپرس،
را منتقل می‌کند. افزونه عمداً اطلاعات بازدیدکنندگان را ارسال نمی‌کند و هیچ سازوکار
تله‌متری‌ای به سایت اضافه نمی‌کند.
شرایط استفاده سرویکس: https://servix.cc/terms
سیاست حریم خصوصی سرویکس: https://servix.cc/privacy
مستندات API سرویکس: https://servix.cc/docs
مسئولیت تدوین اطلاعیه حریم خصوصی سایت و نمایش داده‌های دارای مجوز مطابق با طرح
فعال سرویکس، همچنان بر عهده مالک سایت است.
عکس‌های صفحه
نصب
- افزونه «داده‌های بازار سرویکس» را از صفحه افزونه‌های وردپرس نصب و فعال کنید.
- مقدار
SERVIX_API_KEYرا درwp-config.phpتعریف کنید یا کلید را از مسیر تنظیمات > داده‌های بازار سرویکس وارد کنید. - برای بررسی اعتبار اشتراک، «آزمایش اتصال» را انتخاب کنید.
- بلوک «قیمت‌های بازار سرویکس» را اضافه کنید، سپس دارایی‌های موردنظر را انتخاب و مرتب کنید.
- درج نام و پیوند سرویکس به‌طور پیش‌فرض غیرفعال است. فقط در صورتی آن را از تنظیمات افزونه فعال کنید که خودتان بخواهید نمایش داده شود یا طرح فعال سرویکس شما آن را الزامی کرده باشد.
- برای نمایش در نوار کناری، بلوک را در بخش قالب نوار کناری پوسته یا ناحیه ابزارک‌ها قرار دهید.
برای ویرایشگر کلاسیک یا صفحه‌ساز، از این کد استفاده کنید:
[servix_prices assets=”USD_RLS,EUR_RLS” layout=”cards” language=”fa” unit=”source” show_time=”1″]
چیدمان‌های پشتیبانی‌شده شامل کارت و جدول هستند. برای تبدیل فقط مقادیری که واحد مظنه آن‌ها RLS است به تومان، unit=”toman” را تنظیم کنید. مقادیر با واحد مظنه دیگر، با همان واحد اصلی باقی می‌مانند و واحدشان به‌روشنی نمایش داده می‌شود.
سوالات متداول
-
آیا مجوز فعال استفاده از API سرویکس لازم است؟
-
بله. این افزونه به یک کلید API با دسترسی آزمایشی یا پولیِ فعال نیاز دارد. جزئیات
دسترسی، مدت اعتبار و سهمیه‌های فعلی در وب‌سایت سرویکس توضیح داده شده است. -
آیا افزونه نام و پیوند سرویکس را به‌صورت عمومی نمایش می‌دهد؟
-
به‌طور پیش‌فرض خیر. مالک سایت می‌تواند پیوند معرفی Servix.cc را از مسیر تنظیمات
> داده‌های بازار سرویکس فعال کند. این تنظیم، دسترسی به داده‌ها را تغییر نمی‌دهد
و هیچ‌یک از قابلیت‌های افزونه را غیرفعال نمی‌کند. اگر طرح فعال سرویکس درج نام و
پیوند سرویکس را الزامی می‌داند، پیش از نمایش داده‌های آن طرح این گزینه را فعال کنید. -
آیا مشتریان می‌توانند مقادیر را به‌صورت متن نمایش دهند؟
-
بله. مشتری‌ای که مجوز فعال استفاده از API را دارد، می‌تواند طبق شرایط سرویکس و
طرح فعال خود، مقادیر انتخابی را در وب‌سایتی که در اختیار اوست نمایش دهد. -
آیا کلید API برای بازدیدکنندگان ارسال می‌شود؟
-
خیر. درخواست‌ها از PHP وردپرس ارسال می‌شوند و افزونه هرگز کلید را در HTML،
JavaScript، نشانی‌های اینترنتی یا پاسخ‌های عمومی قرار نمی‌دهد. -
افزونه چه زمانی با سرویکس ارتباط برقرار می‌کند؟
-
فقط زمانی که مدیر اتصال را آزمایش کند، ویرایشگر بلوک فهرست دارایی‌های
پشتیبانی‌شده یا پیش‌نمایش را بخواهد، یا بخش نمایشی سایت به داده‌ای نیاز داشته باشد
که در حافظه پنهان معتبر موجود نیست. -
پس از غیرفعال‌کردن یا حذف افزونه چه چیزهایی باقی می‌ماند؟
-
با غیرفعال‌کردن افزونه، تنظیمات برای فعال‌سازی دوباره حفظ می‌شوند. اگر افزونه را
از طریق وردپرس حذف کنید، تنظیمات افزونه، کلید API ذخیره‌شده و داده‌های حافظه پنهان
مربوط به افزونه پاک می‌شوند. در نوشته‌های موجود فقط کد دارایی‌ها، متن کد کوتاه و
گزینه‌های نمایش باقی می‌ماند؛ این نوشته‌ها حاوی کلید API یا پاسخ کامل API نیستند. -
چطور با رعایت نکات امنیتی درخواست پشتیبانی بدهم؟
-
نسخه افزونه، نسخه‌های وردپرس و PHP، کد عیب‌یابیِ غیرحساس و زمان ارسال درخواست را
برای info@servix.cc بفرستید. هرگز کلید API یا پاسخ کامل و احراز هویت‌شده API را
ارسال نکنید. -
ترجمه‌های فارسی چگونه ارائه می‌شوند؟
-
WordPress.org ترجمه‌های تأییدشده فارسی را در قالب یک بسته زبانی جداگانه ارائه
می‌کند. تا زمانی که ترجمه جامعه کاربران بررسی و بسته زبانی منتشر شود، ممکن است
متن اصلی انگلیسی به‌طور موقت در سایت‌های فارسی نمایش داده شود.
نقد و بررسی‌ها
نقد و بررسی‌ای برای این افزونه یافت نشد.
توسعه دهندگان و همکاران
“داده‌های بازار سرویکس” نرم افزار متن باز است. افراد زیر در این افزونه مشارکت کرده‌اند.
مشارکت کنندگان
“داده‌های بازار سرویکس” به 1 زبان ترجمه شده است. با تشکر از مترجمین برای همکاری و کمک‌هایشان.
ترجمه “داده‌های بازار سرویکس” به زبان شما.
علاقه مند به توسعه هستید؟
کد را مرور کنید، مخزن SVN را بررسی کنید، یا از طریق RSS در گزارش توسعه مشترک شوید.
گزارش تغییرات
1.2.1
- بسته‌بندی ترجمه با بسته‌های زبانی WordPress.org هماهنگ شد و فایل‌های زبانِ همراه از بسته‌های ZIP انتشار کنار گذاشته شدند.
- ترجمه‌های PHP و اسکریپت ویرایشگر از طریق دامنه متنی استاندارد
servix-market-dataبارگیری می‌شوند.
1.2.0
- نمایش عمومی نام و پیوند سرویکس به گزینه‌ای اختیاری برای مالک سایت تبدیل شد که به‌طور پیش‌فرض غیرفعال است.
- درخواست بررسی مجوز طرح که پیش‌تر برای اجباری‌کردن نمایش نام سرویکس استفاده می‌شد، حذف شد.
- فراداده‌های انتشار یکپارچه شد، پاک‌سازی هنگام حذف افزونه تکمیل شد و بررسی‌های بسته انتشار استحکام بیشتری یافت.
1.1.0
- پشتیبانی از طرح رایگان آغازین با ۵۰ درخواست احراز هویت‌شده در روز اضافه شد.
- حافظه پنهان محدودِ سمت سرور برای مجوز دسترسی و نمایش نام Servix.cc متناسب با شرایط هر طرح اضافه شد.
- برای حفظ رفتار امن، در صورت تأییدنشدن مجوز دسترسی، نام و پیوند سرویکس همچنان نمایش داده می‌شود.
1.0.0
- تنظیمات API احراز هویت‌شده سرویکس و مدیریت امن کلید در سمت سرور اضافه شد.
- شناسایی دارایی‌ها، دریافت آخرین مقادیر، ذخیره‌سازی در حافظه پنهان و راهکار جایگزین برای داده‌های قدیمی اضافه شد.
- بلوک گوتنبرگ و کد کوتاه «قیمت‌های بازار سرویکس» اضافه شد.
- خروجی فارسی و انگلیسی، چیدمان‌های راست‌به‌چپ و چپ‌به‌راست و زمان هجری خورشیدی اضافه شد.
- چیدمان‌ها، رنگ‌ها، تایپوگرافی، عنوان‌ها، واحدها و نمایش زمان به‌صورت قابل تنظیم اضافه شد.