Kabook PTE Project Monitor

توضیحات

Kabook PTE Project Monitor به سردبیران ترجمهٔ پروژه و مشارکت‌کنندگان بومی‌سازی کمک می‌کند افزونه‌ها و پوسته‌های WordPress.org را از یک پیشخوان واحد پایش کنند.

می‌توانید نامک‌های پروژه یا نشانی‌های پشتیبانی‌شدهٔ WordPress.org را اضافه کنید، یک زبان محلی وردپرس انتخاب کنید و برای مقایسهٔ آخرین اطلاعات انتشار با آخرین وضعیتی که به‌عنوان بررسی‌شده علامت‌گذاری کرده‌اید، بررسی‌ها را اجرا کنید.

این افزونه طراحی شده است تا به شما در ردیابی تغییرات عمومی انتشار و وضعیت ترجمه برای پروژه‌هایی که در سایت فعلی نصب نیستند کمک کند.

ویژگی‌ها

  • پایش افزونه‌ها و پوسته‌های WordPress.org بدون نصب محلی آن‌ها.
  • شناسایی انتشارهای جدید افزونه و پوسته از WordPress.org.
  • پایش پروژه‌های ترجمهٔ Stable و Stable Readme افزونه.
  • پایش پروژهٔ ترجمهٔ واحدی که پوسته‌های WordPress.org از آن استفاده می‌کنند.
  • اجرای بررسی تک‌پروژه از طریق AJAX با بازخورد پیشرفت درون‌خطی.
  • پردازش بررسی‌های کامل از طریق یک صف قابل‌ازسرگیری مناسب برای فهرست‌های بزرگ پروژه.
  • ادامهٔ صف‌های ناقص از طریق WP-Cron هنگام بسته بودن پیشخوان.
  • برجسته‌سازی تغییرات بررسی‌نشده با سطوح شدت زرد و قرمز.
  • علامت‌گذاری آخرین وضعیت بررسی‌شده به‌عنوان بررسی‌شده از طریق AJAX با بازخورد پیشرفت درون‌خطی، بدون بارگذاری مجدد صفحه یا از دست رفتن جستجو، فیلتر یا مرتب‌سازی فعال.
  • با استفاده از یک اقدام دسته‌جمعی، چندین پروژه انتخاب‌شده را همزمان به‌عنوان بازبینی‌شده علامت بزنید و ببینید چه کسی و چه زمانی آخرین بار پروژه را بازبینی کرده است.
  • تعیین بازه زمانی بررسی مختص به پروژه که زمان‌بندی سراسری افزونه را برای آن پروژه خاص جایگزین می‌کند.
  • ستون «بازه بررسی» برای هر پروژه را در داشبورد، از طریق تنظیمات نمایش دهید یا مخفی کنید (به‌طور پیش‌فرض مخفی است).
  • هنگام تایپ نام یا نامک پروژه‌ها برای افزودن، پیشنهادهای WordPress.org را دریافت کنید.
  • مشاهدهٔ پوشش ترجمه، رشته‌های ترجمه‌شده، رشته‌های ترجمه‌نشده، شمار پروژه‌ها و امتیاز تشویقی.
  • جستجو و فیلتر پروژه‌ها بر اساس نوع یا وضعیت بررسی.
  • مرتب‌سازی پروژه‌ها بر اساس اولویت، رشته‌های ترجمه‌نشده، میزان تکمیل، فاصلهٔ انتشار، آخرین بررسی یا نام.
  • نمایش ۲۰، ۵۰ یا ۱۰۰ پروژه در هر صفحه.
  • افزودن هم‌زمان چند نامک افزونه و پوسته یا نشانی پشتیبانی‌شدهٔ WordPress.org.
  • برون‌بری پیوندهای افزونه و پوستهٔ تحت‌پایش و تنظیمات پایش به یک پروندهٔ JSON و درون‌ریزی دوبارهٔ آن‌ها در همین سایت یا سایت دیگر.
  • پیروی خودکار از زبان وردپرسِ مدیر فعلی یا انتخاب دستی زبان محلی.
  • باز کردن مستقیم صفحه ترجمه نسخه «پایدار»، «Readme پایدار» یا «پوسته» که از قبل برای رشته‌های ترجمه‌نشده، در انتظار، یا فازی فیلتر شده باشد، یا رفتن به صفحه پروژه بدون فیلتر — انتخاب با شماست.
  • پیکربندی بازهٔ پایش و آستانه‌های هشدار قرمز.
  • خلاصه ایمیلی روزانه یا هفتگی از پروژه‌های نیازمند بازبینی را دریافت کنید که به ایمیل مدیر سایت یا یک آدرس سفارشی ارسال می‌شود.
  • خلاصه مشابه را به یک وب‌هوک سازگار با اسلک (اسلک، دیسکورد و اکثر گیرنده‌های وب‌هوک چت عمومی) ارسال کنید.
  • تحویل ناموفق ایمیل یا وب‌هوک را در اجرای نظارت بعدی به‌طور خودکار مجدداً امتحان کنید.
  • برای بررسی ایمیل و وب‌هوک پیکربندی شده قبل از اتکا به خلاصه، یک اعلان آزمایشی یک‌باره ارسال کنید.

وضعیت بررسی

نخستین بررسی موفق، خط مبنا را تعیین می‌کند. یک انتشار بعدی یا تغییر در منبع ترجمه می‌تواند باعث شود پروژه زرد یا قرمز نمایش داده شود.

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

رنگ سبز به این معناست که آخرین وضعیت بررسی‌شده به‌عنوان بررسی‌شده تأیید شده است. لزوماً به معنای کامل بودن همهٔ رشته‌های ترجمه نیست؛ میزان تکمیل به‌صورت جداگانه در ستون‌های ترجمه و پیشخوان نمایش داده می‌شود.

ورودی‌های پروژهٔ پشتیبانی‌شده

می‌توانید پروژه‌ها را با هر یک از قالب‌های زیر اضافه کنید:

  • نامک‌های ساده
  • plugin:slug
  • theme:slug
  • صفحه‌های افزونهٔ WordPress.org
  • صفحه‌های پوستهٔ WordPress.org
  • صفحه‌های افزونه با زیردامنهٔ زبان محلی
  • نشانی‌های پروژهٔ پشتیبانی‌شدهٔ Translate.WordPress.org

سرویس‌های خارجی

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

این افزونه از APIهای رسمی WordPress.org برای دریافت فرادادهٔ عمومی پروژه و آمار ترجمه استفاده می‌کند:

  • Plugins & Themes API: برای دریافت نسخه‌ها، تاریخچهٔ انتشار و جزئیات پروژه استفاده می‌شود.
    https://api.wordpress.org/

  • Translations API: برای دریافت فهرست استاندارد زبان‌های محلی وردپرس به‌منظور نگاشت زبان‌ها استفاده می‌شود.
    https://api.wordpress.org/translations/

  • GlotPress API: برای دریافت آمار عمومی ترجمه از سکوی رسمی ترجمه استفاده می‌شود.
    https://translate.wordpress.org/

درخواست‌ها ممکن است شامل نوع پروژه، نامک پروژه، زبان محلی انتخاب‌شده، نشانی IP سرور مورد نیاز برای اتصال شبکه و نشانی سایت موجود در عامل کاربرِ درخواست باشند.

هیچ داده‌ای به Kabook یا هیچ سرویس طرف ثالثی که توسط توسعه‌دهندهٔ افزونه اداره می‌شود ارسال نمی‌شود. همهٔ ارتباطات توصیف‌شده در بالا فقط بین سرور شما و WordPress.org است.

این سرویس‌ها تابع سیاست حریم خصوصی و شرایط WordPress.org هستند:
https://wordpress.org/about/privacy/
https://wordpress.org/about/terms-of-service/

وب‌هوک اعلان اختیاری

اگر URL وب‌هوک را در تنظیمات وارد کنید، سرور شما علاوه بر این، هر زمان که خلاصه آماده ارسال باشد، یک پیام JSON (خلاصه‌ای کوتاه از پروژه‌های نیازمند بازبینی) به آن URL ارسال می‌کند و همچنین به هر سرویسی که اعلان آزمایشی ارسال می‌کنید. این ویژگی به‌طور پیش‌فرض غیرفعال است و فقط داده‌ها را به URL که خودتان پیکربندی می‌کنید ارسال می‌کند؛ این موضوع توسط خط‌مشی رازداری همان سرویس اداره می‌شود، نه WordPress.org.

ایمیل خلاصه اختیاری با استفاده از پیکربندی عادی wp_mail() سایت شما ارسال می‌شود، همانند هر ایمیل اعلان وردپرس دیگر (مانند بازنشانی گذرواژه).

عکس‌های صفحه

نصب

  1. پرونده‌های افزونه را در /wp-content/plugins/kabook-pte-project-monitor بارگذاری کنید، یا افزونه را از طریق وردپرس نصب کنید.
  2. افزونه را فعال کنید.
  3. ابزارها > PTE Project Monitor را باز کنید.
  4. افشای سرویس خارجی را بازبینی و پایش را فعال کنید.
  5. نامک‌های افزونه یا پوسته و نشانی‌های WordPress.org را اضافه کنید.
  6. برای تعیین خط مبنا، نخستین بررسی را اجرا کنید.

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

آیا افزونه‌ها یا پوسته‌های تحت‌پایش باید نصب شوند؟

خیر. این افزونه اطلاعات عمومی پروژه و ترجمه را از WordPress.org دریافت می‌کند.

کدام پروژه‌های ترجمه بررسی می‌شوند؟

افزونه‌ها از Stable و Stable Readme استفاده می‌کنند. پوسته‌ها از پروژهٔ ترجمهٔ واحد WordPress.org خود استفاده می‌کنند.

چرا یک ترجمهٔ کامل‌شده همچنان زرد یا قرمز باقی می‌ماند؟

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

آیا می‌توانم نشانی پروژه‌ها را اضافه کنم؟

بله. ورودی‌های پشتیبانی‌شده شامل نامک‌های ساده، plugin:slug، theme:slug، صفحه‌های افزونه و پوستهٔ WordPress.org، صفحه‌های افزونه با زیردامنهٔ زبان محلی و نشانی‌های پروژهٔ پشتیبانی‌شدهٔ Translate.WordPress.org هستند.

آیا می‌توانم پروژه‌های تحت‌پایش و تنظیمات خود را به سایت دیگری منتقل کنم؟

بله. از زبانهٔ درون‌ریزی/برون‌بری در تنظیمات افزونه استفاده کنید تا یک پروندهٔ JSON با پیوندهای افزونه و پوستهٔ تحت‌پایش و تنظیمات پایش بارگیری کنید، سپس همان پرونده را در سایت دیگری بارگذاری کنید. پروژه‌های تحت‌پایش موجود و تاریخچهٔ بررسی آن‌ها هرگز با یک درون‌ریزی حذف یا بازنویسی نمی‌شوند.

در طول یک بررسی کامل بزرگ چه اتفاقی می‌افتد؟

مرورگر پروژه‌ها را یک‌به‌یک پردازش می‌کند و پیشرفت زنده را نمایش می‌دهد. پیشرفت بین درخواست‌ها ذخیره می‌شود. یک رویداد جایگزین WP-Cron می‌تواند صف ناقص را ادامه دهد و پروژه‌های قطع‌شده پیش از ادامهٔ صف دوباره امتحان می‌شوند.

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

رویدادهای زمان‌بندی‌شدهٔ وردپرس به WP-Cron وابسته‌اند. در سایت‌های کم‌بازدید، ممکن است یک رویداد دیرتر از بازهٔ پیکربندی‌شده اجرا شود.

آیا افزونه داده‌هایی را به Kabook ارسال می‌کند؟

خیر. این افزونه به هیچ سروری در Kabook متصل نمی‌شود و دورسنجی ندارد.

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

در تنظیمات، تناوب خلاصه (خاموش، روزانه یا هفتگی) را انتخاب کنید و مشخص کنید که آیا فقط پروژه‌های قرمز یا پروژه‌های قرمز و زرد را پوشش دهد. خلاصه فقط زمانی ارسال می‌شود که حداقل یک پروژه مطابق با معیار نیاز به بازبینی داشته باشد، که پس از هر اجرای نظارت تکمیل‌شده بررسی می‌شود. می‌توانید یک ایمیل اعلان سفارشی (به‌طور پیش‌فرض ایمیل مدیر سایت است) و در صورت تمایل، یک URL وب‌هوک سازگار با اسلک تنظیم کنید. از «ارسال اعلان آزمایشی» برای تأیید فوری هر دو استفاده کنید. تحویل ناموفق به‌طور خودکار در اجرای تکمیل‌شده بعدی، تا 3 بار تلاش مجدد خواهد شد.

نقد و بررسی‌ها

نقد و بررسی‌ای برای این افزونه یافت نشد.

توسعه دهندگان و همکاران

“Kabook PTE Project Monitor” نرم افزار متن باز است. افراد زیر در این افزونه مشارکت کرده‌اند.

مشارکت کنندگان

“Kabook PTE Project Monitor” به 1 زبان ترجمه شده است. با تشکر از مترجمین برای همکاری و کمک‌هایشان.

ترجمه “Kabook PTE Project Monitor” به زبان شما.

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

کد را مرور کنید، مخزن SVN را بررسی کنید، یا از طریق RSS در گزارش توسعه مشترک شوید.

گزارش تغییرات

1.2.0

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

1.1.0

  • افزودن شمارنده «رشته‌های ترجمه‌شده» به معیارهای پیشخوان، در کنار شمارنده موجود برای موارد ترجمه‌نشده.
  • افزودن اقدام دسته‌جمعی «علامت‌گذاری به‌عنوان بازبینی‌شده» در کنار حذف دسته‌جمعی، برای بازبینی چندین پروژه به‌طور همزمان.
  • افزودن بازه زمانی بررسی مختص به هر پروژه که زمان‌بندی سراسری افزونه را برای آن پروژه خاص جایگزین می‌کند.
  • افزودن پیشنهادهای WordPress.org هنگام تایپ در فیلد «افزودن پروژه‌ها»، برای مترجمانی که با نامک‌های انگلیسی راحت نیستند.
  • ثبت اینکه چه کسی آخرین بار پروژه را بازبینی کرده و چه زمانی، در کنار وضعیت آن.
  • امکان باز شدن پیوندهای ترجمه «پایدار»، «Readme پایدار» و «پوسته» به رشته‌های ترجمه‌نشده، در انتظار، یا فازی، یا صفحه پروژه بدون فیلتر — قابل تنظیم در بخش تنظیمات، که به‌صورت پیش‌فرض مانند قبل روی رشته‌های ترجمه‌نشده تنظیم شده است.
  • رفع مشکل تراز ماندن درصد «پوشش کلی» در سمت چپ در صفحه‌های مدیریت راست‌چین (RTL).

1.0.0

  • انتشار عمومی اولیه.
  • پایش انتشارهای افزونه و پوستهٔ WordPress.org از یک پیشخوان واحد.
  • مقایسهٔ تغییرات انتشار و وضعیت ترجمه با آخرین خط مبنای بررسی‌شده.
  • پشتیبانی از بررسی تک‌پروژه با AJAX، علامت‌گذاری بررسی با AJAX و بررسی‌های کامل صف قابل‌ازسرگیری.
  • افزودن ردیابی وضعیت بررسی، فیلتر، مرتب‌سازی، صفحه‌بندی و کنترل‌های پایش.
  • افزودن درون‌ریزی و برون‌بری پیوندها و تنظیمات پروژه‌های تحت‌پایش به‌صورت پروندهٔ JSON.
  • استفاده فقط از سرویس‌های عمومی WordPress.org پس از موافقت مدیر.