# CodoBookings

**Contributors:** junaidte14  
**Tags:** bookings, appointments, calendar, scheduling, standalone, pmpro-extension, woocommerce, google-calendar  
**Requires at least:** 6.0  
**Tested up to:** 6.7  
**Requires PHP:** 7.4  
**License:** GPLv2 or later  
**License URI:** https://www.gnu.org/licenses/gpl-2.0.html  

---

## 🎯 Description

**CodoBookings** is a lightweight yet powerful **WordPress booking management plugin** designed for developers and site owners who want complete flexibility.  
Originally built as a Paid Memberships Pro (PMPro) extension, it has now evolved into a **standalone booking engine**, providing the foundation for managing appointments, schedules, and customer interactions — **without requiring any dependencies**.

Future extensions (coming soon) will seamlessly integrate with:
- 🧩 **Paid Memberships Pro** (membership-based bookings)
- 🛒 **WooCommerce** (sell bookings as products)
- 📅 **Google Calendar** (sync bookings with personal or business calendars)
- 💬 **Email & Notifications** (customized reminders, confirmations, and admin alerts)

---

## 🚀 Key Features

✅ **Standalone Booking System** – Manage bookings and appointments directly from your WordPress admin.  
✅ **Custom Calendar UI** – Interactive weekly and monthly calendars with available slots and tooltips.  
✅ **Recurring Booking Support** – Handle weekly recurring slots with future-date logic.  
✅ **Booking Status Management** – Track pending, confirmed, and cancelled bookings.  
✅ **Admin Dashboard Widgets** – Quick overview of calendar and booking stats with helpful links.  
✅ **Extensible Architecture** – Built modularly, allowing clean integration of add-ons and third-party APIs.  
✅ **Optimized and Secure** – Uses nonces, prepared SQL statements, and follows WordPress coding standards.  

---

## 🧱 Planned Extensions

| Extension | Description | Status |
|------------|--------------|--------|
| **PMPro Integration** | Restrict or enable bookings based on membership level. | 🚧 Coming soon |
| **WooCommerce Integration** | Convert bookings into WooCommerce products with checkout flow. | 🚧 Coming soon |
| **Google Calendar Sync** | Allow users and admins to link and sync bookings to Google Calendar. | 🚧 Coming soon |
| **Email Templates** | Customizable email notifications for bookings, cancellations, and reminders. | 🚧 Coming soon |
---

## 🧩 Developer Hooks

CodoBookings provides several developer hooks to extend its behavior.

---

## 🛠 Installation

1. Download the plugin ZIP file or clone the repository.  
2. Upload the folder to `/wp-content/plugins/codobookings/`.  
3. Activate **CodoBookings** through the WordPress admin dashboard.  
4. Access the **CodoBookings** menu to manage calendars, bookings and settings.  

---

## 💡 Usage

Once activated:
- Manage calendars via **CodoBookings → Calendars** in admin.
- Manage bookings via **CodoBookings → Bookings** in admin.  
- Add or update slots using the booking calendar.  
- View booking summaries in the WordPress **Dashboard Widget**.  
- Extend functionality using future add-ons or custom hooks.

---

**Hooks Overview:**
- `codobookings_admin_overview_stats` – Extend the dashboard widget with custom stats.
- `codobookings_before_calendar` – [Action Hook] Fires before a calendar is shown.
- `codobookings_after_calendar` – [Action Hook] Fires after a calendar is shown.
- `codobookings_before_booking_insert` – [Filter Hook] Fires before a booking is created.  
- `codobookings_booking_created` – Triggered when a new booking is created.  
- `codobookings_booking_status_changed` – Fires when a booking status is updated.
- `codobookings_emails_sent` – Fires when a booking confirmation email is sent.
- `codobookings_status_email_sent` – Fires when a booking status change email is sent.

**Hooks in JS Code:**
- `beforeConfirmBooking` – Fires before processing booking request from the user.
- `afterConfirmBooking` – Fires after processing booking request from the user.
- `beforeCreateBooking` – Fires before a booking is created.
- `afterCreateBooking` – Fires after a booking is created.
- `beforeCalendarReload` – Fires before a calendar is reloaded.
- `afterCalendarReload` – Fires after a calendar is reloaded.
- `afterSidebarRender` – Fires after a calendar sidebar (with time slots) is loaded.

---

## 📘 Changelog

### 1.2.0 - Features and Improvements
- Added User Fields Extension link on dashboard page
- Updated the translations file

### 1.1.0 - Features and Improvements
- New hooks introduced in PHP code
- Some wording changes
- Hooks added in JS code for future extensibility
- Fixed confirmation message visibility

### 1.0.0 - Initial Release
- Standalone booking plugin core
- Admin dashboard widget for stats
- Booking list and management UI
- Recurring booking logic (weekly)
- Modular architecture for future extensions

---

## 🧑‍💻 Developer Notes

CodoBookings is structured for scalability:
- Each functional area resides in its own file under `/includes/`.
- Hooks and filters are available for extension developers.

---

## 🔗 Links

- **Website:** [https://codoplex.com](https://codoplex.com)

---

## 🧾 License

This plugin is licensed under the **GPLv2 or later** license.  
You are free to use, modify, and redistribute it under the same license.

---