-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathreadme.txt
173 lines (121 loc) · 5.56 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
=== VenoMaps - geo map and custom markers ===
Author: Nicola Franchini
Contributors: nicolafranchini
Version: 1.2.4
Stable tag: 1.2.4
Tested up to: 6.4
Requires at least: 4.0
Requires PHP: 5.3
Plugin Name: VenoMaps
Plugin URI: https://veno.es/venomaps/
Description: Create maps with custom styles, multiple markers, info windows with rich text editors. Widget and Block available. Vector maps supported.
Tags: map, maps, openlayers, location, places
Author URI: https://veno.es/
License: GPLv3
License URI: http://www.gnu.org/licenses/gpl-3.0.txt
Donate link: https://www.paypal.com/donate/?hosted_button_id=BXVJVBJ2BZUQL
Create maps with custom styles, multiple markers, info windows with rich text editors. Widget and Block available. Vector maps supported.
== Description ==
This plugin creates custom maps which can be placed anywhere: Contact pages, posts, sidebars, footer widgets, or directly into your theme's files!
Select a custom style and a size for the map, upload your custom markers, set the map's and the markers' coordinates, insert some html content for the popup info boxes and publish your map.
The VenoMaps page also offers some geolocation utilities to get the coordinates typing an address, or placing the marker in a specific position on the map. VenoMaps Block available.
VenoMaps is an alternative to Google Maps, it is based on OpenLayers and OpenStreetMap, doesn't require API keys and offers different custom maps.
You can also add your own custom styles from external services.
### Features
* **Easy to install and setup**
* **Ability to add Maps on pages / posts**
* **Gutenberg Block**
* **Ability to set custom options for each Map**
* **Manage custom markers with the WP media library**
* **Rich text editor for the Info Boxes**
* **Clusters**
* **Custom map styles**
* **Geolocation utility to get Latitude / Longitude from address**
* **Responsive design**
== Installation ==
Upload the plugin folder `venomaps` to the `/wp-content/plugins/` directory
Activate the plugin through the Plugins menu in WordPress
Create a new map under VenoMaps > Add New
Select the generated shortcode and insert it inside any post or page, or search VenoMaps among Blocks
Use the VenoMaps block to select a map and insert it inside your sidebars
Optionally add new styles inside Settings > VenoMaps
== Frequently Asked Questions ==
= How to place a map inside my template file? =
To display a map outside the post editor or widgets, paste the following PHP code inside your template file
`echo do_shortcode('[venomap id="xxx" height="xxx"]');`
replacing `[venomap id="xxx" height="xxx"]` with the shortcode generated by the plugin inside the map's page.
= Needs any API key? =
No. The default map styles are loaded without any API key. If you want to add some custom map styles you can create a free account at the following services:
- https://cloud.maptiler.com/maps/
- https://stadiamaps.com/stamen/
- https://www.thunderforest.com/maps/
select some standard maps, or create your own custom styles.
= Supports Google Maps? =
No, this plugin borns as an alternative to Google Maps, and is based on OpenStreetMap and OpenLayers. Quick, easy to setup, and free of tracking cookies.
== Screenshots ==
1. Custom map with markers
2. Clusters
3. Map page settings
4. Block
5. General settings
== Other Notes ==
### Create a Map
Go to your website admin panel, click on VenoMaps > Add New, give it a title and fill the coordinates as basic options.
You can add one or more markers with various options and attach a infobox to each marker. Publish the map.
### Adding into posts/pages
Insert the Block VenoMaps inside your posts or page, or copy the shortcode from the field below the map's title and paste it anywhere inside your posts or pages, that's it.
### Adding into widget
Under Appearance > Widgets you will find a new widget **VenoMaps**. Add it to your sidebar, select the desired map from the dropdown menu and save.
### Custom styles available
Under Settings > Venomaps you can add custom map tiles and set the api keys for the following services: Stadiamaps, Thunderforest, Maptiler
### Licenses and copyrights
## Default maps data provided by:
OpenStreetMap [ODbL](https://www.openstreetmap.org/copyright)
== Changelog ==
= 1.2.4 =
* New: Fullscreen control
= 1.2.3 =
* Update: Included maps from Stadiamaps, Thunderforest, Maptiler
* Update: Center map on marker when clicked
* Update: Cursor pointer on markers
= 1.2.2 =
* Update: Removed default styles, now Stamen maps require an api key
* Update: OpenLayers library 8.1.0
= 1.2.1 =
* Update: sync missing files
= 1.2.0 =
* New: Dynamic Clusters with custom colors
* Update: dropped jQuery dependency
* Update: removed legacy widgets
* Update: tested up to PHP 8.2
* Update: OpenLayers library 7.3.0
* Update: `Initial Zoom` and `Zoom Scroll` custom settings to each map
* Update: dropped support for vector maps, now custom maps only support raster tiles in png format
= 1.1.0 =
* Update: Minor CSS fixes
= 1.0.9 =
* Update: Support WP 6.2
* Update: Minor fixes
= 1.0.8 =
* Update: Support PHP 8.1
= 1.0.7 =
* Update: Support new block widgets
= 1.0.6 =
* Update: move marker position changing coordinates inside geolocation
= 1.0.5 =
* Fix: PHP error before saving settings
= 1.0.4 =
* Update: Drag and drop marker to get geolocation inside map edit
= 1.0.3 =
* Update: exclude venomaps cpt from public query
= 1.0.2 =
* Update: small fix on save settings
= 1.0.1 =
* Update: Hide VenoMaps CPT from nav menu items
* Update: Load css inside head
* Fix: Undefined templist
= 1.0.0 =
* First version
== Upgrade Notice ==
= 1.0.0 =
* First release