Flexatech Stay Suite
| 开发者 | flexatech |
|---|---|
| 更新时间 | 2026年9月23日 21:12 |
| PHP版本: | 8.2 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Flexatech Stay Suite is a professional room-reservation system for WordPress. It manages hotel rooms, rate plans with date-specific price and availability overrides, realtime availability computed straight from bookings (no stale caches), time-limited holds that prevent overbooking, coupons, and modern payment gateways with signature-verified, idempotent webhooks.
Every amount is stored and computed as integer cents, and the total charged is always re-computed on the server at checkout, so a tampered client payload can never lower the price.
📚 DOCUMENT
Highlights
- Rooms as a custom post type with per-room inventory, capacity, deposit, and extras.
- Rate plans with priority, min/max stay, and per-date-range / day-of-week price rules.
- Realtime availability using half-open night semantics
[check_in, check_out), so same-day turnover (a guest checks out and another checks in the same day) works correctly. - Overbooking-safe holds: a time-limited hold reserves inventory during checkout and is swept automatically when it expires (WP-Cron).
- Coupons (percentage or fixed amount) with usage limits and expiry.
- Payment gateways: Offline / bank transfer (built in), plus Stripe and PayPal with sandbox/live modes and webhook verification. The charged amount always equals the server-computed total.
- Transactional emails for booking received (customer + admin), processing, completed, cancelled, and payment receipts, each toggleable with a custom subject.
- A modern React admin app for the dashboard, calendar, bookings, rate plans, coupons, and settings, backed by a versioned REST API (
flexatech-stay-suite/v1). - WP-CLI commands and full privacy exporter/eraser integration.
安装:
- Upload the
flexatech-stay-suitefolder to/wp-content/plugins/, or install the zip via Plugins → Add New → Upload Plugin. - Activate the plugin through the Plugins screen in WordPress.
- On first activation you land on the Setup screen. It shows a live completion checklist, guides you through each step, and creates the cart, checkout, and confirmation pages in one click.
- Open the "Flexatech Stay Suite" admin menu to configure currency, booking rules, taxes, payment gateways, and emails.
- Create a property, add rooms with inventory and capacity, and add rate plans with pricing rules. The Setup screen tracks each of these until you are ready to accept bookings.
- Clone the repository:
git clone https://github.com/flexatech/flexatech-stay-suite.git - Build the admin dashboard bundle:
cd apps/admin && pnpm install && pnpm build(writes the compiled assets toassets/dist). - Copy the plugin folder into
/wp-content/plugins/, or run./release.shto produce a distributable zip inbuild/.
常见问题:
How do I set up the booking pages on the front end?
Room browsing (single rooms and archives) is generated automatically inside your theme, so those need no setup. For the cart and checkout steps, create a Cart, Checkout, and Booking Confirmation page and paste [flexatech_hotel_cart], [flexatech_hotel_checkout], and [flexatech_hotel_thankyou] into them respectively, then publish. A "My Bookings" page with [flexatech_hotel_account] is recommended. The plugin discovers these pages by their shortcode, so you can name them anything. See the "Storefront pages" section above for the full walkthrough.
Can a customer manipulate the price at checkout?
No. The client never sends amounts. The server re-quotes the entire cart from the room's rate plans and inventory at checkout, so the charged total is always the authoritative server figure.
Does it prevent overbooking?
Yes. Availability is computed directly from bookings and time-limited holds, with commit-time re-checks, so two guests cannot book the last room at the same time.
Which payment gateways are supported?
Offline / bank transfer is built in and enabled by default. Stripe and PayPal are included with sandbox and live modes; enter your keys in Settings → Payments to enable them.
Where is the source for the admin app?
The admin dashboard is a React and TypeScript app. Its readable source ships in apps/admin/src, along with its build manifest (apps/admin/package.json, apps/admin/vite.config.ts, apps/admin/tsconfig.json). To rebuild the compiled bundle in assets/dist, run pnpm install then pnpm build inside apps/admin. The complete source and build tooling is public on GitHub: https://github.com/flexatech/flexatech-stay-suite
更新日志:
1.2.0
- New: First-run Setup dashboard. A guided screen with a real, weighted completion score computed from your actual data (properties, rooms, pricing, inventory, storefront pages, and payment methods), a "ready to accept bookings" indicator, and one-click creation of the cart, checkout, and confirmation pages.
- New: The first activation opens the Setup screen once (no redirect loops, admins only, skippable), and an incomplete-setup reminder shows on the Dashboard and Plugins screens until setup is ready or you dismiss it.
- New: Online documentation with a user guide and developer reference at https://flexatech-stay-suite.vercel.app/, plus a hooks reference (docs/HOOKS.md) covering every action and filter.
- New: Optional deactivation feedback form. When you deactivate the plugin, a short form asks why; the anonymous result helps us improve the plugin. It never blocks deactivation. See "External services" for exactly what is sent.
- Recommend Flexa MailBridge on the Emails settings screen for reliable SMTP delivery of booking emails.
- Security: The admin dashboard and its read-only data routes (statistics, coupons, rate plans, and room meta) now require the administrator capability. They were previously reachable by lower roles such as Authors. A filter is provided to re-map the capability.
- Moved the top-level admin menu below the core WordPress menus so it no longer sits among the built-in items.
- Passed the WordPress Plugin Check with no errors or warnings: escaped exception messages, hardened the direct database queries, and regenerated the translation template.
- New: Per-room deposit: set a fixed "amount due now" per room at checkout, with an automatic fallback to the global advance-payment percentage for rooms that have no deposit set.
- New: Filter rooms by room type and amenity on the room archive and taxonomy pages.
- New: Zero-config front-end templates: single room, room archive, and room-type/amenity archive pages now render automatically inside your active theme, with full theme-template override support and a filter to turn them off.
- New: Unpaid online payments left past their hold window are now cancelled automatically, freeing the room, handled separately from offline holds.
- New: Your configured currency symbol position (before/after the amount, with or without a space) is now applied everywhere on the server, including emails.
- New: Coupons can be individually enabled or disabled; a disabled coupon is never applied when quoting or at checkout.
- Security: Editing rate plans and coupons now requires the administrator capability; viewing remains available to lower roles. A filter is provided to re-map the capability.
- Security: Viewing customer bookings and changing a booking's status now require the administrator capability to protect guest personal data; refunds remain admin-only. A filter is provided to re-map these for staff roles.
- Fix: The booking confirmation ("thank you") page no longer returns a 404 and now shows the correct booking summary.
- Fix: Booking line items now record the correct per-night price and subtotal, which could previously be zero.
- Fix: Room permalinks (such as /rooms/) no longer 404 on a fresh install; rewrite rules are flushed on activation.
- Disclosed Stripe and PayPal as external services in the readme and completed a code-quality (phpcs) pass.
- Initial release: rooms, rate plans, realtime availability, overbooking-safe holds, coupons, offline/Stripe/PayPal gateways, transactional emails, REST API, React admin app, WP-CLI, and privacy tools.