PluginProbe
CodePeople Post Map for Google Maps / trunk
CodePeople Post Map for Google Maps vtrunk
1.3.0 1.2.9 1.2.8 1.2.7 1.2.6 trunk 1.0.44 1.1.0 1.1.1 1.1.2 1.1.3 1.1.4 1.1.5 1.1.6 1.1.7 1.1.8 1.2.0 1.2.1 1.2.2 1.2.3 1.2.4 1.2.5
codepeople-post-map / readme.txt

readme.txt in CodePeople Post Map for Google Maps trunk, at readme.txt

668 lines 36.9 KB
No matching file
Up and down to move Enter to open Esc to close
Raw Download Zip
1 === CodePeople Post Map for Google Maps ===
2 Contributors: codepeople
3 Donate link: http://wordpress.dwbooster.com/content-tools/codepeople-post-map
4 Tags:google maps,maps,marker,places,routes
5 Requires at least: 3.0.5
6 Tested up to: 7.1
7 Stable tag: 1.3.0
8 License: GPLv2 or later
9 License URI: http://www.gnu.org/licenses/gpl-2.0.html
10
11 CodePeople Post Map lets you geotag posts and seamlessly integrate your blog with Google Maps for a smooth, location-aware experience.
12
13 == Description ==
14
15 **CodePeople Post Map for Google Maps** lets you insert Google Maps into posts or WordPress templates displaying multiple posts. In single posts, it shows a marker for the post’s geolocation and optionally markers for recent posts in related categories. In templates, it displays markers for all posts on the page, highlighting the related post on hover.
16
17 **Main Features:**
18
19 ► Insert Google Maps at optimal positions or associate geolocation without displaying the map
20 ► Handle large volumes of markers
21 ► Discover related entries via map markers
22 ► Define location by address or coordinates
23 ► Customize markers and info bubbles (including default-open bubbles)
24 ► Embed maps in multiple languages
25 ► Based on Google Maps JavaScript API v3
26 ► Show markers for posts in the same category
27 ► Customize zoom, size, margins, alignment, map type/language, display mode (full or icon), controls, number of points, and hover class
28 ► Style the map freely
29
30 **Premium Features:**
31
32 * Load points from specific posts, categories, tags, or all posts
33 * Use location info and descriptions in post search
34 * Associate multiple points per post/page
35 * Draw routes and shapes
36 * Add a search box for places
37 * Create legends with categories/tags/taxonomies to toggle visibility
38 * Add links for directions, opening in Google Maps, or Street View
39 * Display multiple maps per post/page (same points across maps)
40 * Insert maps as sidebar widgets
41 * Group markers in clusters
42 * Show and refresh user location at intervals
43 * Generate dynamic points from image metadata or WordPress App geolocation
44 * Associate maps with any public post_type
45 * In non-singular pages, show a map per post
46 * Export/import points via CSV or KML
47 * Load KML layers from files
48
49 **Developer Features (includes Premium):**
50
51 * Design contact forms linked to map points
52 * Send notification emails from form submissions
53 * Assign unique or global email addresses to points
54 * Support Contact Form 7 shortcodes in point descriptions
55 * Use point-associated images as map icons
56
57 **Demo Access:**
58
59 [https://demos.dwbooster.com/cp-google-maps/wp-login.php](https://demos.dwbooster.com/cp-google-maps/wp-login.php "Click to access the administration area demo")
60
61 [https://demos.dwbooster.com/cp-google-maps/](https://demos.dwbooster.com/cp-google-maps/ "Click to access the Public Page")
62
63 == Shorcode Attributes and Plugin Settings ==
64
65 Note 1: To display all points that belong to a specific category in the same Google Map, it is required to insert the following shortcode `[codepeople-post-map cat="3"]`. The number 3 represent the category ID, replace this number by the corresponding category's ID. To insert the code directly in a template, the snippet of code would be:
66
67 <?php echo do_shortcode('[codepeople-post-map cat="3"]'); ?>
68
69 Note 2: To display all points that belong to more than one category in a same Google Map, separate the categories IDs with the comma symbol `[codepeople-post-map cat="3,5"]`. The numbers 3 y 5 are the categories IDs, replace these numbers by the corresponding categories IDs. To insert the code directly in a template, the snippet of code would be:
70
71 <?php echo do_shortcode('[codepeople-post-map cat="3,5"]'); ?>
72
73 Note 3: To display all points defined in the website in a same Google Map, use -1 as the category's ID:
74
75 [codepeople-post-map cat="-1"]
76
77 or
78
79 <?php echo do_shortcode('[codepeople-post-map cat="-1"]'); ?> for template.
80
81 Note 4: To display all points that belong to the posts with a specific tag assigned in a same Google Map, for example the tag name "mytag", use the shortcode's attribute "tag", as follows: `[codepeople-post-map tag="mytag"]`. To insert the code directly in a template, the snippet of code would be:
82
83 <?php echo do_shortcode('[codepeople-post-map tag="mytag"]'); ?>
84
85 Note 5: To display the points belonging to specific posts or pages in a same Google Map, enter their ids separated by comma through the "id" attribute in the shortcode as follows: `[codepeople-post-map id="123"]`. To insert the code directly in a template, the snippet of code would be:
86
87 <?php echo do_shortcode('[codepeople-post-map id="123"]'); ?>
88
89 The "id" attribute has preference over the rest of the filtering attributes.
90
91 If you prefer configure your map directly from the shortcode, then you must enter an attribute for each map feature to specify. For example:
92
93 [codepeople-post-map width="500" height="500"]
94
95 The complete list of allowed attributes are:
96
97 Very Important. Some of attributes are available only in the premium and developer versions of the plugin.
98
99 width: Values allowed, number or percentage. Defines the map's width:
100
101 [codepeople-post-map width="300"]
102
103 or
104
105 [codepeople-post-map width="100%"]
106
107 height: Values allowed, number or percentage (In the web's development, the height in percentage is effective only if the parent element has a height defined). Defines the map's height:
108
109 [codepeople-post-map height="300"]
110
111 align: Values allowed, left, right, center. Aligns the map's container to the left, right or center:
112
113 [codepeople-post-map align="center"]
114
115 dynamic_zoom: Values allowed, 1 or 0. Adjust the zoom of map dynamically to display all points on map at the same time:
116
117 [codepeople-post-map dynamic_zoom="1"]
118
119 zoom: Accepts a number to define the map's zoom. To apply a zoom to the map, the dynamic zoom should be 0:
120
121 [codepeople-post-map dynamic_zoom="0" zoom="5"]
122
123 type: Values allowed, SATELLITE, ROADMAP, TERRAIN and HYBRID. Select the type of map to display:
124
125 [codepeople-post-map type="ROADMAP"]
126
127 language: Values allowed, en for English, es for Spanish, pt for Portuguese, etc. (for the complete list, check the Google Maps documentation). Select a language to display on map:
128
129 [codepeople-post-map language="en"]
130
131 route: Values allowed, 0 or 1. Draw or not the route between points in a same post or page:
132
133 [codepeople-post-map route="1"]
134
135 mode: Values allowed, DRIVING, BICYCLING and WALKING. Define the type of route:
136
137 [codepeople-post-map route="1" mode="DRIVING"]
138
139 show_window: Values allowed, 0 or 1. To enable or disable the infowindows:
140
141 [codepeople-post-map show_window="1" ]
142
143 show_default: Values allowed, 0 or 1. Display or not an infowindow expanded by default:
144
145 [codepeople-post-map show_window="1" show_default="1"]
146
147 markerclusterer: Values allowed, 0 or 1. Displays a cluster with the number of points in an area:
148
149 [codepeople-post-map markerclusterer="1"]
150
151 mousewheel: Values allowed, 0 or 1. Enables the map's zoom with the mouse wheel:
152
153 [codepeople-post-map mousewheel="1"]
154
155 zoompancontrol: Values allowed, 0 or 1. Displays or hide the zoom controls in the Google Maps:
156
157 [codepeople-post-map zoompancontrol="1"]
158
159 typecontrol: Values allowed, 0 or 1. Displays or hide the type control in the Google Map:
160
161 [codepeople-post-map typecontrol="1"]
162
163 streetviewcontrol: Values allowed, 0 or 1. Displays or hide the street-view control in the Google Map:
164
165 [codepeople-post-map streetviewcontrol="1"]
166
167 defaultpost: Defines the post ID, for centring the map, and display by default the infowindow corresponding to the first point associated to this post:
168
169 [codepeople-post-map defaultpost="396"]
170
171 center: To define the center of the map, but if the infowindows are configured to be opened by default, the map will be centered in the point with the infowindow opened:
172
173 [codepeople-post-map center="40.7127837,-74.00594130000002"]
174
175 legend: Accepts a taxonomy name as value. Some common taxonomies names are: category and post_tag, for the categories and tags, respectively. Displays the legend with the list of elements that belong to the taxonomy and are assigned to the posts associated with the points:
176
177 [codepeople-post-map legend="category"]
178
179 legend_title: Text to be used as legend title:
180
181 [codepeople-post-map legend="category" legend_title="Select the categories to display on map"]
182
183 legend_class: Class name to be assigned to the legend. The legend design may be modified through CSS styles. Creates a class name, with the styles definition, and associates the new class name to the legend through the legend_class attribute:
184
185 [codepeople-post-map legend="category" legend_class="my-legend-class"]
186
187 tag: Tags slugs separated by ",". Displays on map the points whose posts have assigned the tags:
188
189 [codepeople-post-map tag="tag1,tag2,tag3"]
190
191 cat: Categories IDs separated by "," or -1. Displays on map the points whose posts belong to the categories. The special value -1, allows display on map all points defined in the website:
192
193 [codepeople-post-map cat="2,4,56"]
194
195 [codepeople-post-map cat="-1"]
196
197 excludecat: Categories IDs to exclude, separated by ",". From points to be displayed on map, the plugin excludes the points whose posts belong to the categories to exclude:
198
199 [codepeople-post-map tag="tag1,tag2" excludecat="4"]
200
201 excludepost: Posts IDs to exclude separated by ",":
202
203 [codepeople-post-map cat="-1" excludepost="235,260"]
204
205 excludetag: Tags IDs to exclude separated by ",":
206
207 [codepeople-post-map excludetag="2,13"]
208
209 taxonomy: The taxonomy is a special attribute that should be combined with other attributes, depending of taxonomies to use for points filtering. Suppose the website includes two new taxonomies: taxonomyA and taxonomyB, and the map should display all points that belong to the posts with the value T1 for taxonomyA, and T3,T4 for taxonomyB, the shortcode would be:
210
211 [codepeople-post-map taxonomy="taxonomyA,taxonomyB" taxonomyA="T1" taxonomyB="t2,t3"]
212
213 Note 5: The geolocation information is stored in image's metadata from mobiles or cameras with GPS devices.
214
215 Note 6: Some plugins interfere with the shortcodes replacements, and provokes that maps don't be loaded correctly, in this case should be passed a new parameter through the shortcode print=1
216
217 Passing the parameter print=1, displays the map at beginning of page/post content.
218
219 Note 7: To display in the Google Map all points in posts with a specific taxonomy assigned, or multiple taxonomies, should be used the "taxonomy" attribute in the shortcode, with the list of all taxonomies separated by the comma symbol, for example: taxonomy="taxonomy1,taxonomy2", and a new attribute for each taxonomy with the values corresponding. For example if you want select the points that belong to the posts with the values: "value1" for "taxonomy1", the shortcode would be:
220
221 [codepeople-post-map taxonomy="taxonomy1" taxonomy1="value1"]
222
223 for multiple taxonomies:
224
225 [codepeople-post-map taxonomy="taxonomy1,taxonomy2" taxonomy1="value1" taxonomy2="value2,value3"].
226
227 post_type: In combination with other attributes like: cat, tag or taxonomy, it is possible to load on map only the points that belong to the post types in the list:
228
229 [codepeople-post-map cat="-1" post_type="post,page"]
230
231 excludepost_type: In combination with other attributes like: cat, tag or taxonomy, it is possible to load on map only the points that do not belong to the post types in the list:
232
233 [codepeople-post-map cat="-1" excludepost_type="post"]
234
235 kml: Absolute URL (http://...) to a KML file with the Keyhole Markup Language:
236
237 [codepeople-post-map kml="http://www.yourwebsite.com/your-file.kml"]
238
239 If you want more information about this plugin or another one don't doubt to visit my website:
240
241 [http://wordpress.dwbooster.com/content-tools/codepeople-post-map](http://wordpress.dwbooster.com/content-tools/codepeople-post-map "CodePeople Post Map for Google Maps")
242
243 == Installation ==
244
245 **To install CodePeople Post Map for Google Maps, follow these steps:**
246
247 1. Download and unzip the plugin
248 2. Upload the entire codepeople-post-map/ directory to the /wp-content/plugins/ directory
249 3. Activate the plugin through the Plugins menu in WordPress
250
251 == Interface ==
252
253 **Google Maps** offers several setting options and is highly flexible. Options can be set up in the Settings page (and will become the **default setup** for all maps added to posts in the future), or may be **specific to each post** to be associated with the Google maps (in this case the values are entered in the editing screen of the post in question.)
254
255 The settings are divided into two main groups, those belonging to the Google maps and those belonging to the geolocation point.
256
257 **Google Maps configuration options:**
258
259 * Map zoom: Initial map zoom.
260 * Dynamic zoom: Allows to adjust the map's zoom dynamically to display all points at the same time.
261 * Map width: Width of the map.
262 * Map height: Height of the map.
263 * Map margin: Margin of the map.
264 * Map align: Aligns the map at left, center or right of area.
265 * Map type: Select one of the possible types of maps to load (roadmap, satellite, terrain, hybrid).
266 * Map language: a large number of languages is available to be used on maps, select the one that matches your blog's language.
267 * Allow drag the map: allows drag the map to see other places.
268 * Map route: Draws the route through the points that belong to the same post (available only in the premium and developer versions of plugin)
269 * Travel Mode: Travel mode used in route drawing (available only in the premium and developer versions of plugin)
270 * Include Traffic Layer: Displays a traffic layer over the map.
271 * Show info bubbles: display or hide the bubbles with the information associated to the points.
272 * Display a bubble by default: display a bubble opened by default.
273 * Display map in post / page: When the Google maps are inserted in a post you can select whether to display the Google maps or display an icon, which displays the map, when pressed (if the Google maps are inserted into a template that allows multiple posts, this option does not apply)
274 * Options: This setting allows you to select which map controls should be available.
275 * Display a bundle of points in the same area, like a cluster: Allows grouping multiple points in a cluster (available only in the premium and developer versions of plugin)
276 * Display Featured Image by default: Displays the Featured Image in posts and pages in the infowindows, if the points don't have associated an image.
277 * Display the user's location: Displays a marker with the location of user that is visiting the webpage (available only in the premium and developer versions of plugin)
278 * Refresh the user's location every: Integer number that represent the interval in milliseconds to refresh the user's location (available only in the premium and developer versions of plugin)
279 * Title of user's location: Enter the title of infowindow belonging to the user's marker (available only in the premium and developer versions of plugin)
280 * Display the get directions link: Displays a link in the infowindow to get the directions to the point (available only in the premium and developer versions of plugin)
281 * Display a link to Google Maps: Displays a link in the infowindow to load the point directly on Google Maps.
282 * Display a link to Street View: Displays a link in the infowindow to display the street view in the specific point.
283 * Enter the number of points on the post / page map: When the Google maps are inserted into a post, points that belong to the same categories will be shown on the same Google map. This option allows you to set the number of points to be shown. When the Google maps are inserted into a template that allows multiple posts this option does not apply.
284 * Generate points dynamically from geolocation information included on images, when images are uploaded to WordPress: If the image uploaded to WordPress includes geolocation information is generated a point with related to the geolocation information.
285 * Generate points dynamically from geolocation information included on posts: Displays new points on maps, if the post includes geolocation information, generated by WordPress App.
286 * Display maps legends: Check the option to display a legend with categories, tags, or custom taxonomies, to display or hide the points on map dynamically.
287 * Select the taxonomy to display on legend: Select the taxonomies to display on legend.
288 * Enter a title for legend: Enter the title to display in the legend.
289 * Enter a classname to be applied to the legend: To customize the legend appearance, associate to it a classname, and set the class definition in any of style files in your website.
290 * Highlight post when mouse hovers over related point on map: When the Google maps are inserted into a template that allows multiple posts, hovering the mouse over one of the points will highlight the associated post through assignment of a class in the next setup option.
291 * Highlight class: Name of the class to be assigned to a post to highlight when the mouse is hovered over the point associated with that post on the Google map.
292 * Use points information in search results: Allows search in the points information ( available only in the premium and developer versions of plugin )
293 * Allow to associate a map to the post types: Allows to associate points to custom post types in website ( available only in the premium and developer versions of plugin )
294
295 **Configuration options related to the points location**
296
297 * Location name: Name of the place you are indicating on the Google maps, alternatively, the name of the post can be used.
298 * Location description: Description of the place you are showing on the Google maps. If left blank, the post summary will be used.
299 * Select an image from media library: Select an image to associate with the localization point.
300 * Address: Physical address of the geolocation point.
301 * Latitude: Latitude of the geolocation point (gotten from Google Maps).
302 * Longitude: Longitude of the geolocation point (gotten from Google Maps).
303 * Verify: This button allows you to check the accuracy of the geolocation point address by updating the latitude and longitude where necessary.
304 * Select the marker by clicking on the images: Select the bookmark icon to show on the Google Maps.
305 * Insert the map tag: Inserts a shortcode in the content of the post where the Google Map is displayed with the features selected in the setup. You can attach geolocation information to a post but choose not to show the Google maps in the content of the post. In case you do want to display a map in the post content, use this button.
306
307 **Configure Shapes**
308
309 * Check the box over the "Insert the map tag" button.
310 * Enter the stroke weight of shape.
311 * Enter the color of shape.
312 * Enter the opacity of shape.
313 * Press with the mouse on map at right to draw the shape.
314
315 **Inserting maps as widgets on sidebars** (available only in the premium and developer versions of plugin)
316
317 To insert the maps as widget on sidebars, go to the menu option "Appearance / Widgets", and drag the "CodePeople Post Map for Google Maps" widget to the sidebar.
318
319 It is possible define, for each map on sidebar, all attributes available with the format attr="value". The map's width is set to the 100% of sidebar by default.
320
321 **Translations**
322
323 The CodePeople Post Map for Google Maps uses the English language by default, but includes the following language packages:
324
325 * Spanish
326 * French
327
328 Note: The languages packages are generated dynamically. If detects any errors in the translation, please, contact us to correct it.
329
330 == Frequently Asked Questions ==
331
332 = Q: Why the Google Map shortcode is not inserted on page content? =
333
334 A: There are some content editors, available as WordPress plugins, that provoke some compatibility issues with WordPress, in this case you should type the shortcode manually:
335
336 [codepeople-post-map]
337
338 = Q: How many Google Maps I can insert into a post? =
339
340 A: In the free version of plugin only one map with only one point associated in each post/page. In the premium version of plugin it is possible associate multiple points to the post and insert multiple shortcodes ( if there are multiple maps included in the same post/page, all of them will display the same points)
341
342 = Q: How to insert Google Maps into a template? =
343
344 A: Load the template in which you want to place the map in the text editor of your choice and place the following code in the position where you want to display the Google maps:
345
346 <?php echo do_shortcode ('[codepeople-post-map]'); ?>
347
348 = Q: Is possible to load all points that belong to the posts with a tag assigned in a same Google Map? =
349
350 A: To display all points that belong to the posts with a specific tag assigned, for example the tag name "mytag", use the shortcode's attribute "tag", as follows:
351
352 [codepeople-post-map tag="mytag"]
353
354 To insert the code directly in a template, the snippet of code would be:
355
356 <?php echo do_shortcode('[codepeople-post-map tag="mytag"]'); ?>
357
358 = Q: How to know the ID of a category? =
359
360 A: The explanation to determine the ID of a category is applied to other taxonomies.
361
362 Access to the categories through the menu option: "Posts/Categories". After accessing to the categories page, click the "Edit" link corresponding to the category, and pays special attention to the parameter "tag_ID", in the URL on browser. The value in this parameter correspond to the ID of the category.
363
364 = Q: Is possible to load all points in a category in a same Google Map? =
365
366 A: To display all points that belong to a specific category, it is required to insert the following shortcode
367
368 [codepeople-post-map cat="3"]
369
370 The number 3 represent the category ID, replace this number by the corresponding category's ID. To insert the code directly in a template, the snippet of code would be:
371
372 <?php echo do_shortcode ('[codepeople-post-map cat="3"]'); ?>
373
374 = Q: How to exclude the points in a category? =
375
376 A: To exclude the points that belong to a specific category, or various categories, inserts the attribute excludecat in the shortcode:
377
378 [codepeople-post-map excludecat="3,4"]
379
380 The number 3 and 4 represent the categories IDs.
381
382 = Q: How to exclude the points in a post? =
383
384 A: To exclude the points that belong to a post, or various posts, inserts the attribute excludepos in the shortcode:
385
386 [codepeople-post-map excludepost="3,4"]
387
388 The number 3 and 4 represent the posts IDs.
389
390 = Q: How to exclude the points in posts with tag? =
391
392 A: To exclude the points that belong to the post with a specific tag, or various tags, inserts the attribute excludetag in the shortcode:
393
394 [codepeople-post-map excludetag="3,4"]
395
396 The number 3 and 4 represent the tags IDs.
397
398 = Q: Is possible to load all points in more than one category in a same Google Map? =
399
400 A: To display all points that belong to multiple categories, it is required separate the categories IDs with comma ","
401
402 [codepeople-post-map cat="3,5"]
403
404 The numbers 3 and 5 are the categories IDs, replace these numbers with the corresponding categories IDs. To insert the code directly in a template, the snippet of code would be:
405
406 <?php echo do_shortcode ('[codepeople-post-map cat="3,5"]'); ?>
407
408 = Q: Is possible to load all points in the website in a same Google Map? =
409
410 A: To display all points in the website use -1 as the category ID:
411
412 [codepeople-post-map cat="-1"]
413
414 or
415
416 <?php echo do_shortcode ('[codepeople-post-map cat="-1"]'); ?>
417
418 for template.
419
420 = Q: If I link geolocation information to a post but do not insert a Google map in it, will the geolocation information be available? =
421
422 A: If you have inserted a Google map into a template where multiple posts are displayed, then the geolocation information associated with posts is displayed on the map.
423
424 = Q: How can I disable the information window of point opened by default? =
425
426 A: Go to the settings of map (the settings page of plugin for settings of all maps, or the settings of a particular map), and uncheck the option "Display a bubble by default"
427
428 = Q: How can I disable all information windows of points? =
429
430 A: Go to the settings of map (the settings page of plugin for settings of all maps, or the settings of a particular map), and uncheck the option "Show info bubbles"
431
432 = Q: How can I use different icons, in the points markers? =
433
434 A: To use your own icons, you only should to upload the icons images to the following location: "/wp-content/plugins/codepeople-post-map/images/icons/", and then select the image from the list in the point's definition.
435
436 = Q: How can I use particular settings in a map? =
437
438 A: You may use a particular settings in a map, defining the options directly as attributes of shortcode:
439
440 [codepeople-post-map width="100%"]
441
442 If you are inserting the map in a particular page/post, you may check the field named "Use particular settings for this map", and then entering the particular values in the settings options.
443
444 = Q: Is possible to display the map as responsive design? =
445
446 A: Yes, that is possible, you only should to define the width of map with values in percent. For example: 100%
447 Pay attention the height definition with percent is not recommended, because it is only possible if the map's container has a fixed height.
448
449 = Q: How to get the directions to the point? =
450
451 A: Go to the settings page of plugin and check the box to display the "Get directions" link in the infowindow. The "Get directions" link will be displayed in the infowindow.
452
453 = Q: Is possible to include multiple taxonomies in the maps' legends? =
454
455 A: In the shortcode can be defined the attribute "legend" for selecting the taxonomy to use in the legend of map:
456
457 [codepeople-post-map legend="category"]
458
459 but from the version 5.0.6 of the plugin it is possible to define in the legend multiple taxonomies separated by comma, to include all of them in the map's legend:
460
461 [codepeople-post-map legend="category,post_tag"]
462
463 = Q: How to open the point on Google Maps? =
464
465 A: If you want to display a link to open the point directly on Google Maps, go to the settings page of plugin, and checks the box to display the link in the infowindow.
466
467 = Q: Could I insert the map as widget? =
468
469 A: Yes, you can. Go to the menu option: "Appearance / Widgets" and insert the "CodePeople Post Map for Google Maps" widget on side bar.
470
471 = Q: My images include geolocation information. Is possible use the geolocaion information stored in the image to generate points on map? =
472
473 A: Go to the settings page of plugin and select the corresponding option to allow processing the information stored on image's metadata, and then if an image uploaded to WordPress, includes geolocation information, will be generated a point with this information dynamically, that will be displayed on map.
474
475 = Q: Why the maps are not showing on website? =
476
477 A: Some plugins interfere with the shortcodes replacements, and provokes that maps don't be loaded correctly, in this case should be passed a new parameter through the shortcode print=1
478 Passing the parameter print=1, displays the map at beginning of page/post content.
479
480 = Q: It is possible to draw routes for flights between countries? =
481
482 A: By default Google draws routes between points connected by cars, bus, trains, etc, but not for flights. So, in this case should be used polylines. To connect points with polylines, tick the attribute: "Connect the points with polylines, even if there is not a route between points", in the settings page of maps.
483
484 = Q: How can I change the route between address? =
485
486 A: The route depends on the order of the points. If you want change the route, you should change the order of point. Takes the point by the handle's icon, and drag it to its correct position in the points list.
487
488 = Q: What are the differences between routes and polylines? =
489
490 A: The routes are drawn on maps, only if there are known routes between the locations, based in the travelling mode (driving, walking), but if Google unknown a way between both address, is not able to draw the route. The polylines are straight lines connecting two addresses, even if there is not a route. It is main difference between both concepts, and why the polylines are preferred for representing flights.
491
492 = Q: Is possible create routes between points in different posts? =
493
494 A: Yes, it's possible to draw a route including points belonging to different posts/pages, but in the current version of the plugin would be needed duplicate some points. Visit the following link to our technical blog with detailed instructions:
495
496 [http://blog.net-factor.com/how-connecting-multiple-posts-on-a-route/](http://blog.net-factor.com/how-connecting-multiple-posts-on-a-route/ "How connecting multiple posts on a route?")
497
498 = Q: How can I centring the map in a point defined a specific post, and display its infowindow? =
499
500 A: Use the "defaultpost" attribute, in the map's shortcode, as follows:
501
502 [codepeople-post-map defaultpost="231"]
503
504 The number is the post's ID
505
506 = Q: I've configured the sizes of the map to be displayed with a responsive design, but the map is not showing =
507
508 A: To display the maps with a responsive design, you should define the map's width with percentages (for example 100% if you want that the map width be the same that its container), but PAY ATTENTION, in web development the treatment of the width and height is different. The page width is limited by the browser's width, but with the height it is not apply. So, you should enter a fixed height(for example 320px).
509
510 The only way to define the map's height in percentages, is if the element that contain the map has defined a fixed height.
511
512 = Q: Can be inserted a link in the infowindow? =
513
514 A: It is possible insert links, and any other HTML element in the infowindow. You only should insert HTML tags directly in the point description. For example, to insert a link to our web page: &lt;a href=&quot;http://wordpress.dwbooster.com&quot;&gt;Click Here&lt;/a&gt;
515
516 = Q: After entering an address, and to press the verify button, the address is modified, and the pin is displayed in a different location of the map =
517
518 A: If after pressing the "verify" button, the address is modified dynamically, and the pin is displayed in another location, the cause is simple. If Google Maps does not recognize an address, it uses the nearest known address, and displays the pin on this location.
519
520 To solve the issue, you simply should drag and drop the pin in the correct location, and type the address again, but this time "DON'T PRESS AGAIN THE VERIFY BUTTON".
521
522 = Q: I've inserted an image in the page, but have not been generated a new point in the map =
523
524 A: First, be sure you have checked the option "Generate points dynamically from geolocation information included on images, when images are uploaded to WordPress", from the settings page of the plugin.
525
526 Second, be sure the image includes the Exif tags with the geolocation information (latitude and longitude)
527
528 Finally, you should upload the image from the "Add Media" button of the page or post, and not from the media library.
529
530 = Q: Can be generated a point from the page publication, with the location of the author? =
531
532 A: Yes, that is possible but only from the WordPress App, available for iPhone, iPad and Android, with the option for sharing the location enabled in the application. Furthermore, from the settings page of the plugin, should be checked the option: "Generate points dynamically from geolocation information included on posts"
533
534 = Q: How to display a map in the search results page, with the points defined in the resulting posts and pages? =
535
536 A: To insert a map in the results page with the points defined in the resulting posts and pages, you simply should identify the template file, in the active theme on your WordPress, that is used in the search page (usually it is called search.php), and inserts the map's shortcode directly in the file's content:
537
538 <?php echo do_shortcode( '[codepeople-post-map]' ); ?>
539
540 = Q: Can be searched in the website by the points information? =
541
542 A: If was checked the option "Use points information in search results", from the settings page of the plugin. The searching process will consider the points information too, and the posts and pages resulting could be selected by its points.
543
544 Pay attention, the results of search will be the posts and pages that include the points, not the point directly.
545
546 = Q: What styles are used in the infowindows? =
547
548 A: The design of infowindows is defined through styles in the cpm-styles.css file, located in "/wp-content/plugins/codepeople-post-map/styles/cpm-styles.css", specifically with the styles:
549
550 .cpm-infowindow {margin:0; padding:0px; min-height:80px; font-size:11px; clear:both;}
551 .cpm-infowindow .cpm-content {float:left;width:100%; color:black;}
552 .cpm-infowindow .cpm-content .title {font-size:12px; line-height: 18px; font-weight:bold; color:black;}
553 .cpm-infowindow .cpm-content .address {font-weight:bold; font-size:9px;}
554 .cpm-infowindow .cpm-content .description {font-size:10px;}
555
556 = Q: Can be highlighted the post or page related with the point on map? =
557
558 A: From the settings page of the plugin, there are two options:
559
560 * Highlight post when mouse move over related point on map
561 * Highlight class
562
563 If you check the option: "Highlight post when mouse move over related point on map", and enter a class name in the "Highlight class" attribute, in the maps inserted on pages with multiple entries, the class name will be applied to the post, or page, when the mouse is moved over a point associated in the corresponding page or post.
564
565 = Q: How can be created shapes on map? =
566
567 A: In the map's definition, directly in the page or post where the map is being inserted, there is the checkbox: "Do you want display a shape on map?", please, tick the checkbox to expand the shape's section.
568
569 The shape's section includes some options like: the stroke weight (if you don't want to display an stroke around the shape, set its value to zero), the fill colour (the colour code with the format: #FFFFFF, to select the shape colour), and the opacity to be applied to the shape, take into consideration than zero is transparent and 1 is opaque. Remember, the shape is displayed over the map, if you set the opacity to 1, won't be possible to see the map's area.
570
571 Now the most important part create the shape's area. To create the shape's area is sufficient with click in the map at right (Don't worry, the pins are not included in the final map, are inserted in the preview map to allow modify the shape's area). Through the pins at right map it is possible modify the shape's area, click on the pin to delete it, or drag the pin to another location to vary the shape.
572
573 == Screenshots ==
574
575 01. Maps in action
576 02. Styling the maps
577 03. Map with user's location
578 04. Map with shape
579 05. Global maps settings
580 06. Point insertion's form
581 07. Inserting map on sidebars
582 08. Generates points, from the geolocation information stored on image's metadata
583 09. Contact Form Builder (only available in the Developer version of the plugin)
584 10. Associate the contact form with the point, and define an email address between the point's data (only available in the Developer version of the plugin)
585 11. Export/Import section (only available in the Developer version of the plugin)
586
587 == Changelog ==
588
589 = 1.3.0 =
590
591 * Updates the Editor integration to ensure compatibility with WordPress 7.1.
592
593 = 1.2.9 =
594
595 * Enhanced security in the Gutenberg preview endpoint with additional authorization checks.
596
597 = 1.2.8 =
598
599 * Fixes some notices in PHP8.5.
600
601 = 1.2.7 =
602 = 1.2.6 =
603
604 * Enhanced plugin security. Special thanks to dutafi (Patchstack) and PRISM (Wordfence) for responsibly reporting the issues.
605 * Increased the minimum required user role to Author for creating points, as this permission level is more appropriate for the feature.
606
607 = 1.2.5 =
608
609 * Modifies the plugin name and references to meet WordPress directory requirements.
610
611 = 1.2.4 =
612
613 * Ensures full compatibility with WordPress 6.8.
614
615 = 1.2.3 =
616
617 * Enhance the compatibility with latest Google Maps APIs.
618
619 = 1.2.2 =
620
621 * Improves the plugin interface.
622
623 = 1.2.1 =
624
625 * Resolves a compatibility issue with WordPress version previous to 5.5.
626
627 = 1.2.0 =
628
629 * Introduces the new Marker and Cluster libraries.
630 * Updates the Gutenberg block and metabox for enhanced functionality.
631 * Enhances the plugin settings page for a better user experience.
632
633 = 1.1.8 =
634
635 * Allows configuring the points to display when WPML is installed on the website.
636
637 = 1.1.7 =
638
639 * Load Google Maps APIs asynchronously so as not to affect website performance.
640
641 = 1.1.6 =
642
643 * Fixes a conflict in the activation process with WP6.5.
644
645 = 1.1.5 =
646
647 * Implements the integration with new Borlabs Cookie version.
648
649 = 1.1.4 =
650
651 * Improves the integration with third-party plugins.
652
653 = 1.1.3 =
654
655 * Removes deprecated JS code.
656
657 = 1.1.2 =
658
659 * Hides the map gray background color on zoom out.
660
661 = 1.1.1 =
662
663 * Fixes an issue in default variables.
664
665 = 1.1.0 =
666
667 * Improves the plugin interface.
668 * Implements the WCML integration to display points from active language.