mercator/wn-flatreservation-plugin

Holiday flat reservation management for WinterCMS.

dev-main 2026-04-26 12:28 UTC

Requires

• php: >=8.2

MIT

• Helmut Kaufmann

README

A WinterCMS plugin for managing holiday flat reservations, bookings, and availability.

Features

• Multi-flat support
• Per-flat same-day handover setting
• Overlap validation (prevents double-booking)
• Backend and frontend reservation management
• Calendar and list views
• ICS feed support
• .block file support for maintenance/blackout periods

Installation

Composer

Install via Composer:

composer require mercator/wn-flatreservation-plugin

Then run migrations:

php artisan winter:up

Enable the plugin in the WinterCMS backend.

Manual

1. Place this plugin in plugins/mercator/flatreservation.
2. Run migrations: php artisan winter:up
3. Enable the plugin in the WinterCMS backend.

Usage

• Manage flats and reservations in the backend.
• Each flat can enable/disable same-day handover (check-in and check-out on the same day).
• The plugin prevents overlapping bookings according to the flat's handover setting.
• Use the frontend component to display a reservation dashboard, calendar, and booking form.
• Add .block files in the plugin directory to define maintenance or blackout periods (see docs for format).
• ICS feeds are available for calendar integration.

Winter Block: Flat Reservation Overview

The block Flat Reservation Overview is used to define or customize the availability overview display for flats.

License

MIT