انتخاب، نصب و مدیریت افزونه‌های فروشگاه

انتخاب و نصب افزونه از بازارچه

در /panel/apps زبانهٔ «کشف» فهرست افزونه‌های قابل بررسی را نشان می‌دهد. پیش از نصب، افزونه را مثل یک دسترسی جدید به داده و بخش‌های فروشگاه ارزیابی کنید؛ نام و توضیح کوتاه کافی نیست. از جست‌وجو و دسته‌هایی مثل ارسال، پرداخت، بازاریابی، تحلیل و پشتیبانی برای پیدا کردن گزینه استفاده کنید. زبانهٔ «نصب‌شده» نصب‌ها را نشان می‌دهد و «به‌روزرسانی‌ها» فقط موردهایی را فهرست می‌کند که نسخهٔ تازه دارند.

در کارت هر افزونه این موارد را بخوانید:

• سازنده و تأیید: نشان «رسمی آناما» یا «تأییدشده» را با نام توسعه‌دهنده و پیوندهای حریم خصوصی، پشتیبانی و شرایط استفاده بسنجید. نبود نشان به معنی ناسالم‌بودن قطعی نیست، اما یعنی باید اطلاعات سازنده و سیاست داده را با دقت بیشتری بررسی کنید.
• دسترسی‌ها: فهرست می‌گوید افزونه چه داده‌ای را می‌تواند بخواند یا تغییر دهد؛ برای مثال «مشاهدهٔ سفارش‌ها» با «مدیریت سفارش‌ها» یکی نیست. فقط دسترسی‌هایی را بپذیرید که برای کاری که می‌خواهید انجام دهید لازم‌اند.
• محل استفاده: بخش‌هایی مثل فروشگاه، پرداخت، حساب مشتری یا پنل مدیریت مشخص می‌کنند افزونه در کجا اثر می‌گذارد. به‌خصوص دسترسی‌های نوشتن، پرداخت و مشتری را پیش از نصب دقیق بررسی کنید.
• نسخه، سرویس خارجی و رضایت: شمارهٔ نسخه، سرویس‌های بیرونی، رده‌های رضایت و وضعیت عملکرد ممکن است در کارت باشند. اگر عملکرد «دادهٔ کافی نیست» نشان می‌دهد، آن را نتیجهٔ خوب تلقی نکنید؛ هنوز نمونهٔ کافی ثبت نشده است.

وقتی روی «نصب» می‌زنید، پنجرهٔ بررسی باز می‌شود. این پنجره «App Trust Card» را با دادهٔ خواندنی، دادهٔ قابل‌تغییر، سرویس‌های خارجی، وضعیت تأیید و پیوندهای حریم خصوصی و پشتیبانی نشان می‌دهد. پیوند حریم خصوصی نداشتن یا فهرست سرویس خارجی نامعلوم را پیش از تصمیم بررسی کنید؛ نصب به‌معنی موافقت آگاهانه با همهٔ دسترسی‌هاست.

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

تنظیم و روشن‌کردن افزونه

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

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

بررسی نسخه و ارتقا

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

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

غیرفعال‌کردن یا حذف

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

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

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

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