Customization
Works with any theme
The public widget ships with scoped CSS (no jQuery, no global resets leaking into your theme’s styles). It renders inside whatever container holds the shortcode, inheriting page-level width and typography.
Tested themes: Twenty Twenty-Four, Astra, GeneratePress, Blocksy, Hello Elementor. If you hit a visual conflict in a different theme, see the FAQ.
Primary color
Under Booking Manager → Settings → Appearance:
- Primary color (hex) — applies to the widget’s buttons, selected slot highlight, step indicator, and approval checkmarks.
That’s the one user-facing knob by default. Change it, save, and the widget repaints on the next page load.
Shortcode placement
[booking_manager slug="your-page-slug"]
Paste the shortcode into:
- Any page or post in the block editor (use a Shortcode block)
- Any page in the classic editor
- A page template override via
do_shortcode()if your theme supports it
The widget lazy-renders: the JS bundle only loads on pages where the shortcode is present.
Custom CSS overrides (optional)
If you want to go beyond the primary color, override the widget’s classes from your theme’s Appearance → Customize → Additional CSS. The widget root is .booknslot-public-root. Example:
.booknslot-public-root {
--bm-radius: 8px; /* sharper corners on cards/buttons */
--bm-font: 'Inter', sans-serif;
--bm-spacing: 1.5rem;
}
Available CSS custom properties:
| Property | Default | What it controls |
|---|---|---|
--bm-primary | your Settings value | Buttons, highlights |
--bm-radius | 12px | Card and input corners |
--bm-font | inherit | Widget body font |
--bm-spacing | 1rem | Vertical rhythm between sections |
Custom form fields as design knobs
The Form Builder is also a customization surface — you can add institution-specific fields (project code, department, supervisor) without writing PHP or JS. See Configuration → Form builder.
What you cannot change (by design)
- The OTP verification step — removing it would undermine the “verified booker” guarantee that makes auto-approval trustworthy.
- The step indicator / 4-step flow — well-established UX pattern.
- Email templates are preset text (not editable in v1.0.0). If you need custom copy, the Resend API integration lets you replace the send-path entirely.