یادداشت و Kanban در پیشخوان وردپرس

Admin Sticky Notes

مدیریت یادداشت‌های چسبان، کارها (Todo) و بورد Kanban به سبک Trello — فقط داخل ناحیهٔ مدیریت؛ بدون بار روی سایت عمومی. فیلتر، جستجو، یادداشت عمومی برای مدیران، چک‌لیست، سررسید، ویجت داشبورد و رابط AJAX.

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

توسعه‌دهنده

Alireza Aminzadeh

مجوز

GPLv2+

پیش‌نیاز

WP 5.0+ · PHP 7.2+

محدودهٔ بارگذاری

فقط پیشخوان

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

Admin Sticky Notes راهکار یادداشت‌برداری و مدیریت کار برای مدیران وردپرس است؛ طبق توضیحات رسمی افزونه، می‌توانید بدون ترک پیشخوان کارها را مثل Trello سازماندهی کنید. نسخهٔ ثبت‌شده در هدر افزونه: 2.0.0 — Text domain: admin-sticky-notes.

  • حداقل وردپرس ۵٫۰ و PHP ۷٫۲ (طبق header افزونه).
  • README وردپرس.org: تست تا ۶٫۷.
  • استایل و اسکریپت افزونه فقط روی صفحات مربوط به Sticky Notes و ویجت داشبورد بارگذاری می‌شود — برای بازدیدکنندهٔ سایت بار اضافه ندارد.
این برگهٔ تم: فقط معرفی و مستندات است؛ دادهٔ واقعی یادداشت‌ها در جداول دیتابیس افزونه و از پیشخوان قابل دسترسی است.

منو و صفحات پیشخوان

منوی سطح‌اول با آیکن dashicons-sticky و عنوان «Sticky Notes»؛ زیرمنوها:

  • All Notes — لیست/یادداشت چسبان با قابلیت جابه‌جایی (draggable) و فیلترها؛ دسترسی edit_posts.
  • Kanban Board — بورد ستونی با کشیدن کارت؛ همان سطح دسترسی.
  • Settings — تنظیمات عمومی؛ manage_options.
  • صفحهٔ پنهان admin-sticky-notes-kanban-setup برای عیب‌یابی/راه‌اندازی Kanban (فقط مدیر).

مدیریت یادداشت‌ها (طبق README و کد)

  • ایجاد، ویرایش و حذف یادداشت؛ عنوان اجباری است.
  • چک‌لیست Todo با پیگیری پیشرفت (فیلد checklist در دیتابیس).
  • سطوح اولویت: پایین، متوسط، بالا، فوری (urgent).
  • ۶ رنگ کارت: زرد، آبی، سبز، صورتی، نارنجی، بنفش — پیش‌نمایش زنده در فرم.
  • دسته و برچسب؛ سررسید با تقویم؛ نوع یادداشت (مثلاً note / todo).
  • یادداشت خصوصی (فقط مالک) در برابر یادداشت عمومی (برای کاربران دارای edit_posts در کوئری).
  • موقعیت چسبان position_x / position_y و حالت کمینه‌شده.

بورد Kanban

طبق README: بورد دیداری شبیه Trello با قابلیت‌های زیر.

  • ستون‌های پیش‌فرض: To Do، In Progress، Review، Done.
  • ستون‌های سفارشی نامحدود؛ رنگ ستون؛ شمارنده کارت در هدر ستون.
  • کشیدن کارت بین ستون‌ها و مرتب‌سازی داخل ستون؛ کشیدن عنوان ستون برای تغییر ترتیب.
  • دکمهٔ افزودن کارت سریع در هر ستون؛ ویرایش/حذف ستون سفارشی (کارت‌ها به اولین ستون منتقل می‌شوند).
  • ذخیره در فیلدهای column_id و board_position.

ویجت داشبورد

  • نمایش آمار: تعداد کل، فعال، تکمیل‌شده.
  • لیست یادداشت‌های فعال اخیر (محدودیت تعداد از تنظیمات، پیش‌فرض ۵).
  • لینک به صفحهٔ «همهٔ یادداشت‌ها».

تنظیمات (گزینهٔ admin_sticky_notes_settings)

فرم تنظیمات در کد افزونه این فیلدها را ذخیره می‌کند:

کلید کاربرد
default_color رنگ پیش‌فرض یادداشت جدید.
default_priority اولویت پیش‌فرض.
enable_notifications اعلان‌های پیشخوان.
enable_email_reminders یادآوری ایمیل برای سررسید.
dashboard_widget_limit تعداد یادداشت در ویجت داشبورد (۱–۲۰).
auto_save_interval فاصلهٔ ذخیرهٔ خودکار هنگام ویرایش (ثانیه).
show_on_all_admin_pages نمایش یادداشت‌های شناور در همهٔ صفحات ادمین.

فعال‌سازی

هنگام نصب، گزینهٔ پیش‌فرض kanban_view_enabled هم در آرایهٔ اولیهٔ تنظیمات ذخیره می‌شود؛ فرم فعلی صفحهٔ تنظیمات ممکن است همهٔ کلیدهای آرایه را نمایش ندهد.

اکشن‌های AJAX (پیشخوان)

همه با wp_ajax_* و nonce asn_nonce؛ یادداشت‌ها معمولاً نیازمند edit_posts هستند.

اکشن نقش
asn_get_notesدریافت لیست با فیلتر جستجو، نوع، اولویت، دسته، تکمیل
asn_save_noteایجاد/به‌روزرسانی؛ شامل column_id و board_position
asn_delete_noteحذف با بررسی مالکیت
asn_toggle_completeتغییر وضعیت تکمیل
asn_update_positionبه‌روزرسانی موقعیت چسبان روی صفحه
asn_get_kanban_dataبارگذاری ستون‌ها و کارت‌ها
asn_move_noteجابه‌جایی کارت به ستون دیگر
asn_create_columnایجاد ستون
asn_update_columnویرایش عنوان/رنگ ستون
asn_delete_columnحذف ستون غیرپیش‌فرض
asn_reorder_columnsترتیب ستون‌ها
asn_update_card_positionsترتیب کارت‌ها داخل ستون

دیتابیس

جدول یادداشت‌ها {prefix}admin_sticky_notes

  • id, user_id, column_id, title, content
  • note_type, priority, color, category, tags
  • is_public, is_completed, due_date, checklist
  • position_x, position_y, board_position, is_minimized, assigned_to
  • created_at, updated_at

جدول ستون‌های Kanban {prefix}admin_sticky_notes_columns

  • id, user_id, title, slug, color, position, is_default

زبان، ترجمه و RTL

  • زبان پیش‌فرض رشته‌ها انگلیسی؛ بستهٔ زبان فارسی admin-sticky-notes-fa_IR.po در پوشهٔ languages.
  • برای محلی fa_IR فونت Vazir از مسیر افزونه بارگذاری می‌شود.
  • فایل rtl.css برای چیدمان راست‌به‌چپ در ادمین.

امنیت (طبق README و پیاده‌سازی)

  • بررسی nonce برای درخواست‌های AJAX.
  • بررسی capability (مثلاً edit_posts، manage_options برای تنظیمات).
  • sanitize روی ورودی‌ها؛ محتوا با wp_kses_post برای فیلدهای HTML؛ خروجی با توابع escape وردپرس.
  • پرس‌وجوهای دیتابیس با $wpdb->prepare.

نصب و راه‌اندازی (خلاصهٔ README)

  1. نصب و فعال‌سازی از پیشخوان یا آپلود پوشهٔ admin-sticky-notes.
  2. README پیشنهاد می‌کند یک بار غیرفعال و دوباره فعال کنید تا جداول Kanban به‌درستی ایجاد شوند.
  3. مسیر عیب‌یابی: /wp-admin/admin.php?page=admin-sticky-notes-kanban-setup — «Run Setup Now» در صورت نیاز.
در README.org به سازگاری با چندسایته (Multisite) و آماده بودن برای ترجمه اشاره شده است.

سوالات متداول (از README.txt)

دیگران یادداشت‌های من را می‌بینند؟

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

آیا داده به سرویس بیرونی می‌رود؟

طبق بخش Privacy در README، داده در دیتابیس وردپرس شما ذخیره می‌شود.

آیا سایت عمومی کند می‌شود؟

README می‌گوید افزونه فقط در ادمین بارگذاری می‌شود و برای فرانت بهینه است.

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