Plugin Settings
Create the required pages
Before customizing the various settings, you need to create the pages used by the plugin to handle confirmations, payment results, and return messages. You may name these pages as you prefer; the important part is adding the correct shortcode.
For this example, we will create three pages:
1. Confirmation Page
Contains the shortcode:
This page is used when online payments are disabled. The guest receives an email containing a tokenized link and, by opening the page, confirms the reservation.
2. Success Contains the shortcode:
This page is displayed after a successful Stripe payment.
3. Cancel Contains the shortcode:
This is the destination page shown when the user cancels or interrupts the Stripe payment process.
Once these pages have been created and the shortcodes added, you can proceed to configure the plugin settings. The Settings page allows you to manage all global options of the Simple BnB Rental plugin, organized into different sections.
License
- License key – Enter the license key provided at the time of purchase.
- Status – Displays whether the license is valid or inactive.
General
Basic settings that affect all rooms and reservations.
| Option | Description |
|---|---|
| Check-in after (global) | Global check-in time (e.g., 15:00). Can be overridden for individual rooms. |
| Check-out before (global) | Global check-out time (e.g., 10:00). Can be overridden for individual rooms. |
| Currency | Currency used for prices (e.g., EUR, USD, GBP). All prices will be displayed and calculated in this currency. |
| Show rooms before search | If enabled, all rooms are shown when the page loads and filtered only after selecting the dates. |
| Hold inventory for pending reservations | Temporarily blocks room availability while the reservation is pending. Useful to prevent double bookings during payment or confirmation. |
| Pending timeout (minutes) | Maximum duration (in minutes) that a pending reservation remains valid. After this limit, it is automatically canceled and availability is released. |
Note: Rooms inherit the global check-in/check-out times, but they can be overridden in the individual room settings.
Configuration of automatic notifications for administrators and guests.
| Option | Description |
|---|---|
| Confirmation page | The site page containing the [simpbnb_confirm] shortcode. This is what guests see after confirming a booking. |
| Email format | Choose whether to send emails in HTML or plain text format. |
| Admin notification | Enable or disable the administrator notification. You can specify multiple email addresses separated by commas; if left empty, the site administrator’s email address will be used. |
| Guest confirmation | Enable or disable the confirmation email sent to the guest. |
| Admin subject / body | Subject and message body for the email sent to the administrator. |
| Guest subject / body | Subject and message body for the email sent to the guest. |
Available placeholders:
{site_name}, {reservation_id}, {room_name}, {checkin_date}, {checkout_date}, {nights}, {adults}, {children}, {total_price}, {customer_name}, {customer_email}, {customer_phone}, {admin_url}
Payments (Stripe)
Optional section to enable online payments with Stripe Checkout.
| Option | Description |
|---|---|
| Enable online payments | Enables integration with Stripe Checkout. |
| Charge mode | Payment mode: Full amount or Deposit. |
| Deposit (%) | Deposit percentage to request, if enabled. |
| Stripe publishable key / secret key | API keys obtained from your Stripe account. |
| Stripe webhook signing secret | Key used to verify Webhook notifications (from Developers → Webhooks in your Stripe dashboard). |
| Success page | Page displayed after a successful payment. |
| Cancel page | Page displayed when the user cancels or abandons the payment. |
| Cancel page – Back to search link | URL for the “Back to search” link on the cancellation page. |
| Cancel page – Contact us link | URL for the “Contact us” link on the cancellation page. |
By default, rooms inherit the global time settings. You can override them per room by specifying the corresponding fields; leave blank to inherit the global time.
Pending Reservation Logic
During this status, the availability of the room may or may not be blocked, depending on the settings. A periodic cron job automatically cancels expired pending reservations, freeing up availability.
Find more information in the Cron and pending section.
Screenshot
