/
dev-readme.txt
409 lines (345 loc) · 22 KB
/
dev-readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
=== Appointments ===
Contributors: wpmudev, wpmudev-support1, wpmudev-support2, wpmudev-support4, wpmudev-support6
Tags: Appointment, Booking, Calendar, Reservation, Scheduling, google calendar
Requires at least: 4.8
Tested up to: 5.1.1
Stable tag: 2.4.2
License: GPL2
The most powerful, flexible and feature-rich bookings plugin available for WordPress. Appointments does it all.
== Description ==
Appointments is a powerful, flexible and feature-rich plugin that allows you to accept, set and manage your bookings on your site.
Do you constantly swap between your website and your appointment booking system, juggling calls and missing new clients who fall through the cracks?
Ditch your diary and save a fortune in time and money with Appointments!
[youtube https://www.youtube.com/watch?v=y8gZWjshwqs&hd=1]
= Appointments Does It All =
Appointments is the most comprehensive bookings plugin available for WordPress. It’s ideal for businesses and individuals who schedule times with clients, such as consultants, web designers, spa, hair salons, photographers and sales executives.
With Appointments:
* Customers can book their own appointments on your site
* You can schedule appointments with clients
* Manage customer contact information
* Collect payments or deposits using PayPal
* Manage your entire team, create service providers and services
* Send confirmation and reminder emails to increase customer attendance rates
* Allow you and your clients to book appointments up to one year in advance
* Manage appointments using Google calendar
= Book an Appointment in Just Three Clicks =
Use Paypal to collect payments and deposits right out of the box with Appointments. No button creation or coding necessary. Or integrate with <a href="https://premium.wpmudev.org/project/e-commerce/">MarketPress</a> to support a wide variety of gateways.
You can even integrate the plugin with Membership by WPMU DEV to offer discounts and payment vouchers to existing members of your site.
= Customize Your Appointment Calendar =
Set up customizable profiles for each of your staff members and Appointments will automatically display their available time slots.
Clients can click any service your company offers and Appointments will display all your available team members for that service.
= Integrate Appointments with Google Calendar =
Admins and clients can save any appointment directly to their Google Calendar with no API coding required.
There is also the option to fully integrate Google Calendar with your site by entering API credentials, allowing you to make appointment edits from your Google Calendar and push changes back to your site.
= 30+ Custom Features =
Appointments has features that rival the most sophisticated – and much more expensive – booking platforms, including:
* Create “black out” dates and times
* Edit schedules from back end of WordPress, on admin or profile pages
* Compatible with BuddyPress
* Short codes for inserting into posts/pages
* Creates automatic appointment page including all required shortcodes
* Display weekly, or monthly schedules
* Limit booking of appointments in advance ( e.g. you can set, say, two days to 365 days from today is allowed)
* Gravatar support for personalizing provider profiles
* Custom Color labels for appointments
* Form autofill for repeat clients
* Login with Facebook, Twitter, Google+ or WordPress
* Integrates with WPMU DEV Membership plugin, thus ability to offer discount to certain membership levels
* Integrates with WPMU DEV MarketPress plugin, thus uses its additional payment gateways (PayPal is already included), and also allows for multiple bookings.
* Option to require payments or deposits in advance
* Deposits can be selected as percentage or as fixed amounts
* Synchronizes with your Google Calendar account and automatically updates it
* Send clients appointment reminders
* Take phone appointments manually
* Ability to automatically remove unpaid appointments after a set time
* Multiple custom widgets included
* Documentation inside the plugin including tutorials and FAQ’s
* More than 130 custom filter and action hooks
* Support for multiple break times
* Worker calendar shortcodes
= Want More? =
<a href="https://premium.wpmudev.org/project/appointments-plus/">Download the pro version</a> for greater functionality and advanced features:
* Create unlimited services
* Create unlimited service provider profiles
* Administrative Permissions - Allows you to select who can do what in your admin backend.
* Export Date Range - Allows you to export appointments within a date range
* Allow HTML emails - By default, the plugin sends plain text emails. Activating this add-on will allow your emails to be sent as HTML.
* Locations - Allows you to create locations for your appointments.
* Locations on Google Maps - Allows you to bind locations to your services.
* Service Locations - Allows you to bind locations to your services.
* Worker Locations - Allows you to bind locations to your Service Providers.
* Appointments in product cart - Control how your appointments show in the MarketPress product cart.
* Biography post type - Allows you to select a post type for your service providers biographies (available under Settings > General > Advanced Settings)
* Service Description post type - Allows you to select a post type for your service descriptions (available under Settings > General > Advanced Settings)
* Service provider names - Allows you to select how a service provider will be introduced to your customers.
* Durations - Allows you to make changes to service durations calculus
* Paddings - Allows you to add padding times surrounding your appointment intervals.
* Shared Resources - Allows your services to define shared real-life resources, such as rooms or vehicles. The services that share resources will only allow appointments up to minimum common capacity.
* Additional fields - Allows you to require additional fields to be entered by your users.
* Limit Services Login - Allows you to choose which social services you allow your users to log in with.
== Installation ==
= To Install: =
1. Download the Appointments plugin file
2. Unzip the file into a folder on your hard drive
3. Upload the `/appointments/` folder to the `/wp-content/plugins/` folder on your site
4. Visit your Dashboard -> Plugins and Activate it there.
= To Set Up And Configure Appointments =
* You can find <a href='http://premium.wpmudev.org/project/appointments-plus/#usage'>in-depth setup and usage instructions with screenshots here »</a>
== Frequently Asked Questions ==
= Do I need to be a paid WPMU DEV member? =
No. This plugin is offered at no charge. A full-featured, premium version is available for purchase on WPMU DEV.
What else could I get in the premium version?
* Create unlimited services
* Create unlimited service provider profiles
* Administrative Permissions - Allows you to select who can do what in your admin backend.
* Export Date Range - Allows you to export appointments within a date range
* Allow HTML emails - By default, the plugin sends plain text emails. Activating this add-on will allow your emails to be sent as HTML.
* Locations - Allows you to create locations for your appointments.
* Locations on Google Maps - Allows you to bind locations to your services.
* Service Locations - Allows you to bind locations to your services.
* Worker Locations - Allows you to bind locations to your Service Providers.
* Appointments in product cart - Control how your appointments show in the MarketPress product cart.
* Biography post type - Allows you to select a post type for your service providers biographies (available under Settings > General > Advanced Settings)
* Service Description post type - Allows you to select a post type for your service descriptions (available under Settings > General > Advanced Settings)
* Service provider names - Allows you to select how a service provider will be introduced to your customers.
* Durations - Allows you to make changes to service durations calculus
* Paddings - Allows you to add padding times surrounding your appointment intervals.
* Shared Resources - Allows your services to define shared real-life resources, such as rooms or vehicles. The services that share resources will only allow appointments up to minimum common capacity.
* Show Scheduled Users - Shows scheduled user names for unavailable appointment schedule segments.
* Additional fields - Allows you to require additional fields to be entered by your users.
* Limit Services Login - Allows you to choose which social services you allow your users to log in with.
<a href='https://premium.wpmudev.org/project/appointments-plus/'>**Upgrade to the full version now »**</a>
= How do I get support? =
We provide comprehensive and guaranteed support on the <a href='http://premium.wpmudev.org/forums/tags/appointments'>WPMU DEV forums</a> and <a href='http://premium.wpmudev.org/live-support/'>live chat</a> only.
== Screenshots ==
1. Style and display a calendar on your site where clients can select and make appointments.
2. You can create profiles for each of your staff members listing their qualifications, experience or any other details about what they offer.
3. Clients can click any service your company offers and Appointments + will display all your available team members for that service.
4. Payment settings page
5. Google Calendar integration
== Changelog ==
= 2.4.2 =
* Fixed a problem with custom confirmation email.
* Fixed a problem with slot availability.
* Added plugin specific text to privacy policy page (only during creation a policy page).
= 2.4.1 =
* Fixed a problem with Service Provider shortcode param name.
* Fixed a problem with start hour for specific configurations.
* Fixed a problem with appointments intervals.
* Fixed a problem with time slots when an appointment has no provider in inline-edit.
= 2.4.0 =
* Added ability to show/hide columns on "Services" settings screen.
* Added ability to show/hide columns on "Service Provider" settings screen.
* Added asterisk to additional, required fields (pro only).
* Added columns "Paddings" and "Location" on "Service Providers" settings screen (pro only).
* Added columns "Paddings", "Location" and "Shared resources" on "Services" settings screen (pro only).
* Added locations on appointment form.
* Added SERVICE_LOCATION placeholder replaced by a service Location in email templates.
* Fixed time display format to selected in WordPress options.
* Improved "confirmation" checkbox on Service Provider Profile page.
* Improved Object Cache clear.
= 2.3.2 =
* Added an option to force load Appointment's scripts and styles.
* Added a limit for "Service Capacity" on a service add and edit screen to the number of defined workers.
* Fixed a problem with appointment hour when a worker was not selected.
* Fixed a problem with more than one Service Provider on schedule table, when first is already busy, but second is not.
* Fixed a problem with service description when Service is not selected.
* Fixed problems with capacity.
* Improved adding a new service provider, when is only one service it will be checked by default.
* Improved column "Price".
* Improved Service "Service Capacity" edit field.
* Excluded "removed" and "completed" statuses from is_busy() calculations.
* Added asterisk to GDPR checkbox label on appointment form.
= 2.3.0 =
* Convert "Time base" on "Time Settings" to human readable. Props for David @ BBS.
* Fixed a problem with an appointment create time, it showed "Unknown" for Time Formats: "g:i a" and "g:i A".
* Fixed a problem with an appointment date when we add an appointment on admin area.
* Fixed a problem with autoconfirmation free appointment.
* Fixed a problem with bottom bulk action on "Add-ons" tab.
* Fixed a problem with double cancellation emails.
* Fixed a problem with not available calendars on Service Provider profile.
* Fixed a problem with paddings on the weekly booking calendar.
* GDPR: Added ability to delete older appointments. You can set up how long presents appointments should be stored in the database.
* GDPR: Added ability to erase user personal data.
* GDPR: Added ability to export user personal data.
* GDPR: Added checkbox with the agreement to process personal data.
* GDPR: Added plugin information to default "Private Policy" page during auto-creation of this page.
* Improved "Working Hours" and "Exceptions" tabs content on mobile devices.
* Improved UX on "Payments" tab for MarketPress integration.
* Improved few translation strings.
* Improved the "app_my_appointments" shortcode and added a message when we have no appointments.
* Refactored "Service Providers" screen and use WP_List_Table class for the list.
* Refactored "Services" screen and use WP_List_Table class for the list.
* Removed DateTime::createFromFormat() usage to be compatible with PHP 5.2
= 2.2.7 =
* Added check for service name it can be empty.
* Changed default appointments sorting to "Appointment Date".
* Fixed an export problem for additional fields with HTML entities in a name.
* Fixed an export problem for the date range.
* Fixed an integration problem with MarketPress plugin.
* Fixed a problem with booking, when the site is on HTTP but admin force HTTPS usage.
= 2.2.6 =
* Added ability to delete "Service".
* Added ability to delete "Service Provider".
* Added asterisk to required fields label on appointment form.
* Fixed a problem with appointments details, the start hour of appointment is now depended on settings.
* Fixed a problem with Appointments settings on the BuddyPress profile.
* Fixed a problem with BuddyPress profile integration.
* Fixed a problem with double send reminders.
* Fixed a problem with the tutorial restart.
* Fixed a warning message for ob_end_flush() in an older version of PHP.
* Improved appointments calendars, now start on the day set in WordPress options.
= 2.2.5 =
* Added filter 'app-export-appointment-args' which allows changing export arguments eg. sorting field.
* Fixed incompatibilities with Divi Builder.
* Fixed missing sortings on the frontend.
* Fixed problems with changing the custom time for slots.
* Fixed problem with paddings.
* Fixed re-send confirmation emails.
* Improved Yes/No choice used on appointments configuration screen.
= 2.2.4 =
* Fixed a problem with the export of single appointment.
* Fixed a problem with no visible slots on Weekly Calendar view.
* Fixed a problem with viewing PayPal transaction.
* Fixed potential vulnerabilities in appointments list.
* Improved "Create an Appointment Page" UX.
* Improved default additional CSS to avoid interaction with default classes.
* Improved help tab, now we use WordPress built-in help tab.
= 2.2.3 =
* Fixed problem with bower_components directory.
* Fixed problem with extra information displayed in the wrong column.
* Fixed problem with no visible slots on Monthly view.
* Fixed problem with too many emails.
* Fixed problem with worker shortcode.
* Fixed URL building for dismissing a message.
* Moved external sources into one parent directory.
* Prevent process if a user does not exist.
* Removed wp_enqueue_* functions from views.
* Updated Unslider to version 2.0.3.
= 2.2.2.2 =
* Fixed security issue (vulnerability) with appointments actions. Props for Rolf Allard van Hagen.
= 2.2.2.1 =
* Fixed missing JavaScript scripts.
= 2.2.2 =
* Allow Service Description Page featured imaged to be used as Product variation thumbnail (MarketPress integration).
* Fixed a problem with the abandoned orders in admin.
* Fixed issue with comma as thousand separators when using PayPal.
* Fixed problem with duplicated page description.
* Fixed security issue (vulnerability) with data stored on a browser. Thanks to Matt Barry @ Wordfence
* Fixed weekly calendar hours for a worker.
= 2.2.1 =
* Added new function: appointments_is_working().
* Added shortcode option in app_monthly_schedule to give user option to hide today's times and force a user to click on a date before showing times.
* Added sort CSV columns for appointments export.
* Added timetables helpers tests.
* Allow currency option to be visible even if payments are disabled.
* appointments_is_available_time was not always returning a value.
* Appointments don't get active after Stripe payment from MarketPress.
* Fixed appointments_is_worker_holiday parameters.
* Fixed auto reload of appointment status totals when status is changed.
* Fixed client cancellation not synced to Google Calendar.
* Fixed cron not being set for Google Calendar sync for service providers.
* Fixed for checking the available time of worker.
* Fixed required messages at a monthly calendar.
* Fixed required messages at a weekly calendar.
* Fixed require_service in app_monthly_schedule shortcode not showing dropdown.
* Fixed to check for allow overwork.
* Load GCal only when needed.
* Removed Appointments::is_available_time().
* Swap start/end if start > end in appointments_is_available_time.
* Try to avoid collateral effects due to Appointments class attributes.
= 2.2.0 =
* New: option to keep settings on uninstall
* Fix: Trim spaces in status attribute of app_my_appointments shortcode
* Fix: Scheduling calender not showing on appointment page
* Fix: Divi inegration for pagination with smooth scroll
* Fix: Upfront Editor breaks because of A+ calendar widget
* Fix: Set min service when no service selected and location has been set
* Fix: Datpicker was not localized in Exceptions screen
* Other minor fixes/improvements
= 2.1.0.1 =
* Fixed: Only load dashbaord class in premium version
= 2.1 =
* New: Cancel link is back
* New: Better alerts in bookings pages
* Enhance: Lots of performance improvements
* Enhance: JavaScript files are now compressed
* Enhance: Removed deprecated functions since 1.6
* Security: Fixed XSS vulnerability
* Fixed: Wrong provider when single-worker and provider_id set on url for wrong service_id
* Fixed: Shortcodes were not working when Hustle was activated
* Fixed: require_provider attribute in monthly calendar was not working
* Fixed: Some datepickers were not respecting start of the week
* Fixed: Weekly calendar was not properly calculating capacities.
* Fixed: Users could not confirm appointments from BuddyPress profile page
* Fixed: Google Calendar settings were reset when a worker cancels an appointment
* Fixed: Weekly calendar was showing 1970 as next week in some cases
* Fixed: Unavailable times are showing as "busy" instead of "Not possible"
* Fixed: Firefox was preventing new tab for Google Calendar button
* Fixed: JavaScript error when using an Upfront theme
* Fixed: Correct provider is not selected with autorefresh attribute in shortcodes.
* Fixed: Google Calendar sync fixes
* Fixed: All services display largest time slot when service duration addon was activated
* Fixed: MarketPress integration fixes
* Some other minor fixes
= 2.0.5 =
* Fix: app_monthly_schedule not showing properly working hours when a provider is set as parameter
* Fix: Wrong working hour on Saturdays when A+ is just activated
* Fix: GCal sync issues when providers have selected a calendar
* Some other minor fixes
= 2.0.4 =
* Fix: GCal sync was overriding the appointments service
* Fix: Appointments Shortcode orderby attribute not working
* Fix: Events not removed from Provider's GCal, when Allow Service Providers for Google Calendar API Integration selected
* Fix: TinyMCE shortcodes UI: Pagination date was a checkbox instead of a text box
* Fix: No error message was displayed when service/workers limit was reached in free version
= 2.0.3 =
* Fix: Service was not properly to a worker set when an appointment was imported from GCal
* Fix: Break hours wrong due to a cache collission
* Fix: widgets deprecated notice
* Fix: warnings when generating timetables
* Fix: Widget shows all dates busy
* Fix: Wrong provider when no one is selected in appointments page
* Removed CANCEL placeholder from notifications template
= 2.0.2 =
* Fixed: Monthly calendar was displaying as available worker holidays
* Fixed: Working hours in user profile was not properly saved, giving warnings in front
* Fixed: Appointment worker was not properly set on front end
= 2.0.1 =
* New: Filter for weekly schedule headers
* Fixed: When week started in Sunday, monthly calendar was wrongly displayed
* Fixed: All monthly calendar slots appeared as busy in some cases
* Fixed: Warning when updating an appointment and status was not changed
* Fixed: A post could not be assigned to a Service when Services Description addon was activated
* Fixed: Services were not saved when some of the addons were activated
* Fixed: Warning when getting working hours
* Fixed: Fatal error in Tetris addon
* Fixed: Locations selector was not displayed when Paddings Add-on was active
* Enhance: Better cookies management
* Enhance: Workers/Services admin screen UX
= 2.0 =
* Fixed: Stripe does not set appointments to confirmed after payment received
* Fixed: Columns offset from the table head when exported to csv
* Fixed: Sometimes Google Calendar event status was not updated
* Fixed: Nonce error when saving Appointments Settings with BuddyPress activated
* Fixed: Additional fields were hidden in settings menu if there were no additional fields set.
* Fixed: Working hour exceptions not applying in very rare cases
* Fixed: Email headers when blogname included some HTML in it.
* Fixed Shared Resources Addon: Shared resources were not working properly in some cases
* Fixed: Notification emails were not being sent to admin/service provider
* Fixed: When Saturday was set to start of the week, weekly calendar was starting on Sunday
* Fixed MarketPress integration: Appointment showing even if it's free
* Fixed: Timeslot available when providers aren't available and "No preference" provider option is selected
* New: Added new Shortcodes UI in WP Editor
* New: new hooks for abetter extensibility
* Enhance: Performance improvements
* Enhance: Better dates localization
* Enhance: Some styles fixes and improvements in settings menu
* Enhance: Improvements in dates and times calculations
* Enhance: Paddings options have been moved to general options
* Removed: Built in cache feature. A+ now uses WordPress Cache API
* Removed: Cancel link from emails due to possible exploit
* Removed: AJAX Shortcode addon
* Removed: Removed shortcodes submenu
* Some other minor fixes.
[See full changelog](http://plugins.svn.wordpress.org/appointments/trunk/changelog.txt).