WooBooking Calendar Plugin

WooBooking Calendar is a powerful and flexible booking solution designed for WooCommerce. It enables you to easily add a booking calendar to your WooCommerce store, manage time slots, and offer customizable pricing for services or events. Whether you’re running a service-based business or hosting events, WooBooking Calendar streamlines the process of booking appointments online.

Key Features

• Customizable Booking Calendar: Display an interactive calendar that allows customers to select their desired date and time slot.
• Flexible Time Slot Management: Set predefined or custom time slots for specific days and events.
• Dynamic Pricing: Assign different prices to time slots based on availability or specific time periods.
• WooCommerce Integration: Integrates directly with WooCommerce, allowing customers to book appointments while checking out.
• Availability Management: Disable specific days or time slots, and set weekly or custom off days to control your availability.
• Easy Admin Interface: Intuitive settings page to manage booking options, time slots, off days, and pricing.

Installation Requirements

• WordPress Version: 5.2 or higher
• PHP Version: 7.2 or higher
• WooCommerce: Required for the plugin to function correctly.

Installation Steps

Upload the Plugin

• Download the .zip file of the WooBooking Calendar plugin.
• Navigate to your WordPress admin dashboard, go to Plugins > Add New.
• Click Upload Plugin, select the .zip file, and click Install Now.
• After installation, click Activate to enable the plugin.

Activate WooCommerce

Make sure that WooCommerce is installed and activated. If it’s not installed, the plugin will notify you and deactivate itself automatically.

Configuration

After the plugin is activated, you can configure the booking settings by following these steps:

Access Settings

Go to WooBooking Settings in the WordPress admin menu.

Set Time Slot Pricing

Configure time slots and their associated prices. For example:

    { "09:00": 25, "11:00": 30 }
    

Define Weekly Off Day

Set the day of the week (e.g., Sunday) as the weekly off day where no bookings can be made.

Add Custom Off Days

Define specific off days (e.g., public holidays) by entering the dates in comma-separated format (e.g., 2025-05-01,2025-12-25).

Configure Default Time Slots

Set default available times for booking (e.g., 09:00,11:00).

Assign Fixed Slots for Specific Dates

Set specific available time slots for certain dates using JSON format. For example:

    { "2025-06-01": ["10:00", "12:00"] }
    

Save Settings

After configuring your settings, click Save Changes to apply the new settings.

Usage

Once your settings are configured, the booking calendar will be available for use on your site. Here’s how to use it:

Add the Calendar to a Page

Use the [booking_calendar] shortcode to display the booking calendar on any page or post.

    [booking_calendar]
    

Booking Process

• Customers can select an available date and time from the calendar.
• Available time slots will be marked in green (🟢), and booked slots will be marked in red (🔴).
• After selecting a time slot, customers can proceed to checkout with the booking details added to the WooCommerce cart.

Booking Information on Checkout

• The selected date, time, and price will appear on the WooCommerce checkout page, along with other cart items.
• The booking details will be saved as part of the WooCommerce order metadata.

Admin Features

• Booking Details in Orders: View the selected date, time, and price in WooCommerce orders in the admin dashboard.
• Off Day Management: Easily set off days (weekly or custom) where no bookings will be allowed.
• Easy Configuration: Adjust booking settings (time slots, pricing, availability) directly from the plugin settings page.
• Dynamic Calendar: The front-end calendar will automatically update to reflect booked dates and times.

WooCommerce Dependency

This plugin requires WooCommerce to function correctly. If WooCommerce is not installed or activated, the plugin will:

• Display an admin notice indicating that WooCommerce is required.
• Deactivate itself to prevent issues.

Troubleshooting

WooCommerce Missing Error

If you see the error message "WooCommerce is not installed," ensure that WooCommerce is installed and activated. The plugin will deactivate itself if WooCommerce is missing.

Booking Availability Not Updating

If the booking availability is not showing correctly, try clearing your browser cache or any caching plugin you may be using.

Frequently Asked Questions (FAQs)

Q: Can I change the time slots for specific dates?

Yes! You can configure fixed time slots for specific dates through the plugin’s settings, using a simple JSON format.

Q: How do I manage the off days for my business?

You can set a weekly off day (like Sunday) and add custom off days (such as public holidays) directly in the plugin settings.

Q: How do I set up pricing for time slots?

The plugin allows you to define prices for different time slots using a JSON format in the settings. For example:

    { "09:00": 25, "11:00": 30 }
    

Contributing

We welcome contributions to WooBooking Calendar Plugin! If you would like to improve the plugin or fix bugs, please follow these steps:

• Fork the repository.
• Create a new branch for your feature or bugfix.
• Submit a pull request with a clear description of the changes.

License

This plugin is licensed under the GPL v2 or later license. You are free to use, modify, and distribute the plugin, but please attribute the original author.

Developer Information

• Author: Mugniul Afif
• Email: mugniulafif@clientsync.tech
• GitHub: github.com/Mugniul30
• Website: clientsync.tech

Changelog

• 1.0.0: Initial release of the WooBooking Calendar Plugin.
• Integrated WooCommerce booking system with customizable time slots and pricing.
• Added the ability to disable specific dates and time slots.
• WooCommerce dependency check implemented.

Conclusion

This README.md file is professionally structured and provides clear instructions for users and developers. It covers installation, configuration, troubleshooting, and contributions in a clean and organized manner.