=== Appointment Hour Booking ===
Contributors: codepeople
Donate link: https://apphourbooking.dwbooster.com/download
Tags: hour,service,booking,appointment,schedule,sessions,events,reservation,classes,teaching,training
Requires at least: 3.0.5
Tested up to: 4.9
Stable tag: trunk
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Appointment Hour Booking is a plugin for creating booking forms for appointments with a start time and a defined duration.

== Description ==

Appointment Hour Booking is a WordPress plugin for creating booking forms for **appointments with a start time and a defined duration**. The start time is visually selected by the end user from a set of start times calculated based in the **"open" hours and service duration**. The duration is defined in the "service" selected by the customer. Each calendar can have multiple services with different duration and prices.

This plugin is usefull for different cases like **booking of medical services** where services with different duration and prices may be available, for **personal training sessions**, for **booking rooms for events**, for **reserving language classes** or other type of classes and other type of **services/resources booking** where start times are selected and the availability is automatically managed using the defined service duration to avoid double-booking (the booked time is blocked once the booking is completed).

Main Features:

* Easy **visual configuration** of calendar data
* **Working dates**, invalid/holiday dates and special dates can be defined
* Supports restriction of **default, maximum and minimimum dates**
* **Open hours** can be defined for each date
* Each calendar can have **multiple services** defined
* Each service can have its own **price and duration**
* **Start-times** are calculated automatically based in the open hours and service duration
* Available times are managed automatically to **avoid double-booking**
* Multiple services can be selected on each booking
* Automatic price calculation
* Customizable **email notifications** for administrators and users
* Form **validation** and built it anti-spam **captcha** protection
* Manual and automatic **CSV reports**
* Printable **appointments list**

Features in commercial versions:

* **Visual form builder** for creating the booking form fields
* Booking form can be connected to **payment process** (Ex: PayPal, Skrill)
* **Addons** for integration with external services: reCaptcha, SalesForce, WooCommerce and others

= Appointment Hour Booking can be used for: = 

**Booking services or resources:** Define open hours, services, prices and durations ane let the calendar plugin manage the schedule.

**Sample cases:** Medical services, personal training, resource allocation, booking rooms, classes, etc...


== Installation ==

To install **Appointment Hour Booking**, follow these steps:

1.	Download and unzip the Appointment Hour Booking calendar plugin
2.	Upload the entire appointment-hour-booking/ directory to the /wp-content/plugins/ directory
3.	Activate the Appointment Hour Booking plugin through the Plugins menu in WordPress
4.	Configure the settings at the administration menu >> Settings >> Appointment Hour Booking. 
5.	To insert the appointment hour booking calendar form into some content or post use the icon that will appear when editing contents

== Frequently Asked Questions ==

= Q: What means each field in the appointment hour booking calendar settings area? =

A: The product's page contains detailed information about each appointment calendar field and customization:

https://apphourbooking.dwbooster.com


= Q: Where can I publish a appointment booking form? =

A: You can publish appointment booking forms on pages and posts. The shortcode can be also placed into the template. The commercial versions of the plugin also allow publishing it as a widget.


= Q: How can I apply CSS styles to the form fields? =

A: Please check complete instructions in the following page: https://apphourbooking.dwbooster.com/faq#q82

= Q: How can I align the form using various columns? =

A: Into the form editor click a field and into its settings there is one field named "**Add Css Layout Keywords**". Into that field you can put the name of a CSS class that will be applied to the field.

There are some pre-defined CSS classes to use align two, three or four fields into the same line. The CSS classes are named:

**column2**
**column3**
**column4**

For example if you want to put two fields into the same line then specify for both fields the class name "**column2**".


= Q: How to hide the fields on forms? =

A: You should use a custom class name. All fields include the attribute "Add Css Layout Keywords", you only should enter through this attribute a custom class name (the class name you prefer), for example myclass, and then define the new class in a css file of your website, that could be the "wp-content/plugins/appointment-hour-booking/css/stylepublic.css" file, like follow:

.myclass{ display:none; }

If you are using the latest version of the plugin, please enter in the "Add Css Layout Keywords" attribute, the class name: hide, included in the plugin's distribution.

= Q: How to edit or remove the form title / header? =

A: Into the form builder in the administration area, click the "Form Settings" tab. That area is for editing the form title and header text.

It can be used also for different alignment of the field labels.


= Q: Can the emails be customized? =

A: In addition to the possibility of editing the email contents you can use the following tags:

%INFO%: Replaced with all the information posted from the form
%itemnumber%: Request ID.
%formid%: ID of the booking form.
%referrer%: Referrer URL if reported.
%additional%: IP address, server time.
%final_price%: Total cost.
%fieldname1%, %fieldname2%, ...: Data entered on each field

= Q: Can I add a reference to the item number (submission number) into the email? =

A: Use the tag %itemnumber% into the email content. That tag will be replaced by the submission item number.


= Q: How to insert an image in the notification emails? =

A: If you want send an image in the notification emails, like a header, you should insert an IMG tag in the "Email notification to admin" and/or "Email confirmation to user" textareas of form settings, with an absolute URL in the SRC attribute of IMG tag:

<IMG src="http://..." >

= Q: How to insert changes of lines in the notification emails, when the HTML format is selected? =

A: If you are using the HTML format in the notification emails, you should insert the BR tags for the changes of lines in the emails content:

<BR />


= Q: The form doesn't appear. Solution? =

A: If the form doesn't appear in the public website (in some cases only the captcha appear) then change the script load method to direct, this is the solution in most cases.

That can be changed in the "troubleshoot area" located below the list of calendars/items.

= Q: I'm not receiving the emails with the appointment data. =

A: Try first using a "from" email address that belongs to your website domain, this is the most common restriction applied in most hosting services.

If that doesn't work please check if your hosting service requires some specific configuration to send emails from PHP/WordPress websites. The plugin uses the settings specified into the WordPress website to deliver the emails, if your hosting has some specific requirements like a fixed "from" address or a custom "SMTP" server those settings must be configured into the WordPress website.


= Q: Non-latin characters aren't being displayed in the form. There is a workaround? =

A: Use the "throubleshoot area" to change the character encoding.


= Q: Can I display a list with the appointments? =

A: A list with the appointments set on the calendar can be displayed by using this shortcode in the page where you want to display the list:

**[CP_APP_HOUR_BOOKING_LIST]**

... it can be also customized with some parameters if needed, example:

**CP_APP_HOUR_BOOKING_LIST from="today" to="today +30 days" fields="DATE,TIME,email" calendar="1"]**

... the "from" and "to" are used to display only the appointments / bookings on the specified period. That can be either indicated as relative days to "today" or as fixed dates.

The styles for the list are located at the end of the file "css/stylepublic.css":

**.cpabc_field_0, .cpabc_field_1, .cpabc_field_2, ...**

Clear the browser cache if the list isn't displayed in a correct way (to be sure it loads the updated styles).




== Other Notes ==

= The Troubleshoot Area =

Use the troubleshot if you are having problems with special or non-latin characters. In most cases changing the charset to UTF-8 through the option available for that in the troubleshot area will solve the problem.

You can also use this area to change the script load method if the booking calendar isn't appearing in the public website.

 
= The Notification Emails =

The notification emails with the appointment data entered in the booking form can sent in "Plain Text" format (default) or in "HTML" format. If you select "HTML" format, be sure to use the BR or P tags for the line breaks into the text and to use the proper formatting.

 
= Exporting Appointments to CSV / Excel Files =  

The appointment data can be exported to a CSV file (Excel compatible) to manage the data from other applications. That option is available from the "bookings list", the appointments can be filtered by date and by the text into them, so you can export just the needed appointments to the CSV file.
 

= Other Versions and Features = 
 
The free version published in this WordPress directory is a fully-functional version for accepting appointments as indicated in the plugin description. There are also commercial versions with additional features, for example:

- Ability to process forms/appointments linked to payment process (PayPal, Skrill)
- Form builder for a visual customization of the booking form
- Addons with multiple additional features

Please note that the pro features aren't advised as part of the free plugin in the description shown in this WordPress directory. If you are interested in more information about the commercial features go to the plugin's page: https://apphourbooking.dwbooster.com/download
 
 
== Screenshots ==

1. Appointment booking form.
2. Inserting an appointment hour booking calendar into a page.
3. Managing the appointment hour booking  calendar.
5. Appointment Hour Booking calendar settings.

== Changelog ==

= 1.0.02 =
* First version published

== Upgrade Notice ==

= 1.0.02 =
* First version published