پرسش‌های متداول RasaadSync

Q: آیا افزونه به دسترسی مدیریتی روی سایت منبع نیاز دارد؟
A: خیر. فقط REST API عمومی وردپرس روی سایت منبع باید فعال باشد؛ هیچ کلید API یا احراز هویتی لازم نیست.

Q: در هر بار همگام‌سازی چند نوشته وارد می‌شود؟
A: حداکثر یک نوشته؛ همیشه فقط آخرین نوشتهٔ دستهٔ انتخاب‌شدهٔ منبع.

Q: آیا نوشته‌های تکراری دوباره وارد می‌شوند؟
A: خیر. با متای `_rasaadsync_source_id` از ورود مجدد همان نوشته جلوگیری می‌شود.

Q: آیا تصویر شاخص هم کپی می‌شود؟
A: بله، تصویر شاخص در کتابخانهٔ رسانهٔ سایت شما بارگذاری و به نوشته متصل می‌شود.

Q: تصاویر داخل متن محتوا چه می‌شوند؟
A: تصاویری که روی دامنهٔ منبع میزبانی شده‌اند دانلود شده و آدرس آن‌ها در محتوا بازنویسی می‌شود؛ تصاویر خارجی دست‌نخورده باقی می‌مانند.

Q: اگر دانلود یکی از تصاویر شکست بخورد چه اتفاقی می‌افتد؟
A: نوشته بدون آن تصویر وارد می‌شود و هشدار در گزارش ثبت می‌گردد؛ روند همگام‌سازی متوقف نمی‌شود.

Q: وضعیت پیش‌فرض نوشته‌های ورودی چیست؟
A: «پیش‌نویس». می‌توانید آن را به «در انتظار بررسی» یا «منتشرشده» تغییر دهید.

Q: آیا تاریخ انتشار اصلی نوشته حفظ می‌شود؟
A: بله، تاریخ اصلی منبع دریافت و به منطقهٔ زمانی سایت شما تبدیل می‌شود.

Q: آیا ویرایش یا حذف نوشته در منبع روی سایت منعکس می‌شود؟
A: خیر. نسخهٔ فعلی فقط یک‌بار نوشته را وارد می‌کند؛ همگام‌سازی به‌روزرسانی/حذف در نقشهٔ راه نسخه‌های بعدی است.

Q: آیا امکان حذف خودکار نوشته‌های قدیمی وجود دارد؟
A: اکشن مدیریت یتیم‌ها (`rasaadsync_handle_orphans`) گزینه‌های نگه‌داشتن / زباله‌دان / پیش‌نویس را ارائه می‌دهد و با فهرست کامل نوشته‌های منبع مقایسه می‌کند. حذف کامل هرگز به‌صورت خودکار انجام نمی‌شود و در صورت خطا یا ناقص بودن فهرست منبع هیچ نوشته‌ای تغییر نمی‌کند.

Q: چندسایتی (Multisite) پشتیبانی می‌شود؟
A: رسماً تست و پشتیبانی نشده است؛ هر سایت باید افزونه را جداگانه نصب و پیکربندی کند.

Q: کلید لایسنس را از کجا بگیرم و اگر نگیرم چه می‌شود؟
A: از [rasaad.ir/portal](https://rasaad.ir/portal). بدون کلید معتبر، افزونه هیچ عملکردی ندارد و صفحهٔ فعال‌سازی نمایش داده می‌شود. کلید به دامنه متصل است؛ باطل‌شدن کلید از سمت سرور حداکثر طی یک دقیقه افزونه را قفل می‌کند.

Q: اگر لایسنس منقضی یا باطل شود نوشته‌های واردشده حذف می‌شوند؟
A: خیر. فقط همگام‌سازی و تنظیمات قفل می‌شود؛ محتوای قبلاً واردشده دست‌نخورده می‌ماند.

Q: چرا دکمهٔ «همگام‌سازی اکنون» گاهی خطای انتظار می‌دهد؟
A: برای جلوگیری از درخواست‌های پیاپی، محدودیت ۱۰ ثانیه‌ای بین هر همگام‌سازی دستی وجود دارد.

Q: گزارش‌ها تا چه زمانی نگه داشته می‌شوند؟
A: حداکثر ۱۰۰ رکورد آخر در آپشن `rasaadsync_sync_log` ذخیره و جدیدترین رکورد اول نمایش داده می‌شود؛ امکان پاک کردن کامل گزارش هم هست.

Q: آیا افزونه شورت‌کد یا فیلتر/اکشن سفارشی دارد؟
A: خیر. نسخهٔ فعلی شورت‌کد یا هوک عمومی ارائه نمی‌کند.

Q: آیا ترجمهٔ فارسی موجود است؟
A: بله، فایل‌های ترجمه fa_IR همراه افزونه ارسال می‌شوند.

Q: امنیت ارتباط با سایت منبع چگونه است؟
A: احراز هویتی انجام نمی‌شود و تأیید گواهی SSL به‌صورت پیش‌فرض همیشه فعال است. تنها اگر مدیر گزینهٔ «اجازهٔ SSL ناامن» را صریحاً فعال کند، در صورت خطای گواهی تلاش مجدد بدون تأیید انجام می‌شود. توصیه می‌شود سایت منبع HTTPS معتبر داشته باشد.

تغییرات RasaadSync

1.1.10

• به‌روزرسانی نسخه افزونه به ۱٫۱٫۱۰
  



1.1.8


• به‌روزرسانی مستندات: شماره نسخه‌های تاریخچه با ارقام انگلیسی یکدست شدند
  
• اصلاح بخش «حذف افزونه» در یادداشت‌ها برای انعکاس دقیق رفتار صفحهٔ راهنمای Uninstall و `uninstall.php`
  



1.1.7


• رفع باگ فیلترها در REST API: پارامترهای کوئری (`categories`، `per_page`، `page` و…) که به‌اشتباه در بدنهٔ درخواست GET ارسال می‌شدند نادیده گرفته می‌شدند؛ در نتیجه «آخرین نوشته» بدون توجه به دسته انتخاب‌شده واکشی می‌شد. اکنون پارامترها به‌درستی در آدرس درخواست قرار می‌گیرند.
  
• رفع باگ تاریخ انتشار: تاریخ محلی سایت منبع به‌اشتباه به‌عنوان UTC تفسیر می‌شد و نوشته‌های واردشده در سایت‌های غیر-UTC تاریخِ جابه‌جاشده داشتند؛ اکنون `post_date` از `date_gmt` منبع محاسبه می‌شود.
  
• امنیت SSL: تلاش مجدد با تأیید گواهیِ غیرفعال دیگر خودکار نیست و فقط در صورت فعال‌کردن صریح گزینهٔ `rasaadsync_allow_insecure_ssl` توسط مدیر انجام می‌شود (پیش‌تر هر خطای SSL بی‌صدا باعث دور زدن اعتبارسنجی گواهی می‌شد).
  



1.1.6



Patch test




1.1.5


• کاهش کش وضعیت لایسنس در khaleghi-sdk از ۲۴ ساعت به ۵ دقیقه؛ کلید باطل‌شده حداکثر طی چند دقیقه به‌روزرسانی‌ها را هم مسدود می‌کند
  
• افزودن گزینهٔ پیکربندی `license_ttl` به khaleghi-sdk (نسخهٔ ۱.۰.۱)
  
• به‌روزرسانی مستندات و همگام‌سازی نسخهٔ ذکرشده در فایل «اطلاعات تکمیلی»
  



1.1.4


• بهبود کارایی: شمارش تصاویر در صفحهٔ حذف دیگر فهرست نوشته‌های غیرهمگام را برای هر تصویر از نو واکشی نمی‌کند
  
• بهبود کارایی: شناسایی نوشته‌های یتیم با جستجوی هش به‌جای مقایسهٔ خطی با تا ۵٬۰۰۰ شناسه
  
• نقطهٔ پایانی «تلاش مجدد» در شکست همگام‌سازی اکنون پاسخ خطای سازگار برمی‌گرداند
  
• حذف رشتهٔ ترجمهٔ بلااستفادهٔ «Retrying...» از منبع و فایل‌های زبان
  
• به‌روزرسانی ساختار فایل در README و حذف قالب بلااستفادهٔ اعلان مدیریت
  



1.1.3


• صفحهٔ حذف (Uninstall) هدایت‌شده: جایگزین لینک‌های «غیرفعال‌سازی/حذف» پیش‌فرض وردپرس
  
• شمارش زندهٔ نوشته‌های همگام‌شده و تصاویر واردشده با بازهٔ تاریخ، قبل از تأیید حذف
  
• حذف محتوا فقط با کلید فعال + تایپ واژهٔ DELETE؛ بدون انتخاب هیچ گزینه‌ای، افزونه صرفاً غیرفعال می‌شود
  
• گزینهٔ حذف یا نگه‌داشتن فایل‌های افزونه برای نصب مجدد
  
• حفظ تصاویری که در محتوای دیگری استفاده شده‌اند
  
• فایل `uninstall.php` به‌عنوان پاکسازی امنِ جایگزین (فقط تنظیمات و کرون، هرگز محتوا)
  
• پیام بومی وردپرس پس از غیرفعال‌سازی و بنر خوش‌آمد پس از فعال‌سازی
  
• رفع خطای fatal در صفحهٔ حذف (ارجاع نامعتبر کلاس) و حذف آیتم منوی اضافی
  



1.1.2


• رفع هشدار `_load_textdomain_just_in_time`: برچسب بازه‌های همگام‌سازی فقط هنگام نمایش ترجمه می‌شوند، نه هنگام زمان‌بندی کرون
  
• افزودن هدایت خودکار به صفحهٔ افزونه پس از فعال‌سازی
  



1.1.1


• سخت‌گیری بیشتر در اعتبارسنجی لایسنس: کش اعتبار به ۶۰ ثانیه کاهش یافت و کلید باطل‌شده حداکثر تا یک دقیقه افزونه را قفل می‌کند
  
• حذف اعلان تکراری و انگلیسی SDK؛ تمام پیام‌های لایسنس فقط توسط خود افزونه نمایش داده می‌شود
  
• ترمینال همگام‌سازی دیگر روی کلید نامعتبر اجرا نمی‌شود (قفل فوری در همهٔ مسیرها)
  



1.1.0


• افزونه اکنون محصول لایسنس‌محور است: بدون کلید معتبر، هیچ عملکردی (همگام‌سازی، کرون، تنظیمات) اجرا نمی‌شود
  
• صفحهٔ فعال‌سازی تمام‌صفحه با رابط کاربری جدید برای واردکردن و تأیید کلید لایسنس
  
• اعتبارسنجی فعال لایسنس: بررسی مجدد خودکار هر ۶ ساعت از طریق WP-Cron و در هر بارگذاری صفحه پس از انقضای کش
  
• نمایش وضعیت لایسنس به‌صورت نشان رنگی در هدر صفحهٔ تنظیمات
  



1.0.5


• اتصال به پلتفرم Khaleghi از طریق khaleghi-sdk برای بررسی لایسنس و به‌روزرسانی خودکار
  
• افزودن فیلد کلید لایسنس به صفحهٔ تنظیمات همراه با نمایش وضعیت لایسنس
  
• رفع خطای اعتبارسنجی URL منبع (پارامتر اشتباه در `filter_var`) که مانع ذخیرهٔ آدرس‌های معتبر می‌شد
  
• ساده‌سازی اعتبارسنجی SSRF: عدم اتکا به DNS (که روی هاست‌های اشتراکی شکست می‌خورد) و حفظ مسدودسازی http/localhost/IPهای خصوصی
  



1.0.4


• حذف گزینهٔ «حذف کامل» از مدیریت یتیم‌ها: نوشته‌ها فقط به زباله‌دان می‌روند یا پیش‌نویس می‌شوند و هرگز به‌صورت خودکار پاک نمی‌شوند
  
• رفع باگ خطرناک مدیریت یتیم‌ها: مقایسه با فهرست کامل و صفحه‌بندی‌شدهٔ شناسه‌های منبع به‌جای فقط آخرین نوشته (قبلاً همهٔ نوشته‌های قدیمی‌تر به اشتباه «یتیم» شمرده می‌شدند)
  
• شکست ایمن عملیات یتیم‌ها: در صورت خطای API، دستهٔ خالی منبع، یا ناقص ماندن فهرست، هیچ نوشته‌ای حذف نمی‌شود
  
• رفع باگ زمان‌بندی: ثبت بازه‌های سفارشی کرون از طریق فیلتر `cron_schedules` (بازهٔ ۱۵ دقیقه قبلاً بی‌صدا شکست می‌خورد)
  
• جلوگیری از برنامه‌ریزی تکراری کرون
  
• اعتبارسنجی URL منبع برای مقابله با SSRF (فقط http/https و میزبان عمومی)
  
• رفع آسیب‌پذیری XSS در اسکریپت مدیریت: escape کردن داده‌های دریافتی از سایت منبع در ترمینال، توست‌ها، وضعیت اتصال و لیست دسته‌ها
  
• رفع خطای متغیر تعریف‌نشده `data` در پاسخ‌های ناموفق همگام‌سازی
  
• اصلاح ذخیره‌سازی `post_date_gmt` (قبلاً به‌اشتباه به وقت محلی تبدیل می‌شد)
  
• پاکسازی محتوای واردشده از سایت منبع با `wp_kses_post`
  
• انتقال دریافت دسته/برچسب منبع به کلاینت Api (حذف فراخوانی مستقیم HTTP)
  
• یکپارچه‌سازی منطق تلاش مجدد SSL و ثبت هشدار هنگام غیرفعال‌سازی موقت تأیید گواهی
  
• اعمال محدودیت نرخ روی «تلاش مجدد» و اعتبارسنجی بازهٔ کرون هنگام ذخیره تنظیمات
  
• حذف رشته‌های انگلیسی هاردکد از جاوااسکریپت و استفاده کامل از بستهٔ i18n
  
• همسان‌سازی نسخهٔ هدر افزونه و مستندات
  



1.0.3


• اصلاح نسخهٔ داخلی افزونه (ثابت `RASAADSYNC_VERSION`)
  
• بهبود پایداری همگام‌سازی و مدیریت خطاها
  



1.0.0


• انتشار نخستین نسخه
  
• همگام‌سازی آخرین نوشتهٔ یک دسته از سایت منبع via REST API
  
• بارگذاری تصویر شاخص و دانلود تصاویر داخلی محتوا
  
• جلوگیری از ورود تکراری بر اساس شناسهٔ منبع
  
• زمان‌بندی WP-Cron + همگام‌سازی دستی «همگام‌سازی اکنون»
  
• ترمینال همگام‌سازی زنده و تاریخچهٔ همگام‌سازی
  
• بررسی اتصال و دریافت دسته‌های منبع
  
• مدیریت یتیم‌ها و تلاش مجدد (Retry)
  
• ترجمهٔ فارسی (fa_IR)