forked from wp-plugins/event-post
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathreadme.txt
executable file
·412 lines (312 loc) · 12.3 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
=== Event post ===
Contributors: bastho, n4thaniel, ecolosites
Donate link: http://ba.stienho.fr/#don
Tags: Post,posts,event,date,geolocalization,gps,widget,map,openstreetmap,calendar
Requires at least: 3.8
Tested up to: 4.2.1
Stable tag: /trunk
License: GPLv2
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Add some meta-datas to posts to convert them into full calendar events :
begin, end, location, color
== Description ==
Add some meta-datas to posts to convert them into full calendar events.
Each event can be exported into ical(.ics), outlook(vcs), or Google Calendar.
Geolocation works thanks to openstreetmap.
= Localization =
* English
* fr_FR : French
* it_IT : Italian by NewHouseStef, pgallina
* sv_SE : Swedish by mepmepmep
= Post metas =
**Date attributes**
* Begin date-time
* End date-time
* Color
**Location attributes**
* Address
* GPS coordinates
[see full documentation](https://wordpress.org/plugins/event-post/other_notes/)
## Shortcodes
The plugin comes with three shortcodes wich allows to :
* `[events_list]` : display a list of events
* `[events_map]` : display a map of events
* `[events_cal]` : display a calendar of events
* `[event_details]` : display a detail of the current event
### Available options :
#### [events_list]
##### Query parameters
* **nb=5** *(number of post, -1 is all, default: 5)*
* **future=1** *(boolean, retreive, or not, events in the future, default = 1)*
* **past=0** *(boolean, retreive, or not, events in the past, default = 0)*
* **cat=''** *(string, select posts only from the selected category, default=null, for all categories)*
* **tag=''** *(string, select posts only from the selected tag, default=null, for all tags)*
* **geo=0** *(boolean, retreives or not, only events wich have geolocation informations, default=0)*
* **order="ASC"** *(string (can be "ASC" or "DESC")*
* **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...)*
##### Display parameters
* **thumbnail=""** * (Bool, default:false, used to display posts thumbnails)*
* **thumbnail_size=""** * (String, default:"thmbnail", can be set to any existing size : "medium","large","full" etc...)*
* **excerpt=""** * (Bool, default:false, used to display posts excerpts)*
* **style=""** * (String, add some inline CSS to the list wrapper)*
* **type=div** *(string, possible values are : div, ul, ol default=div)*
* **title=''** *(string, hidden if no events is found)*
* **before_title="<h3>"** *(string (default <h3>)*
* **after_title="</h3>"** *(string (default </h3>)*
* **container_schema=""** *(string html schema to display list)*
* **item_schema=""** *(string html schema to display item)*
example : `[events_list future=1 past=1 cat="actuality" nb=10]`
container_schema default value :
> <%type% class="event_loop %id% %class%" id="%listid%" style="%style%" %attributes%>
> %list%
> </%type%>
>
item_schema default value :
> <%child% class="event_item %class%" data-color="%color%">
> <a href="%event_link%">
> %event_thumbnail%
> <h5>%event_title%</h5>
> </a>
> %event_date%
> %event_cat%
> %event_location%
> %event_excerpt%
> </%child%>
>
####[events_map]
* **nb=5** *(number of post, -1 is all, default: 5)*
* **future=1** *(boolean, retreive, or not, events in the future, default = 1)*
* **past=0** *(boolean, retreive, or not, events in the past, default = 0)*
* **cat=''** *(string, select posts only from the selected category, default=null, for all categories)*
* **tag=''** *(string, select posts only from the selected tag, default=null, for all tags)*
* **tile=''** *(string (default@osm.org, OpenCycleMap, mapquest, osmfr, 2u, satelite, toner), sets the map background, default=default@osm.org)*
* **title=''** *(string (default )*
* **before_title="<h3>"** *(string (default <h3>)*
* **after_title="</h3>"** *(string (default </h3>)** **thumbnail=""** * (Bool, default:false, used to display posts thumbnails)*
* **excerpt=""** * (Bool, default:false, used to display posts excerpts)*
example: `[events_map future=1 past=1 cat="actuality" nb="-1"]`
####[events_cal]
* **cat=''** *(string, select posts only from the selected category, default=null, for all categories)*
* **date=''** *(string, date for a month. Absolutly : 2013-9 or relatively : -1 month, default is empty, current month*
* **datepicker=1** *(boolean, displays or not a date picker*
* **mondayfirst=0** *(boolean, weeks start on monday, default is 0 (sunday)*
example: `[events_cal cat="actuality" date="-2 months" mondayfirst=1]`
####[event_details]
* **attribute** string (date, start, end, address, location). The default value is NULL adn displays the full event bar
= Hooks =
#### Filters
* eventpost_printdate
* eventpost_printlocation
* eventpost_params
* eventpost_get
* eventpost_retreive
* eventpost_multisite_get
* eventpost_multisite_blogids
* eventpost_list_shema
#### Actions
* before_eventpost_generator
* after_eventpost_generator
== Installation ==
1. Upload `event-post` to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress admin
3. You can edit defaults settings in Settings > Event post
== Frequently asked questions ==
= Is the plugin fetches free ? =
Yes, and it uses only open-sources : openstreetmap, openlayer, jquery
== Screenshots ==
1. Single page
2. Editor interface
3. Map
== Changelog ==
= 3.6.4 =
* Fix displaying of dates in map
= 3.6.3 =
* Better multisite sort
* Fix multiple dates
* Fix CSS issue between ical export buttons and category
= 3.6.2 =
* Fix "get_plugin_data" error, finally remove the function.
= 3.6.1 =
* Fix "get_plugin_data" error
= 3.6.0 =
* Add version to static files (JS/CSS) to prevent from local cache problems
* Add sort parameters in shortcode UI
* Fix lang on datepicker
* Fix bug (missing dates) for multisite functions
* Code cleanup, Retrocompatibilty to PHP<5.3
= 3.5.4 =
* Fix empty date storing
* Re-add quarters in time
= 3.5.3 =
* Improve accessibility, use of native colors from the theme for links
* More hookable ajax URL for calendar
* Upgrade IT locale
* Fix php warnings
* Fix shortcake compatibility in pages
= 3.5.2 =
* Fix missing files in last commit
= 3.5.0 =
* Add **event_details** shortcode
* Add integration with shotcake (ShortCodes UI)
* Add Optional event icons in the loop
* Optimize UI : New datepicker, separated date and address custom boxes
* Add stats in dashboard glance items
* Code optimization
* Update IT localization by pgallina
= 3.4.2 =
* Fix: remove PHP warnings
* Fix: JS script not loaded when the "calendar widget" is alone
= 3.4.1 =
* Fix: remove PHP warnings
= 3.4.0 =
* Add: Whole category ICS feed (link available in list widget, for future events)
* Fix: JS was not loaded in single events since last version
* Fix: Strict Standards warning, reported by argad
* Fix: Dependence of OpenLayer librairy not needed by calendar widget, reported by p1s1
= 3.3.0 =
* Add: eventpost_list_shema filter
* Add: Global container/item shema settings
* Add: Security improvement in settings management
* Fix: Load scripts only of needed
= 3.2.4 =
* Fix: Previous fix fix
= 3.2.3 =
* Fix: Custom icons fix
= 3.2.2 =
* Fix: Category filter
* Fix: Add max zoom
= 3.2.1 =
* Fix: Event list widget : missing title
= 3.2.0 =
* Add: Italian localization, thanks to NewHouseStef
= 3.1.1 =
* Fix: Future/past display style
= 3.1.0 =
* Add: Save default settings to improve performances
* Add: More options in list and map widgets
= 3.0.0 =
* Update to OpenLayer3
* Add: Responsive support
* Add: Satelite and Toner view
* Add: `cat` attributes now accepts multiple categories values ( cat="1,2,3" )
* Add: Custom markers directory for developpers
* Add: Global "event bar position" option : before or after the single content
* Fix: Cleaner settings page
= 2.8.12 =
* Add : Swedish localization, thanks to Mepmepmep
= 2.8.11 =
* Fix : PHP warnings on empty dates
= 2.8.10 =
* Fix : 00 minutes bug
= 2.8.9 =
* Fix : Bug fix
* Change : Multisite support is no more a separated plugin
= 2.8.8 =
* Fix : Empty date error
= 2.8.7 =
* Fix : JS error in minified osm-admin.js file
= 2.8.6 =
* Fix : Error while retreiving the excerpt
= 2.8.5 =
* Add : Setting to print/hide link for events with empty content
* Fix : Check content with queried object instead of global $post
* Fix : Bug in calendar animations
= 2.8.4 =
* Fix : Optimize JS in admin side
* Add : French and chinese localisation for date-picker
* Add : Minify CSS
= 2.8.3 =
* Fix : bug fix
= 2.8.2 =
* Fix : apply content filter most later
= 2.8.1 =
* Fix : content filter bug on home page
= 2.8.0 =
* Add : attributes to events_list shortcode :
* * thumbnail=(true/false)
* * thumbnail_size=thumbnail
* * excertp=(true/false)
* * container_schema (documentation comming soon)
* * item_schema (documentation comming soon)
* Add : Usage of the event color for single details
* Enhance : Event information form UI
* Fix : Re-check if end date is after begin date
* Fix : CSS adjustments
* Fix : CSS adjustments
* Fix : Prevent from filters applying "the_content" on another thing than the current post content
= 2.7.1 =
* Fix : Really check all blogs when using "blogs=all" in shortcodes. May cause memory limit on big networks
= 2.7.0 =
* Add : Multisite event list support
* Add : Integration of several hooks
* Add : Map widget
* Add : Parameters to display or not export buttons
* Add : Native WP icons for map and calendar items
* Add : data-color in list items
* Fix : Event's first day not shown in calendar
* Fix : Use of minified JS files
= 2.6.0 =
* Add : order and orderby parameters for shortcode [events_list]
= 2.5.0 =
* Add : tag and style parameters for shortcode [events_list]
= 2.4.1 =
* Fix : Parameters bug in export files
= 2.4.0 =
* Add : Calendar widget/shortcode
= 2.3.3 =
* Add : Improve address search UI
* Fix : Address search bug fix
= 2.3.2 =
* Add : make the function "EventPost::get_events" usable with an array as param
* Fix : Use of https links
* Fix : Change licence from CC BY-NC to GPLv3
= 2.3.1 =
* Fix : OSM map link error
= 2.3.0 =
* Add : update openlayer version to 2.13.1
* Add : change Map UI buttons
* Add : Shortcode editor
* Fix : Minor JS bug
= 2.2.4 =
* Fix : Quick edit was removing date and geo datas
* Fix : PHP Warning
= 2.2.3 =
* Add : Title, before_title and after_title attributes to shortcode functions
* Fix : Do not display empty title in widget
= 2.2.2 =
* Add : add custom box to all post-types
= 2.2.1 =
* Fix : bad output
= 2.2.0 =
* Add : Admin settings page : choose a date format and a default map background
* Add : Tile option for map shortcode, select a map background for a particular map
available maps : default@osm.org, OpenCycleMap, mapquest, osmfr, 2u
= 2.1.0 =
* Add : ajaxloader icon for address search
* Add : Event and location columns in posts list
* Add : widget description
* Add : place icon when available for address search
* Fix : Empty display_name property in address search
= 2.0.0 =
* Add: Category option for widgets and shortcodes
* Add: Force end date to be greater than begin date
* Add: Separate search field for GPS and address
* Fix: Wrong parameter for widget options
* Fix: Load jquery datetimepicker only if not supported by the browser
= 1.1.0 =
* Add: Width & height properties in the '[events_map]' shortcode
* Add: Allow multiple maps on the same page
* Fix: Same ID in multiple DOM elements bug fix
* Fix: Some W3C standard corrections
= 1.0.0 =
* Plugin creation
== Upgrade notice ==
= 3.6.2 =
* Fix "get_plugin_data" error.
= 3.5.0 =
* New options are available for: icons in the loop, default position of the admin boxes
* New shortcode [event_details] is available
* Support for Shortcake (Shortcode UI plugin)
= 2.7.0 =
* The event meta box is no more displayed for non posts items such as pages or custom post-types
* Please active the multisite plugin in order to allow your users to browse events from the network