Complete setup and practitioner scheduling manual for ReservePress Wellness (Plugin v1.0.17 & Theme v1.2.7) — built for massage therapy clinics, day spas, holistic studios, and multi-practitioner wellness centres.
Before installing ReservePress Wellness, confirm your server meets the following requirements: Requirement
Minimum
WordPress
PHP
MySQL / MariaDB
MySQL 5.7+ or MariaDB 10.3+
HTTPS
Required for Stripe payments (strongly recommended for all installs)
Pretty Permalinks
Must be enabled — Settings → Permalinks → any option except Plain
WP Memory Limit
128 MB minimum; 256 MB recommended
Optional: Stripe Account
Required only if you want to collect online payments or deposits. Not required for pay-in-clinic (cash/card on arrival) workflows.
/wp-content/plugins/ via FTP or your host's file manager.The plugin automatically creates 8 custom database tables prefixed with wp_rpsal_ (or your configured prefix). Custom capabilities are added to the Administrator role. No existing WordPress data is modified.
wp_rpsal_serviceswp_rpsal_service_categorieswp_rpsal_staffwp_rpsal_staff_hourswp_rpsal_appointmentswp_rpsal_clientswp_rpsal_promotionswp_rpsal_blocked_timesFollow these steps in order after activating the plugin. Completing each step before the next ensures the booking widget works correctly from day one.
Go to RP Wellness → Settings and fill in the General section:
Go to RP Wellness → Services and click the Categories tab. Categories group services in the booking widget (e.g. Massage, Facial, Bodywork). You can skip this step and add services without categories.
Go to RP Wellness → Services → Add New Service. Fill in:
[rpwel_services] shortcode.Go to RP Wellness → Staff → Add New Staff Member. Fill in:
Go to RP Wellness → Staff, click a staff member's name, then click Set Hours. Configure working days and time ranges for each day of the week. The booking widget only shows available slots within these hours.
Staff with no hours configured will show no available slots in the booking widget. Hours apply to the staff member's local timezone as configured in WordPress Settings → General.
Create the following pages in WordPress → Pages → Add New. The slug (URL) must match exactly for the plugin's links to work correctly.
Page Title
Slug
Content / Notes
Book Appointment
book-appointment
Add shortcode [rpwel_booking_widget] or use Booking Page template (ReservePress Wellness theme).
My Appointments
my-appointments
Add shortcode [rpwel_my_appointments]. Guests access via email link; logged-in users see their bookings automatically.
Services
services
Add [rpwel_services] shortcode or use the Services Page template (ReservePress Wellness theme).
After creating pages, go to RP Wellness → Settings → General and update the My Appointments URL field with the full URL of your My Appointments page.
All shortcodes can be added to any WordPress page, post, or widget area. They automatically enqueue the required CSS and JavaScript. No additional setup is needed beyond placing the shortcode in your content.
The plugin registers both rpwel_ and rpsal_ prefixes for all shortcodes. Either prefix works identically.
[rpwel_booking_widget][rpwel_booking_widget service_id="3"][rpwel_booking_widget staff_id="2" title="Book with Sarah"]The primary booking shortcode. Renders a fully interactive multi-step booking flow:
Attribute
Default
Description
service_id
0
Pre-select a service by ID. Widget skips Step 1 if set.
staff_id
0
Pre-select a staff member by ID. Widget skips Step 2 if set.
title
Book an Appointment
Heading displayed at the top of the widget.
[rpwel_services][rpwel_services columns="2" category_id="1"][rpwel_services show_price="false" show_book_button="true"]Displays a responsive grid of active services with name, price, description, and a Book Now button. Attribute
Default
Description
category_id
0
Filter by service category ID. Shows all categories if omitted.
columns
3
Number of columns in the grid (1–4).
show_price
true
Show or hide the service price.
show_book_button
true
Show or hide the Book Now button.
[rpwel_service id="5"]Displays a single service by its ID — name, description, duration, and price. Useful for dedicated service landing pages.
Attribute
Default
Description
id
0 (required)
The ID of the service to display. Find IDs in RP Wellness → Services.
[rpwel_staff][rpwel_staff columns="4"]Displays all active staff members in a grid with photo, name, title, bio, and a Book with Me button. Attribute
Default
Description
columns
3
Number of columns in the grid.
[rpwel_my_appointments]Displays a client's appointment history. Behaviour depends on login status:
This shortcode requires the My Appointments page to be created and its URL saved in RP Wellness → Settings → General. Without this, the confirmation email's View My Appointments link will not work.
[rpwel_promotions]Displays all currently active promotions with their discount code, description, and validity. Promotion codes can be entered by clients during the booking checkout step.
[rpwel_availability_calendar service_id="1"][rpwel_availability_calendar service_id="1" staff_id="2"]Displays a read-only month calendar highlighting available dates for a given service and optionally a specific staff member. Useful on service or staff landing pages. Attribute
Default
Description
service_id
0 (required)
The service to check availability for.
staff_id
0
Optionally restrict to a specific staff member.
The RP Wellness menu appears in the WordPress admin sidebar. It contains the following sections:
[rpwel_promotions] shortcode.All settings are at RP Wellness → Settings. The settings screen is divided into seven tabs. Each tab saves independently — click Save Settings within each tab.
Setting
Description
rpsal_salon_name
Your clinic name — appears in email notifications and the booking widget.
rpsal_salon_email
Reply-to email address for all client-facing emails.
rpsal_salon_phone
Clinic phone number — included in confirmation emails.
rpsal_theme_style
auto = inherit active theme CSS variables. off = always use plugin default colours.
rpsal_my_appts_url
Full URL of the My Appointments page. Required for email confirmation links.
Setting
Description
rpsal_min_advance_hours
Minimum hours in advance a client can book. Default: 2.
rpsal_max_advance_days
How far ahead clients can book. Default: 60 days.
rpsal_slot_interval
Interval between time slots shown in the widget. Default: 30 minutes.
rpsal_cancellation_hours
Hours of notice required for cancellation.
rpsal_allow_guest_booking
Allow bookings without a WordPress account. Recommended: on.
rpsal_require_phone
Make the phone field required at checkout.
Setting
Description
rpsal_gratuity_enabled
Show a gratuity/tip selector at checkout. Only available when Stripe is enabled.
rpsal_gratuity_presets
Comma-separated tip percentages shown as quick-select buttons. Default: 15,18,20.
rpsal_gratuity_default
Pre-selected tip percentage. Leave blank for none.
Setting
Description
rpsal_payment_mode
full = charge full amount at booking. deposit = charge deposit only. none = pay in clinic.
rpsal_stripe_enabled
Enable Stripe payment processing.
rpsal_stripe_test_mode
on = use test API keys. off = use live keys.
rpsal_stripe_pub_key_live
Stripe live publishable key (starts with pk_live_).
rpsal_stripe_secret_live
Stripe live secret key (starts with sk_live_). Never share this key.
rpsal_stripe_pub_key_test
Stripe test publishable key (starts with pk_test_).
rpsal_stripe_secret_test
Stripe test secret key (starts with sk_test_).
rpsal_stripe_webhook_secre t
Stripe webhook signing secret (starts with whsec_). Required for payment confirmation.
Setting
Description
rpsal_tax_enabled
Apply tax to service prices at checkout.
rpsal_tax_rate
Tax percentage (e.g. 13 for 13% HST).
rpsal_tax_name
Label shown at checkout (e.g. HST, GST, VAT).
rpsal_tax_inclusive
on = prices already include tax. off = tax added on top.
Setting
Description
rpsal_currency
ISO currency code. Default: CAD.
rpsal_currency_symbol
Symbol displayed with prices. Default: $.
rpsal_currency_position
before = $10.00. after = 10.00$.
rpsal_currency_decimals
Number of decimal places. Default: 2.
Setting
Description
rpsal_email_from_name
Sender name for all plugin emails.
rpsal_email_from_address
Sender email address.
rpsal_email_confirmation
Send a confirmation email to the client after booking.
rpsal_email_reminder
Send a reminder email before the appointment.
rpsal_email_reminder_hours
Hours before the appointment to send the reminder. Default: 24.
rpsal_email_cancellation
Send a cancellation notice to the client.
rpsal_smtp_host
SMTP server hostname (e.g. smtp.sendgrid.net).
rpsal_smtp_port
SMTP port. Common values: 587 (TLS), 465 (SSL).
rpsal_smtp_username
SMTP account username.
rpsal_smtp_password
SMTP account password.
rpsal_smtp_encryption
tls or ssl.
WordPress default email (wp_mail) is often blocked by hosting providers. Use a transactional email service such as SendGrid, Mailgun, or Postmark for reliable delivery. Enter the SMTP credentials in the fields above, or use a dedicated SMTP plugin if preferred.
ReservePress Wellness adds custom capabilities to the WordPress role system. Administrators receive all capabilities automatically on activation. You can assign individual capabilities to other roles using a role management plugin such as User Role Editor.
Capability
Description
Admin
Manager*
Recept.*
manage_rpsal_appointments
View, create, edit appointments
✓
✓
✓
edit_rpsal_appointments
Edit existing appointments
✓
✓
✓
delete_rpsal_appointments
Delete appointments
✓
✓
manage_rpsal_services
Manage services and categories
✓
✓
edit_rpsal_services
Edit service details
✓
✓
manage_rpsal_staff
Manage staff members and hours
✓
✓
manage_rpsal_settings
Access plugin settings
✓
✓
view_rpsal_reports
View revenue and booking reports
✓
✓
view_rpsal_calendar
View the calendar screen
✓
✓
✓
access_rpsal_frontend
Access the Front Desk interface
✓
✓
✓
* Manager and Receptionist are not created automatically. Assign capabilities to existing roles using a role editor plugin.
The Front Desk is a dedicated interface designed for in-clinic use — reception tablets, front desk computers, or any staff-facing screen. It is separate from the WordPress admin and accessible at: https://yoursite.com/?rpsal_front_desk=1
The interface includes:
The Front Desk interface requires the access_rpsal_frontend capability. Administrators have this by default. Assign it to receptionist or manager roles as needed.
The plugin sends the following emails automatically. All emails are sent via the SMTP settings configured in RP Wellness → Settings → Email.
Trigger
Recipient
Booking Confirmation
Immediately after a successful booking
Client
Appointment Reminder
N hours before the appointment (configurable)
Client
Cancellation Notice
When an appointment is cancelled
Client
Reminder emails require a WP-Cron job to fire. On most shared hosts this works automatically. For high-traffic or mission-critical reminders, configure a real cron job on your server: */5 * * * * curl -s https://yoursite.com/wp-cron.php?doing_wp_cron > /dev/null
Step 1: Create a Stripe Account
Go to stripe.com and create or log in to your account. Complete business verification if required for live payments.
Step 2: Get Your API Keys
In the Stripe dashboard, go to Developers → API Keys. Copy your Publishable key and Secret key. Start with test mode keys (pk_test_… and sk_test_…) for initial setup.
Step 3: Enter Keys in Plugin Settings
Go to RP Wellness → Settings → Payments. Enable Stripe and check Test Mode. Paste your test keys into the Test Publishable Key and Test Secret Key fields. Save settings.
Step 4: Set Up Webhook
In Stripe dashboard go to Developers → Webhooks → Add Endpoint. Endpoint URL: https://yoursite.com/wp-json/rpsal/v1/stripe-webhook. Select events: payment_intent.succeeded and payment_intent.payment_failed. Copy the Signing Secret and paste it into the Stripe Webhook Secret field in plugin settings.
Step 5: Test a Payment
Make a test booking on your site. Use Stripe test card 4242 4242 4242 4242 with any future expiry and any CVC. Confirm the booking appears in RP Wellness → Appointments with payment status Paid. When ready for live payments, switch off Test Mode and replace with live API keys.
Never paste your Stripe secret key anywhere public or in version control. The webhook secret prevents fraudulent payment confirmation requests. HTTPS is required for Stripe to function on live sites.
The ReservePress Wellness Theme (v1.2.7) is the official companion theme for ReservePress Wellness. It is designed to work out of the box with the plugin — no manual shortcode setup required for the Booking or Services pages.
Page Title
Slug
Template
Home (set as front page)
/
Front Page
Services
services
Services Page
About
about
About Page
Contact
contact
Contact Page
Book Appointment
book-appointment
Booking Page
Go to Appearance → Customize to access all theme options. The Customizer is organised into the following sections:
Section
What you can configure
Typography
Font pairing (5 curated options). Only the selected pair is loaded from Google Fonts.
Clinic Information
Clinic name, tagline, phone, email, address, hours, and Book Now URL.
Homepage — Hero
Eyebrow, heading, subtext, both CTA buttons, meta card labels, hero image, and feature card overrides.
Homepage — Sections
Treatment cards (3), about teaser text and image, CTA band text.
Testimonials
Section heading plus up to 3 testimonials (quote, name, role each).
About Page
Practitioner name and title, header photo, story section (3 paragraphs + photo), 4 credentials.
Colours
Sage, Sage Dark, Terracotta, Background, Body Text, and Front Desk sidebar colour.
ReservePress Wellness Theme Lite is a minimal booking shell included free with every ReservePress Wellness purchase. It is designed for clinics whose main website runs on a non-WordPress platform such as Shopify, Squarespace, or Wix — where you need a clean, branded booking experience without building a full WordPress site.
Install WordPress in a subfolder of your domain (e.g. yourdomain.com/book/). Theme Lite turns that subfolder into a self-contained booking portal — nothing more. Visitors who land on your booking URL see only the booking form and a confirmation/appointments page. The header shows your logo, which links back to your main site.
Go to Appearance → Customize. Theme Lite exposes four options only: Option
Description
Logo
Upload your clinic logo. Displayed in the header, links back to your main site.
Primary Colour
Accent colour applied to buttons and highlights in the booking widget.
Main Site URL
The URL your logo links to (e.g. https://yourdomain.com).
Footer Copyright
Copyright line displayed in the footer.
Theme Lite has no navigation menu, no homepage, and no marketing content. It is intentionally minimal — a booking shell only. For a full clinic website experience with a homepage, services page, staff profiles, and contact page, use the ReservePress Wellness Theme (Chapter 11).
Booking widget shows “Online booking is coming soon”
[rpwel_booking_widget] (not [rpwel_booking]).Services page shows “No services found”
[rpwel_services] is placed in the page content.For additional help, feature requests, or to report a bug, visit reservepress.ca or contact us at hello@reservepress.ca.
ReservePress Wellness is open source software licensed under the GNU General Public License v2 or later.