PluginProbe
Event Post / 4.4
Event Post v4.4
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 5.6.1 All 46 releases
event-post / readme.txt

readme.txt in Event Post 4.4, at readme.txt

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