PluginProbe
Event Post / 6.1.2
Event Post v6.1.2
6.1.2 6.1.1 6.1.0 6.0.1 6.0.0 5.12.0 trunk 3.9 4.0 4.2 4.3 4.4 4.5 5.0 5.1 5.10.0 5.10.1 5.10.2 5.10.3 5.10.4 5.11.0 5.11.1 5.2 5.5 5.6 All 47 releases
← All changes | readme.txt +456 -688 5.2 → 6.1.2 View file →
@@ -1,688 +1,456 @@
1 -=== Event post ===
2 -Contributors: bastho, unecologeek, ecolosites
3 -Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=RR4ACWX2S39AN
4 -Tags: calendar, event, events, Post, posts, ics, ical, date, geolocalization, coordinates, gps, widget, map, openstreetmap, agenda, weather, multisite, native, gutenberg
5 -Requires at least: 4.8
6 -Tested up to: 5.0
7 -Stable tag: 5.2
8 -License: GPLv2
9 -License URI: https://www.gnu.org/licenses/gpl-2.0.html
10 -
11 -The only WordPress plugin using native posts as full calendar events with begin and end date, geolocation, color and weather.
12 -
13 -== Description ==
14 -Adds some meta-datas to posts to convert them into full calendar events.
15 -Each event can be exported into ical(.ics), outlook(vcs), or Google Calendar.
16 -Geolocation works thanks to openstreetmap.
17 -
18 -It can also fetch the weather, but doesn't bring the sun :)
19 -
20 -[event-post.com](https://event-post.com/)
21 -
22 -= Post metas =
23 -
24 -**Date attributes**
25 -
26 -* Begin date-time
27 -* End date-time
28 -* Color
29 -
30 -**Location attributes**
31 -
32 -* Address
33 -* GPS coordinates
34 -
35 -**Weather attribute** (for a given location and date if possible)
36 -
37 -* Weather
38 - - Temperature
39 - - Weather
40 -
41 -= Full documentation =
42 -
43 -[Plugins/themes developpers documentation](http://event-post.com/docs/event-post/)
44 -
45 -## Shortcodes
46 -The plugin comes with several shortcodes wich allows to:
47 -
48 -* `[events_list]`: display a list of events
49 -* `[events_map]`: display a map of events
50 -* `[events_cal]`: display a calendar of events
51 -* `[event_details]`: display a detail of the current event
52 -* `[event_term]`: display the date range of a given term based on all events it contains
53 -
54 -### Available options:
55 -#### [events_list]
56 -##### Query parameters
57 -* **nb=5** *(number of post, -1 is all, default: 5)*
58 -* **future=1** *(boolean, retreive, or not, events in the future, default = 1)*
59 -* **past=0** *(boolean, retreive, or not, events in the past, default = 0)*
60 -* **cat=''** *(string, select posts only from the selected category, default=null, for all categories)*
61 -* **tag=''** *(string, select posts only from the selected tag, default=null, for all tags)*
62 -* **geo=0** *(boolean, retreives or not, only events wich have geolocation informations, default=0)*
63 -* **order="ASC"** *(string (can be "ASC" or "DESC")*
64 -* **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...)*
65 -
66 -##### Display parameters
67 -
68 -* **thumbnail=""** *(Bool, default:false, used to display posts thumbnails)*
69 -* **thumbnail_size=""** *(String, default:"thmbnail", can be set to any existing size : "medium","large","full" etc...)*
70 -* **excerpt=""** *(Bool, default:false, used to display posts excerpts)*
71 -* **style=""** *(String, add some inline CSS to the list wrapper)*
72 -* **type=div** *(string, possible values are : div, ul, ol default=div)*
73 -* **title=''** *(string, hidden if no events is found)*
74 -* **before_title="<h3>"** *(string (default <h3>)*
75 -* **after_title="</h3>"** *(string (default </h3>)*
76 -* **container_schema=""** *(string html schema to display list)*
77 -* **item_schema=""** *(string html schema to display item)*
78 -
79 -example: `[events_list future=1 past=1 cat="actuality" nb=10]`
80 -
81 -container_schema default value:
82 -
83 -> <%type% class="event_loop %id% %class%" id="%listid%" style="%style%" %attributes%>
84 -> %list%
85 -> </%type%>
86 ->
87 -
88 -
89 -item_schema default value:
90 -
91 -> <%child% class="event_item %class%" data-color="%color%">
92 -> <a href="%event_link%">
93 -> %event_thumbnail%
94 -> <h5>%event_title%</h5>
95 -> </a>
96 -> %event_date%
97 -> %event_cat%
98 -> %event_location%
99 -> %event_excerpt%
100 -> </%child%>
101 ->
102 -
103 -####[events_map]
104 -
105 -* **nb=5** *(number of post, -1 is all, default: 5)*
106 -* **future=1** *(boolean, retreive, or not, events in the future, default = 1)*
107 -* **past=0** *(boolean, retreive, or not, events in the past, default = 0)*
108 -* **cat=''** *(string, select posts only from the selected category, default=null, for all categories)*
109 -* **tag=''** *(string, select posts only from the selected tag, default=null, for all tags)*
110 -* **tile=''** *(string ([email protected], OpenCycleMap, mapquest, osmfr, 2u, satelite, toner), sets the map background, [email protected])*
111 -* **title=''** *(string (default)*
112 -* **zoom=''** *(number or empty (default, means fit to points)*
113 -* **before_title="<h3>"** *(string (default <h3>)*
114 -* **after_title="</h3>"** *(string (default </h3>)** **thumbnail=""** * (Bool, default:false, used to display posts thumbnails)*
115 -* **excerpt=""** *(Bool, default:false, used to display posts excerpts)*
116 -* **list=""** *(String ("false", "above", "below", "right", "left") default: "false", Display a list of posts)*
117 -
118 -example: `[events_map future=1 past=1 cat="actuality" nb="-1"]`
119 -
120 -####[events_cal]
121 -
122 -* **cat=''** *(string, select posts only from the selected category, default=null, for all categories)*
123 -* **date=''** *(string, date for a month. Absolutly : 2013-9 or relatively : -1 month, default is empty, current month*
124 -* **datepicker=1** *(boolean, displays or not a date picker*
125 -* **mondayfirst=0** *(boolean, weeks start on monday, default is 0 (sunday)*
126 -* **display_title=0** *(boolean, displays or not events title under the day number)*
127 -
128 -example: `[events_cal cat="actuality" date="-2 months" mondayfirst=1 display_title=1]`
129 -
130 -####[event_details]
131 -
132 -* **attribute** *string (date, start, end, address, location). The default value is NULL and displays the full event bar*
133 -
134 -
135 -= Hooks =
136 -<a id="hooks"></a>
137 -#### Filters
138 -* eventpost_get
139 -* eventpost_getsettings
140 -* eventpost_item_scheme_entities
141 -* eventpost_item_scheme_values
142 -* eventpost_list_shema
143 -* eventpost_listevents
144 -* eventpost_multisite_get
145 -* eventpost_multisite_blogids
146 -* eventpost_params
147 -* eventpost_printdate
148 -* eventpost_printlocation
149 -* eventpost_retreive
150 -
151 -#### Actions
152 -* before_eventpost_generator
153 -* after_eventpost_generator
154 -* eventpost_getsettings
155 -* eventpost_settings_form
156 -* eventpost_after_settings_form
157 -
158 -== Installation ==
159 -
160 -1. Upload `event-post` to the `/wp-content/plugins/` directory
161 -2. Activate the plugin through the 'Plugins' menu in WordPress admin
162 -3. You can edit defaults settings in Settings > Event post
163 -
164 -== Frequently asked questions ==
165 -
166 -= Is the plugin free ? =
167 -Yes, and it uses only open-sources : openstreetmap, openlayer, jquery
168 -
169 -= How do I enable weather feature ? =
170 -Weather feature uses openweathermap.org api.
171 -
172 -You have to create an account and generate an API key at http://openweathermap.org/price
173 -
174 -I have no interest in openweathermap.org, I personally use the free plan.
175 -
176 -= Is there any limitation for the weather feature ? =
177 -Openweathermap.org provides a free plan limited to 60 requests per minute.
178 -
179 -You can also subscribe to paid plan, I don't care.
180 -
181 -
182 -== Screenshots ==
183 -
184 -1. Single page
185 -2. Editor interface
186 -3. Map
187 -
188 -== Changelog ==
189 -
190 -= 5.2.2 =
191 -
192 -- WordPress 5.0 compliant
193 -
194 -= 5.2.1 =
195 -
196 -- Fix crash when Gutenberg is not activated
197 -
198 -= 5.2 =
199 -
200 -News:
201 -
202 -- List of events beside the map
203 -- Use ES6 library for Gutenberg Blocks
204 -
205 -Fixes:
206 -
207 -- Upgrade OpenLayer to version 4.6.5
208 -- Fix map issue: unrecognized Animation/Pan
209 -- Fix empty permalink detection thanks to @maxoud and @akalwp
210 -- Cleanup textdomain in block js files
211 -- Fix Timezone issue in Gcal export
212 -
213 -= 5.1 =
214 -
215 -News:
216 -
217 -- Adds Gutenberg block support for folowing shortcodes: List, Map, Calendar
218 -- Allow to display posts title in Calendar
219 -- Upgrade OpenLayer to version 4.6.4
220 -- Adds twitter labels for date and location
221 -
222 -Fixes:
223 -
224 -- Load beautifull css and js files when WP_DEBUG is enabled
225 -- Wording and typo fixes
226 -- Fix some PHP Warnings
227 -
228 -= 5.0.3 =
229 -
230 -- i18n: Contextualize i18n for "from" and "to"
231 -- Fix: Pass CTZ param to GoogleCalendar only if timesone is set
232 -- Fix: Explicitly get published events. (prevents from displaying drafts over admin/ajax URLs
233 -
234 -= 5.0.2 =
235 -
236 -- Add: CSS class for past events in calendar
237 -- Add: Number of events in search results
238 -- Fix: Ensure correct response for getLatLong Ajax call
239 -
240 -= 5.0.1 =
241 -
242 -Retro-compatibility for php < 5.5, remove fatal error "Can't use function return value in write context"
243 -http://php.net/manual/en/function.empty.php
244 -
245 -= 5.0 =
246 -
247 -- Added search form shortcode/widget
248 -- Quick and bulk edit
249 -- Custom CSS support: file URL or local theme file
250 -- Use native settings API
251 -
252 -Fixes
253 -
254 -- Fix incompatibility with PDOS / remove warning
255 -
256 -= 4.5.1 =
257 -
258 -- Fix events dated at Epok when GMT is not well parsed
259 -- Move supported tiles to https (OSM, Humanitarian, OSM-fr)
260 -
261 -= 4.5 =
262 -
263 -- Add option to hide event-bar
264 -- Add Tiles: **Humanitarian**, **Positron** and **Dark matter**
265 -- Add Retina (x2) title support
266 -- Add setting link in the plugins page
267 -- Add Map tiles attribution support
268 -- Add Add zoom option to SC/Widget
269 -- Add support for shortcake term selector (requires [shortcake](https://wordpress.org/plugins/shortcode-ui/) 0.7+)
270 -
271 -- Better support of timezones in VCS/ICS exports
272 -- Fix wrong parameter in calendar shortcode UI register
273 -- Fix displaying icons in wrong post's title in single pages
274 -- Fix "Uncaught Error: [] operator not supported for string, PHP7 compliance
275 -- Correctly checks for content filtering, as mentionned in https://developer.wordpress.org/reference/hooks/the_content/#usage
276 -
277 -= 4.4 =
278 -**Edit page**
279 -
280 -- Improves "Location" edit box UI
281 - - click to drag the map
282 - - lighter search form
283 -- Improves "Date" edit box UI
284 - - new all day toggle option
285 - - new native WP datepicker
286 - - Better and obvious check that end date is after begining
287 - - lighter UI
288 -
289 -**Calendar Widget**
290 -
291 -- Fix calendar widget title not displayed
292 -- Fix today highlithing in calendar when day of month is lower than 10
293 -
294 -**Other fixes**
295 -
296 -- Fix openweahtermap URL in settings page
297 -- Fix date pickers preview in settings page
298 -
299 -= 4.3.4 =
300 -- fix typo in cache management, related to https://wordpress.org/support/topic/location-deleted-after-update-a-post
301 -- check twice if event permaling is filled. fix https://wordpress.org/support/topic/event_link-not-working
302 -
303 -= 4.3 =
304 -
305 -End users new features:
306 -
307 -- Introduce initial Weather support
308 -- Introduce child events feature
309 -- Allows to define current location as coordinates of an event
310 -- Add loader icon for maps on front
311 -- Add map icon in the editor
312 -- Add address in the admin posts-list
313 -- Do not validate post form when hitting enter from the location search field
314 -
315 -Developers new features:
316 -
317 -- New actions `evenpost_init`, `eventpost_get_single`, `eventpost_custom_box_date`, `eventpost_custom_box_loc` and `eventpost_getsettings_action`
318 -- New filter `eventpost_default_list_shema`
319 -- New `$post` parameter to `eventpost_item_scheme_values` filter
320 -- Update i18n file
321 -
322 -Bug fixes:
323 -
324 -- Almost perfect accessibility in calendar
325 -- Cleaner HTML indent
326 -- Fix bad HTML syntax in event list
327 -- Fix wrong target for calendar container
328 -- Fix some CSS bad syntaxes
329 -- Some corrections in readme.txt
330 -
331 -= 4.2.4 =
332 -- Fix JS bugs introduced in 4.2
333 -
334 -= 4.2 =
335 -release date: mar. 24 2016
336 -
337 -* Add generic wrapper functions
338 -* Drag map instead of point in editor mode
339 -* Code refactoring
340 - - externalize shortcode management in a separated file
341 - - store maps in a json file instead of an old csv
342 - - add lot of documentation
343 - - some code cleanup
344 -* Update OpenLayer to 3.14
345 -* Fix javascript bug causing some issues with other plugins
346 -
347 -= 4.1.1 =
348 -release date: feb. * 2016
349 -
350 -* Increases accessibility
351 - - Add alternative texts
352 - - remove default color for calendar widget
353 -* Remove french locale since it's available at https://translate.wordpress.org/projects/wp-plugins/event-post/dev
354 -* Fix PHP warning in map widget
355 -
356 -= 4.1 =
357 -release date: feb. 4th 2016
358 -
359 -* Update OpenLayer to 3.11
360 -* Position preview in admin, drag and drop feature
361 -* Correctly parse time-zone for date displaying
362 -* Add timezone to Google calendar links
363 -* Only load JS and CSS when needed in the admin
364 -* Initial work on dates of a term
365 -* Fix wrong permalink in calendar widget
366 -
367 -= 4.0.1 =
368 -release date: nov. 12 2015
369 -
370 -* Added Localization for brazilian portuguese thanks to lipemesquita
371 -
372 -= 4.0.0 =
373 -release date: oct. 27 2015
374 -
375 -* Make replacement by "today" optional (prevent cache plugins issues)
376 -* More standard setting page
377 -* Only show events on dashboard right now if they're more than 0
378 -* Date and time formats harmonization
379 -* Add `.pot` file and make match text-domain to plugin slug
380 -* Only displays expandable map in the content of the current single
381 -* Rename some js and css files
382 -
383 -= 3.9.0 =
384 -release date: oct. 6 2015
385 -
386 -* Add width and height options in map widget
387 -* Add thumbnail + size option in both list, map and calendar widgets
388 -* Add some [hooks](https://wordpress.org/plugins/event-post/other_notes/#hooks)
389 -* Code cleanup
390 -
391 -= 3.8.2 =
392 -* fix bug in past events fetching
393 -
394 -= 3.8.1 =
395 -release date: sept. 23 2015
396 -
397 -* Fix time zone issue
398 -* Add filter hook to list_events()
399 -* Add some explicit CSS classes to elements
400 -
401 -= 3.8.0 =
402 -release date: sept. 22 2015
403 -
404 -* Some wording
405 -* Add an option for time format
406 -* wrap export buttons in event list
407 -* Fix javascript bug in map when no default tile is set
408 -* Remove dummy javascript debug log
409 -
410 -= 3.7.0 =
411 -release date: sept. 15 2015
412 -
413 -* Update OpenLayer to version 3.9
414 -* Add Map interaction options (MouseWheelZoom, PinchZoom...)
415 -* Add option for datepicker UI
416 -* Add eligible post types option
417 -* Better performances
418 -* Fix PHP Warnings
419 -
420 -= 3.6.8 =
421 -* update french translation
422 -
423 -= 3.6.7 =
424 -* more WP 4.3 compliant
425 -
426 -= 3.6.6 =
427 -* Fix PHP warnings
428 -
429 -= 3.6.5 =
430 -release date: aug. 14 2015
431 -
432 -* Fix bad html syntax
433 -* Make plugin WP 4.3 compliant
434 -* Add lot of comments
435 -* Update swedish translation thanks to @mepmepmep
436 -
437 -= 3.6.4 =
438 -* Fix displaying of dates in map
439 -
440 -= 3.6.3 =
441 -* Better multisite sort
442 -* Fix multiple dates
443 -* Fix CSS issue between ical export buttons and category
444 -
445 -= 3.6.2 =
446 -* Fix "get_plugin_data" error, finally remove the function.
447 -
448 -= 3.6.1 =
449 -* Fix "get_plugin_data" error
450 -
451 -= 3.6.0 =
452 -* Add version to static files (JS/CSS) to prevent from local cache problems
453 -* Add sort parameters in shortcode UI
454 -* Fix language on date-picker
455 -* Fix bug (missing dates) for multi-site functions
456 -* Code cleanup, Retro compatibility to PHP<5.3
457 -
458 -= 3.5.4 =
459 -* Fix empty date storing
460 -* Re-add quarters in time
461 -
462 -= 3.5.3 =
463 -* Improve accessibility, use of native colors from the theme for links
464 -* More hookable ajax URL for calendar
465 -* Upgrade IT locale
466 -* Fix php warnings
467 -* Fix shortcake compatibility in pages
468 -
469 -= 3.5.2 =
470 -* Fix missing files in last commit
471 -
472 -= 3.5.0 =
473 -* Add **event_details** shortcode
474 -* Add integration with shotcake (ShortCodes UI)
475 -* Add Optional event icons in the loop
476 -* Optimize UI : New date-picker, separated date and address custom boxes
477 -* Add statistics in dashboard glance items
478 -* Code optimization
479 -* Update IT localization by pgallina
480 -
481 -= 3.4.2 =
482 -* Fix: remove PHP warnings
483 -* Fix: JS script not loaded when the "calendar widget" is alone
484 -
485 -= 3.4.1 =
486 -* Fix: remove PHP warnings
487 -
488 -= 3.4.0 =
489 -* Add: Whole category ICS feed (link available in list widget, for future events)
490 -* Fix: JS was not loaded in single events since last version
491 -* Fix: Strict Standards warning, reported by argad
492 -* Fix: Dependence of OpenLayer library not needed by calendar widget, reported by p1s1
493 -
494 -= 3.3.0 =
495 -* Add: eventpost_list_shema filter
496 -* Add: Global container/item shema settings
497 -* Add: Security improvement in settings management
498 -* Fix: Load scripts only of needed
499 -
500 -= 3.2.4 =
501 -* Fix: Previous fix fix
502 -
503 -= 3.2.3 =
504 -* Fix: Custom icons fix
505 -
506 -= 3.2.2 =
507 -* Fix: Category filter
508 -* Fix: Add max zoom
509 -
510 -= 3.2.1 =
511 -* Fix: Event list widget : missing title
512 -
513 -= 3.2.0 =
514 -* Add: Italian localization, thanks to NewHouseStef
515 -
516 -= 3.1.1 =
517 -* Fix: Future/past display style
518 -
519 -= 3.1.0 =
520 -* Add: Save default settings to improve performances
521 -* Add: More options in list and map widgets
522 -
523 -= 3.0.0 =
524 -* Update to OpenLayer3
525 -* Add: Responsive support
526 -* Add: Satelite and Toner view
527 -* Add: `cat` attributes now accepts multiple categories values ( cat="1,2,3" )
528 -* Add: Custom markers directory for developpers
529 -* Add: Global "event bar position" option : before or after the single content
530 -* Fix: Cleaner settings page
531 -
532 -= 2.8.12 =
533 -* Add : Swedish localization, thanks to Mepmepmep
534 -
535 -= 2.8.11 =
536 -* Fix : PHP warnings on empty dates
537 -
538 -= 2.8.10 =
539 -* Fix : 00 minutes bug
540 -
541 -= 2.8.9 =
542 -* Fix : Bug fix
543 -* Change : Multisite support is no more a separated plugin
544 -
545 -= 2.8.8 =
546 -* Fix : Empty date error
547 -
548 -= 2.8.7 =
549 -* Fix : JS error in minified osm-admin.js file
550 -
551 -= 2.8.6 =
552 -* Fix : Error while retreiving the excerpt
553 -
554 -= 2.8.5 =
555 -* Add : Setting to print/hide link for events with empty content
556 -* Fix : Check content with queried object instead of global $post
557 -* Fix : Bug in calendar animations
558 -
559 -= 2.8.4 =
560 -* Fix : Optimize JS in admin side
561 -* Add : French and chinese localisation for date-picker
562 -* Add : Minify CSS
563 -
564 -= 2.8.3 =
565 -* Fix : bug fix
566 -
567 -= 2.8.2 =
568 -* Fix : apply content filter most later
569 -
570 -= 2.8.1 =
571 -* Fix : content filter bug on home page
572 -
573 -= 2.8.0 =
574 -* Add : attributes to events_list shortcode :
575 - * thumbnail=(true/false)
576 - * thumbnail_size=thumbnail
577 - * excerpt=(true/false)
578 - * container_schema (documentation coming soon)
579 - * item_schema (documentation coming soon)
580 -* Add : Usage of the event color for single details
581 -* Enhance : Event information form UI
582 -* Fix : Re-check if end date is after begin date
583 -* Fix : CSS adjustments
584 -* Fix : CSS adjustments
585 -* Fix : Prevent from filters applying "the_content" on another thing than the current post content
586 -
587 -
588 -= 2.7.1 =
589 -* Fix : Really check all blogs when using "blogs=all" in shortcodes. May cause memory limit on big networks
590 -
591 -= 2.7.0 =
592 -* Add : Multi-site event list support
593 -* Add : Integration of several hooks
594 -* Add : Map widget
595 -* Add : Parameters to display or not export buttons
596 -* Add : Native WP icons for map and calendar items
597 -* Add : data-color in list items
598 -* Fix : Event's first day not shown in calendar
599 -* Fix : Use of minified JS files
600 -
601 -= 2.6.0 =
602 -* Add : order and orderby parameters for shortcode [events_list]
603 -
604 -= 2.5.0 =
605 -* Add : tag and style parameters for shortcode [events_list]
606 -
607 -= 2.4.1 =
608 -* Fix : Parameters bug in export files
609 -
610 -= 2.4.0 =
611 -* Add : Calendar widget/shortcode
612 -
613 -= 2.3.3 =
614 -* Add : Improve address search UI
615 -* Fix : Address search bug fix
616 -
617 -= 2.3.2 =
618 -* Add : make the function "EventPost::get_events" usable with an array as param
619 -* Fix : Use of https links
620 -* Fix : Change license from CC BY-NC to GPLv3
621 -
622 -= 2.3.1 =
623 -* Fix : OSM map link error
624 -
625 -= 2.3.0 =
626 -* Add : update openlayer version to 2.13.1
627 -* Add : change Map UI buttons
628 -* Add : Shortcode editor
629 -* Fix : Minor JS bug
630 -
631 -= 2.2.4 =
632 -* Fix : Quick edit was removing date and geo datas
633 -* Fix : PHP Warning
634 -
635 -= 2.2.3 =
636 -* Add : Title, before_title and after_title attributes to shortcode functions
637 -* Fix : Do not display empty title in widget
638 -
639 -= 2.2.2 =
640 -* Add : add custom box to all post-types
641 -
642 -= 2.2.1 =
643 -* Fix : bad output
644 -
645 -= 2.2.0 =
646 -* Add : Admin settings page : choose a date format and a default map background
647 -* Add : Tile option for map shortcode, select a map background for a particular map
648 -available maps : [email protected], OpenCycleMap, mapquest, osmfr, 2u
649 -
650 -= 2.1.0 =
651 -* Add : ajax loader icon for address search
652 -* Add : Event and location columns in posts list
653 -* Add : widget description
654 -* Add : place icon when available for address search
655 -* Fix : Empty display_name property in address search
656 -
657 -= 2.0.0 =
658 -* Add: Category option for widgets and shortcodes
659 -* Add: Force end date to be greater than begin date
660 -* Add: Separate search field for GPS and address
661 -* Fix: Wrong parameter for widget options
662 -* Fix: Load jquery datetimepicker only if not supported by the browser
663 -
664 -= 1.1.0 =
665 -* Add: Width & height properties in the '[events_map]' shortcode
666 -* Add: Allow multiple maps on the same page
667 -* Fix: Same ID in multiple DOM elements bug fix
668 -* Fix: Some W3C standard corrections
669 -
670 -= 1.0.0 =
671 -* Plugin creation
672 -
673 -== Upgrade notice ==
674 -
675 -= 4.1.1 =
676 -Increases accessibility
677 -
678 -= 3.6.2 =
679 -* Fix "get_plugin_data" error.
680 -
681 -= 3.5.0 =
682 -* New options are available for: icons in the loop, default position of the admin boxes
683 -* New shortcode [event_details] is available
684 -* Support for Shortcake (Shortcode UI plugin)
685 -
686 -= 2.7.0 =
687 -* The event meta box is no more displayed for non posts items such as pages or custom post-types
688 -* 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='&lt;h3&gt;'** *(string, default &lt;h3&gt;)*
89 +* **after_title='&lt;/h3&gt;'** *(string, default &lt;/h3&gt;)*
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 +> &lt;%type% class="event_loop %id% %class%" id="%listid%" style="%style%" %attributes%&gt;
103 +> %list%
104 +> &lt;/%type%&gt;
105 +>
106 +
107 +
108 +item_schema default value:
109 +
110 +> &lt;%child% class="event_item %class%" data-color="%color%"&gt;
111 +> &lt;a href="%event_link%"&gt;
112 +> %event_thumbnail%
113 +> &lt;h5>%event_title%&lt;/h5&gt;
114 +> &lt;/a&gt;
115 +> %event_date%
116 +> %event_cat%
117 +> %event_location%
118 +> %event_excerpt%
119 +> &lt;/%child%&gt;
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='&lt;h3&gt;';** *(string, default &lt;h3&gt;)*
135 +* **after_title='&lt;/h3&gt;'** *(string, default &lt;/h3&gt;)**
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 &nbsp 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