-
Notifications
You must be signed in to change notification settings - Fork 3
/
readme.txt
105 lines (67 loc) · 4.45 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
=== GeoMeta For ACF ===
Contributors: stuporglue, luminfire
Tags: Advanced Custom Fields, GIS, geo, Spatial, ACF, WP-GeoMeta, GeoJSON
Requires at least: 4.4.0
Tested up to: 4.8
Stable tag: 0.0.7
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Store real spatial data with Advanced Custom Fields, using the WP-GeoMeta library.
== Description ==
GeoMeta for ACF is an easy way to store location information about posts, pages, users or other content types that ACF supports. The default input is a map with drawing tools to let the user draw markers, lines and polygons. Alternatively you can accept latitude and longitude values, or raw GeoJSON text.
GeoMeta for ACF supports for both ACF version 4 and 5.
Why use GeoMeta for ACF instead of one of the other map inputs for ACF?
GeoMeta for ACF uses WP-GeoMeta under the hood, which means that you're actually storing spatial meta data, not just text. With the WP-GeoMeta library you have access to all of the spatial functions MySQL supports to search and filter your WordPress posts and users.
= Compatibility =
This ACF field type is compatible with:
* ACF 5 / ACF Pro
* ACF 4
*Note*
Metavalues for terms (Categories/Tags) were stored in wp_options up until ACF Pro 5.5.0. GeoMeta for ACF will still display a map or other input field for terms in previous versions of ACF, but since the values aren't stored in the wp_termmeta table, they won't be picked up for inclusion in the spatial table and spatial searches on them will fail.
== Installation ==
Be sure that Advanced Custom Fields is installed. You can use Advanced Custom Fields (v4) or Advanced Custom Fields PRO (v5). Version 4 is [in the plugin repository](https://wordpress.org/plugins/advanced-custom-fields/). ACF PRO is [available from https://www.advancedcustomfields.com/pro/](https://www.advancedcustomfields.com/pro/).
With ACF installed, you can install this plugin in the usual WordPress way.
1. Upload the plugin files to the `/wp-content/plugins/geometa-acf` directory, or install the plugin through the WordPress plugin screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress.
Create a new field in ACF and select the GeoMeta field type.
== Frequently Asked Questions ==
No one has actually asked any questions yet!
= How can I run spatial queries? =
GeoMeta for ACF uses WP-GeoMeta internally. For sample queries, please see the [WP-GeoMeta documentation](https://github.com/BrilliantPlugins/wp-geometa#querying).
= Where can I get help with GIS and WordPress? =
For community support try [WherePress.com](http://WherePress.com/)
For commercial support you can contact the plugin developer at [Cimbura.com](https://cimbura.com/contact-us/project-request-form/)
For fast and short questions you can [contact me](https://twitter.com/stuporglue) on twitter.
== Screenshots ==
1. You can select the GeoMeta field type within the ACF field group like you would expect. You can choose one of three options for how users will enter spatial data.
2. The most likely option is to display a map with drawing tools. Editors can add, edit and delete shapes on the map.
3. If your users expect to be able to enter latitude and longitude, you can opt to capture those instead. The value is saved to the postmeta table as GeoJSON.
4. You can also allow editors to paste in raw GeoJSON text if that better meets your needs.
== Changelog ==
= 0.0.7 =
* Updated wp-geometa-lib for MySQL 8
= 0.0.6 =
* Updated wp-geometa-lib
= 0.0.5 =
* Updated wp-geometa-lib
* Updated readme.txt
* Tested with WP 4.8
* Fixed [issue](https://github.com/BrilliantPlugins/geometa-acf/issues/1) where maps wouldn't show up on category pages.
= 0.0.4 =
* Updated wp-geometa-lib
* Geometa-ACF is now using Leaflet-PHP to generate Leaflet code. Will allow for easier Leaflet maintenance going forward.
* Alpha feature *Bring Your Own Geocoder*. Define GEOMETA_ACF_BYOGC=true to enable and see media/js/geometa-acf.js for callbacks. More documentation coming when it comes out of alpha.
= 0.0.3 =
* Moved from including the WP-GeoMeta plugin to including wp-geometa-lib
* Fixed Contributor name for cimburacom
= 0.0.2 =
* Set up I18N support and Portuguese translation
* Code cleanup
* A start on code documentation
= 0.0.1 =
* Initial Release.
* Support for Map input, lat/lng fields and raw GeoJSON input
* Support for ACF v4 and ACF Pro/v5
== Upgrade Notice ==
= 0.0.3 =
* You don't have GeoMeta for ACF yet, so there's no need to read this upgrade notice!