AppGeolocation Setup

How to install App-Geolocation

Download the plugin .zip file from your account page, then upload in your WordPress admin under Plugins => Add New => Upload.  Do not unzip the file.

If you would prefer SSH/FTP, extract the contents of the zip file and upload the contents to your wp-content/plugins/ directory on your server.

Configuring App-Geolocation

Once you have activated the App-Geolocation extension, a new tab will show up in the AppPresser settings page for it. In your WordPress admin, click on the AppPresser icon in your admin menu, then click the Geolocation tab.

Create a Google Map API key

Settings

Show map on posts with geolocation data

Check this setting if you want to display a Google Map ™ on posts that have collected and saved geolocation data. If checked, the map will be appended to the post's post content and use geolocation data saved to the post meta.

Save user geolocation data 

Check this setting if you wish to save user-provided geolocation data to the current user's user meta. The geolocation of the user's current location at the time of AppPresser app use. 

Frequency to save a user's geolocation data 

Set how often the user's geolocation should be updated, in various available time intervals.

Once you are happy with the settings, click the "Save Settings" button.

Using App Geolocation

After you configure your API key, you can now use the various App Geolocation shortcodes and features. The [app-geolocation] and [checkin] shortcodes perform different functions, please see usage information below.

Checkins

The checkin feature adds a checkin modal with a map and pin point(s) of the user's current location. There is a toolbar icon added to the top right to open the modal and there is also a new [checkin] shortcode for for checking into places. There are three options for check ins. All checkin options requires a user to be logged in.

1. Places search (adds multiple pins of a Places business near user)
2. Address checkin (displays one pin at the specified address)
3. Checks user into location (saves users latitude and longitude)

Checkin Shortcode

Example:

To search for nearby business located in Google places omit the address parameter.

[checkin class="checkin-button" button_text="Checkin Here" place="Starbucks"]
			

To drop a pin at a specific address include the address parameter.

[checkin class="checkin-button" button_text="Checkin Here" place="Workplace" address="123 main street colorado"]
			

• class - adds a custom class to the button for styling.
• button_text - the text displayed in the button (default: Check In)
• place - Google places search adds pins if places found
• address - the address to drop a pin, checks user into this address

The address parameter will override the place parameter and drop a pin at the address supplied. Omit the address parameter and Places will search for locations close to the users location. A user can click a pin and then check into that place.

If you want to have the user checked into a specific address omit the place parameter.

App-Geolocation Hooks

$user_id
				

$appp_atts<p><code>$appp_atts
				

$post_id
				

get_option( 'active_plugins' )
				

'<label>' . __( 'Title:', 'apppresser-geolocation' ) . '</label>'
				

'<label>' . __( 'Content:', 'apppresser-geolocation' ) . '</label>'
				

Checkin Hooks

There are two hooks during the creation of the checkin.

apply_filters( 'appgeo_checkin_post_filter', $checkin );
apply_filters( 'appgeo_checkin_meta_filter', $checkin_meta );
			

appgeo_checkin_post_filter is to filter the checkin cpt and appgeo_checkin_meta_filter is used to filter the checkin meta ( location data ).

Example:

appgeo_checkin_post_filter

function my_filter_checkin( $checkin ) {

    $checkin['post_title'] = 'custom title checking';

    return $checkin;

}
add_filter( 'appgeo_checkin_post_filter', 'my_filter_checkin' );
			

appgeo_checkin_meta_filter

function my_meta_filter_checkin( $checkin_meta ) {

    $checkin_meta['place'] = 'Starbucks - the one on the moon';

    return $checkin_meta;

}
add_filter( 'appgeo_checkin_meta_filter', 'my_meta_filter_checkin' );
			

Using Checkin Data

Now that users are adding checkins with location meta you can use this data. All checkins are a custom post type (checkin).

get_posts( array( 'author' => $user_id, 'post_type' => 'checkin') );
			

The location data is post meta. Post meta keys:

get_post_meta( $post_id, 'latitude' )
			

• latitude
• longitude
• place
• address

Default GPS Position Hook

In version 2.1.0, a default position was added in case the GPS has been disable from a user's device.  You can use a hook to either set the default position or disable it completely.

Type: Filter | File: AppPresser_GeoLocation_Modal.php | Since: 2.1.0 Located in: /plugins/appgeo/inc/AppPresser_GeoLocation_Modal.php

Set your own position

function my_default_gps_position() {
	return array( 'latitude' => '46.8533701', 'longitude' => '-55.8090062' );
}
add_filter( 'appgeo_default_position', 'my_default_gps_position' );
			

Disable default position

function disable_default_gps_position() {
	return true;
}
add_filter( 'appgeo_default_position', 'disable_default_gps_position' );
			

appgeo_map_images

If you would like to customize the marker images using with the [appp-map] shortcode you can create a directory on your site with replacement images.

To use the appgeo_map_images filter:

1. Create a directory somewhere on your site such as in your theme folder or you wp-content/uploads folder
2. Copy the images from the /wp-content/plugins/appgeo/images/ folder to your own folder
3. Edit the files you copied with your photo editor
4. Add the appgeo_map_images filter to your directory
5. create a function that return a string of the URL path to your marker images
6. You will want to add this function to the mu-plugins folder so it works regardless which theme you are using. If your WordPress install doesn't have a mu-plugins directory create one inside the wp-content directory. You can just create a new file named my-appgeo-map-images.php and paste the code below into it.

<?php

// /wp-content/mu-plugins/my-appgeo-map-images.php

/**
 * Used with the appp-map shortcode.
 * This will return the URL to my custom map markers
 * 
 * @return string A url such as: http://mysite.com/wp-content/uploads/my-custom-markers
 */
function my_appgeo_map_images( $url_path ) {

	$my_folder_name = 'my-custom-markers';

	$uploads = wp_upload_dir();

	return $uploads['baseurl'] . '/' . $my_folder_name . '/m';
}

add_filter( 'appgeo_map_images', 'my_appgeo_map_images' );
			

appgeo_map_images

If would like use overwrite the default center_lat and center_long used with the appp-map shortcode you can use the appgeo_map_coord filter

1. Create a function that return an array of the lat and longs
2. You will want to add this function to the mu-plugins folder so it works regardless which theme you are using. If your WordPress install doesn't have a mu-plugins directory create one inside the wp-content directory. You can just create a new file named my-appgeo-map-coord.php and paste the code below into it.

<?php

/**
 * This will return my default lat and long to use
 * will all of my appp-map shortcode maps
 * 
 * @return array
 */
function my_appgeo_map_coord() {

	$my_default_lat = '48.1282706';
	$my_default_long = '-55.3150867';

	return array( 'latitude' => $my_default_lat, 'longitude' => $my_default_long );
}

add_filter( 'appgeo_map_coord', 'my_appgeo_map_coord' );