Nobat (نوبت) — WordPress Appointment Booking Plugin

Version: 2.2.0
Requires WordPress: 6.1+
Requires PHP: 8.0+
License: GPL-2.0-or-later
Text Domain: nobat
Author: WPROAD

A modern appointment booking system for WordPress with admin management, Persian (Jalali) calendar support, multi-schedule calendars, and a clean PHP / React architecture.

Features

• Multiple schedules — Create several calendars; more than one can be active at once
• Shortcode calendar selection — Show a specific schedule, or fall back to the latest active one
• Persian calendar — Jalali (Shamsi) dates in admin and booking UI
• User-based bookings — Appointments require a logged-in WordPress user
• Cancellation workflow — Users request cancellation; admins approve from the calendar
• Admin calendar — Weekly view with slot and appointment management
• Appointment limits — Configurable max active appointments per user (default: 3)
• Status tracking — pending, confirmed, completed, cancelled, cancel_requested with history
• REST API — Namespace nobat/v2 with admin / user permission checks
• Clean architecture — Repositories, services, controllers, DI container, PSR-4 autoload

Installation

1. Place the plugin in /wp-content/plugins/nobat/
2. Install dependencies and build assets:

cd wp-content/plugins/nobat
composer install --no-dev
npm install
npm run build

3. Activate Nobat in WordPress → Plugins
4. Tables are created/updated on activation

Quick start

1. Create and activate a schedule

1. Nobat → Add Schedule — set name, date range, duration, weekly hours
   New schedules are created inactive.
2. Nobat → Schedules → Edit — set Active when ready
   Multiple schedules may be active at the same time.
3. Optional: View Calendar from the schedules list to open that schedule in the calendar UI.

Notes for admins

• Overlapping date ranges across schedules are allowed; the admin must manage conflicts manually.
• Deactivating a schedule cancels its open appointments (pending, confirmed, cancel_requested).
• Deleting a schedule deletes all of its appointments (and related slots / working hours).

2. Add the booking form (shortcode)

Users must be logged in to book. Guests see a login prompt.

Use the booking shortcode to render the React booking UI:

Attributes

Examples

# Latest active schedule (default)
[nobat_booking]

# Specific schedule by ID (from Nobat → Schedules)
[nobat_booking schedule_id="12"]

Find schedule IDs under Nobat → Schedules.

3. Admin workflow

1. Calendar (Nobat) — weekly view; defaults to latest active schedule, or ?schedule_id= for a specific one
2. All Appointments — list and manage bookings
3. Schedules — list, edit (name / active), view calendar, delete
4. Add Schedule — create a new calendar
5. Settings — max appointments, success message, brand colors

Admin menu

Database

Five tables (prefix is your $wpdb->prefix, usually wp_):

Details: docs/DATABASE-SCHEMA.md

REST API

Base URL: /wp-json/nobat/v2

Full reference: docs/API-ENDPOINTS.md

Appointments

Schedules

Slots

Development

Prerequisites

• PHP 8.0+
• Node.js 16+ (React build)
• Composer 2.0+
• WordPress 6.1+

Workflow

composer install
npm install

# Watch mode
npm run start

# Production assets
npm run build

composer dump-autoload

Project structure

nobat/
├── nobat.php                 # Plugin bootstrap
├── includes/
│   ├── Core/                 # Container, Router, DatabaseManager, ShortcodeHandler
│   ├── Repositories/         # Data access
│   ├── Services/             # Business logic
│   ├── Controllers/          # REST handlers
│   ├── Middleware/           # Auth
│   ├── Utilities/            # Helpers (dates, slots, validation)
│   ├── Admin/                # WP_List_Table classes
│   ├── bootstrap.php         # DI registration
│   ├── admin-menu.php
│   ├── admin-page.php
│   ├── admin-settings.php
│   └── enqueue-scripts.php
├── src/
│   ├── admin/
│   │   ├── cal/              # Admin calendar (React)
│   │   └── schedule/         # Create schedule (React)
│   ├── frontend/           # Front booking UI (React)
│   ├── hooks/                # Shared React hooks
│   ├── ui/                   # Shared UI components
│   └── utils/
├── build/                    # Compiled JS/CSS (cal, schedule, frontend)
├── languages/                # i18n (.po / .mo)
└── docs/                     # Developer documentation

Architecture

1. Repository — database access
2. Service — business rules
3. Controller — REST request/response
4. DI container — wiring in includes/bootstrap.php
5. Middleware — admin / logged-in checks

See docs/ARCHITECTURE.md.

Customization

Settings (admin UI)

Configured under Nobat → Settings:

• Max active appointments per user
• Success message after booking
• Brand colors (brand, on, soft, hover)

Styling

Edit SCSS / CSS under src/, then rebuild:

• src/admin/cal/cal.scss
• src/admin/schedule/schedule.scss
• src/frontend/frontend.scss and src/frontend/soft-slot/
• src/ui/ui-components.scss

npm run build

Translation

wp i18n make-pot . languages/nobat.pot

Ship .po / .mo under languages/ (e.g. nobat-fa_IR.po). Compile with:

msgfmt -o languages/nobat-fa_IR.mo languages/nobat-fa_IR.po

Manual test checklist

• [ ] Create schedule (inactive by default)
• [ ] Activate via Edit; confirm another active schedule stays active
• [ ] Calendar without schedule_id shows latest active
• [ ] Calendar with ?schedule_id= shows that schedule
• [ ] Shortcode without schedule_id uses latest active
• [ ] Shortcode with schedule_id="N" loads schedule N
• [ ] Book as logged-in user; guest sees login prompt
• [ ] Deactivate warns and cancels open appointments
• [ ] Delete warns and removes appointments
• [ ] Cancellation request + admin handling on calendar
• [ ] Appointment limit enforced
• [ ] Jalali dates display correctly

Documentation

License

GPL-2.0-or-later

Nobat - WordPress Appointment Booking Plugin
Copyright (C) WPROAD

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

Author

WPROAD
Website: https://wproad.ir/nobat
GitHub: https://github.com/wproad/nobat