پروژه و وظیفه در پیشخوان وردپرس

Persian Project Management

افزونهٔ مدیریت پروژه و وظایف با رابط فارسی و RTL، جداول اختصاصی دیتابیس، داشبورد با نمودار، کانبان تیمی، تقویم کاری و REST محدود — هماهنگ با نقش‌ها و nonceهای وردپرس.

شروع مستندات مسیر نصب

توسعه‌دهنده

Alireza Aminzadeh

هزینه استفاده

رایگان (GPL-2.0-or-later)

پیش‌نیاز

وردپرس ۶٫۰+ / PHP ۷٫۴+

دامنهٔ ترجمه

persian-project-management

معرفی و پیش‌نیاز

Persian Project Management فضای کاری مدیریت پروژه را داخل پیشخوان وردپرس می‌آورد؛ داده در جداول {prefix}ppm_projects و {prefix}ppm_tasks نگه‌داری می‌شود و نسخهٔ اسکیما با گزینهٔ ppm_db_version و تابع maybe_upgrade روی plugins_loaded همگام می‌ماند.

  • نسخهٔ فعلی در سایت شما (در صورت فعال بودن افزونه): 1.0.0
  • حداقل: وردپرس ۶٫۰، PHP ۷٫۴ (طبق README مخزن).
  • مخزن: persian-project-management-wordpress-plugin در گیت‌هاب.
یکپارچگی با تم: این صفحه فقط معرفی و مستندات است؛ منطق افزونه در پوشهٔ wp-content/plugins/ نصب می‌شود. برای دکمهٔ دانلود ZIP، لینک را در مدیریت تم → لینک دانلود — مدیریت پروژه فارسی وارد کنید.

تجربهٔ ادمین و ظاهر

  • RTL و رشته‌های فارسی (text domain بالا).
  • نوار کناری در صفحات پشتیبانی‌شده؛ نمایش/مخفی از تنظیمات → نوار کناری.
  • برندینگ: لوگوی رسانه، نام سازمان، شعار در هدر؛ در صورت خالی بودن از عنوان سایت استفاده می‌شود.
  • رنگ پس‌زمینهٔ محتوا به‌ازای هر صفحهٔ مجاز از تنظیمات → صفحات.
  • پس‌زمینهٔ کانبان: رنگ و/یا تصویر از رسانه در تنظیمات → کانبان.

داشبورد

  • نوار کاربر (نام نمایشی و نقش وردپرس)، جستجوی سریع پروژه، میانبرها به لیست پروژه/وظایف، پروژهٔ جدید و کانبان.
  • KPIها: همهٔ پروژه‌ها، فعال‌های «ایجادشده این ماه»، پروژه‌های با تأخیر، فعال بدون مالک، کارت بودجه/هزینه (مقدار نمایشی با فیلتر ppm_projects_total_budget_display).
  • هشدار مهلت: پایان در ۷ روز آینده با لینک به پروژه.
  • نمودارها (Chart.js): توزیع وضعیت پروژه، پروژهٔ فعال به‌ازای مالک، روند ۱۲ ماهه، وظایف باز در برابر بسته.

پروژه‌ها

  • لیست با جستجو، فیلتر، مرتب‌سازی، صفحه‌بندی و خروجی CSV.
  • فیلدها: عنوان، اسلاگ، وضعیت (draft، planning، in_progress، on_hold، completed)، مالک، تاریخ شروع/پایان، پیشرفت ۰–۱۰۰، دسته، برچسب، آرشیو.
  • meta_json: اعضای تیم با نقش، پنج فاز PM، هویت بصری (لوگو، رنگ‌ها)، پیوست‌های رسانه.
  • جریان ایجاد چندمرحله‌ای؛ حالت ویرایش/مشاهده با خلاصهٔ فقط‌خواندنی برای بینندگان.

وظایف

  • لیست وظایف در سطح پروژه از مسیر ادمین.
  • مدل: عنوان، باز/بسته، کلید ستون کانبان، تاریخ سررسید اختیاری (Y-m-d).
  • فیلتر بر اساس پروژه در جاهایی که UI پشتیبانی می‌کند.
بورد تجمیعی

کانبان تیمی

یک بورد برای وظایف چندپروژه‌ای؛ ستون‌ها تا ۱۲ مورد قابل پیکربندی (کلید، عنوان، نمایش دکمهٔ افزودن سریع). جابه‌جایی و ویرایش از طریق AJAX با nonce.

اقدام‌های AJAX (نمونه) POST admin-ajax — ppm_kanban_move_card

همچنین ppm_kanban_save_card (با nonce به‌ازای وظیفه) و ppm_kanban_delete_card.

Drag & Drop

کارت بین ستون‌ها؛ به‌روزرسانی ستون کانبان در سرور.

مودال ویرایش

عنوان، سررسید و سایر فیلدهای پشتیبانی‌شده.

پس‌زمینه

رنگ و تصویر از تنظیمات کانبان برای ظاهر بورد.

تقویم کاری

رویدادها از بازهٔ تاریخ پروژه‌ها و سررسید وظایف ساخته می‌شوند؛ در بک‌اند تاریخ میلادی Y-m-d؛ رابط ممکن است شمسی نشان دهد. فیلتر نوع: all، projects، tasks و در صورت نیاز project_id.

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

تنظیمات (سه تب)

ذخیره در جاهایی که اعمال شده نیازمند قابلیت ppm_manage_projects است.

تب محتوا
نوار کناری نمایش نوار به‌ازای صفحه، لوگو، نام سازمان، شعار.
کانبان رنگ و تصویر پس‌زمینهٔ بورد.
صفحات رنگ پس‌زمینهٔ #wpbody-content برای اسلاگهای مجاز.

نقش‌ها و امنیت

در فعال‌سازی/ارتقا، نقش مدیرکل این قابلیت‌ها را دریافت می‌کند؛ برای سایر نقش‌ها می‌توان با ویرایشگر نقش یا کد اختصاصی اعمال کرد.

Capability کاربرد
ppm_manage_projects CRUD پروژه و بخش‌هایی از تنظیمات که نیاز به آن دارند.
ppm_view_projects لیست، تک‌پروژه، کانبان، تقویم، نماهای دفترچه.
ppm_manage_tasks مدیریت وظایف (در جاهای مرتبط، مدیریت پروژه نیز کفایت می‌کند).
  • Nonce روی فرم‌های تنظیمات و درخواست‌های AJAX؛ permission callback روی REST.

مرجع REST API (ppm/v1)

نمونهٔ مستندشده در README: رویدادهای تقویم برای کاربران احراز‌هویت‌شده با مجوز مناسب.

مسیر متد توضیح
/wp-json/ppm/v1/calendar-events GET پارامترهای معمول: from، to، اختیاری project_id، types (all | projects | tasks).

دیتابیس و ارتقا

  • {prefix}ppm_projects — پروژه‌ها و meta_json.
  • {prefix}ppm_tasks — وظایف با project_id، ستون کانبان، due_date.
  • ایجاد/به‌روزرسانی با dbDelta؛ همگام‌سازی از طریق PPM_Activator::maybe_upgrade() هنگام تغییر نسخهٔ داخلی.

نقشهٔ راه (جای‌نگهدار)

  • منوی تیم — صفحهٔ placeholder.
  • منوی گزارش‌ها — صفحهٔ placeholder.
نصب در وردپرس

مسیر پوشهٔ افزونه

پوشه را در مسیر زیر قرار دهید یا از پیشخوان ZIP بارگذاری کنید؛ سپس از افزونه‌ها فعال‌سازی کنید تا جداول ساخته شوند.

Relative path
wp-content/plugins/persian-project-management/

نام فایل اصلی افزونه در مخزن: persian-project-management.php — پس از فعال‌سازی، منو و صفحات پیشخوان افزونه در دسترس است.