Title: WP GeoPosts
Author: fyaconiello
Published: 2012-08-16
Last modified: 2012-08-20
---
Search plugins
This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.
# WP GeoPosts
By [fyaconiello](https://profiles.wordpress.org/fyaconiello/)
[Download](https://downloads.wordpress.org/plugin/wp-geoposts.zip)
* [Details](https://tt.wordpress.org/plugins/wp-geoposts/#description)
* [Reviews](https://tt.wordpress.org/plugins/wp-geoposts/#reviews)
* [Installation](https://tt.wordpress.org/plugins/wp-geoposts/#installation)
* [Development](https://tt.wordpress.org/plugins/wp-geoposts/#developers)
[Support](https://wordpress.org/support/plugin/wp-geoposts/)
## Description
#### Features
1. Adds `location`, `latitude`, and `longitude` meta + metaboxes to any content type.
2. Provides an easy to use interface for selecting which content types to apply the
above meta values. _Note: this allows selection of built in types: page and post
as well as any registered custom post types._
3. Provides `WP_GeoQuery` an extended `WP_Query` class for doing distance based and
geo-aware queries.
Coming Soon!
* Add support for `within radius` option to WP_GeoQuery
* HTML5 geolocation of visitors, with a fallback to `Change Location` (stored as
COOKIE)
* Custom Markers by post type.
* Shortags for:
- `Get Directions` link (utilizing Google Maps)
- Static Map – show one or more posts on a static map
- Dynamic Map – show one or more posts on a dynamic map
- Option to show radius as overlay (for `within radius` calls)
## Installation
#### Installation
1. Upload the entire `wp-geo-posts` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the `Plugins` menu in WordPress.
#### Setup
1. Click the `Settings` link on the plugin management page **OR** click the `WP GeoPosts`
link from the Settings flyout menu.
2. Generate a Google Maps API Key and enter it into the provided text input. _Note:
this is optional and used for Google Maps API calls._
3. Select all of the content types that you wish to attach georelated content from
the leftmost bank of choices and move them to the rightmost column.
4. Submit the Form by clicking `Save Changes`.
## FAQ
What are the post meta keys that your metabox adds?
For every post type selected on the plugin settings page. That type’s add/edit screens
will have an additional metabox automatically added. Metadata that is added to each
record:
* **Location** via `wp_gp_location`
* **Latitude** via `wp_gp_latitude`
* **Longitude** via `wp_gp_longitude`
How do I use WP_GeoQuery? (What is it for?)
Make a geo-aware query against the posts table. `WP_GeoQuery` accepts all arguments
that `WP_Query` takes. `latitude` and `longitude` are optional parameters. If passed,`
distance` is calculated and returned with each result. In addition to the regular
fields, each result returns `latitude`, `longitude`, and `location`.
```
'37.5160', // User's Latitude (optional)
'longitude' => '-77.5005', // User's Longitude (optional)
'posts_per_page' => 25, // Any regular options available via WP_Query
));
foreach($query->posts as $post)
{
echo " {$post->post_title}
\n";
// returned only if latitude and longitude are passed into WP_GeoQuery
echo " {$post->distance}
\n";
// Always returned by WP_GeoQuery
echo " {$post->location}
\n";
echo " {$post->latitude}
\n";
echo " {$post->longitude}
\n";
echo "
\n";
}
?>
```
## Reviews
### [Works great!](https://wordpress.org/support/topic/works-great-3174/)
[nagman](https://profiles.wordpress.org/nagman/) 2016-09-03
Very easy to use, works perfectly with WP 4.5.3. Yet something is missing: in the
admin panel, it would be great to have autocomplete functionality on the input field.
[ Read all 1 review ](https://wordpress.org/support/plugin/wp-geoposts/reviews/)
## Contributors & Developers
“WP GeoPosts” is open source software. The following people have contributed to
this plugin.
Contributors
* [ fyaconiello ](https://profiles.wordpress.org/fyaconiello/)
[Translate “WP GeoPosts” into your language.](https://translate.wordpress.org/projects/wp-plugins/wp-geoposts)
### Interested in development?
[Browse the code](https://plugins.trac.wordpress.org/browser/wp-geoposts/), check
out the [SVN repository](https://plugins.svn.wordpress.org/wp-geoposts/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/wp-geoposts/) by
[RSS](https://plugins.trac.wordpress.org/log/wp-geoposts/?limit=100&mode=stop_on_copy&format=rss).
## Changelog
#### 1.0
* Initial Release
## Meta
* Version **1.0**
* Last updated **14 ел ago**
* Active installations **40+**
* WordPress version ** 3.0 or higher **
* Tested up to **3.4.2**
* Language
* [English (US)](https://wordpress.org/plugins/wp-geoposts/)
* Tags
* [distance](https://tt.wordpress.org/plugins/tags/distance/)[geo](https://tt.wordpress.org/plugins/tags/geo/)
[location](https://tt.wordpress.org/plugins/tags/location/)[metabox](https://tt.wordpress.org/plugins/tags/metabox/)
* [Advanced View](https://tt.wordpress.org/plugins/wp-geoposts/advanced/)
## Ratings
5 out of 5 stars.
* [ 1 5-star review ](https://wordpress.org/support/plugin/wp-geoposts/reviews/?filter=5)
* [ 0 4-star reviews ](https://wordpress.org/support/plugin/wp-geoposts/reviews/?filter=4)
* [ 0 3-star reviews ](https://wordpress.org/support/plugin/wp-geoposts/reviews/?filter=3)
* [ 0 2-star reviews ](https://wordpress.org/support/plugin/wp-geoposts/reviews/?filter=2)
* [ 0 1-star reviews ](https://wordpress.org/support/plugin/wp-geoposts/reviews/?filter=1)
[Your review](https://wordpress.org/support/plugin/wp-geoposts/reviews/#new-post)
[See all reviews](https://wordpress.org/support/plugin/wp-geoposts/reviews/)
## Contributors
* [ fyaconiello ](https://profiles.wordpress.org/fyaconiello/)
## Support
Got something to say? Need help?
[View support forum](https://wordpress.org/support/plugin/wp-geoposts/)
## Donate
Would you like to support the advancement of this plugin?
[ Donate to this plugin ](http://fyaconiello.github.com/wp-geo-posts/)