| @@ -1,33 +1,27 @@ | ||
| 1 | 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 | |
| 2 | +Contributors: bastho, unecologeek, ecolosites | |
| 3 | +Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=RR4ACWX2S39AN | |
| 4 | +Tags: cevent, events,alendar, Post, posts, ics, ical, date, geolocalization, coordinates, gps, widget, map, openstreetmap, agenda, weather, multisite, native | |
| 5 | +Requires at least: 4.5 | |
| 6 | +Tested up to: 4.8 | |
| 7 | +Stable tag: 4.5 | |
| 8 | 8 | License: GPLv2 |
| 9 | 9 | License URI: https://www.gnu.org/licenses/gpl-2.0.html |
| 10 | 10 | |
| 11 | -Add some meta-datas to posts to convert them into full calendar events : | |
| 12 | -begin, end, location, color | |
| 11 | +The only WordPress plugin using native posts as full calendar events with begin and end date, geolocation, color and weather. | |
| 13 | 12 | |
| 14 | 13 | == Description == |
| 15 | -Add some meta-datas to posts to convert them into full calendar events. | |
| 14 | +Adds some meta-datas to posts to convert them into full calendar events. | |
| 16 | 15 | Each event can be exported into ical(.ics), outlook(vcs), or Google Calendar. |
| 17 | 16 | Geolocation works thanks to openstreetmap. |
| 18 | 17 | |
| 19 | -= Localization = | |
| 18 | +It can also fetch the weather, but doesn't bring the sun :) | |
| 20 | 19 | |
| 21 | -* English | |
| 22 | -* fr_FR : French | |
| 23 | -* it_IT : Italian by NewHouseStef, pgallina | |
| 24 | -* sv_SE : Swedish by mepmepmep | |
| 20 | +[event-post.com](http://event-post.com/) | |
| 25 | 21 | |
| 26 | - | |
| 27 | 22 | = Post metas = |
| 28 | 23 | |
| 29 | - | |
| 30 | 24 | **Date attributes** |
| 31 | 25 | |
| 32 | 26 | * Begin date-time |
| 33 | 27 | * End date-time |
| @@ -37,17 +31,26 @@ | ||
| 37 | 31 | |
| 38 | 32 | * Address |
| 39 | 33 | * GPS coordinates |
| 40 | 34 | |
| 41 | -[see full documentation](https://wordpress.org/plugins/event-post/other_notes/) | |
| 35 | +**Weather attribute** (for a given location and date if possible) | |
| 42 | 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 | + | |
| 43 | 45 | ## Shortcodes |
| 44 | -The plugin comes with three shortcodes wich allows to : | |
| 46 | +The plugin comes with several shortcodes wich allows to : | |
| 45 | 47 | |
| 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 | |
| 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 | |
| 50 | 53 | |
| 51 | 54 | ### Available options : |
| 52 | 55 | #### [events_list] |
| 53 | 56 | ##### Query parameters |
| @@ -61,12 +64,12 @@ | ||
| 61 | 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...)* |
| 62 | 65 | |
| 63 | 66 | ##### Display parameters |
| 64 | 67 | |
| 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)* | |
| 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)* | |
| 69 | 72 | * **type=div** *(string, possible values are : div, ul, ol default=div)* |
| 70 | 73 | * **title=''** *(string, hidden if no events is found)* |
| 71 | 74 | * **before_title="<h3>"** *(string (default <h3>)* |
| 72 | 75 | * **after_title="</h3>"** *(string (default </h3>)* |
| @@ -72,9 +75,9 @@ | ||
| 72 | 75 | * **after_title="</h3>"** *(string (default </h3>)* |
| 73 | 76 | * **container_schema=""** *(string html schema to display list)* |
| 74 | 77 | * **item_schema=""** *(string html schema to display item)* |
| 75 | 78 | |
| 76 | -example : `[events_list future=1 past=1 cat="actuality" nb=10]` | |
| 79 | +example: `[events_list future=1 past=1 cat="actuality" nb=10]` | |
| 77 | 80 | |
| 78 | 81 | container_schema default value : |
| 79 | 82 | |
| 80 | 83 | > <%type% class="event_loop %id% %class%" id="%listid%" style="%style%" %attributes%> |
| @@ -82,9 +85,9 @@ | ||
| 82 | 85 | > </%type%> |
| 83 | 86 | > |
| 84 | 87 | |
| 85 | 88 | |
| 86 | -item_schema default value : | |
| 89 | +item_schema default value: | |
| 87 | 90 | |
| 88 | 91 | > <%child% class="event_item %class%" data-color="%color%"> |
| 89 | 92 | > <a href="%event_link%"> |
| 90 | 93 | > %event_thumbnail% |
| @@ -104,12 +107,13 @@ | ||
| 104 | 107 | * **past=0** *(boolean, retreive, or not, events in the past, default = 0)* |
| 105 | 108 | * **cat=''** *(string, select posts only from the selected category, default=null, for all categories)* |
| 106 | 109 | * **tag=''** *(string, select posts only from the selected tag, default=null, for all tags)* |
| 107 | 110 | * **tile=''** *(string ([email protected], OpenCycleMap, mapquest, osmfr, 2u, satelite, toner), sets the map background, [email protected])* |
| 108 | -* **title=''** *(string (default )* | |
| 111 | +* **title=''** *(string (default)* | |
| 112 | +* **zoom=''** *(number or empty (default, means fit to points)* | |
| 109 | 113 | * **before_title="<h3>"** *(string (default <h3>)* |
| 110 | 114 | * **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)* | |
| 115 | +* **excerpt=""** *(Bool, default:false, used to display posts excerpts)* | |
| 112 | 116 | |
| 113 | 117 | example: `[events_map future=1 past=1 cat="actuality" nb="-1"]` |
| 114 | 118 | |
| 115 | 119 | ####[events_cal] |
| @@ -122,9 +126,9 @@ | ||
| 122 | 126 | example: `[events_cal cat="actuality" date="-2 months" mondayfirst=1]` |
| 123 | 127 | |
| 124 | 128 | ####[event_details] |
| 125 | 129 | |
| 126 | -* **attribute** string (date, start, end, address, location). The default value is NULL adn displays the full event bar | |
| 130 | +* **attribute** *string (date, start, end, address, location). The default value is NULL and displays the full event bar* | |
| 127 | 131 | |
| 128 | 132 | |
| 129 | 133 | = Hooks = |
| 130 | 134 | <a id="hooks"></a> |
| @@ -156,12 +160,24 @@ | ||
| 156 | 160 | 3. You can edit defaults settings in Settings > Event post |
| 157 | 161 | |
| 158 | 162 | == Frequently asked questions == |
| 159 | 163 | |
| 160 | -= Is the plugin fetches free ? = | |
| 164 | += Is the plugin free ? = | |
| 161 | 165 | Yes, and it uses only open-sources : openstreetmap, openlayer, jquery |
| 162 | 166 | |
| 167 | += How do I enable weather feature ? = | |
| 168 | +Weather feature uses openweathermap.org api. | |
| 163 | 169 | |
| 170 | +You have to create an account and generate an API key at http://openweathermap.org/price | |
| 171 | + | |
| 172 | +I have no interest in openweathermap.org, I personally use the free plan. | |
| 173 | + | |
| 174 | += Is there any limitation for the weather feature ? = | |
| 175 | +Openweathermap.org provides a free plan limited to 60 requests per minute. | |
| 176 | + | |
| 177 | +You can also subscribe to paid plan, I don't care. | |
| 178 | + | |
| 179 | + | |
| 164 | 180 | == Screenshots == |
| 165 | 181 | |
| 166 | 182 | 1. Single page |
| 167 | 183 | 2. Editor interface |
| @@ -168,11 +184,159 @@ | ||
| 168 | 184 | 3. Map |
| 169 | 185 | |
| 170 | 186 | == Changelog == |
| 171 | 187 | |
| 172 | -= Comming = | |
| 173 | -* Support of OpenWeatherMap | |
| 188 | += Coming = | |
| 174 | 189 | |
| 190 | += 5.0.2 = | |
| 191 | + | |
| 192 | +- Add: CSS class for past events in calendar | |
| 193 | +- Add: Number of events in search results | |
| 194 | +- Fix: Ensure correct response for getLatLong Ajax call | |
| 195 | + | |
| 196 | += 5.0.1 = | |
| 197 | + | |
| 198 | +Retro-compatibility for php < 5.5, remove fatal error "Can't use function return value in write context" | |
| 199 | +http://php.net/manual/en/function.empty.php | |
| 200 | + | |
| 201 | += 5.0 = | |
| 202 | + | |
| 203 | +- Added search form shortcode/widget | |
| 204 | +- Quick and bulk edit | |
| 205 | +- Custom CSS support: file URL or local theme file | |
| 206 | +- Use native settings API | |
| 207 | + | |
| 208 | +Fixes | |
| 209 | + | |
| 210 | +- Fix incompatibility with PDOS / remove warning | |
| 211 | + | |
| 212 | += 4.5.1 = | |
| 213 | + | |
| 214 | +- Fix events dated at Epok when GMT is not well parsed | |
| 215 | +- Move supported tiles to https (OSM, Humanitarian, OSM-fr) | |
| 216 | + | |
| 217 | += 4.5 = | |
| 218 | + | |
| 219 | +- Add option to hide event-bar | |
| 220 | +- Add Tiles: **Humanitarian**, **Positron** and **Dark matter** | |
| 221 | +- Add Retina (x2) title support | |
| 222 | +- Add setting link in the plugins page | |
| 223 | +- Add Map tiles attribution support | |
| 224 | +- Add Add zoom option to SC/Widget | |
| 225 | +- Add support for shortcake term selector (requires [shortcake](https://wordpress.org/plugins/shortcode-ui/) 0.7+) | |
| 226 | + | |
| 227 | +- Better support of timezones in VCS/ICS exports | |
| 228 | +- Fix wrong parameter in calendar shortcode UI register | |
| 229 | +- Fix displaying icons in wrong post's title in single pages | |
| 230 | +- Fix "Uncaught Error: [] operator not supported for string, PHP7 compliance | |
| 231 | +- Correctly checks for content filtering, as mentionned in https://developer.wordpress.org/reference/hooks/the_content/#usage | |
| 232 | + | |
| 233 | += 4.4 = | |
| 234 | +**Edit page** | |
| 235 | + | |
| 236 | +- Improves "Location" edit box UI | |
| 237 | + - click to drag the map | |
| 238 | + - lighter search form | |
| 239 | +- Improves "Date" edit box UI | |
| 240 | + - new all day toggle option | |
| 241 | + - new native WP datepicker | |
| 242 | + - Better and obvious check that end date is after begining | |
| 243 | + - lighter UI | |
| 244 | + | |
| 245 | +**Calendar Widget** | |
| 246 | + | |
| 247 | +- Fix calendar widget title not displayed | |
| 248 | +- Fix today highlithing in calendar when day of month is lower than 10 | |
| 249 | + | |
| 250 | +**Other fixes** | |
| 251 | + | |
| 252 | +- Fix openweahtermap URL in settings page | |
| 253 | +- Fix date pickers preview in settings page | |
| 254 | + | |
| 255 | += 4.3.4 = | |
| 256 | +- fix typo in cache management, related to https://wordpress.org/support/topic/location-deleted-after-update-a-post | |
| 257 | +- check twice if event permaling is filled. fix https://wordpress.org/support/topic/event_link-not-working | |
| 258 | + | |
| 259 | += 4.3 = | |
| 260 | + | |
| 261 | +End users new features: | |
| 262 | + | |
| 263 | +- Introduce initial Weather support | |
| 264 | +- Introduce child events feature | |
| 265 | +- Allows to define current location as coordinates of an event | |
| 266 | +- Add loader icon for maps on front | |
| 267 | +- Add map icon in the editor | |
| 268 | +- Add address in the admin posts-list | |
| 269 | +- Do not validate post form when hitting enter from the location search field | |
| 270 | + | |
| 271 | +Developers new features: | |
| 272 | + | |
| 273 | +- New actions `evenpost_init`, `eventpost_get_single`, `eventpost_custom_box_date`, `eventpost_custom_box_loc` and `eventpost_getsettings_action` | |
| 274 | +- New filter `eventpost_default_list_shema` | |
| 275 | +- New `$post` parameter to `eventpost_item_scheme_values` filter | |
| 276 | +- Update i18n file | |
| 277 | + | |
| 278 | +Bug fixes: | |
| 279 | + | |
| 280 | +- Almost perfect accessibility in calendar | |
| 281 | +- Cleaner HTML indent | |
| 282 | +- Fix bad HTML syntax in event list | |
| 283 | +- Fix wrong target for calendar container | |
| 284 | +- Fix some CSS bad syntaxes | |
| 285 | +- Some corrections in readme.txt | |
| 286 | + | |
| 287 | += 4.2.4 = | |
| 288 | +- Fix JS bugs introduced in 4.2 | |
| 289 | + | |
| 290 | += 4.2 = | |
| 291 | +release date: mar. 24 2016 | |
| 292 | + | |
| 293 | +* Add generic wrapper functions | |
| 294 | +* Drag map instead of point in editor mode | |
| 295 | +* Code refactoring | |
| 296 | + - externalize shortcode management in a separated file | |
| 297 | + - store maps in a json file instead of an old csv | |
| 298 | + - add lot of documentation | |
| 299 | + - some code cleanup | |
| 300 | +* Update OpenLayer to 3.14 | |
| 301 | +* Fix javascript bug causing some issues with other plugins | |
| 302 | + | |
| 303 | += 4.1.1 = | |
| 304 | +release date: feb. * 2016 | |
| 305 | + | |
| 306 | +* Increases accessibility | |
| 307 | + - Add alternative texts | |
| 308 | + - remove default color for calendar widget | |
| 309 | +* Remove french locale since it's available at https://translate.wordpress.org/projects/wp-plugins/event-post/dev | |
| 310 | +* Fix PHP warning in map widget | |
| 311 | + | |
| 312 | += 4.1 = | |
| 313 | +release date: feb. 4th 2016 | |
| 314 | + | |
| 315 | +* Update OpenLayer to 3.11 | |
| 316 | +* Position preview in admin, drag and drop feature | |
| 317 | +* Correctly parse time-zone for date displaying | |
| 318 | +* Add timezone to Google calendar links | |
| 319 | +* Only load JS and CSS when needed in the admin | |
| 320 | +* Initial work on dates of a term | |
| 321 | +* Fix wrong permalink in calendar widget | |
| 322 | + | |
| 323 | += 4.0.1 = | |
| 324 | +release date: nov. 12 2015 | |
| 325 | + | |
| 326 | +* Added Localization for brazilian portuguese thanks to lipemesquita | |
| 327 | + | |
| 328 | += 4.0.0 = | |
| 329 | +release date: oct. 27 2015 | |
| 330 | + | |
| 331 | +* Make replacement by "today" optional (prevent cache plugins issues) | |
| 332 | +* More standard setting page | |
| 333 | +* Only show events on dashboard right now if they're more than 0 | |
| 334 | +* Date and time formats harmonization | |
| 335 | +* Add `.pot` file and make match text-domain to plugin slug | |
| 336 | +* Only displays expandable map in the content of the current single | |
| 337 | +* Rename some js and css files | |
| 338 | + | |
| 175 | 339 | = 3.9.0 = |
| 176 | 340 | release date: oct. 6 2015 |
| 177 | 341 | |
| 178 | 342 | * Add width and height options in map widget |
| @@ -196,9 +360,9 @@ | ||
| 196 | 360 | * Some wording |
| 197 | 361 | * Add an option for time format |
| 198 | 362 | * wrap export buttons in event list |
| 199 | 363 | * Fix javascript bug in map when no default tile is set |
| 200 | -* Remove dummy javascript debug infos | |
| 364 | +* Remove dummy javascript debug log | |
| 201 | 365 | |
| 202 | 366 | = 3.7.0 = |
| 203 | 367 | release date: sept. 15 2015 |
| 204 | 368 | |
| @@ -242,11 +406,11 @@ | ||
| 242 | 406 | |
| 243 | 407 | = 3.6.0 = |
| 244 | 408 | * Add version to static files (JS/CSS) to prevent from local cache problems |
| 245 | 409 | * 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 | |
| 410 | +* Fix language on date-picker | |
| 411 | +* Fix bug (missing dates) for multi-site functions | |
| 412 | +* Code cleanup, Retro compatibility to PHP<5.3 | |
| 249 | 413 | |
| 250 | 414 | = 3.5.4 = |
| 251 | 415 | * Fix empty date storing |
| 252 | 416 | * Re-add quarters in time |
| @@ -264,10 +428,10 @@ | ||
| 264 | 428 | = 3.5.0 = |
| 265 | 429 | * Add **event_details** shortcode |
| 266 | 430 | * Add integration with shotcake (ShortCodes UI) |
| 267 | 431 | * 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 | |
| 432 | +* Optimize UI : New date-picker, separated date and address custom boxes | |
| 433 | +* Add statistics in dashboard glance items | |
| 270 | 434 | * Code optimization |
| 271 | 435 | * Update IT localization by pgallina |
| 272 | 436 | |
| 273 | 437 | = 3.4.2 = |
| @@ -280,9 +444,9 @@ | ||
| 280 | 444 | = 3.4.0 = |
| 281 | 445 | * Add: Whole category ICS feed (link available in list widget, for future events) |
| 282 | 446 | * Fix: JS was not loaded in single events since last version |
| 283 | 447 | * Fix: Strict Standards warning, reported by argad |
| 284 | -* Fix: Dependence of OpenLayer librairy not needed by calendar widget, reported by p1s1 | |
| 448 | +* Fix: Dependence of OpenLayer library not needed by calendar widget, reported by p1s1 | |
| 285 | 449 | |
| 286 | 450 | = 3.3.0 = |
| 287 | 451 | * Add: eventpost_list_shema filter |
| 288 | 452 | * Add: Global container/item shema settings |
| @@ -363,13 +527,13 @@ | ||
| 363 | 527 | * Fix : content filter bug on home page |
| 364 | 528 | |
| 365 | 529 | = 2.8.0 = |
| 366 | 530 | * 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) | |
| 531 | + * thumbnail=(true/false) | |
| 532 | + * thumbnail_size=thumbnail | |
| 533 | + * excerpt=(true/false) | |
| 534 | + * container_schema (documentation coming soon) | |
| 535 | + * item_schema (documentation coming soon) | |
| 372 | 536 | * Add : Usage of the event color for single details |
| 373 | 537 | * Enhance : Event information form UI |
| 374 | 538 | * Fix : Re-check if end date is after begin date |
| 375 | 539 | * Fix : CSS adjustments |
| @@ -380,9 +544,9 @@ | ||
| 380 | 544 | = 2.7.1 = |
| 381 | 545 | * Fix : Really check all blogs when using "blogs=all" in shortcodes. May cause memory limit on big networks |
| 382 | 546 | |
| 383 | 547 | = 2.7.0 = |
| 384 | -* Add : Multisite event list support | |
| 548 | +* Add : Multi-site event list support | |
| 385 | 549 | * Add : Integration of several hooks |
| 386 | 550 | * Add : Map widget |
| 387 | 551 | * Add : Parameters to display or not export buttons |
| 388 | 552 | * Add : Native WP icons for map and calendar items |
| @@ -408,9 +572,9 @@ | ||
| 408 | 572 | |
| 409 | 573 | = 2.3.2 = |
| 410 | 574 | * Add : make the function "EventPost::get_events" usable with an array as param |
| 411 | 575 | * Fix : Use of https links |
| 412 | -* Fix : Change licence from CC BY-NC to GPLv3 | |
| 576 | +* Fix : Change license from CC BY-NC to GPLv3 | |
| 413 | 577 | |
| 414 | 578 | = 2.3.1 = |
| 415 | 579 | * Fix : OSM map link error |
| 416 | 580 | |
| @@ -439,9 +603,9 @@ | ||
| 439 | 603 | * Add : Tile option for map shortcode, select a map background for a particular map |
| 440 | 604 | available maps : [email protected], OpenCycleMap, mapquest, osmfr, 2u |
| 441 | 605 | |
| 442 | 606 | = 2.1.0 = |
| 443 | -* Add : ajaxloader icon for address search | |
| 607 | +* Add : ajax loader icon for address search | |
| 444 | 608 | * Add : Event and location columns in posts list |
| 445 | 609 | * Add : widget description |
| 446 | 610 | * Add : place icon when available for address search |
| 447 | 611 | * Fix : Empty display_name property in address search |
| @@ -463,8 +627,11 @@ | ||
| 463 | 627 | * Plugin creation |
| 464 | 628 | |
| 465 | 629 | == Upgrade notice == |
| 466 | 630 | |
| 631 | += 4.1.1 = | |
| 632 | +Increases accessibility | |
| 633 | + | |
| 467 | 634 | = 3.6.2 = |
| 468 | 635 | * Fix "get_plugin_data" error. |
| 469 | 636 | |
| 470 | 637 | = 3.5.0 = |
| @@ -473,5 +640,5 @@ | ||
| 473 | 640 | * Support for Shortcake (Shortcode UI plugin) |
| 474 | 641 | |
| 475 | 642 | = 2.7.0 = |
| 476 | 643 | * 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 | |
| 644 | +* Please active the multisite plugin in order to allow your users to browse events from the network | |
