افزونه نوبت‌نما | نوبت‌دهی و رزرو آنلاین وردپرس Nobatnama 1.0.0

نوبت‌نما؛ افزونه نوبت‌دهی فارسی وردپرس از کدنما

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

این افزونه برای خدمات تک‌نفره مانند ویزیت کلینیک، خدمات سالن زیبایی، مشاوره و جلسات تخصصی طراحی شده است. رابط فارسی و راست‌به‌چپ، تقویم شمسی، ظاهر سبز روشن و سفید و فونت محلی وزیرمتن، تجربه‌ای مرتب برای موبایل و دسکتاپ فراهم می‌کنند. طراحی و توسعه: آقای بیشه | برند: کدنما (Codenama) | نسخه: ۱.۰.۰

رزرو آنلاین در چهار مرحله

1. انتخاب خدمت: نمایش نام، توضیح، مدت و مبلغ هر خدمت در کارت‌های تصویری. مشتری در صورت وجود چند دسته، می‌تواند خدمات را با دسته‌بندی فیلتر کند.
2. انتخاب متخصص: فقط ارائه‌دهندگان فعال و تأییدشده مرتبط با خدمت انتخابی نمایش داده می‌شوند. کارت متخصص شامل نام، معرفی، حوزه فعالیت، شهر و تصویر پروفایل است؛ فیلتر شهر نیز در صورت وجود چند شهر در دسترس قرار می‌گیرد.
3. انتخاب روز و ساعت: مشتری در تقویم شمسی یا میلادی روز را انتخاب می‌کند و ساعت‌های آزاد همان روز، همراه با زمان پایان جلسه، از سرور دریافت می‌شوند.
4. ثبت مشخصات: نام، ایمیل، شماره تماس، یادداشت اختیاری و پذیرش شرایط دریافت می‌شود. خلاصه خدمت، متخصص، زمان و مبلغ در مسیر رزرو قابل مشاهده است.

نشانگر مراحل، بازگشت به مرحله قبل، پیام‌های خطای مشخص، حالت دریافت اطلاعات و امکان تلاش دوباره، مشتری را در مسیر رزرو همراهی می‌کنند. شماره تماس با ارقام فارسی و عربی نیز پردازش می‌شود. پس از ثبت، تأییدیه وضعیت واقعی نوبت را نشان می‌دهد؛ درخواست منتظر بررسی یا پرداخت، به‌عنوان رزرو نهایی معرفی نمی‌شود.

تعریف خدمات و تعرفه‌ها

• ساخت و ویرایش چند خدمت با نام، توضیح کوتاه و دسته‌بندی.
• تعیین مدت هر خدمت از ۵ تا ۴۸۰ دقیقه، با گام‌های ۵ دقیقه‌ای.
• تعیین زمان آماده‌سازی یا استراحت پیش و پس از جلسه؛ هر کدام از ۰ تا ۲۴۰ دقیقه، با گام‌های ۵ دقیقه‌ای.
• تعریف مبلغ هر خدمت به‌صورت عدد صحیح؛ مبلغ صفر برای خدمت رایگان قابل استفاده است.
• فعال یا غیرفعال‌کردن خدمت برای رزروهای جدید، با حفظ سابقه نوبت‌های قبلی.
• اختصاص یک خدمت به چند متخصص و اختصاص چند خدمت به یک متخصص.

برای مثال، یک مشاوره ۳۰ دقیقه‌ای با ۱۵ دقیقه فاصله پس از جلسه، علاوه بر زمان مراجعه‌کننده، فاصله لازم برای آماده‌شدن متخصص را نیز در ظرفیت رزرو لحاظ می‌کند.

متخصصان، شیفت‌ها و تعطیلی‌ها

مدیر می‌تواند برای هر ارائه‌دهنده، نام، معرفی، ایمیل، تلفن، شهر، حوزه فعالیت، نشانی تصویر پروفایل و خدمات قابل ارائه را ثبت کند. اتصال پروفایل به حساب وردپرس، دسترسی به پنل اختصاصی متخصص را فراهم می‌کند.

• برنامه مستقل برای هر روز هفته، با حداکثر ۶ بازه کاری در هر روز؛ مانند شیفت صبح و عصر.
• امکان تعطیل‌کردن یک روز هفته و افزودن تاریخ‌های تعطیلی اختصاصی.
• اعتبارسنجی بازه‌ها؛ زمان شروع باید پیش از پایان باشد و بازه‌های یک روز نباید با یکدیگر هم‌پوشانی داشته باشند.
• تعیین وضعیت فعال و تأییدشده؛ نمایش عمومی و دریافت رزرو جدید به هر دو وضعیت وابسته است.
• غیرفعال‌کردن موقت متخصص برای رزروهای جدید، با حفظ سوابق و امکان مدیریت نوبت‌های موجود برای متخصص تأییدشده.

تاریخ تعطیلی اختصاصی در فرم مدیریت با قالب میلادی YYYY-MM-DD وارد می‌شود؛ تقویم رزرو مشتری می‌تواند همچنان شمسی باشد. تغییر برنامه کاری یا تعطیلی‌ها، نوبت‌های از قبل ثبت‌شده را خودکار لغو نمی‌کند.

زمان‌های آزاد و جلوگیری از تداخل نوبت‌ها

زمان‌های شروع با گام ثابت ۱۵ دقیقه از برنامه متخصص محاسبه می‌شوند. مدت خدمت و فاصله‌های قبل و بعد، باید به‌طور کامل در یک بازه کاری جا بگیرند. حداقل فاصله تا زمان رزرو، محدوده روزهای آینده، تعطیلی‌ها و نوبت‌های موجود نیز در نتیجه لحاظ می‌شوند.

• هر متخصص در هر لحظه فقط یک جلسه می‌پذیرد؛ انتخاب خدمات متفاوت، مجوز رزرو هم‌زمان یک متخصص ایجاد نمی‌کند.
• نوبت‌های منتظر تأیید و تأییدشده و نگهداری‌های پرداخت معتبر، ظرفیت را اشغال می‌کنند.
• رزرو لغوشده و نگهداری پرداختی که مهلتش تمام شده، برای رزرو جدید ظرفیت را مسدود نمی‌کنند.
• ظرفیت هنگام ثبت نهایی دوباره در سرور بررسی می‌شود؛ قفل پایگاه داده و تراکنش، رقابت دو درخواست برای یک زمان مشترک را کنترل می‌کنند.
• ارسال دوباره همان درخواست با شناسه درخواست ثابت، نوبت دوم ایجاد نمی‌کند.

ساعت‌ها بر اساس منطقه زمانی تنظیم‌شده در وردپرس نمایش داده می‌شوند و زمان نوبت‌ها در پایگاه داده به‌صورت UTC ذخیره می‌شود. نام منطقه زمانی در رابط مشتری و پنل‌ها قابل مشاهده است.

مدیریت نوبت برای مشتری عضو و مهمان

• رزرو بدون عضویت: مراجعه‌کننده می‌تواند به‌عنوان مهمان ثبت نوبت کند.
• مدیریت مهمان با لینک شخصی: پس از ثبت، لینک خصوصی مدیریت و امکان کپی آن ارائه می‌شود. در صورت تنظیم صفحه مدیریت و فعال‌بودن ایمیل، لینک در ایمیل اولیه مشتری نیز قرار می‌گیرد.
• پنل مشتری عضو: کاربر واردشده، نوبت‌های مرتبط با حساب خودش را می‌بیند. نوبت مهمان صرفاً با واردشدن به حسابی دارای همان ایمیل، به حساب منتقل نمی‌شود؛ لینک شخصی برای مدیریت آن باقی می‌ماند.
• جزئیات قابل پیگیری: خدمت، متخصص، تاریخ و ساعت، مبلغ، وضعیت و کد پیگیری نوبت نمایش داده می‌شوند.
• لغو با تأیید مشتری: پیش از اجرای لغو، تأیید دوباره دریافت می‌شود و مهلت تعیین‌شده در سرور نیز کنترل می‌شود.
• جابه‌جایی زمان: برای نوبت‌های منتظر تأیید یا تأییدشده و پیش از پایان مهلت، انتخاب روز و ساعت جدید با حفظ همان خدمت و متخصص امکان‌پذیر است.
• حفظ نوبت قبلی: اگر زمان جدید آزاد نباشد یا جابه‌جایی ناموفق شود، نوبت قبلی حفظ می‌شود.
• ادامه پرداخت: برای نگهداری پرداخت فعال، مشتری می‌تواند پیش از پایان مهلت از پنل مدیریت به صفحه پرداخت برگردد.
• فایل تقویم: دریافت فایل ICS برای واردکردن دستی نوبت در تقویم‌های سازگار با این قالب.

پس از پایان مهلت لغو یا جابه‌جایی، رابط مشتری راهنمای تماس با کسب‌وکار را نشان می‌دهد. اگر قیمت خدمت یا واحد پول نسبت به نوبت دارای سفارش پرداخت تغییر کرده باشد، جابه‌جایی آنلاین آن نوبت انجام نمی‌شود و هماهنگی با کسب‌وکار لازم است.

پنل اختصاصی متخصص

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

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

تغییر نام، مبلغ خدمات، اتصال حساب، تأیید عمومی پروفایل و تنظیمات کلی کسب‌وکار در اختیار مدیر باقی می‌ماند.

فرم درخواست همکاری متخصص

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

درخواست جدید به‌صورت غیرفعال و تأییدنشده در بخش ارائه‌دهندگان مدیر قرار می‌گیرد. مدیر پس از بررسی، پروفایل را تأیید می‌کند و خدمات و برنامه کاری را به آن اختصاص می‌دهد. ارسال درخواست به‌تنهایی امکان دریافت نوبت ایجاد نمی‌کند و درخواست تکراری همان حساب نیز پذیرفته نمی‌شود.

پیشخوان مدیریتی و گزارش‌ها

• داشبورد با شمار نوبت‌های امروز، نوبت‌های پیش رو، درخواست‌های منتظر تأیید و ارزش نوبت‌های تأییدشده و انجام‌شده.
• نمایش آخرین نوبت‌ها و دسترسی سریع به تعریف خدمات، ارائه‌دهندگان و راهنمای راه‌اندازی.
• فهرست نوبت‌ها با فیلتر وضعیت، ارائه‌دهنده و بازه تاریخ.
• جزئیات مراجعه‌کننده، خدمت، متخصص، زمان، مبلغ، یادداشت و شناسه سفارش ووکامرس مرتبط.
• تغییر وضعیت مطابق چرخه مجاز هر نوبت و حفظ سوابق نوبت‌های بسته‌شده.
• خروجی CSV از همان فیلترهای اعمال‌شده، شامل اطلاعات تماس، خدمت، متخصص، زمان UTC و محلی، وضعیت، مبلغ، واحد پول، شناسه سفارش و یادداشت.
• راهنمای داخلی ساخت برگه‌ها و چک‌لیست آماده‌سازی سایت.
• افزودن اختیاری سه خدمت و سه ارائه‌دهنده نمونه برای کلینیک، سالن و مشاوره؛ تنها با اقدام صریح مدیر، بدون ساخت نوبت یا مشتری مصنوعی.

فهرست مدیریتی و خروجی CSV حداکثر آخرین ۲۰۰ نتیجه مطابق فیلتر را ارائه می‌کنند. پنل مشتری آخرین ۱۰۰ نوبت حساب و پنل متخصص آخرین ۱۰۰ نوبت هر پروفایل را بارگذاری می‌کنند. شمارهای داشبورد مدیریتی از کل سوابق محاسبه می‌شوند؛ مبلغ داشبورد، ارزش ثبت‌شده نوبت‌های تأیید یا انجام‌شده است و گزارش خالص مالی، تسویه یا سود محسوب نمی‌شود.

وضعیت‌های نوبت و تأیید درخواست‌ها

تأیید خودکار یا دستی برای پرداخت در محل و خدمات رایگان قابل تنظیم است. در خدمات پولی با پرداخت آنلاین، تأیید نهایی به پرداخت معتبر وابسته است؛ مدیر یا متخصص نمی‌تواند نوبت منتظر پرداخت را از طریق تغییر وضعیت معمول، پرداخت‌شده تأیید کند.

پرداخت در محل و اتصال اختیاری ووکامرس

در حالت پرداخت در محل، رزرو بدون نیاز به ووکامرس انجام می‌شود. برای پرداخت آنلاین، ووکامرس فعال و درگاه تنظیم‌شده سایت استفاده می‌شوند. افزونه برای هر رزرو پولی، سفارش مربوط به همان نوبت را با مبلغ محاسبه‌شده در سرور می‌سازد و سبد خرید عادی فروشگاه را تغییر نمی‌دهد.

• نگهداری زمان برای ۱۵ دقیقه از زمان ایجاد نوبت؛ ساخت صفحه پرداخت، این مهلت را تمدید نمی‌کند.
• تأیید پس از پرداخت موفق با بررسی ارتباط سفارش، مبلغ، واحد پول و معتبر بودن مهلت نگهداری.
• امکان بازگشت به پرداخت تا زمانی که نگهداری و سفارش مربوط معتبر باشند.
• نمایش خطای آماده‌سازی پرداخت با حفظ نوبت ثبت‌شده و لینک مدیریت، برای پیگیری یا تلاش دوباره در مهلت باقی‌مانده.
• آزادشدن ظرفیت نگهداری پس از پایان مهلت، حتی اگر اجرای زمان‌بندی وردپرس با تأخیر انجام شود.
• علامت‌گذاری پرداخت دیرهنگام یا نامنطبق برای بررسی مدیر؛ چنین پرداختی نوبت بسته یا منقضی‌شده را خودکار احیا نمی‌کند.
• ارتباط وضعیت ناموفق یا لغوشده سفارش با نگهداری در انتظار پرداخت و لغو نوبت فعال مرتبط پس از بازگشت کامل وجه سفارش.
• پشتیبانی از ذخیره‌سازی سفارش‌های ووکامرس با HPOS.

واحد پول نوبت‌نما و ووکامرس باید دقیقاً یکسان باشد؛ تومان و ریال متفاوت هستند. لغو نوبت، بازگشت وجه خودکار انجام نمی‌دهد و مدیر باید بازپرداخت احتمالی را طبق سیاست کسب‌وکار در ووکامرس بررسی کند. درگاه، حساب پذیرنده و اشتراک سرویس پرداخت در بسته افزونه ارائه نمی‌شوند.

ایمیل، یادآوری و امکان توسعه اطلاع‌رسانی

• ارسال ایمیل ثبت نوبت و تغییر زمان یا وضعیت به مشتری؛ اعلان‌های ثبت و تغییر برای ایمیل مدیر سایت و متخصص مربوط نیز ارسال می‌شوند.
• اطلاعات ایمیل شامل کد پیگیری، خدمت، متخصص، زمان محلی، منطقه زمانی و وضعیت است.
• ارسال لینک خصوصی مدیریت فقط در اعلان اولیه مشتری و در صورت تعیین صفحه مدیریت؛ این کلید برای مدیر و متخصص ارسال نمی‌شود.
• یادآوری ایمیلی نوبت‌های تأییدشده به مشتری، در بازه قابل تنظیم پیش از جلسه.
• امکان خاموش‌کردن ایمیل‌ها و غیرفعال‌کردن یادآوری با مقدار صفر.
• رویدادهای برنامه‌نویسی برای ثبت نوبت، تغییر نوبت، نتیجه اطلاع‌رسانی و پرداخت نیازمند بررسی؛ قابل استفاده برای اتصال اختصاصی توسط توسعه‌دهنده.

ارسال از wp_mail و تنظیمات ایمیل سایت استفاده می‌کند؛ تحویل ایمیل به پیکربندی صحیح ارسال یا SMTP وابسته است. بررسی یادآوری‌ها با WP-Cron هر ۳۰ دقیقه انجام می‌شود، بنابراین زمان ارسال دقیق به اجرای cron بستگی دارد. این نسخه اتصال آماده به پنل پیامک ندارد؛ اتصال پیامکی اختصاصی از طریق رویدادهای افزونه به توسعه و سرویس جداگانه نیاز دارد.

قواعد قابل تنظیم برای کسب‌وکار

منطقه زمانی از تنظیمات عمومی وردپرس گرفته می‌شود. تغییر واحد پول، مبلغ رزروهای قبلی را تبدیل نمی‌کند. گام ۱۵ دقیقه‌ای شروع زمان‌ها و مهلت ۱۵ دقیقه‌ای پرداخت در این نسخه ثابت هستند.

ظاهر، دسترس‌پذیری و نصب در برگه‌های وردپرس

رابط با کارت‌های خدمات، تصویر معرفی، لوگوی نوبت‌نما و تصاویر همراه برای کلینیک، سالن و مشاوره ارائه می‌شود. تصویر پروفایل متخصص قابل تعیین است و در نبود یا خطای تصویر، نمایش جایگزین در نظر گرفته شده است. فونت وزیرمتن و تصاویر رابط همراه افزونه هستند و برای بارگذاری فونت به CDN نیاز نیست.

طراحی واکنش‌گرا، کنترل‌های دارای برچسب، استفاده با صفحه‌کلید، حفظ تمرکز هنگام تغییر انتخاب‌ها و احترام به تنظیم کاهش حرکت مرورگر، بخشی از رابط هستند. می‌توانید چند نمونه کد کوتاه را در یک برگه قرار دهید؛ هر نمونه شناسه مستقل دارد.

عنوان صفحه و انتخاب اولیه خدمت یا متخصص را نیز می‌توانید با ویژگی‌های کد کوتاه تعیین کنید:

[codenama_booking service="123" provider="456" title="رزرو مشاوره"]

شناسه‌ها را با خدمت و متخصص سایت خود جایگزین کنید. این ویژگی‌ها انتخاب اولیه را مشخص می‌کنند؛ مشتری همچنان می‌تواند انتخاب را تغییر دهد و به معنی محدودکردن قطعی فهرست نیستند.

دسترسی و نگهداری اطلاعات

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

فرم‌های مدیریت از بررسی مجوز و درخواست معتبر وردپرس استفاده می‌کنند. درخواست رزرو عمومی نیز اعتبارسنجی سرور، فیلد مقابله با ربات و محدودیت تعداد درخواست دارد؛ مبلغ، مدت و مالکیت از اطلاعات معتبر سرور تعیین می‌شوند. خروجی CSV برای جلوگیری از اجرای فرمول‌های واردشده در متن آماده می‌شود و پاسخ‌های API با دستور جلوگیری از کش ارسال می‌شوند.

غیرفعال‌سازی یا حذف افزونه، سابقه مشتریان و نوبت‌ها را خودکار پاک نمی‌کند. متن پیشنهادی حریم خصوصی در ابزار وردپرس افزوده می‌شود؛ صادرکننده و حذف‌کننده خودکار اطلاعات شخصی در ابزارهای حریم خصوصی وردپرس در نسخه ۱.۰.۰ ارائه نشده است.

پیش‌نیازها و محدوده نسخه ۱.۰.۰

• زیرساخت: وردپرس ۶.۴ یا بالاتر، PHP ۷.۴ یا بالاتر و MySQL/MariaDB با InnoDB و پشتیبانی GET_LOCK.
• مرورگر: JavaScript و پشتیبانی Intl برای نمایش تقویم شمسی؛ افزونه PHP Intl اختیاری است.
• نوع ظرفیت: جلسه تک‌نفره برای هر متخصص؛ رزرو گروهی و ظرفیت چندنفره یک ساعت ارائه نشده است.
• ساختار کسب‌وکار: چند متخصص و شهر قابل تعریف هستند، اما سیستم مستقل شعب با قواعد و تنظیمات جداگانه وجود ندارد.
• شیفت‌ها: بازه کاری باید داخل یک روز باشد؛ شیفت عبوری از نیمه‌شب پشتیبانی نمی‌شود.
• تقویم خارجی: فایل ICS قابل دریافت است؛ همگام‌سازی دوطرفه خودکار با تقویم خارجی ارائه نشده است.
• خدمات بیرونی: ایمیل، پرداخت و اتصال اختصاصی پیامک به تنظیمات یا سرویس مربوط نیاز دارند؛ حساب درگاه، SMTP و پنل پیامک در بسته نیستند.
• کش: برگه‌های رزرو و پنل‌ها و مسیر /wp-json/codenama-booking/v1/ باید از کش کامل صفحه کنار گذاشته شوند.

پس از نصب، منطقه زمانی را تنظیم کنید، خدمات و متخصصان تأییدشده را بسازید، برنامه کاری را تعیین کنید و کدهای کوتاه را در برگه‌های دلخواه قرار دهید. صفحه مدیریت مشتری را در تنظیمات انتخاب کنید و پیش از استفاده عمومی، رزرو، ایمیل، لغو، جابه‌جایی و در صورت فعال‌سازی، درگاه واقعی سایت خود را آزمایش کنید.

نوبت‌نما یک افزونه مستقل کدنما، توسعه‌یافته توسط آقای بیشه است. بسته شامل ZIP قابل نصب، رابط فارسی، تصاویر و فونت محلی و راهنمای راه‌اندازی است. کد افزونه با مجوز GPL-2.0-or-later و فونت وزیرمتن با مجوز SIL Open Font License ارائه می‌شوند.