We belong to a global community of people spread out across the world, yet connected to each other with mobile devices. Many are constantly on the move, bringing their smartphones and tablets along with them. With the geolocation technology present within these mobile devices, there exists the capability to request a user's latitude and longitude information, and utilize that information in multiple ways. With AppGeolocation, we have made it easy to tap into the user's mobile device geolocation information and create or update posts with it.
Creating unique checkins.
If you are building app functionality that relies on a user creating new checkins, AppGeolocation is perfectly capable of accommodating this. You can set the shortcode to create new posts within any post type you want, with the user as the author. On top of that, you can allow the user to set a title and post content with it. You could visualize this similar to how Foursquare acts.
You can get started with recording and posting the necessary information with the following settings
[app-geolocation action="new" post_type="userlocation" post_title="true" post_content="true"]
Note: Substitute your own post_type slug where "userlocation" is shown above.
If you are interested in having moderation for each posting, there is the
post_status shortcode attribute available. It defaults to
publish but would accept any post type status that is natively available to WordPress. Preferably
draft for this moderation example.
Map previews of the current location are available if you set the
map_preview attribute. This will query Google Maps™ for a static image of the provided coordinates.
Updating user's location.
Imagine for a moment that you have a company that has goods that need to be kept track of, but is not always used by the same employee every day. A good example of this could be a fleet of vehicles. If you are keeping information uptodate with a custom post type, AppGeolocation has all the capability to help update that vehicle's location. You can put an instance of the [app-geolocation] shortcode on the single post for each vehicle, and let your employees update from there. Due to the default settings for the shortcode, the only attribute you'd really need to consider is the
force_login boolean attribute. This would make it so employees would need to be logged in, in order to post the geolocation information.
These are just some examples of what could be done with the AppGeolocation extension. Hopefully you can think of more examples as well. For more information on all of the shortcode's attributes, visit the AppGeolocation Extension page.
|force_login||boolean||Whether or not the user must be logged in to use the geolocation features.|| false, true
|action||string|| Whether or not to post to the current post/page or create a new post. Use
|| this, new
|post_type||string||Allows you to specify a post type to post the user's location to. Note: this parameter can only be use when action is "new"|| any post types that are registered.
Note: use the post type slug.
|post_title||boolean||Sets whether to display a "title" field for the form. If set to true, the form will display a "Title" field that you can use to name the created post.|| false, true
|post_content||boolean||Sets whether to display a "post content" field for the form. If set to true, the form will display a "post content" field that you can use to add to the content area.|| false, true
|post_status||string||Sets the post status for the new post.|| draft, publish
|map_preview||boolean||Whether or not to show a map preview for the posting.||false, true Default: false|
Examples:[app-geolocation force_login="true"] [app-geolocation action="new"] [app-geolocation action="new" post_type="user_location"] [app-geolocation post_title="true"] [app-geolocation post_content="true"] [app-geolocation post_status="draft"] [app-geolocation map_preview="true"]
Display a Google map with your checkins as markers
Introduced in AppGeolocation 2.2.0. Once you have collected checkin data either as the checkin custom post type, as a user's meta or as any post type's meta, you can display those as markers on a map. There are several options that lets you customize the map with the following parameters:
[appp-map] [appp-map source="user" zoom="auto"] [appp-map source="checkin"] [appp-map zoom="3" height="600" center_lat="37.4419" center_long="-122.1419"]
|source||string|| This will display the geolocations from the checkin post type, post meta and user meta.
user This will display the geolocations from the user meta.
checkin This will display the geolocations from the checkin post type.
| all, user, checkin
|zoom||string, integer|| 0-20 Any number between 0 - 20.
auto Auto zoom and auto center around your markers. This option cannot be used with center_lat or center_long.
| all, user, checkin
|selector||string||map-container The HTML id parameter like <div id="map-container"></div>||Default: map-container|
|height||string, integer||600 or 600px The number of pixels you want the map to be.||Default: 600|
|center_lat||float||37.4419 The latitude where you want the map centered. If left empty the map will use fitBound to center the map around all of your markers.||Default: 37.4419 (the default can be changed with filter)|
|center_long||float||-122.1419 The longitude where you want the map centered.||Default: 122.1419 (the default can be changed with filter)|
- Custom Map Markers Hook (v2 docs)
Add custom marker map images to your map.
- Custom Default Latitude and Longitude (v2 docs)
Set your own default lat and long coordinates for the appp-map shortcode.
Saves user's latitude and longitude to their user meta.
You must enable this feature in the WP-Admin of your WordPress site in the AppPresser settings under the Geolocation tab. You can customize it with the following parameters:
[app-geotracking] [app-geotracking prompt="5" use_click="false"] [app-geotracking use_click="true"]Click here to begin[/app-geotracking]
|prompt||string||The number of seconds to pause before geotracking begins. This allow users to read any content on the page before they get a prompt from the device to allow access to their location.||Default: 5|
|use_click||string||Requires the user to click a button before geotracking begins.|| true or false
The geotracking will also stop once the app is closed.