Reservair/README.md

Reservair

A WordPress plugin for managing reservations and bookings. Visitors submit reservation requests through a Gutenberg block; administrators manage everything through a dedicated admin panel.

Requirements

• WordPress 6.7+
• PHP 7.4+
• Composer
• Node.js / npm

Admin Menu

Page	Slug	Description
Reservations (root)	reservations-settings	Services — the reservable resources
Timetables	timetable-settings	Time-block schedules with capacity and repeating windows
Forms	forms-settings	Custom reservation form definitions
Reservations	reservations-list	All submissions with accept / reject actions
Google Calendar	rsv-google-calendar	OAuth2 connect and webhook configuration

REST API

All routes are registered under the reservations/v1 namespace.

Resource	Controller
/service	RsvServicesController
/service-type	RsvServiceTypeController
/reservation	RsvReservationController
/timetable	RsvTimetableDefinitionController
/timetable/availability	RsvTimetableAvailabilityController
/timetable/capacity	RsvTimetableCapacityController
/timetable/reservation	RsvTimetableReservationController
/form	RsvFormController
/form-definition	RsvFormDefinitionController
/google-callback	OAuth2 redirect handler
/google-calendar-hook	Google Calendar push notification webhook

Linting

Static analysis is handled by Psalm and covers both src/ (frontend PHP) and includes/ (plugin PHP).

vendor/bin/psalm

Pre-existing issues are suppressed in psalm-baseline.xml. New code must introduce no new errors — any issue not in the baseline will cause a non-zero exit.

Updating the baseline — after intentionally fixing pre-existing issues, shrink the baseline so they don't regress:

vendor/bin/psalm --update-baseline

Psalm is part of the lint Composer script, alongside phpcs and phpstan (those require separate installation):

composer run lint

Running Tests

See tests/README.md for setup and usage.

Build

npm install
npm run build

composer install