| 1 |
=== Booking Manager === |
| 2 |
Contributors: wpdevelop, oplugins |
| 3 |
Donate link: https://oplugins.com/plugins/booking-manager |
| 4 |
Tags: events, bookings, list events, sync bookings, booking calendar, synchronize events, import ics, export ics, import events, export events, ical, airbnb |
| 5 |
Requires at least: 4.0 |
| 6 |
Requires PHP: 5.6 |
| 7 |
Tested up to: 6.4 |
| 8 |
Stable tag: 2.1.7 |
| 9 |
License: GPLv2 or later |
| 10 |
License URI: http://www.gnu.org/licenses/gpl-2.0.html |
| 11 |
|
| 12 |
Showing events listing from .ics feeds or sync bookings from different sources to your website |
| 13 |
|
| 14 |
== Description = |
| 15 |
|
| 16 |
Booking Manager plugin can easily show list of events in customizable way from external .ics feeds at your website. |
| 17 |
Booking Manager have native integration with **[Booking Calendar](https://wordpress.org/plugins/booking/)** plugin. |
| 18 |
It can sync bookings from **Booking Calendar** with different sources (Airbnb, Booking.com, HomeAway, TripAdvisor, VRBO, FlipKey and any other calendar that uses .ics format). |
| 19 |
|
| 20 |
>[Plugin Homepage](https://oplugins.com/plugins/booking-manager/ "Booking Manager Homepage") | [Support](https://oplugins.com/plugins/booking-manager/#faq "Support") |
| 21 |
|
| 22 |
= Booking Manager IS GREAT FOR = |
| 23 |
|
| 24 |
* Listing of upcoming events at your website from .ics feeds |
| 25 |
* Sync bookings from different sources with [Booking Calendar](https://wordpress.org/plugins/booking/) plugin |
| 26 |
|
| 27 |
= FEATURES = |
| 28 |
|
| 29 |
* List of events from external .ics feeds. |
| 30 |
* Ability to upload .ics file(s) to your website and use it. |
| 31 |
* Customization of events listing template - it's how events showing at front-end side of your website. |
| 32 |
* Easily inserting shortcode for events listing into any post or page via popup dialog, where you can select different parameters. |
| 33 |
* Setting different parameters for events listing, like "start from" and "finish to" dates, etc... |
| 34 |
* Native integration with **Booking Calendar** plugin. |
| 35 |
* **Sync bookings** from Booking Calendar with different sources (Airbnb, Booking.com, HomeAway, TripAdvisor, VRBO, FlipKey and any other calendar that uses .ics format). |
| 36 |
* **Import .ics** feeds (files) into Booking Calendar. Its useful, if you need to import bookings from multiple external websites into one calendar in Booking Calendar plugin. |
| 37 |
* **Export .ics** feeds (files) from Booking Calendar. You can publish bookings from Booking Calendar as .ics feeds at different pages, and then import such bookings in your other different website, like Airbnb. |
| 38 |
* Configure URLs for pages where you want to publish your ics feeds. |
| 39 |
* Mobile friendly. |
| 40 |
|
| 41 |
== Installation == |
| 42 |
|
| 43 |
= Automatic installation = |
| 44 |
|
| 45 |
To do an automatic install, log in to your WordPress admin panel, navigate to the Plugins menu and click Add New. |
| 46 |
In the search field type "Booking Manager" and click Search Plugins. |
| 47 |
Once you've found the plugin you can view details about it such as the point release, rating and description. |
| 48 |
Now, you can install it by clicking "Install Now". |
| 49 |
|
| 50 |
= Manual installation via WordPress admin panel = |
| 51 |
|
| 52 |
* Download plugin zip file to your computer |
| 53 |
* In your WordPress admin panel, navigate to the Plugins menu and click Add New. |
| 54 |
* Click "Upload Plugin" button and hit "Choose File" button |
| 55 |
* When the popup appears select your downloaded zip file of plugin |
| 56 |
* Follow the on-screen instructions and wait as the upload completes. |
| 57 |
* When it's finished, activate the plugin via the prompt. A message will show confirming activation was successful. |
| 58 |
|
| 59 |
= Manual installation via FTP = |
| 60 |
|
| 61 |
* Download plugin zip file to your computer and unzip it |
| 62 |
* Using an FTP application, or your hosting control panel, upload the unzipped plugin folder to your WordPress installation's `wp-content/plugins/` directory. |
| 63 |
* In your WordPress admin panel, navigate to the Plugins menu and find your uploaded plugin |
| 64 |
* Click on Activate link under the plugin. A message will show confirming activation was successful. |
| 65 |
|
| 66 |
That's it! |
| 67 |
|
| 68 |
== Frequently Asked Questions == |
| 69 |
|
| 70 |
= How to start showing events from .ics feeds (files)? = |
| 71 |
|
| 72 |
* Open "oPlugins Panel" menu page in WordPress admin panel |
| 73 |
* Upload .ics file via this page or simply use URL to .ics feed from external website |
| 74 |
* Insert into page or post the shortcode for listing events from .ics feed. Please click on insert shortcode button in edit content toolbar at edit post page. Then in popup dialog select your parameters for showing events and click on Insert button. Save changes. Test it. |
| 75 |
|
| 76 |
= How to start import of .ics feeds (files)? = |
| 77 |
|
| 78 |
* Install [Booking Calendar](https://wordpress.org/plugins/booking/) plugin. |
| 79 |
* Insert [booking-manager-import ...] shortcode into some post(s) or page(s) easily via configuration popup window. Please click on insert shortcode button in edit content toolbar at edit post page. |
| 80 |
* Using such shortcodes in pages give a great flexibility to import from different .ics feeds (sources) into the same resource (calendar). Also it's possible to define different CRON parameters for accessing such different pages with different time intervals. |
| 81 |
* Or you can import .ics feed or file directly at Booking > Settings > Sync > Import page. |
| 82 |
|
| 83 |
= How to start export of .ics feeds (files)? = |
| 84 |
|
| 85 |
* Install [Booking Calendar](https://wordpress.org/plugins/booking/) plugin. |
| 86 |
* Configure ULR feed(s) at the Booking > Settings > Sync > Export page. |
| 87 |
* Using such URL(s) you can import .ics feeds, from interface of other websites. Check more info about how to import .ics feeds into other websites at the support pages of specific website. |
| 88 |
* Visit these (previously configured URL feeds) pages for downloading .ics files (for example by configuring CRON at your server). |
| 89 |
|
| 90 |
= Support Languages = |
| 91 |
|
| 92 |
- English |
| 93 |
- Dutch [63% Completed] |
| 94 |
- German [62% Completed] |
| 95 |
- Italian [62% Completed] |
| 96 |
- Norwegian [62% Completed] |
| 97 |
- Swedish [62% Completed] |
| 98 |
- Hungarian [62% Completed] |
| 99 |
- Ukrainian [62% Completed] |
| 100 |
- Russian [62% Completed] |
| 101 |
- French [62% Completed] |
| 102 |
- Chinese [62% Completed] |
| 103 |
- Chinese (Taiwan) [61% Completed] |
| 104 |
- Hebrew [61% Completed] |
| 105 |
- Danish [61% Completed] |
| 106 |
- Finnish [61% Completed] |
| 107 |
- Brazilian Portuguese [61% Completed] |
| 108 |
- Polish [61% Completed] |
| 109 |
- Portugal [37% Completed] |
| 110 |
- Spanish [37% Completed] |
| 111 |
- Greece [37% Completed] |
| 112 |
- Czech [37% Completed] |
| 113 |
- Slovak [37% Completed] |
| 114 |
- Croatian [37% Completed] |
| 115 |
- Turkish [37% Completed] |
| 116 |
- Catalan [37% Completed] |
| 117 |
- Bulgarian [37% Completed] |
| 118 |
- Arabic [58% Completed] |
| 119 |
- Belarussian [12% Completed] |
| 120 |
|
| 121 |
= Requirements = |
| 122 |
|
| 123 |
- PHP 5.6 or newer, |
| 124 |
- MySQL version 5.0 or newer, |
| 125 |
- WordPress 4.0 or newer, |
| 126 |
- jQuery 1.7.1 or newer |
| 127 |
|
| 128 |
== Screenshots == |
| 129 |
|
| 130 |
1. **Events Listing** - showing events listing at front-end side of website. |
| 131 |
2. **Manage ics** - upload .ics file(s) to your server |
| 132 |
3. **Settings** - configure different settings of plugin |
| 133 |
4. **Events Listing Template** - customize template how to show events at your website |
| 134 |
5. **Inserting shortcode** - popup dialog for easy configuring and inserting plugin shortcode into content of post |
| 135 |
|
| 136 |
== Changelog == |
| 137 |
= 2.1.7 = |
| 138 |
* Fix empty spaces in the UID of exported events in some servers. 2.1.7.1 |
| 139 |
|
| 140 |
= 2.1.6 = |
| 141 |
* Fix vulnerable to SQL injection in the [booking-manager-delete ...] shortcode. |
| 142 |
|
| 143 |
= 2.1.5 = |
| 144 |
* New shortcode parameter. Ability to use shortcode [booking-manager-delete resource_id=1 action='delete'] to delete all imported bookings from specific booking resource (calendar). ( In paid versions of Booking Calendar you can define ID of booking resource, where you want to delete imported bookings with this parameter: resource_id=1 ). |
| 145 |
|
| 146 |
= 2.1.4 = |
| 147 |
* New shortcode parameter in import shortcode: delete='skip'. It will prevent of deletion of all previous imported bookings, even if you activated option "Trash / delete all imported bookings before new import" at the Booking > Settings > Sync > "General" page. Example: [booking-manager-import delete='skip' resource_id=1 import_conditions='if_dates_free' from='today' until='any' url='https://calendar.google.com/calendar/ical/CALENDAR_ID/public/basic.ics'] |
| 148 |
|
| 149 |
= 2.1.3 = |
| 150 |
* Fix issue of not importing events with only one date (if was activated "Use check in/out time" at the Booking > Settings > Sync > "General" page). In this case, system append one additional date for such events (even if the option "Append check out day", unchecked). It is required for the bookings with check in/out times (chnge over dates), because such bookings minimum for 2 dates. |
| 151 |
|
| 152 |
= 2.1.2 = |
| 153 |
* Added support legacy versions of Booking Calendar. |
| 154 |
|
| 155 |
= 2.1.1 = |
| 156 |
* Add message that Booking Manager require Booking Calendar 9.8 or newer |
| 157 |
|
| 158 |
= 2.1 = |
| 159 |
* Support Booking Calendar 9.8 |
| 160 |
|
| 161 |
= 2.0.31 = |
| 162 |
* **Fix**. PHP Fatal error: Uncaught TypeError: count(): Argument #1 ($value) must be of type Countable|array, null given ... (2.0.31.1) |
| 163 |
|
| 164 |
= 2.0.30 = |
| 165 |
* **New** Added new REFRESH-INTERVAL property to head of exported .ics feeds with PERIOD 10 minutes. This property specifies a suggested minimum interval for polling for changes of the calendar data from the original source of that data. (2.0.30.1) |
| 166 |
* **New** Added new X-PUBLISHED-TTL:PT10M property to head of exported .ics feeds with PERIOD 10 minutes for MS Outlook. (2.0.30.1) |
| 167 |
|
| 168 |
= 2.0.29 = |
| 169 |
* **Fix**. Possible Server Side Request Forgery (SSRF) issue. |
| 170 |
|
| 171 |
= 2.0.28 = |
| 172 |
* **Fix**. Issue of import events, where last day of event blocking the whole day on the calendar. (2.0.28.1) |
| 173 |
|
| 174 |
= 2.0.27 = |
| 175 |
* **Fix**. If activated option "Append check out day" at Booking > Settings > Sync > "General" page, system will append this additional day does not depend on the change-over days option, as before. (2.0.27.1) |
| 176 |
|
| 177 |
= 2.0.26 = |
| 178 |
* **Fix**. Hide 'ATTENDEE' and 'MAILTO' fields in events of exported .ics feed, if activated option 'Remove booking details in exported .ics feed' at the Booking Manager plugin at menu 'oPlugins Panel' > General Settings page. |
| 179 |
|
| 180 |
= 2.0.25 = |
| 181 |
* **Fix**. Uncaught TypeError: Cannot access offset of type string on string in ../wp-content/plugins/booking-manager/core/wpbm-functions.php:218 (2.0.25.1) |
| 182 |
|
| 183 |
= 2.0.24 = |
| 184 |
* **New**. Ability permanently delete all imported bookings before new import, instead of sending to Trash. Activate this option at the Booking > Settings > Sync > "General" page. (2.0.24.1) |
| 185 |
|
| 186 |
= 2.0.23 = |
| 187 |
* **Fix**. issue when .ics event have DTSTART has a DATE data type, and there is no DTEND. The event will ends on the same calendar date and time of day specified by the "DTSTART" property. (2.0.23.1) |
| 188 |
|
| 189 |
= 2.0.22 = |
| 190 |
* **New** shortcode for deleting importing bookings in specific booking resource: [booking-manager-delete resource_id=5] |
| 191 |
* **Fix**. issue of incorrectly import events that ended with 00:00:00 time. (2.0.22.2) |
| 192 |
|
| 193 |
= 2.0.21 = |
| 194 |
* **Fix**. issue of incorrectly import events that ended with 00:00:00 time. Previously if you import event from 2022-01-28 23:00 to 00:00 system was marked as unavailable 2022-01-28 23:00 to 2022-01-29 (all day). Currenlty system will import from 2022-01-28 23:00 to 2022-01-28 23:59 (2.0.21.1) |
| 195 |
* **Fix**. issue of loading not needed calendar.css file (8.9.4.13) |
| 196 |
|
| 197 |
= 2.0.20 = |
| 198 |
* Added "ATTENDEE" block to the exported .ics feeds ( 2.0.20.1) |
| 199 |
* Ability to export into .ics feeds only bookings, that was created in Booking Calendar plugin, without any other imported bookings. Activate it at Booking > Settings > Sync > "General" page. (2.0.20.2) |
| 200 |
|
| 201 |
= 2.0.19 = |
| 202 |
* **Fix**. Deprecated jQuery( ... ).submit() message |
| 203 |
* **Fix**. Error with undefined $milliseconds variable ( 8.8.2.1 ) |
| 204 |
|
| 205 |
= 2.0.18 = |
| 206 |
* **Support** WordPress 5.7 (2.0.18.4) |
| 207 |
* **Improvement** removed "Chosen" library |
| 208 |
* **Fix**. Showing deprecated message: ../booking-manager/core/any/js/admin-support.js:527:16: jQuery.fn.load() is deprecated (2.0.18.1) |
| 209 |
* **Fix**. Showing deprecated message: .. get_magic_quotes_runtime / set_magic_quotes_runtime .. (2.0.18.2) |
| 210 |
* **Fix**. Delete imported bookings after the downloading of the .ics feed, to prevent issue of deleting of all imported bookings and having issue with downloading new .ics feed and new import (2.0.18.3) |
| 211 |
|
| 212 |
= 2.0.17 = |
| 213 |
* **Fix**. Deprecated warnings: Array and string offset access syntax with curly braces is deprecated, while using PHP 7.4 |
| 214 |
|
| 215 |
= 2.0.16 = |
| 216 |
* **Support** WordPress 5.5 (2.0.16.1) |
| 217 |
|
| 218 |
= 2.0.15 = |
| 219 |
* **Fix**. Warning: preg_match(): Compilation failed: invalid range in character class for emails (2.0.15.1) |
| 220 |
* **Improvement** of working import_conditions='if_dates_free' parameter in [booking-manager-import ... shortcode, during checking events import for specific times. Previously was checked if entire day was available. (2.0.15.2) |
| 221 |
* **Improvement** Replaced usage of Bootstrap slideToggle to jQuery toggle function - for ability to show some sections, if bootstrap library deactivated. (2.0.15.3) |
| 222 |
* **Fix**. Issue of not ability to import the events for specific time-slots at the same date (2.0.15.4) |
| 223 |
|
| 224 |
= 2.0.14 = |
| 225 |
* **Fix**. Error Parse error: syntax error, unexpected '[' in ..wpbm-bc-import.php on line 866, while using PHP 5.2.4 (2.0.14.1) |
| 226 |
* **Fix**. Invalid link error for some type of .ics feeds, which have & in URL (2.0.14.2) |
| 227 |
* **Fix**. Error "[WPBM Error] File does not contain events " during showing events listing at oPlugins Panel > Manage .ics page for some type of .ics URLs (2.0.14.3) |
| 228 |
|
| 229 |
= 2.0.13 = |
| 230 |
* **Compatibility**. Support **WordPress 5.3** - update of admin panel styles. (2.0.13.1) |
| 231 |
|
| 232 |
= 2.0.12 = |
| 233 |
* **New** Ability remove all details from the .ics feed (SUMMARY and DESCRIPTION fields) during export of .ics feeds and export only booked dates. You can activate this option at the oPlugins Panel > General Settings page (2.0.12.3) |
| 234 |
* **Fix** issue of ability to import the events from the "Expedia" ("expediapartnercentral.com"), which is require to define some 'user-agent' for request , like 'Mozilla/5.0 (iPad; U; CPU OS 3_2_1 like Mac OS X; en-us) AppleWebKit/531.21.10 (KHTML, like Gecko) Mobile/7B405'. Otherwise its prevent from loading .ics feeds. (2.0.12.1) |
| 235 |
* **Fix** Added back "STATUS:CONFIRMED" in exported .ics feed. (2.0.12.2) |
| 236 |
|
| 237 |
= 2.0.11 = |
| 238 |
* **New** Ability to check events (in .ics feed), if they was imported into the "Booking Calendar". Use [BOOKING_ID] shortcode in Settings > "Listing Template" for showing ID of imported booking 9relative to specific event), if its exist. (2.0.11.4) |
| 239 |
* **New** [BOOKING_LINK] shortcode in Listing template for direct link to booking in Booking Listing page, if event was imported. Example of usage shortcode in Settings > "Listing Template" Booking ID: <a href="[BOOKING_LINK]" target="_blank">[BOOKING_ID]</a> (2.0.11.5) |
| 240 |
* **New** Ability to export only approved bookings into .ics feeds. Available in the Booking Calendar Business Small or higher versions since 8.5.2 or newer update. (2.0.11.1) |
| 241 |
* **Fix** Issue of previosly exporting bookings from "child" booking resources for "parent booking resource". Currently system export only bookings from specific booking resource (does not include child booking resources) (2.0.11.2) |
| 242 |
* **Fix** Removed "STATUS:CONFIRMED" in exported .ics feed. Otherwise possible issue in the booking.com that show in dashboard such bookings with red status instead of yellow. (2.0.11.3) |
| 243 |
|
| 244 |
= 2.0.10 = |
| 245 |
* **New Experimental Feature**. Trash all imported bookings before new import. Move all previously imported bookings to trash before new import bookings. Its can resolve issue of updating deleted and edited events in external sources. Its work only, if you are using one source (.ics feed) for importing into specific booking resource! Work only in update of Booking Calendar 8.4.7 or newer. (2.0.10.3) |
| 246 |
* **Improvement** Force import. Ability to import bookings without checking, if such bookings already have been imported. Available in the Booking Calendar 8.4.7 or newer. (2.0.10.1) |
| 247 |
* **Improvement** Show more detail info of not ability to download .ics feeds. (2.0.10.5) |
| 248 |
* **Fix** PHP Warning: count(): Parameter must be an array or an object that implements Countable in ../booking-manager/core/wpbc/wpbm-bc-import.php on line 259 (2.0.10.4) |
| 249 |
|
| 250 |
= 2.0.9 = |
| 251 |
* **Improvement** Ability to import new bookings from .ics feed, is such bookings already exist in the Booking Calendar, but was moved to trash. (2.0.9.3) |
| 252 |
* **Fix** Warning: Invalid argument supplied for foreach() in ../booking-manager/core/wpbc/wpbm-bc.php on line 73 (2.0.9.2) |
| 253 |
* **Fix** error warning in PHP 7.2: "PHP Fatal error: Uncaught ArgumentCountError: Too few arguments to function wpbm_recheck_plugin_locale(), 1 passed and exactly 2 expected in ../booking-manager/core/wpbm-translation.php:226" (2.0.9.1) |
| 254 |
|
| 255 |
= 2.0.8 = |
| 256 |
* **Support** Fix compatibility with Gutenberg 4.1- 4.3( or newer ). Before this having JavaScript error " ReferenceError: jQuery is not defined" at edit post page, because of weird behavior with 'edit_form_advanced' hook, while activated Gutenberg. (2.0.8.2) |
| 257 |
* **Fix** issue of checkboxes and radio buttons height in new Firefox updates in admin panel, otherwise sometimes, there exist weird artefact (2.0.8.1) |
| 258 |
|
| 259 |
= 2.0.7 = |
| 260 |
* **Improvement** Export bookings from Booking Calendar into .ics feed for 2 years instead of 1 year previously. (2.0.7.1) |
| 261 |
* **Improvement** Add notes to the booking relative source of imported booking. (2.0.7.2) |
| 262 |
* **Fix** Warning: count(): Parameter must be an array or an object that implements Countable in ../core/wpbc/wpbm-bc-import.php on line 12 (2.0.7.3) |
| 263 |
* **Fix** Skip adding Timezone to "middle" days, if Booking Calendar use change over days, to prevent of having clock icon in middle days. (2.0.7.4) |
| 264 |
|
| 265 |
= 2.0.6 = |
| 266 |
* **Improvement** Set timezone frrom Booking > Settings > Sync page for booking listing shortcode (2.0.6.1) |
| 267 |
|
| 268 |
= 2.0.5 = |
| 269 |
* **Improvement** Added check in/out times to imported bookings, if in Booking Calendar was activated "change over" functionality and activated this option at the Booking > Settings > Sync page in Booking Calendar 8.2 or newer. (2.0.5.1) |
| 270 |
* **Under Hood** Ability to add one additional day to .ics event (useful in some cases for bookings with change-over days). Possible to activate this option at the Booking > Settings > Sync page in Booking Calendar 8.2 or newer. (2.0.5.2) |
| 271 |
* **Fix** Add checking about exist PHP function 'mb_detect_encoding'. In some systems, PHP mbstring extension can not be active. (2.0.5.3) |
| 272 |
* **Fix** Issue of not ability to export .ics feed, if the WordPress website was installed not in root directory. Home url, have additional folder, like this: http://server.com/my-website/ (2.0.5.4) |
| 273 |
|
| 274 |
= 2.0.4 = |
| 275 |
* **Improvement** Updated all links from http to https of plugin website. |
| 276 |
* **Improvement** Add timezone to the export for .ics feed from Booking Calendar, in case if you was defined timezone at the Booking > Settings > Sync > "Import Google Calendar Events" page. (2.0.3.3) |
| 277 |
|
| 278 |
= 2.0.3 = |
| 279 |
* **Fix** Issue of JavaScript error during inserting shortcode from popup window (2.0.3.1) |
| 280 |
* **Fix** Issue of importing event with admin email instead of email like [email protected] (some domain configurations can not have such email at all). (2.0.3.2) |
| 281 |
|
| 282 |
= 2.0.2 = |
| 283 |
* **Impovement** Export to .ics feed bookings from Booking Calendar that does not inside of Trash folder (2.0.2.3) |
| 284 |
* **Fix** issue of showing warning "parsererror ~ SyntaxError: JSON.parse: unexpected character at line 1 column 1 of the JSON data" (2.0.2.1) |
| 285 |
* **Fix** issue of showing Fatal error: "Uncaught Error: Call to a member function get_error_message()" (2.0.2.2) |
| 286 |
|
| 287 |
= 2.0.1 = |
| 288 |
* **Impovement** Do not show 'Import XX bookings' message, if parameter silence=1 exist in import shortcode (2.0.1.2) |
| 289 |
* **Impovement** Show error description if plugin can not download .ics file by some reason (2.0.1.3) |
| 290 |
* **Fix** issue of not importing events, if end date set more than 20 years from today date (2.0.1.1) |
| 291 |
* **Fix** issue of showing error in PHP 7, at the Settings General page (2.0.1.4) |
| 292 |
* **Fix** showing "Deprecated" warnings in PHP 7 environment (2.0.1.5) |
| 293 |
* **Fix** correctly showing single and double quotes (' and ") symbols during export bookings to .ics feed (2.0.1.6) |
| 294 |
|
| 295 |
= 2.0 = |
| 296 |
* Fully redeveloping version of plugin |
| 297 |
|
| 298 |
== Upgrade Notice == |
| 299 |
= 2.0.16 = |
| 300 |
Support WordPress 5.5 |
