Rentals

Rentals adds nightly stays to Bookings, so guests can book accommodation through your KahunaCart shop. This chapter explains how to configure properties and manage stays.

Rentals requires Bookings. It uses Bookings for property records, availability, orders, customer messages and the front desk.

Create a property as a product. Add its name, price, picture, description and category. Set its Type to Booking, then set How it is booked to Nightly stay in its booking rule. This adds a date-range picker to the product page. See Products.

The product price is the nightly rate. Rate bands can override it for selected dates or apply a percentage of that price. See Rates and seasons.

Set the terms on each property. Its booking rule holds arrival and departure times, stay limits, fees, deposit terms and cancellation rules. The plugin settings provide three message timing values you can leave at their defaults. See Settings.

Before you begin

KahunaCart Bookings 1.0.0 or later, installed, enabled and configured.
KahunaCart 1.2.11 or later for rental pricing support.
Grav 2.1.0 or later, with the API plugin.
Manage Bookings and Setup (kahunacart.bookings.manage) and kahunacart.products.manage permissions for setup.
A scheduled worker running bin/plugin kahunacart work to send receipts, arrival notes, balance reminders and thank-you emails. See CLI.

GPM checks these version requirements during installation. Verify them yourself when installing by copying the plugin folder.

Rentals requires Bookings. On the Rentals store page, choose Rentals only for $149 if you already own Bookings, or Bookings + Rentals for $249. Rentals only requires a signed-in licence covering Bookings or Bookings in the same cart. The store checks this at add-to-cart and checkout:

Who	What the store says
Not signed in	"Rentals only is for stores that already have Bookings. Sign in to the account that holds your KahunaCart license, or choose Bookings + Rentals." Sign in is a link, and it brings you back to the Rentals page afterwards.
Signed in, with a licence that doesn't cover Bookings	"Your license doesn't include Bookings yet. Choose Bookings + Rentals to get both."

If the cart contains Bookings and Rentals only separately, it offers the Bookings + Rentals bundle at a $49 saving.

What it adds

Where	What appears
A booking rule	Select Nightly stay under How it is booked to edit arrival times, stay limits, guests, fees and payment terms. These use the service editor’s existing Save button.
KahunaCart → Bookings	The Rates tab shows seasonal bands on an annual timeline. It appears when a nightly property exists.
A product page	A date-range picker for arrival and departure, with a quote calculated by the store.
The admin overview	The Stays view displays bookings across a month. The front desk offers a similar fortnight or month view.
The front desk	Today’s arrivals and departures, plus a form to quote and book stays at the counter.
Notifications	Configurable arrival and thank-you emails.
A property on People and places	Calendar export and import controls for listing sites such as Airbnb, VRBO and Booking.com.

Chapter guide

Page	What it covers
Rentals	This page: what it is, what it needs and what it does not do.
Getting started	Configure a rental property manually or use the `seed rental` example.
A stay’s rules	Nightly dates, changeovers, stay limits, allowed weekdays and gap prevention.
Rates and seasons	The rate card: bands, overlaps, weekend rates, band minimums, and why a percentage is a multiplier.
Guests and fees	How many it sleeps, how many the rate covers, the extra-guest charge, the cleaning fee and the damage deposit.
Taking payment	Full payment, optional deposits, balance deadlines and cancellations.
The picker	The guest calendar, date holds and embeddable availability calendar.
The owner's side	The screens in the admin, the stays view, the front desk, and why a night is not on offer.
Messages	The arrival note and the thank-you, what each one carries, and the one place a door code is ever printed.
Channel sync	Airbnb, VRBO and Booking.com, both ways, and the one limit to understand before you rely on it.
Settings reference	The three timing numbers on this add-on's own screen, and everything that is set on the property instead.
Selling in more than one currency	A rate card and fees in each currency, and what a band with no amount does.
Developers	The model, the engine, the routes, the two tables, the jobs and the events.

Two worked examples cover common rental setups:

Page	The let
For holiday lets	A whole cottage, a summer season, Saturday changeovers and a cleaning fee.
For bed and breakfasts	Four identical doubles as one record, board basis as an option, and the gap rule off.

Permissions

Rentals uses Bookings permissions. It adds no separate permission keys.

Permission	What it allows
`kahunacart.bookings.view`	Read the rule and the rate card and change nothing.
`kahunacart.bookings.manage`	Every change: the stay rules, the rate card, the fees and anything done to a stay.
`kahunacart.bookings.desk`	The front desk, where arrivals and departures show up.

Bookings view permission allows reading rental rates. Manage permission allows editing them.

Limitations

Card holds for damage deposits. The amount appears on the listing, quote, receipt and arrival email. Collect it separately. See Guests and fees.
Recurring weekend-only minimums. Minimum stays apply year-round or within a dated rate band. You cannot set a different minimum for every Friday and Saturday.
Per-unit channel imports. An imported busy period blocks every unit on its property record. Give a room its own record and calendar links when it is listed separately on another site. See Channel sync.
Front desk payment processing. You can book a stay at the desk and review its quote, but it creates no order, deposit, balance deadline or balance reminder. Collect the To collect amount separately. A stay booked online that still owes its balance can be paid at the till with the Point of Sale add-on. Use the property’s storefront page for an online deposit. See The owner’s side.
Channel-manager APIs. Sync uses periodically refreshed iCal feeds, with no direct account-level integration. See Channel sync for the resulting delay and conflict risks.

Getting started - from an empty store to a bookable cottage
Bookings - the add-on this one sits on, and everything a stay inherits from it
Products - the product, its options, its price, its picture and who may buy it
Payments - the cart, the checkout and every provider a paid stay goes through
Orders and the admin - manage orders linked to paid stays