| @@ -1,477 +1,456 @@ | ||
| 1 | -=== Event post === | |
| 2 | -Contributors: bastho, n4thaniel, ecolosites | |
| 3 | -Donate link: http://ba.stienho.fr/#don | |
| 4 | -Tags: Post,posts,event,date,geolocalization,gps,widget,map,openstreetmap,calendar,agenda | |
| 5 | -Requires at least: 3.8 | |
| 6 | -Tested up to: 4.3.1 | |
| 7 | -Stable tag: /trunk | |
| 8 | -License: GPLv2 | |
| 9 | -License URI: https://www.gnu.org/licenses/gpl-2.0.html | |
| 10 | - | |
| 11 | -Add some meta-datas to posts to convert them into full calendar events : | |
| 12 | -begin, end, location, color | |
| 13 | - | |
| 14 | -== Description == | |
| 15 | -Add some meta-datas to posts to convert them into full calendar events. | |
| 16 | -Each event can be exported into ical(.ics), outlook(vcs), or Google Calendar. | |
| 17 | -Geolocation works thanks to openstreetmap. | |
| 18 | - | |
| 19 | -= Localization = | |
| 20 | - | |
| 21 | -* English | |
| 22 | -* fr_FR : French | |
| 23 | -* it_IT : Italian by NewHouseStef, pgallina | |
| 24 | -* sv_SE : Swedish by mepmepmep | |
| 25 | - | |
| 26 | - | |
| 27 | -= Post metas = | |
| 28 | - | |
| 29 | - | |
| 30 | -**Date attributes** | |
| 31 | - | |
| 32 | -* Begin date-time | |
| 33 | -* End date-time | |
| 34 | -* Color | |
| 35 | - | |
| 36 | -**Location attributes** | |
| 37 | - | |
| 38 | -* Address | |
| 39 | -* GPS coordinates | |
| 40 | - | |
| 41 | -[see full documentation](https://wordpress.org/plugins/event-post/other_notes/) | |
| 42 | - | |
| 43 | -## Shortcodes | |
| 44 | -The plugin comes with three shortcodes wich allows to : | |
| 45 | - | |
| 46 | -* `[events_list]` : display a list of events | |
| 47 | -* `[events_map]` : display a map of events | |
| 48 | -* `[events_cal]` : display a calendar of events | |
| 49 | -* `[event_details]` : display a detail of the current event | |
| 50 | - | |
| 51 | -### Available options : | |
| 52 | -#### [events_list] | |
| 53 | -##### Query parameters | |
| 54 | -* **nb=5** *(number of post, -1 is all, default: 5)* | |
| 55 | -* **future=1** *(boolean, retreive, or not, events in the future, default = 1)* | |
| 56 | -* **past=0** *(boolean, retreive, or not, events in the past, default = 0)* | |
| 57 | -* **cat=''** *(string, select posts only from the selected category, default=null, for all categories)* | |
| 58 | -* **tag=''** *(string, select posts only from the selected tag, default=null, for all tags)* | |
| 59 | -* **geo=0** *(boolean, retreives or not, only events wich have geolocation informations, default=0)* | |
| 60 | -* **order="ASC"** *(string (can be "ASC" or "DESC")* | |
| 61 | -* **orderby="meta_value"** *(string (if set to "meta_value" events are sorted by event date, possible values are native posts fileds : "post_title","post_date" etc...)* | |
| 62 | - | |
| 63 | -##### Display parameters | |
| 64 | - | |
| 65 | -* **thumbnail=""** * (Bool, default:false, used to display posts thumbnails)* | |
| 66 | -* **thumbnail_size=""** * (String, default:"thmbnail", can be set to any existing size : "medium","large","full" etc...)* | |
| 67 | -* **excerpt=""** * (Bool, default:false, used to display posts excerpts)* | |
| 68 | -* **style=""** * (String, add some inline CSS to the list wrapper)* | |
| 69 | -* **type=div** *(string, possible values are : div, ul, ol default=div)* | |
| 70 | -* **title=''** *(string, hidden if no events is found)* | |
| 71 | -* **before_title="<h3>"** *(string (default <h3>)* | |
| 72 | -* **after_title="</h3>"** *(string (default </h3>)* | |
| 73 | -* **container_schema=""** *(string html schema to display list)* | |
| 74 | -* **item_schema=""** *(string html schema to display item)* | |
| 75 | - | |
| 76 | -example : `[events_list future=1 past=1 cat="actuality" nb=10]` | |
| 77 | - | |
| 78 | -container_schema default value : | |
| 79 | - | |
| 80 | -> <%type% class="event_loop %id% %class%" id="%listid%" style="%style%" %attributes%> | |
| 81 | -> %list% | |
| 82 | -> </%type%> | |
| 83 | -> | |
| 84 | - | |
| 85 | - | |
| 86 | -item_schema default value : | |
| 87 | - | |
| 88 | -> <%child% class="event_item %class%" data-color="%color%"> | |
| 89 | -> <a href="%event_link%"> | |
| 90 | -> %event_thumbnail% | |
| 91 | -> <h5>%event_title%</h5> | |
| 92 | -> </a> | |
| 93 | -> %event_date% | |
| 94 | -> %event_cat% | |
| 95 | -> %event_location% | |
| 96 | -> %event_excerpt% | |
| 97 | -> </%child%> | |
| 98 | -> | |
| 99 | - | |
| 100 | -####[events_map] | |
| 101 | - | |
| 102 | -* **nb=5** *(number of post, -1 is all, default: 5)* | |
| 103 | -* **future=1** *(boolean, retreive, or not, events in the future, default = 1)* | |
| 104 | -* **past=0** *(boolean, retreive, or not, events in the past, default = 0)* | |
| 105 | -* **cat=''** *(string, select posts only from the selected category, default=null, for all categories)* | |
| 106 | -* **tag=''** *(string, select posts only from the selected tag, default=null, for all tags)* | |
| 107 | -* **tile=''** *(string ([email protected], OpenCycleMap, mapquest, osmfr, 2u, satelite, toner), sets the map background, [email protected])* | |
| 108 | -* **title=''** *(string (default )* | |
| 109 | -* **before_title="<h3>"** *(string (default <h3>)* | |
| 110 | -* **after_title="</h3>"** *(string (default </h3>)** **thumbnail=""** * (Bool, default:false, used to display posts thumbnails)* | |
| 111 | -* **excerpt=""** * (Bool, default:false, used to display posts excerpts)* | |
| 112 | - | |
| 113 | -example: `[events_map future=1 past=1 cat="actuality" nb="-1"]` | |
| 114 | - | |
| 115 | -####[events_cal] | |
| 116 | - | |
| 117 | -* **cat=''** *(string, select posts only from the selected category, default=null, for all categories)* | |
| 118 | -* **date=''** *(string, date for a month. Absolutly : 2013-9 or relatively : -1 month, default is empty, current month* | |
| 119 | -* **datepicker=1** *(boolean, displays or not a date picker* | |
| 120 | -* **mondayfirst=0** *(boolean, weeks start on monday, default is 0 (sunday)* | |
| 121 | - | |
| 122 | -example: `[events_cal cat="actuality" date="-2 months" mondayfirst=1]` | |
| 123 | - | |
| 124 | -####[event_details] | |
| 125 | - | |
| 126 | -* **attribute** string (date, start, end, address, location). The default value is NULL adn displays the full event bar | |
| 127 | - | |
| 128 | - | |
| 129 | -= Hooks = | |
| 130 | -<a id="hooks"></a> | |
| 131 | -#### Filters | |
| 132 | -* eventpost_get | |
| 133 | -* eventpost_getsettings | |
| 134 | -* eventpost_item_scheme_entities | |
| 135 | -* eventpost_item_scheme_values | |
| 136 | -* eventpost_list_shema | |
| 137 | -* eventpost_listevents | |
| 138 | -* eventpost_multisite_get | |
| 139 | -* eventpost_multisite_blogids | |
| 140 | -* eventpost_params | |
| 141 | -* eventpost_printdate | |
| 142 | -* eventpost_printlocation | |
| 143 | -* eventpost_retreive | |
| 144 | - | |
| 145 | -#### Actions | |
| 146 | -* before_eventpost_generator | |
| 147 | -* after_eventpost_generator | |
| 148 | -* eventpost_getsettings | |
| 149 | -* eventpost_settings_form | |
| 150 | -* eventpost_after_settings_form | |
| 151 | - | |
| 152 | -== Installation == | |
| 153 | - | |
| 154 | -1. Upload `event-post` to the `/wp-content/plugins/` directory | |
| 155 | -2. Activate the plugin through the 'Plugins' menu in WordPress admin | |
| 156 | -3. You can edit defaults settings in Settings > Event post | |
| 157 | - | |
| 158 | -== Frequently asked questions == | |
| 159 | - | |
| 160 | -= Is the plugin fetches free ? = | |
| 161 | -Yes, and it uses only open-sources : openstreetmap, openlayer, jquery | |
| 162 | - | |
| 163 | - | |
| 164 | -== Screenshots == | |
| 165 | - | |
| 166 | -1. Single page | |
| 167 | -2. Editor interface | |
| 168 | -3. Map | |
| 169 | - | |
| 170 | -== Changelog == | |
| 171 | - | |
| 172 | -= Comming = | |
| 173 | -* Support of OpenWeatherMap | |
| 174 | - | |
| 175 | -= 3.9.0 = | |
| 176 | -release date: oct. 6 2015 | |
| 177 | - | |
| 178 | -* Add width and height options in map widget | |
| 179 | -* Add thumbnail + size option in both list, map and calendar widgets | |
| 180 | -* Add some [hooks](https://wordpress.org/plugins/event-post/other_notes/#hooks) | |
| 181 | -* Code cleanup | |
| 182 | - | |
| 183 | -= 3.8.2 = | |
| 184 | -* fix bug in past events fetching | |
| 185 | - | |
| 186 | -= 3.8.1 = | |
| 187 | -release date: sept. 23 2015 | |
| 188 | - | |
| 189 | -* Fix time zone issue | |
| 190 | -* Add filter hook to list_events() | |
| 191 | -* Add some explicit CSS classes to elements | |
| 192 | - | |
| 193 | -= 3.8.0 = | |
| 194 | -release date: sept. 22 2015 | |
| 195 | - | |
| 196 | -* Some wording | |
| 197 | -* Add an option for time format | |
| 198 | -* wrap export buttons in event list | |
| 199 | -* Fix javascript bug in map when no default tile is set | |
| 200 | -* Remove dummy javascript debug infos | |
| 201 | - | |
| 202 | -= 3.7.0 = | |
| 203 | -release date: sept. 15 2015 | |
| 204 | - | |
| 205 | -* Update OpenLayer to version 3.9 | |
| 206 | -* Add Map interaction options (MouseWheelZoom, PinchZoom...) | |
| 207 | -* Add option for datepicker UI | |
| 208 | -* Add eligible post types option | |
| 209 | -* Better performances | |
| 210 | -* Fix PHP Warnings | |
| 211 | - | |
| 212 | -= 3.6.8 = | |
| 213 | -* update french translation | |
| 214 | - | |
| 215 | -= 3.6.7 = | |
| 216 | -* more WP 4.3 compliant | |
| 217 | - | |
| 218 | -= 3.6.6 = | |
| 219 | -* Fix PHP warnings | |
| 220 | - | |
| 221 | -= 3.6.5 = | |
| 222 | -release date: aug. 14 2015 | |
| 223 | - | |
| 224 | -* Fix bad html syntax | |
| 225 | -* Make plugin WP 4.3 compliant | |
| 226 | -* Add lot of comments | |
| 227 | -* Update swedish translation thanks to @mepmepmep | |
| 228 | - | |
| 229 | -= 3.6.4 = | |
| 230 | -* Fix displaying of dates in map | |
| 231 | - | |
| 232 | -= 3.6.3 = | |
| 233 | -* Better multisite sort | |
| 234 | -* Fix multiple dates | |
| 235 | -* Fix CSS issue between ical export buttons and category | |
| 236 | - | |
| 237 | -= 3.6.2 = | |
| 238 | -* Fix "get_plugin_data" error, finally remove the function. | |
| 239 | - | |
| 240 | -= 3.6.1 = | |
| 241 | -* Fix "get_plugin_data" error | |
| 242 | - | |
| 243 | -= 3.6.0 = | |
| 244 | -* Add version to static files (JS/CSS) to prevent from local cache problems | |
| 245 | -* Add sort parameters in shortcode UI | |
| 246 | -* Fix lang on datepicker | |
| 247 | -* Fix bug (missing dates) for multisite functions | |
| 248 | -* Code cleanup, Retrocompatibilty to PHP<5.3 | |
| 249 | - | |
| 250 | -= 3.5.4 = | |
| 251 | -* Fix empty date storing | |
| 252 | -* Re-add quarters in time | |
| 253 | - | |
| 254 | -= 3.5.3 = | |
| 255 | -* Improve accessibility, use of native colors from the theme for links | |
| 256 | -* More hookable ajax URL for calendar | |
| 257 | -* Upgrade IT locale | |
| 258 | -* Fix php warnings | |
| 259 | -* Fix shortcake compatibility in pages | |
| 260 | - | |
| 261 | -= 3.5.2 = | |
| 262 | -* Fix missing files in last commit | |
| 263 | - | |
| 264 | -= 3.5.0 = | |
| 265 | -* Add **event_details** shortcode | |
| 266 | -* Add integration with shotcake (ShortCodes UI) | |
| 267 | -* Add Optional event icons in the loop | |
| 268 | -* Optimize UI : New datepicker, separated date and address custom boxes | |
| 269 | -* Add stats in dashboard glance items | |
| 270 | -* Code optimization | |
| 271 | -* Update IT localization by pgallina | |
| 272 | - | |
| 273 | -= 3.4.2 = | |
| 274 | -* Fix: remove PHP warnings | |
| 275 | -* Fix: JS script not loaded when the "calendar widget" is alone | |
| 276 | - | |
| 277 | -= 3.4.1 = | |
| 278 | -* Fix: remove PHP warnings | |
| 279 | - | |
| 280 | -= 3.4.0 = | |
| 281 | -* Add: Whole category ICS feed (link available in list widget, for future events) | |
| 282 | -* Fix: JS was not loaded in single events since last version | |
| 283 | -* Fix: Strict Standards warning, reported by argad | |
| 284 | -* Fix: Dependence of OpenLayer librairy not needed by calendar widget, reported by p1s1 | |
| 285 | - | |
| 286 | -= 3.3.0 = | |
| 287 | -* Add: eventpost_list_shema filter | |
| 288 | -* Add: Global container/item shema settings | |
| 289 | -* Add: Security improvement in settings management | |
| 290 | -* Fix: Load scripts only of needed | |
| 291 | - | |
| 292 | -= 3.2.4 = | |
| 293 | -* Fix: Previous fix fix | |
| 294 | - | |
| 295 | -= 3.2.3 = | |
| 296 | -* Fix: Custom icons fix | |
| 297 | - | |
| 298 | -= 3.2.2 = | |
| 299 | -* Fix: Category filter | |
| 300 | -* Fix: Add max zoom | |
| 301 | - | |
| 302 | -= 3.2.1 = | |
| 303 | -* Fix: Event list widget : missing title | |
| 304 | - | |
| 305 | -= 3.2.0 = | |
| 306 | -* Add: Italian localization, thanks to NewHouseStef | |
| 307 | - | |
| 308 | -= 3.1.1 = | |
| 309 | -* Fix: Future/past display style | |
| 310 | - | |
| 311 | -= 3.1.0 = | |
| 312 | -* Add: Save default settings to improve performances | |
| 313 | -* Add: More options in list and map widgets | |
| 314 | - | |
| 315 | -= 3.0.0 = | |
| 316 | -* Update to OpenLayer3 | |
| 317 | -* Add: Responsive support | |
| 318 | -* Add: Satelite and Toner view | |
| 319 | -* Add: `cat` attributes now accepts multiple categories values ( cat="1,2,3" ) | |
| 320 | -* Add: Custom markers directory for developpers | |
| 321 | -* Add: Global "event bar position" option : before or after the single content | |
| 322 | -* Fix: Cleaner settings page | |
| 323 | - | |
| 324 | -= 2.8.12 = | |
| 325 | -* Add : Swedish localization, thanks to Mepmepmep | |
| 326 | - | |
| 327 | -= 2.8.11 = | |
| 328 | -* Fix : PHP warnings on empty dates | |
| 329 | - | |
| 330 | -= 2.8.10 = | |
| 331 | -* Fix : 00 minutes bug | |
| 332 | - | |
| 333 | -= 2.8.9 = | |
| 334 | -* Fix : Bug fix | |
| 335 | -* Change : Multisite support is no more a separated plugin | |
| 336 | - | |
| 337 | -= 2.8.8 = | |
| 338 | -* Fix : Empty date error | |
| 339 | - | |
| 340 | -= 2.8.7 = | |
| 341 | -* Fix : JS error in minified osm-admin.js file | |
| 342 | - | |
| 343 | -= 2.8.6 = | |
| 344 | -* Fix : Error while retreiving the excerpt | |
| 345 | - | |
| 346 | -= 2.8.5 = | |
| 347 | -* Add : Setting to print/hide link for events with empty content | |
| 348 | -* Fix : Check content with queried object instead of global $post | |
| 349 | -* Fix : Bug in calendar animations | |
| 350 | - | |
| 351 | -= 2.8.4 = | |
| 352 | -* Fix : Optimize JS in admin side | |
| 353 | -* Add : French and chinese localisation for date-picker | |
| 354 | -* Add : Minify CSS | |
| 355 | - | |
| 356 | -= 2.8.3 = | |
| 357 | -* Fix : bug fix | |
| 358 | - | |
| 359 | -= 2.8.2 = | |
| 360 | -* Fix : apply content filter most later | |
| 361 | - | |
| 362 | -= 2.8.1 = | |
| 363 | -* Fix : content filter bug on home page | |
| 364 | - | |
| 365 | -= 2.8.0 = | |
| 366 | -* Add : attributes to events_list shortcode : | |
| 367 | -* * thumbnail=(true/false) | |
| 368 | -* * thumbnail_size=thumbnail | |
| 369 | -* * excertp=(true/false) | |
| 370 | -* * container_schema (documentation comming soon) | |
| 371 | -* * item_schema (documentation comming soon) | |
| 372 | -* Add : Usage of the event color for single details | |
| 373 | -* Enhance : Event information form UI | |
| 374 | -* Fix : Re-check if end date is after begin date | |
| 375 | -* Fix : CSS adjustments | |
| 376 | -* Fix : CSS adjustments | |
| 377 | -* Fix : Prevent from filters applying "the_content" on another thing than the current post content | |
| 378 | - | |
| 379 | - | |
| 380 | -= 2.7.1 = | |
| 381 | -* Fix : Really check all blogs when using "blogs=all" in shortcodes. May cause memory limit on big networks | |
| 382 | - | |
| 383 | -= 2.7.0 = | |
| 384 | -* Add : Multisite event list support | |
| 385 | -* Add : Integration of several hooks | |
| 386 | -* Add : Map widget | |
| 387 | -* Add : Parameters to display or not export buttons | |
| 388 | -* Add : Native WP icons for map and calendar items | |
| 389 | -* Add : data-color in list items | |
| 390 | -* Fix : Event's first day not shown in calendar | |
| 391 | -* Fix : Use of minified JS files | |
| 392 | - | |
| 393 | -= 2.6.0 = | |
| 394 | -* Add : order and orderby parameters for shortcode [events_list] | |
| 395 | - | |
| 396 | -= 2.5.0 = | |
| 397 | -* Add : tag and style parameters for shortcode [events_list] | |
| 398 | - | |
| 399 | -= 2.4.1 = | |
| 400 | -* Fix : Parameters bug in export files | |
| 401 | - | |
| 402 | -= 2.4.0 = | |
| 403 | -* Add : Calendar widget/shortcode | |
| 404 | - | |
| 405 | -= 2.3.3 = | |
| 406 | -* Add : Improve address search UI | |
| 407 | -* Fix : Address search bug fix | |
| 408 | - | |
| 409 | -= 2.3.2 = | |
| 410 | -* Add : make the function "EventPost::get_events" usable with an array as param | |
| 411 | -* Fix : Use of https links | |
| 412 | -* Fix : Change licence from CC BY-NC to GPLv3 | |
| 413 | - | |
| 414 | -= 2.3.1 = | |
| 415 | -* Fix : OSM map link error | |
| 416 | - | |
| 417 | -= 2.3.0 = | |
| 418 | -* Add : update openlayer version to 2.13.1 | |
| 419 | -* Add : change Map UI buttons | |
| 420 | -* Add : Shortcode editor | |
| 421 | -* Fix : Minor JS bug | |
| 422 | - | |
| 423 | -= 2.2.4 = | |
| 424 | -* Fix : Quick edit was removing date and geo datas | |
| 425 | -* Fix : PHP Warning | |
| 426 | - | |
| 427 | -= 2.2.3 = | |
| 428 | -* Add : Title, before_title and after_title attributes to shortcode functions | |
| 429 | -* Fix : Do not display empty title in widget | |
| 430 | - | |
| 431 | -= 2.2.2 = | |
| 432 | -* Add : add custom box to all post-types | |
| 433 | - | |
| 434 | -= 2.2.1 = | |
| 435 | -* Fix : bad output | |
| 436 | - | |
| 437 | -= 2.2.0 = | |
| 438 | -* Add : Admin settings page : choose a date format and a default map background | |
| 439 | -* Add : Tile option for map shortcode, select a map background for a particular map | |
| 440 | -available maps : [email protected], OpenCycleMap, mapquest, osmfr, 2u | |
| 441 | - | |
| 442 | -= 2.1.0 = | |
| 443 | -* Add : ajaxloader icon for address search | |
| 444 | -* Add : Event and location columns in posts list | |
| 445 | -* Add : widget description | |
| 446 | -* Add : place icon when available for address search | |
| 447 | -* Fix : Empty display_name property in address search | |
| 448 | - | |
| 449 | -= 2.0.0 = | |
| 450 | -* Add: Category option for widgets and shortcodes | |
| 451 | -* Add: Force end date to be greater than begin date | |
| 452 | -* Add: Separate search field for GPS and address | |
| 453 | -* Fix: Wrong parameter for widget options | |
| 454 | -* Fix: Load jquery datetimepicker only if not supported by the browser | |
| 455 | - | |
| 456 | -= 1.1.0 = | |
| 457 | -* Add: Width & height properties in the '[events_map]' shortcode | |
| 458 | -* Add: Allow multiple maps on the same page | |
| 459 | -* Fix: Same ID in multiple DOM elements bug fix | |
| 460 | -* Fix: Some W3C standard corrections | |
| 461 | - | |
| 462 | -= 1.0.0 = | |
| 463 | -* Plugin creation | |
| 464 | - | |
| 465 | -== Upgrade notice == | |
| 466 | - | |
| 467 | -= 3.6.2 = | |
| 468 | -* Fix "get_plugin_data" error. | |
| 469 | - | |
| 470 | -= 3.5.0 = | |
| 471 | -* New options are available for: icons in the loop, default position of the admin boxes | |
| 472 | -* New shortcode [event_details] is available | |
| 473 | -* Support for Shortcake (Shortcode UI plugin) | |
| 474 | - | |
| 475 | -= 2.7.0 = | |
| 476 | -* The event meta box is no more displayed for non posts items such as pages or custom post-types | |
| 477 | -* Please active the multisite plugin in order to allow your users to browse events from the network | |
| 1 | +# Event Post | |
| 2 | +Contributors: agencenous, bastho, aureliefoucher, enzomangiante, leroysabrina, unecologeek | |
| 3 | +Donate link: https://apps.avecnous.eu/en/product/eventpost/?mtm_campaign=wp-plugin&mtm_kwd=event-post&mtm_medium=wp-repo&mtm_source=donate | |
| 4 | +Tags: calendar, events, booking, map, geolocation | |
| 5 | +Requires at least: 6.3 | |
| 6 | +Tested up to: 7.1 | |
| 7 | +Stable tag: 6.1.2 | |
| 8 | +Author URI: https://apps.avecnous.eu/?mtm_campaign=wp-plugin&mtm_kwd=event-post&mtm_medium=wp-repo&mtm_source=author | |
| 9 | +License: GPLv2 | |
| 10 | +License URI: https://www.gnu.org/licenses/gpl-2.0.html | |
| 11 | + | |
| 12 | +The only WordPress plugin using native posts as full calendar events with begin and end date, geolocation, color and weather. | |
| 13 | + | |
| 14 | +## Description | |
| 15 | + | |
| 16 | +Adds some meta-data to posts to convert them into full calendar events. | |
| 17 | +Each event can be exported into ical(.ics), outlook(vcs), or Google Calendar. | |
| 18 | +Geolocation works thanks to openstreetmap. | |
| 19 | + | |
| 20 | +It can also fetch the weather, but doesn't bring the sun :) | |
| 21 | + | |
| 22 | +Follow [@wpeventpost](https://twitter.com/wpeventpost) on Twitter for latest news. | |
| 23 | + | |
| 24 | +Examples on [event-post.com](https://event-post.com/?mtm_campaign=wp-plugin&mtm_kwd=event-post&mtm_medium=wp.org) | |
| 25 | + | |
| 26 | +### Post metas | |
| 27 | + | |
| 28 | +**Date attributes** | |
| 29 | + | |
| 30 | +* Begin Date | |
| 31 | +* End Date | |
| 32 | +* Color | |
| 33 | +* Event Status | |
| 34 | +* Event Attendance Mode | |
| 35 | + | |
| 36 | +**Location attributes** | |
| 37 | + | |
| 38 | +* Address | |
| 39 | +* GPS coordinates | |
| 40 | +* Event Virtual Location | |
| 41 | + | |
| 42 | +**WooCommerce compliant** | |
| 43 | + | |
| 44 | +You can enable event features on Woocommerce products. The event will be displayed on the product page. Moreover, the product price will be displayed in event list, calendar, map and timeline. | |
| 45 | + | |
| 46 | +This, way, you can sell tickets for your events, effortlessly and without any additional plugin. | |
| 47 | + | |
| 48 | +**Weather attribute** (for a given location and date if possible) | |
| 49 | + | |
| 50 | +* Weather | |
| 51 | + - Temperature | |
| 52 | + - Weather | |
| 53 | + | |
| 54 | +### Usage | |
| 55 | + | |
| 56 | +[Plugins/themes developpers documentation](https://event-post.com/docs/event-post/?mtm_campaign=wp-plugin&mtm_kwd=event-post&mtm_medium=wp.org) | |
| 57 | + | |
| 58 | +## Blocks & Shortcodes | |
| 59 | +The plugin comes with several blocks/shortcodes which allows to: | |
| 60 | + | |
| 61 | +* `[events_list]`: display a list of events | |
| 62 | +* `[events_map]`: display a map of events | |
| 63 | +* `[events_cal]`: display a calendar of events | |
| 64 | +* `[event_details]`: display a detail of the current event | |
| 65 | +* `[event_term]`: display the date range of a given term based on all events it contains | |
| 66 | + | |
| 67 | +### [events_list] | |
| 68 | +#### Query parameters | |
| 69 | +* **nb=5** *(number of post, -1 is all, default: 5)* | |
| 70 | +* **future=1** *(boolean, retrieve, or not, events in the future, default = 1)* | |
| 71 | +* **past=0** *(boolean, retrieve, or not, events in the past, default = 0)* | |
| 72 | +* **cat=''** *(string, select posts only from the selected category, default=null, for all categories)* | |
| 73 | +* **tag=''** *(string, select posts only from the selected tag, default=null, for all tags)* | |
| 74 | +* **tax_name=''** *(string, custom taxonomy name)* | |
| 75 | +* **tax_term=''** *(string, the term for above taxonomy)* | |
| 76 | +* **geo=0** *(boolean, retreives or not, only events which have geolocation informations, default=0)* | |
| 77 | +* **order="ASC"** *(string, can be "ASC" or "DESC")* | |
| 78 | +* **orderby="meta_value"** *(string, if set to "meta_value" events are sorted by event date, possible values are native posts fields : "post_title","post_date" etc...)* | |
| 79 | + | |
| 80 | +#### Display parameters | |
| 81 | + | |
| 82 | +* **thumbnail=''** *(Bool, default:false, used to display posts thumbnails)* | |
| 83 | +* **thumbnail_size=''** *(String, default:"thmbnail", can be set to any existing size : "medium","large","full" etc...)* | |
| 84 | +* **excerpt=''** *(Bool, default:false, used to display posts excerpts)* | |
| 85 | +* **style=''** *(String, add some inline CSS to the list wrapper)* | |
| 86 | +* **type="div"** *(string, possible values are : div, ul, ol default=div)* | |
| 87 | +* **title=''** *(string, hidden if no events is found)* | |
| 88 | +* **before_title='<h3>'** *(string, default <h3>)* | |
| 89 | +* **after_title='</h3>'** *(string, default </h3>)* | |
| 90 | +* **container_schema=''** *(string html schema to display list)* | |
| 91 | +* **item_schema=''** *(string html schema to display item)* | |
| 92 | + | |
| 93 | +example: | |
| 94 | + | |
| 95 | +`<!-- wp:eventpost/list {"nb":10,"future":true,"past":true,"thumbnail":false,"excerpt":false,"pages":true} /-->` | |
| 96 | + | |
| 97 | +`[events_list future=1 past=1 cat="actuality" nb=10]` | |
| 98 | + | |
| 99 | + | |
| 100 | +container_schema default value: | |
| 101 | + | |
| 102 | +> <%type% class="event_loop %id% %class%" id="%listid%" style="%style%" %attributes%> | |
| 103 | +> %list% | |
| 104 | +> </%type%> | |
| 105 | +> | |
| 106 | + | |
| 107 | + | |
| 108 | +item_schema default value: | |
| 109 | + | |
| 110 | +> <%child% class="event_item %class%" data-color="%color%"> | |
| 111 | +> <a href="%event_link%"> | |
| 112 | +> %event_thumbnail% | |
| 113 | +> <h5>%event_title%</h5> | |
| 114 | +> </a> | |
| 115 | +> %event_date% | |
| 116 | +> %event_cat% | |
| 117 | +> %event_location% | |
| 118 | +> %event_excerpt% | |
| 119 | +> </%child%> | |
| 120 | +> | |
| 121 | + | |
| 122 | +### [events_map] | |
| 123 | + | |
| 124 | +* **nb=5** *(number of post, -1 is all, default: 5)* | |
| 125 | +* **future=1** *(boolean, retreive, or not, events in the future, default = 1)* | |
| 126 | +* **past=0** *(boolean, retreive, or not, events in the past, default = 0)* | |
| 127 | +* **cat=''** *(string, select posts only from the selected category, default=null, for all categories)* | |
| 128 | +* **tag=''** *(string, select posts only from the selected tag, default=null, for all tags)* | |
| 129 | +* **tax_name=''** *(string, custom taxonomy name)* | |
| 130 | +* **tax_term=''** *(string, the term for above taxonomy)* | |
| 131 | +* **tile=''** *(string ([email protected], OpenCycleMap, mapquest, osmfr, 2u, satelite, toner), sets the map background, [email protected])* | |
| 132 | +* **title=''** *(string, default)* | |
| 133 | +* **zoom=''** *(number or empty, default, means fit to points)* | |
| 134 | +* **before_title='<h3>';** *(string, default <h3>)* | |
| 135 | +* **after_title='</h3>'** *(string, default </h3>)** | |
| 136 | +* **thumbnail=''** * (Bool, default:false, used to display posts thumbnails)* | |
| 137 | +* **excerpt=''** *(Bool, default:false, used to display posts excerpts)* | |
| 138 | +* **list=''** *(String ("false", "above", "below", "right", "left") default: "false", Display a list of posts)* | |
| 139 | + | |
| 140 | +example: | |
| 141 | + | |
| 142 | +`<!-- wp:eventpost/map {"nb":-1,"future":true,"past":true,"tile":"toner","list":"below","map_position":false,"disable_mousewheelzoom":true} /-->` | |
| 143 | + | |
| 144 | +`[events_map future=1 past=1 cat="actuality" nb="-1"]` | |
| 145 | + | |
| 146 | +### [events_cal] | |
| 147 | + | |
| 148 | +* **cat=''** *(string, select posts only from the selected category, default=null, for all categories)* | |
| 149 | +* **date=''** *(string, date for a month. Absolutly : 2013-9 or relatively : -1 month, default is empty, current month)* | |
| 150 | +* **datepicker=1** *(boolean, displays or not a date picker)* | |
| 151 | +* **mondayfirst=0** *(boolean, weeks start on monday, default is 0 sunday)* | |
| 152 | +* **display_title=0** *(boolean, displays or not events title under the day number)* | |
| 153 | +* **tax_name=''** *(string, custom taxonomy name)* | |
| 154 | +* **tax_term=''** *(string, the term for above taxonomy)* | |
| 155 | + | |
| 156 | +example: | |
| 157 | + | |
| 158 | +`<!-- wp:eventpost/calendar {"date":"-2 months","color":true,"display_title":true,"mondayfirst":"1","choose":false} /-->` | |
| 159 | + | |
| 160 | +`[events_cal cat="actuality" date="-2 months" mondayfirst=1 display_title=1]` | |
| 161 | + | |
| 162 | +### [event_details] | |
| 163 | + | |
| 164 | +* **attribute** *string (date, start, end, address, location). The default value is NULL and displays the full event bar* | |
| 165 | + | |
| 166 | +`<!-- wp:eventpost/details /-->` | |
| 167 | + | |
| 168 | +`[event_details attribute="address"]` | |
| 169 | + | |
| 170 | +### Hooks | |
| 171 | +<a id="hooks"></a> | |
| 172 | +#### Filters | |
| 173 | +* eventpost_add_custom_box_position | |
| 174 | +* event_post_class_calendar_link | |
| 175 | +* eventpost_columns_head | |
| 176 | +* eventpost_contentbar | |
| 177 | +* eventpost_default_list_shema | |
| 178 | +* eventpost_get | |
| 179 | +* eventpost_get_items | |
| 180 | +* eventpost_get_post_types | |
| 181 | +* eventpost_get_single | |
| 182 | +* eventpost_getsettings | |
| 183 | +* eventpost_item_scheme_entities | |
| 184 | +* eventpost_item_scheme_values | |
| 185 | +* eventpost_list_shema | |
| 186 | +* eventpost_listevents | |
| 187 | +* eventpost_maps | |
| 188 | +* eventpost_multisite_get | |
| 189 | +* eventpost_multisite_blogids | |
| 190 | +* eventpost_params | |
| 191 | +* eventpost_printdate | |
| 192 | +* eventpost_printlocation | |
| 193 | +* eventpost_bulk_edit_fields | |
| 194 | +* eventpost_quick_edit_fields | |
| 195 | +* eventpost_retreive | |
| 196 | +* event-post-rich-result | |
| 197 | +* eventpost_shortcode_slug | |
| 198 | + | |
| 199 | +#### Actions | |
| 200 | +* evenpost_init | |
| 201 | +* eventpost_add_custom_box | |
| 202 | +* eventpost_custom_box_date | |
| 203 | +* eventpost_custom_box_loc | |
| 204 | +* after_eventpost_generator | |
| 205 | +* eventpost_getsettings | |
| 206 | +* eventpost_settings_form | |
| 207 | +* eventpost_after_settings_form | |
| 208 | + | |
| 209 | +## Installation | |
| 210 | + | |
| 211 | +1. Upload `event-post` to the `/wp-content/plugins/` directory | |
| 212 | +2. Activate the plugin through the 'Plugins' menu in WordPress admin | |
| 213 | +3. You can edit defaults settings in Settings > Event post | |
| 214 | + | |
| 215 | +## Frequently asked questions | |
| 216 | + | |
| 217 | +### How can I report security bugs? | |
| 218 | +You can report security bugs through the Patchstack Vulnerability Disclosure Program. The Patchstack team help validate, triage and handle any security vulnerabilities. [Report a security vulnerability.](https://patchstack.com/database/wordpress/plugin/event-post/vdp) | |
| 219 | + | |
| 220 | +### Is the plugin free ? | |
| 221 | +Yes, and it uses only open-sources : openstreetmap, openlayer, jquery | |
| 222 | + | |
| 223 | +### How do I enable weather feature ? | |
| 224 | +Weather feature uses openweathermap.org api. | |
| 225 | + | |
| 226 | +You have to create an account and generate an API key at http://openweathermap.org/price | |
| 227 | + | |
| 228 | +I have no interest in openweathermap.org, I personally use the free plan. | |
| 229 | + | |
| 230 | +### Is there any limitation for the weather feature ? | |
| 231 | +Openweathermap.org provides a free plan limited to 60 requests per minute. | |
| 232 | + | |
| 233 | +You can also subscribe to paid plan, I don't care. | |
| 234 | + | |
| 235 | + | |
| 236 | +## Screenshots | |
| 237 | + | |
| 238 | +1. Map in single page | |
| 239 | +2. Editor interface for the List Block | |
| 240 | +3. Editor interface for event data | |
| 241 | +4. Editor interface for location data | |
| 242 | +## Changelog | |
| 243 | + | |
| 244 | +### 6.1.2 | |
| 245 | + | |
| 246 | +- Fix ability of logged-in users to create child events on posts they aren't allowed edit - Reported by Ananda Dhakal | |
| 247 | +- Fix ability of logged-in users to delete posts without checking permissions - Reported by genisis-lab | |
| 248 | +- Tested up to WP 7.1 | |
| 249 | +- Keep the internal version number in sync with the plugin header | |
| 250 | + | |
| 251 | +### 6.1.1 | |
| 252 | + | |
| 253 | +- Check for event status in export - Reported by Que Thanh Tuan | |
| 254 | +- Add HTTP code in export error | |
| 255 | +- Fix warning about variable references | |
| 256 | + | |
| 257 | +### 6.1.0 | |
| 258 | + | |
| 259 | +- Improves Timeline: | |
| 260 | + - Add mouse swipe on timeline | |
| 261 | + - Add support for responsive number of items | |
| 262 | + - More intuitive controls in editor | |
| 263 | +- Improves Calendar: | |
| 264 | + - Use toggle controls in calendar editor | |
| 265 | + - Add swipe and horizontal scroll navigation | |
| 266 | +- Fixes: | |
| 267 | + - Fix support for classname on blocks | |
| 268 | + - Fix shown HTML in title | |
| 269 | + | |
| 270 | +### 6.0.1 | |
| 271 | + | |
| 272 | +- Show all events in timeline | |
| 273 | +- Default to 3 items in timeline pages | |
| 274 | + | |
| 275 | +### 6.0.0 | |
| 276 | + | |
| 277 | +- Add align support on blocks | |
| 278 | +- Improves Timeline: | |
| 279 | + - New vertical layout | |
| 280 | + - New "order" option | |
| 281 | + - Add gesture support | |
| 282 | + - Add time markers | |
| 283 | + - Use CSS vars | |
| 284 | +- Improves Map: | |
| 285 | + - Split options in editor | |
| 286 | + - Ensure data are loaded before rendering map block | |
| 287 | +- Security: Add direct file access protections | |
| 288 | +- Add comments for translators | |
| 289 | +- Update apiVersion to 3 in block declarations | |
| 290 | + | |
| 291 | +### 5.12.0 | |
| 292 | + | |
| 293 | +- More reliable interaction options in map block editor | |
| 294 | +- Add new geocode method for factorization purpose | |
| 295 | +- Fix margins in map block editor | |
| 296 | +- Update deps | |
| 297 | + | |
| 298 | +### 5.11.1 | |
| 299 | + | |
| 300 | +- Update dependencies | |
| 301 | + | |
| 302 | +### 5.11.0 | |
| 303 | + | |
| 304 | +- More flexible filters in ICS links: allows to deal with custom taxonomies | |
| 305 | +- ICS: Improve DESCRIPTION formatting for better calendar compatibility | |
| 306 | +- Security: Escape some outputs | |
| 307 | + | |
| 308 | +### 5.10.4 | |
| 309 | + | |
| 310 | +- Fix geocoding with Nominatim: use HTTPS, add User-agent and referer for API calls | |
| 311 | +- Add explicit Nominatim attribution in geocoding tool | |
| 312 | +- Fix XSS vulnerability when the HTML tag in event_type was forced, reported by Muhammad Yudha - DJ | |
| 313 | + | |
| 314 | +### 5.10.3 | |
| 315 | + | |
| 316 | +- Fix broken HTML for `container_schema` | |
| 317 | + | |
| 318 | +### 5.10.2 | |
| 319 | + | |
| 320 | +- Security: Fix XSS vulnerability in `events_list` shortcode for `item_schema` and `container_schema` attributes, reported by Peter Thaleikis | |
| 321 | +- Update dependencies | |
| 322 | + | |
| 323 | +### 5.10.1 | |
| 324 | + | |
| 325 | +- Ensure script is loaded in shortcode context | |
| 326 | +- Fix "undefined" price in map | |
| 327 | + | |
| 328 | +### 5.10.0 | |
| 329 | + | |
| 330 | +- Add support for organization / remote offer in rich event data | |
| 331 | +- Manage multiple maps on single page | |
| 332 | +- Security: Escape attributes in custom boxes | |
| 333 | +- Fix too much escaped HTML in `eventpost/details` block | |
| 334 | +- Fix missing script for single map link | |
| 335 | +- Disambiguate `event_category` class | |
| 336 | +- Remove deprecated `FILTER_SANITIZE_STRING` | |
| 337 | +- Moves Weather to EventPost namespace | |
| 338 | +- Re-order hooks, fix warnings | |
| 339 | + | |
| 340 | +### 5.9.11 | |
| 341 | + | |
| 342 | +- fix save_bulkdatas(): Add nonce verification for security, reported by Francesco Carlucci | |
| 343 | +- fix `ltrim()` Passing null to parameter 1, reported by ov3rfly | |
| 344 | + | |
| 345 | +### 5.9.10 | |
| 346 | + | |
| 347 | +- Security: Authenticated (Contributor+) Stored Cross-Site Scripting, reported by Peter Thaleikis | |
| 348 | + | |
| 349 | +### 5.9.9 | |
| 350 | + | |
| 351 | +- Security: Sanitize GPS coordinates, fixes Cross Site Scripting, reported by preo | |
| 352 | + | |
| 353 | +### 5.9.8 | |
| 354 | + | |
| 355 | +- Security: Fix Cross Site Scripting, reported by Peter Thaleikis | |
| 356 | + | |
| 357 | +### 5.9.7 | |
| 358 | + | |
| 359 | +- Security: Fix vulnerability to XSS in `[events_cal]` shortcode, reported by Peter Thaleikis | |
| 360 | +- Ensure that date is well formated in `[events_cal]` shortcode | |
| 361 | + | |
| 362 | +### 5.9.6 | |
| 363 | + | |
| 364 | +- Security: Fix vulnerability to local file inclusion | |
| 365 | + | |
| 366 | +### 5.9.5 | |
| 367 | + | |
| 368 | +- Fixed a bug that display html as string in event calendar blocks | |
| 369 | +- Fixed javascript warning in event map block | |
| 370 | + | |
| 371 | +### 5.9.4 | |
| 372 | + | |
| 373 | +Security: | |
| 374 | + | |
| 375 | +- Fix authenticated (Contributor+) Stored Cross-Site Scripting via shortcode | |
| 376 | +- Uses bulk_edit_posts hook, fixes lack of verification in bulk edit | |
| 377 | +- Escape some outputs | |
| 378 | +- Fix missing jQuery dependency in timeline-block | |
| 379 | + | |
| 380 | +Misc: | |
| 381 | + | |
| 382 | +- Deindex inexisting "Event-post front" and "Event-post admin" blocks | |
| 383 | +- Add main global EventPost object for JS variables | |
| 384 | +- Allows to skip deprecation error | |
| 385 | +- Adds instructions for translators | |
| 386 | +- Limit number of tags in plugin README | |
| 387 | + | |
| 388 | +Now requires WordPress 6.3 | |
| 389 | + | |
| 390 | +### 5.9.3 | |
| 391 | + | |
| 392 | +- Fix quick edit fields | |
| 393 | + | |
| 394 | +### 5.9.2 | |
| 395 | + | |
| 396 | +- Fix call of Wp_Query in EventPost\Children | |
| 397 | +- Fix display of hours in timepicker for AM/PM format | |
| 398 | +- Fix saving of timeline schemas settings | |
| 399 | +- Use wp_json_encode instead of json_encode | |
| 400 | +- Use rawurlencode instead of urlencode | |
| 401 | +- Adds instructions for translators | |
| 402 | + | |
| 403 | +### 5.9.1 | |
| 404 | + | |
| 405 | +- Fix doing_it_wrong calls in legacy widgets | |
| 406 | +- Escape HTML & outputs | |
| 407 | + | |
| 408 | +### 5.9.0 | |
| 409 | + | |
| 410 | +Security: | |
| 411 | + | |
| 412 | +- Fixes XSS vuln in event metadata (https://patchstack.com/database/report-preview/8edeb59a-59e6-42aa-8ed4-5f79cdedf820) | |
| 413 | + | |
| 414 | +Features: | |
| 415 | + | |
| 416 | +- Adds "Completed" event status | |
| 417 | + | |
| 418 | +Misc: | |
| 419 | + | |
| 420 | +- Refactor source of blocks with wordpress-scripts | |
| 421 | +- Improves WordPress's PHPCS compliance | |
| 422 | +- Fix deprecated gmt_offset | |
| 423 | +- Mark legacy widgets as deprecated | |
| 424 | +- Fix warnings in PHP8+ | |
| 425 | + | |
| 426 | +### 5.8.6 | |
| 427 | + | |
| 428 | +- Fix December month on native datepicker | |
| 429 | + | |
| 430 | +### 5.8.5 | |
| 431 | + | |
| 432 | +- Dissociate event description from post excerpt | |
| 433 | +- Remove double line breaks and   in description | |
| 434 | + | |
| 435 | + | |
| 436 | + | |
| 437 | + | |
| 438 | +## Upgrade notice | |
| 439 | + | |
| 440 | +### 6.0.0 | |
| 441 | +* CSS class of event items are refactored: lowercase, removed overkilled prefixes | |
| 442 | + | |
| 443 | +### 4.1.1 | |
| 444 | +Increases accessibility | |
| 445 | + | |
| 446 | +### 3.6.2 | |
| 447 | +* Fix "get_plugin_data" error. | |
| 448 | + | |
| 449 | +### 3.5.0 | |
| 450 | +* New options are available for: icons in the loop, default position of the admin boxes | |
| 451 | +* New shortcode [event_details] is available | |
| 452 | +* Support for Shortcake (Shortcode UI plugin) | |
| 453 | + | |
| 454 | +### 2.7.0 | |
| 455 | +* The event meta box is no more displayed for non posts items such as pages or custom post-types | |
| 456 | +* Please active the multisite plugin in order to allow your users to browse events from the network | |
