forked from bozdoz/wp-plugin-leaflet-map
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathreadme.txt
341 lines (223 loc) · 12.5 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
=== Leaflet Map ===
Author: bozdoz
Author URI: https://www.twitter.com/bozdoz/
Plugin URI: https://wordpress.org/plugins/leaflet-map/
Contributors: bozdoz, Remigr, nielsalstrup, jeromelebleu, gerital
Donate link: https://www.paypal.me/bozdoz
Tags: leaflet, map, mobile, javascript, openstreetmap, mapquest, interactive
Requires at least: 3.0.1
Tested up to: 4.9
Version: 2.10.1
Stable tag: 2.10.1
License: GPLv2
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Interactive maps and markers on your posts and pages with simple shortcodes.
== Description ==
Add a map generated with [LeafletJS](http://leafletjs.com/): an open-source JavaScript library for mobile-friendly interactive maps. Map tiles are provided by default through [OpenStreetMap](http://www.openstreetmap.org/), or [MapQuest](https://www.mapquest.ca/) (with an app key). Can be set per map with shortcode attributes or through the dashboard settings.
= Maps =
Height, width, latitude, longitude and zoom are the basic attributes:
`[leaflet-map height=250 width=250 lat=44.67 lng=-63.61 zoom=5]`
However, you can also just give it an **address**, and Google (by default) will look it up for you:
`[leaflet-map address="Oslo, Norway"]`
The default URL requires attribution by its terms of use. If you want to change the URL, you may define a new attribution, or remove the attribution. You can define this site-wide in the admin, or you can set this per map in the shortcode (0 for disabled):
`[leaflet-map attribution=0]`
OR
`[leaflet-map attribution="Copyright @bozdoz"]`
Look at other examples on the Shortcode Helper in the Leaflet Map admin section.
= Markers =
Add a marker to any map by adding `[leaflet-marker]` after any `[leaflet-map]` shortcode. You can adjust the lat/lng in the same way, as well as some other basic functionality (popup message, draggable, visible on load). Also, if you want to add a link to a marker popup, use this syntax: `[leaflet-marker]Message here: click here[/leaflet-marker]` and add a link like you normally would with the WordPress editor.
= Lines and other Shapes =
Add a line to the map by adding `[leaflet-line]`. You can specify the postions with a list separated by semi-colon `;` or bar `|` using lat/lng: `[leaflet-line latlngs="41, 29; 44, 18"]` or addresses: `[leaflet-line addresses="Istanbul; Sarajevo"]`, or x/y coordinates for image maps.
Or you can add a geojson shape via a url (work in progress): `[leaflet-geojson src="https://example.com/path/to.geojson"]`
= Image Maps =
Alternatively, you could use a plain image for visitors to zoom and pan around with `[leaflet-image src="path/to/image/file.jpg"]`. See screenshots 3 - 5 for help setting that up.
Check out the source code on [GitHub](https://github.com/bozdoz/wp-plugin-leaflet-map)!
Shoot me a question [@bozdoz](https://www.twitter.com/bozdoz/).
== Installation ==
1. Choose to add a new plugin, then click upload
2. Upload the leaflet-map zip
3. Activate the plugin through the 'Plugins' menu in WordPress
4. Use the shortcodes in your pages or posts: e.g. `[leaflet-map]` and `[leaflet-marker]`
== Frequently Asked Questions ==
= How do I change the style for lines/geojson? =
Pass the style attributes to the respective shortcodes (see all options on [LeafletJS](http://leafletjs.com/reference-1.0.3.html#path)):
`[leaflet-line color="red" weight=10 dasharray="2,15" addresses="Halifax, NS; Tanzania" classname=marching-ants]`
= My map now says direct tile access has been discontinued (July 11, 2016); can you fix it? =
Yes. Update to the newest plugin version, and reset defaults in settings. You can choose to use MapQuest by signing up and supplying an app key, or use the default OpenStreetMap tiles (with attribution). See Screenshot 8.
= Can I add geojson? =
Yes, just give it a source URL: `[leaflet-geojson src="https://example.com/path/to.geojson"]` It will also support leaflet geojson styles or geojson.io styles. Add a popup message with `[leaflet-geojson popup_text="hello!"]`, or add HTML by adding it to the content of the shortcode: `[leaflet-geojson]<a href="#">Link here, or use text from a feature property, like {title}</a>[/leaflet-geojson]` or identify a geojson property with `popup_property`, and each shape will use its own popup text if available.
= Can I add kml/gpx? =
Sure!? Use the same attributes as leaflet-geojson (above), but use the `[leaflet-kml]` or `[leaflet-gpx]` shortcode.
= Can I add a message to a marker? =
Yes: `[leaflet-marker message="Hello there!" visible="true"]`, where visible designates if it is visible on page load. Otherwise it is only visible when clicked.
= Can I use your plugin with a picture instead of a map? =
Yes: Use `[leaflet-image src="path/to/image/file.jpg"]`. See screenshots 3 - 5 for help setting that up.
= Can I use my own self-hosted Leaflet files? =
Yes: It's been added to the dashboard options!
= How can I add a link to a marker? =
Use the marker format `[leaflet-marker]Click here![/leaflet-marker]` and add a hyperlink like you normally would with the WordPress editor.
= Can I add a line to the map? =
Use the line format `[leaflet-line]` with attributes `latlngs` or `addresses` separated by semi-colons to draw a line: `[leaflet-line addresses="Sayulita; Puerto Vallarta"]`.
= Can I add my own attributions to custom tile layers? =
Yes: use the keyword `attribution` in your shortcode (semi-colon separated list of attributions): `[leaflet-map attribution="Tiles courtesy of MapBox; Locations contributed by viewers"]`
== Screenshots ==
1. Put the shortcode into the post.
2. See the shortcode play out on the front end.
3. For `[leaflet-image]` upload an image, and copy the URL from the right-hand side
4. For `[leaflet-image]` paste that image URL into an attribute titled `source`: example: `src="http://lorempixel.com/1000/1000/"`.
5. See the `[leaflet-image]` on the front end.
6. If you use `[leaflet-marker draggable=true]`, then you can drag the marker where you want it, open a developers console, and see the specific shortcode to use.
7. Add geojson via URL: `[leaflet-geojson src="https://example.com/path/to.geojson"]`
8. MapQuest requires an app key, get it from their website; alternatively, you can use OpenStreetMap as a free tile service (remember to add an attribution where necessary).
== Changelog ==
= 2.10.1 =
* Fix for plugin settings not being included (somehow)
= 2.10.0 =
* Added functions for translating text
* Added string interpolation for GeoJSON popups to use feature properties (thanks to [@geraldo](https://github.com/geraldo))
= 2.9.1 =
* Fixes for PHP 7.2: made all method arguments identical
* Added minified JavaScript files for site speed
= 2.8.6 =
* Added [leaflet-gpx] for GPX format
= 2.8.6 =
* Fix image shortcode ratio
= 2.8.5 =
* Added missing files from 2.8.4
= 2.8.4 =
* Fixed issues with css and js CDN; removed version from querystring
* Split admin into new class
= 2.8.3 =
* Fix to [leaflet-kml]
* Standardized `src` in leaflet-image and leaflet-geojson/kml
= 2.8.2 =
* Fix to image maps
* Fixes to geocoder
* Added multi-line popups to markers and geojson/kml
= 2.8.1 =
* Code cleanup
* Added server-side and client-side methods to prevent WordPress from adding paragraph tags within shortcode tags
= 2.8.0 =
* Added Fit Markers to settings and map shortcode: [leaflet-map fit_markers=1]
* Moved geojson/kml popup text to the shortcode content instead of a property so that you can use links or other HTML
= 2.7.8 =
* update default Leaflet version (1.1.0 from 1.0.3)
= 2.7.7 =
* added default lat/lngs in the admin; and reordered admin fields to be more user friendly
= 2.7.6 =
* added optional cURL to get geolocations if file_get_contents is not allowed on a server (note: cURL needs to be enabled, obviously)
= 2.7.5 =
* fixed filter_var_array throwing errors in old PHP too
= 2.7.4 =
* Added settings link to plugins page
= 2.7.3 =
* Fix to array_filter on some PHP versions.
= 2.7.2 =
* Fix to possible JavaScript error "Unexpected token <"; only happened when a plugin/theme used `wpautop`; fix was to remove spaces.
= 2.7.1 =
* Removed unnecessary map counts;
= 2.7.0 =
* Added basic marker icon support (with attributes "iconUrl", "iconAnchor", etc.);
= 2.6.0 =
* Changes to map creation which may solve an occasional marker creation JavaScript error
* Added more attributes to marker shortcode (draggable, title, alt, opacity)
* Added doubleClickZoom global, database option to globally disable double click zooming (by default), because it's more inline with disabling scroll zooming by default. Box zooming on the other hand is more intentional
= 2.5.0 =
* Some improvements to the codebase;
* added the same styling options for lines as there are for geojson;
* added popups to lines, as there are for markers;
* added an example to the shortcode admin page for the style attributes on lines;
* added code and another example for disabling all map interactions (all zooms, keyboard, etc);
= 2.4.0 =
* Added Leaflet 1.0.2 scripts by default (works!);
= 2.3.0 =
* Added KML support `[leaflet-kml]`;
= 2.2.0 =
* Added popup_text and popup_property to leaflet-geojson to bind popups via a shortcode property or geojson properties
= 2.1.0 =
* Added Leaflet and GeoJSON.io styles to geojson shortcode
= 2.0.2 =
* OpenStreetMap.org has an SSL certificate (osm.org didn't); not a significant upgrade.
= 2.0.1 =
* Changed ajax request to be compatible with some versions of IE.
= 2.0 =
* Needed to add support for a MapQuest app key, since they discontinued the direct access of their tiles on July 11, 2016; added an alternate OpenStreetMap tile URL as the new default. Remember to reset options to default values!
= 1.16 =
* Added bare geojson support
= 1.15 =
* Removed shortcode brackets from leaflet-marker shortcode
= 1.14 =
* Fixed slashes in optional map attribution
= 1.13 =
* Added new geocoder options (thanks to [@nielsalstrup](https://github.com/nielsalstrup) for DAWA and [@jeromelebleu](https://github.com/nielsalstrup) for OSM)
= 1.12 =
* Added htmlspecialchars in admin.php, and custom attributions. Bugfix : removed position in admin menu so it doesn't overwrite or be overwritten (thanks to [@ziodave](https://github.com/ziodave))
= 1.11 =
* Added HTTPS support.
= 1.10 =
* Added lines to the map, thanks to [@Remigr](https://github.com/Remigr)!
= 1.9 =
* Added ability to use hyperlinks in marker messages.
= 1.8 =
* Added ability to self-host leaflet files.
= 1.7 =
* Uploaded 1.6 to subversion incorrectly!
= 1.6 =
* Important fix to conflicts with other plugins!
= 1.5 =
* Some helpful js fixes for multiple window onload functions, and added the `leaflet-image` shortcode!
= 1.4 =
* Some fixes for Google geocoding, and switched cookies to db options.
= 1.3 =
* Added cookies for Google geocoding to cut back on requests.
= 1.2 =
* Added geocoding to map: `[leaflet-map address="halifax, ns"]`.
= 1.1 =
* Added messages to markers.
= 1.0 =
* First Version. Basic map creation and marker creation.
== Upgrade Notice ==
= 2.10.1 =
Fix for plugin settings not being included (somehow)
= 2.9.1 =
Fix for PHP7.2; added minified JavaScript files
= 2.8.6 =
Added [leaflet-gpx] for GPX format
= 2.8.6 =
Fix image shortcode ratio
= 2.8.5 =
Fix to missing files in 2.8.4
= 2.8.4 =
Fixed issues with css and js CDN; removed version from querystring
= 2.8.3 =
Fixed issues with leaflet-kml
= 2.8.2 =
Fixed issues with image maps and geocoder addresses
= 2.7.6 =
added optional cURL to get geolocations if file_get_contents is not allowed on a server (cURL needs to be enabled, obviously)
= 2.7.5 =
fixed filter_var_array throwing errors in old PHP
= 2.7.3 =
Fixed array_filter on some older PHP versions
= 2.7.2 =
Fixed possible JavaScript error "Unexpected token <"; fix was to remove spaces
= 2.6.0 =
Changes to map creation which may solve an occasional marker creation JavaScript error
= 2.0.2 =
OpenStreetMap.org has an SSL certificate (osm.org didn't)
= 2.0.1 =
GeoJSON ajax requests now work with Internet Explorer (some versions)
= 2.0 =
MapQuest tiles will no longer work without an app key!
= 1.15 =
Fixed incompatibility with plugins that execute recursive shortcodes
= 1.14 =
Fixed slashes in optional map attribution
= 1.12 =
Added htmlspecialchars in admin.php, and custom attributions. Bugfix : removed position in admin menu so it doesn't overwrite or be overwritten (thanks to [@ziodave](https://github.com/ziodave))
= 1.6 =
Removed windows onload functions and created a construct and init js file for initiating the maps when Leaflet is ready (other plugins were overwriting windows.onload).
= 1.5 =
Improved stability for multiple plugins with windows onload functions.
= 1.0 =
First Version. Tested with 3.8.1.