# کلید من — معرفی کامل و راهنمای استفاده

**نسخه:* 1.7.1 | **توسعه‌دهنده:** TS – خانه افزونه | **وب‌سایت:** tablighatsabet.ir

## کلید من چیست؟

«کلید من» یک افزونهٔ **مدیریت مرکزی و پیش‌نیاز** برای خانوادهٔ افزونه‌های «خانه افزونه» است. به‌جای اینکه هر افزونه به‌صورت جداگانه سیستم لایسنس و بروزرسانی خودش را داشته باشد، «کلید من» این کار را یک‌بار برای همیشه در پیشخوان وردپرس شما انجام می‌دهد:

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

به بیان ساده: «کلید من» را نصب کنید، لایسنس‌تان را در آن فعال کنید، و تمام افزونه‌های وابسته به آن به‌صورت خودکار همان لایسنس را می‌شناسند و بروزرسانی می‌شوند.

## این افزونه برای چه کسانی مناسب است؟

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

## امکانات کلیدی

| امکان | توضیح |
|—|—|
| 🗂 داشبورد یکپارچه | نمایش همهٔ افزونه‌های سایت، تفکیک‌شده به «افزونه‌های کلید من» و «سایر افزونه‌ها»، با وضعیت فعال/غیرفعال و نسخهٔ هرکدام |
| 🔑 مدیریت لایسنس | فعال‌سازی، غیرفعال‌سازی و بررسی دستی وضعیت لایسنس، به همراه بررسی خودکار روزانه از طریق Cron وردپرس |
| ⬆ بروزرسانی خودکار | دریافت نسخهٔ جدید از سرور مرکزی هر ۱۲ ساعت و نمایش آن در صفحهٔ استاندارد بروزرسانی وردپرس، با **تأیید دامنه و چک‌سام فایل** پیش از نصب برای امنیت بیشتر |
| 🖼 شناسایی آیکون افزونه | نمایش آیکون هر افزونهٔ وابسته در کارت مخصوص آن در داشبورد |
| 🌐 چندسایتی (Multisite) | تشخیص افزونه‌های فعال‌شده در سطح شبکه در سایت‌های چندگانه |

## نصب و راه‌اندازی

1. فایل zip افزونه را از طریق **افزونه‌ها › افزودن › بارگذاری افزونه** در پیشخوان وردپرس آپلود کنید، یا پوشهٔ `my-key` را در مسیر `wp-content/plugins/` قرار دهید.
2. از صفحهٔ «افزونه‌ها»، افزونهٔ **کلید من** را فعال کنید.
3. یک آیتم منوی جدید به‌نام «کلید من» در پیشخوان ظاهر می‌شود؛ روی آن کلیک کنید تا داشبورد باز شود.

**پیش‌نیازها:** وردپرس ۵٫۶ به بالا و PHP ۷٫۴ به بالا.

## فعال‌سازی لایسنس

1. از منوی «کلید من»، وارد زیرمنوی **لایسنس** شوید.
2. کلید لایسنسی را که از خانه افزونه دریافت کرده‌اید در کادر مربوطه وارد کنید.
3. روی **فعال‌سازی لایسنس** بزنید. کلید برای دامنهٔ سایت فعلی شما ثبت و فعال می‌شود.
4. وضعیت لایسنس (فعال، منقضی، لغوشده و…)، تاریخ انقضا و تعداد فعال‌سازی‌های مجاز در همین صفحه نمایش داده می‌شود.
5. در صورت نیاز، با دکمهٔ **بررسی دوباره وضعیت** می‌توانید بدون منتظرماندن برای بررسی روزانهٔ خودکار، وضعیت را فوراً از سرور به‌روز کنید.
6. برای انتقال لایسنس به سایت دیگر، ابتدا از دکمهٔ **غیرفعال‌سازی لایسنس** استفاده کنید.

## صفحهٔ داشبورد

داشبورد اصلی افزونه دو تب دارد:

– **افزونه‌های کلید من:** افزونه‌هایی که به این سیستم وابسته‌اند، همراه با نسخه، وضعیت فعال/غیرفعال و در صورت وجود، دکمهٔ بروزرسانی.
– **سایر افزونه‌ها:** بقیهٔ افزونه‌های نصب‌شده روی سایت که ارتباطی به «خانه افزونه» ندارند، صرفاً برای مرجع.

اگر لایسنس شما فعال نباشد، یک اعلان بالای صفحه شما را به صفحهٔ لایسنس راهنمایی می‌کند.

## نکتهٔ مهم و شفاف: پیام‌های اسپانسر

تا زمانی‌که لایسنس سایت شما **فعال** نشده باشد، افزونه به‌صورت محدود (حداکثر چند بار در روز) یک پیام تبلیغاتی کوتاه نمایش می‌دهد:

– در پیشخوان مدیریت وردپرس (فقط برای ادمین‌ها).
– در صفحهٔ اصلی سایت برای بازدیدکنندگان، حداکثر ۲ بار در روز برای هر بازدیدکننده.

با فعال‌سازی لایسنس، این پیام‌ها به‌طور کامل حذف می‌شوند. این مکانیزم صرفاً برای یادآوری فعال‌سازی لایسنس طراحی شده و داده‌ای از سایت شما جمع‌آوری نمی‌کند.

## بروزرسانی افزونه

«کلید من» هر ۱۲ ساعت یک‌بار به‌صورت خودکار وضعیت نسخهٔ جدید را از سرور مرکزی بررسی می‌کند. اگر نسخهٔ جدیدتری منتشر شده باشد:

– یک اعلان در تمام صفحات پیشخوان نمایش داده می‌شود.
– بروزرسانی در صفحهٔ استاندارد **افزونه‌ها › بروزرسانی‌ها** وردپرس هم قابل مشاهده و نصب یک‌کلیکی است — دقیقاً مثل افزونه‌های موجود در وردپرس‌دات‌اورگ.

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

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

**آیا بدون لایسنس هم می‌توان از افزونه استفاده کرد؟**
بله، امکانات اصلی داشبورد و مدیریت افزونه‌ها بدون لایسنس هم در دسترس است؛ فقط پیام‌های اسپانسر تا فعال‌سازی لایسنس نمایش داده می‌شوند.

**اگر افزونه را حذف کنم، داده‌هایم چه می‌شود؟**
با حذف (Delete) افزونه از صفحهٔ افزونه‌ها، تمام تنظیمات، اطلاعات لایسنس و کش‌های مرتبط به‌طور کامل از پایگاه‌دادهٔ سایت پاک می‌شود.

**آیا افزونه روی چندسایتی (Multisite) کار می‌کند؟**
بله، وضعیت فعال‌سازی در سطح شبکه در داشبورد به‌درستی تشخیص داده می‌شود.

## پشتیبانی

برای دریافت لایسنس، پشتیبانی فنی یا مشاهدهٔ سایر افزونه‌های «خانه افزونه»، به آدرس زیر مراجعه کنید:

**tablighatsabet.ir**