Docs Archive - Location Picker & Google Address Autofill Plugin for WooCommerce https://lpacwp.com/docs/ Hassle free deliveries and pickups Fri, 05 Sep 2025 13:34:34 +0000 en-US hourly 1 https://wordpress.org/?v=6.9.4 https://lpacwp.com/wp-content/uploads/2023/03/Kikote-Profile-V6-256-x-256-150x150.png Docs Archive - Location Picker & Google Address Autofill Plugin for WooCommerce https://lpacwp.com/docs/ 32 32 Available meta keys in Kikote https://lpacwp.com/docs/how-to-access-meta-keys-inside-kikote/ https://lpacwp.com/docs/how-to-access-meta-keys-inside-kikote/#respond Fri, 25 Jul 2025 20:20:07 +0000 https://lpacwp.com/?post_type=docs&p=4167 Kikote stores useful location-related data as meta keys on each WooCommerce order. These meta keys are saved as custom fields and can be accessed for integrations, custom workflows, or simply viewing order details. To view the public meta keys used […]

The post Available meta keys in Kikote appeared first on Location Picker & Google Address Autofill Plugin for WooCommerce.

]]>
Kikote stores useful location-related data as meta keys on each WooCommerce order. These meta keys are saved as custom fields and can be accessed for integrations, custom workflows, or simply viewing order details.

To view the public meta keys used by Kikote, go to your WordPress admin dashboard and head to WooCommerce > Orders. Click on any order to open the Order Edit screen. On this page, scroll down until you see the Custom Fields section. This is where Kikote saves key data related to the customer’s selected address at checkout. The following explains what information each meta key holds from the screenshots below.

  • lpac_customer_region represents the region chosen the customer on Google Maps. As shown above, the value is region_1_5676, meaning
  • lpac_customer_distance represents the calculated distance between the customer’s selected location and the store’s location. In this case, the value is 3.92, meaning the customer is approximately 3.92 kilometers away from the store.
  • lpac_customer_distance_duration stores the estimated travel time between the store and the customer’s location. Here, the value is 8 mins, indicating it would take about 8 minutes to reach the customer based on the calculated route.
  • lpac_customer_distance_unit defines the unit of measurement used for the distance. In this case, the value is km, meaning distances are being calculated and displayed in kilometers.
  • lpac_latitude holds the latitude coordinate of the customer’s chosen delivery or pickup location. The value 14.0487871 means the customer’s selected point is located at a latitude of approximately 14.05° N.
  • lpac_longitude stores the longitude coordinate of the customer’s selected location. The value -60.9283219 means the location lies at approximately 60.91° W longitude.

The list of meta keys that are above are not extensive and there may be more meta keys added to Kikote in the future. All currently available public meta keys can always be viewed in the Custom Fields area, ensuring you have quick access to the data whenever needed.

The post Available meta keys in Kikote appeared first on Location Picker & Google Address Autofill Plugin for WooCommerce.

]]>
https://lpacwp.com/docs/how-to-access-meta-keys-inside-kikote/feed/ 0
Change “Please select your location manually…” text https://lpacwp.com/docs/change-please-select-your-location-manually-text/ https://lpacwp.com/docs/change-please-select-your-location-manually-text/#respond Tue, 04 Feb 2025 16:16:34 +0000 https://lpacwp.com/?post_type=docs&p=4149 The “Please select your location manually by clicking on the map then moving the marker to your desired location.” text shows when the user/customer has denied your website access to their location or something about their browser is preventing the […]

The post Change “Please select your location manually…” text appeared first on Location Picker & Google Address Autofill Plugin for WooCommerce.

]]>
The “Please select your location manually by clicking on the map then moving the marker to your desired location.” text shows when the user/customer has denied your website access to their location or something about their browser is preventing the website from getting their location.

In those cases the message would show. A user would have to manually reset location permissions for their browser to rid this message and get your website to prompt them for permission to detect location again.

Unfortunately this is just how browsers work.

Here’s how to reset location services for Google Chrome: https://support.google.com/chrome/answer/142065?hl=en&co=GENIE.Platform%3DAndroid

Here’s how for iOS Safari: https://www.lebow.drexel.edu/about/support-services/knowledge-base/how-allow-location-permission-iphone

To change the actual message shown to the user when the website can’t detect their location, you can use the snippet below:

PHP
function sl_cc_edit_manual_location_selection_text($strings){

$strings['manually_select_location'] = 'ADD YOUR CUSTOM MESSAGE HERE';

return $strings;

}
add_filter('kikote_frontend_translated_strings', 'sl_cc_edit_manual_location_selection_text');

The post Change “Please select your location manually…” text appeared first on Location Picker & Google Address Autofill Plugin for WooCommerce.

]]>
https://lpacwp.com/docs/change-please-select-your-location-manually-text/feed/ 0
Ignore shipping price when using Shipping Restrictions feature for Cost by Region https://lpacwp.com/docs/ignore-shipping-price-when-using-shipping-restrictions-feature-for-cost-by-region/ https://lpacwp.com/docs/ignore-shipping-price-when-using-shipping-restrictions-feature-for-cost-by-region/#respond Tue, 04 Feb 2025 15:44:16 +0000 https://lpacwp.com/?post_type=docs&p=4144 By default the plugin checks the order total when validating the Shipping Restrictions feature of Cost by Region. This includes the shipping cost for the order. To ignore the shipping or create more dynamic calculations you can use the filter […]

The post Ignore shipping price when using Shipping Restrictions feature for Cost by Region appeared first on Location Picker & Google Address Autofill Plugin for WooCommerce.

]]>
By default the plugin checks the order total when validating the Shipping Restrictions feature of Cost by Region. This includes the shipping cost for the order.

To ignore the shipping or create more dynamic calculations you can use the filter lpac_region_restrictions_order_total_value.

In the snippet below we will only take into account the cart subtotal when validating the shipping restrictions:

PHP
function sl_cc_region_restrictions_use_subtotal($order_total, $wc_instance){

return $wc_instance->cart->get_subtotal();

}
add_filter('lpac_region_restrictions_order_total_value', 'sl_cc_region_restrictions_use_subtotal', 10, 2);

The post Ignore shipping price when using Shipping Restrictions feature for Cost by Region appeared first on Location Picker & Google Address Autofill Plugin for WooCommerce.

]]>
https://lpacwp.com/docs/ignore-shipping-price-when-using-shipping-restrictions-feature-for-cost-by-region/feed/ 0
Change “Delivery Location” text in order email https://lpacwp.com/docs/change-delivery-location-text-in-order-email/ https://lpacwp.com/docs/change-delivery-location-text-in-order-email/#respond Mon, 24 Jun 2024 16:32:48 +0000 https://lpacwp.com/?post_type=docs&p=4055 If you would like to change the “Delivery Location” text that shows in the emails that customers receive; you can use the following filter:

The post Change “Delivery Location” text in order email appeared first on Location Picker & Google Address Autofill Plugin for WooCommerce.

]]>

If you would like to change the “Delivery Location” text that shows in the emails that customers receive; you can use the following filter:

PHP
function sl_cc_change_email_delivery_location_text($text){
return "Pickup Location";
}
add_filter('lpac_email_map_location_link_button_text', 'sl_cc_change_email_delivery_location_text');

The post Change “Delivery Location” text in order email appeared first on Location Picker & Google Address Autofill Plugin for WooCommerce.

]]>
https://lpacwp.com/docs/change-delivery-location-text-in-order-email/feed/ 0
Switching to Classic Checkout https://lpacwp.com/docs/switching-to-classic-checkout/ https://lpacwp.com/docs/switching-to-classic-checkout/#respond Sun, 17 Mar 2024 16:11:11 +0000 https://lpacwp.com/?post_type=docs&p=3990 WooCommerce Blocks Checkout is not compatible with Kikote in it’s current form. The WooCommerce Blocks Checkout page is a totally new way of doing things in WooCommerce, and all plugins that previously worked fine are suddenly rendered unusable with this […]

The post Switching to Classic Checkout appeared first on Location Picker & Google Address Autofill Plugin for WooCommerce.

]]>
WooCommerce Blocks Checkout is not compatible with Kikote in it’s current form. The WooCommerce Blocks Checkout page is a totally new way of doing things in WooCommerce, and all plugins that previously worked fine are suddenly rendered unusable with this change. We are working to update the plugin to support the Blocks Checkout in the future but until then you would need to switch to classic checkout to be able to use the plugin.

New WooCommerce stores or stores that recreate their WooCommerce pages will automatically have the Blocks Checkout enabled. Please follow these few simple steps to get the plugin to show on your checkout page:

Step 1

Go to your Pages area in your WordPress dashboard and locate your WooCommerce checkout page and click Edit

Step 2

Click on any of the blocks on the page and then from the right pane click on the Switch to classic checkout button:

Step 3

Confirm the switch and save your changes.

Once done you will be able to continue using the plugin fine.

Rest assured that when the plugin is compatible with the WooCommerce Blocks Checkout it will be announced via the plugin’s changelog.

Note

At this point the checkout should show up as normal and you should see the plugin’s options. If you’d like to go further, you can completely remove the Checkout block and instead add a shortcode element in the editor with the shortcode [woocommerce_checkout]

This will give you the same result but your checkout page width might be better (wider) than simply clicking the switch to classic button.

The post Switching to Classic Checkout appeared first on Location Picker & Google Address Autofill Plugin for WooCommerce.

]]>
https://lpacwp.com/docs/switching-to-classic-checkout/feed/ 0
Change shipping label shown for Cost By Distance Range https://lpacwp.com/docs/change-shipping-label-shown-for-cost-by-distance-range/ https://lpacwp.com/docs/change-shipping-label-shown-for-cost-by-distance-range/#respond Wed, 07 Feb 2024 19:39:26 +0000 https://lpacwp.com/?post_type=docs&p=3940 The snippet below shows how you’d go about changing the label for your shipping method(s) based on the range that the customer falls in. PLEASE NOTE; You need to enable the “Display Cost & Unit in Shipping Label” option so […]

The post Change shipping label shown for Cost By Distance Range appeared first on Location Picker & Google Address Autofill Plugin for WooCommerce.

]]>
The snippet below shows how you’d go about changing the label for your shipping method(s) based on the range that the customer falls in. PLEASE NOTE; You need to enable the “Display Cost & Unit in Shipping Label” option so to better get this snippet to work. The snippet searches for the range inside the shipping method title which would be present if the option is enabled:

PHP
function sl_cc_change_shipping_range_method_label($rates, $package){

	foreach( $rates as $rate ){
				
		// Ranges and their label.
		$mappings = [
			'0-2.6' => 'Express Delivery (15-30min)',
			'2.6-12' => 'Express Delivery (20-40min)',
			'12-15' => 'Express Delivery (25-50min)',
			'15-20' => 'Express Delivery (30-60min)',
			'20-30' => 'Next Day Delivery with XYZ Courier',
// 			'>= 30' => 'Example label for entry with no end range'
		];
		
		$label = $rate->label;
		
		foreach( $mappings as $range => $preferred_label ){
			
			if( strpos($label, $range) !== false){
				$rate->label = $preferred_label;	
			}
			
		}

	}
	return $rates;
}
add_filter('woocommerce_package_rates', 'sl_cc_change_shipping_method_label', 200, 2);

The post Change shipping label shown for Cost By Distance Range appeared first on Location Picker & Google Address Autofill Plugin for WooCommerce.

]]>
https://lpacwp.com/docs/change-shipping-label-shown-for-cost-by-distance-range/feed/ 0
Dissect street address only in saved order (not on checkout page) https://lpacwp.com/docs/dissect-address-only-when-saving-order/ https://lpacwp.com/docs/dissect-address-only-when-saving-order/#respond Tue, 19 Dec 2023 15:17:56 +0000 https://lpacwp.com/?post_type=docs&p=3911 In cases where you need the full address returned by Google for some logic on your checkout page, but do not want the address to look duplicated in your saved orders, then you might want to Dissect the customer’s address […]

The post Dissect street address only in saved order (not on checkout page) appeared first on Location Picker & Google Address Autofill Plugin for WooCommerce.

]]>
In cases where you need the full address returned by Google for some logic on your checkout page, but do not want the address to look duplicated in your saved orders, then you might want to Dissect the customer’s address after they click the place order button.

The below snippet should be sufficient to achieve this.

PHP
function sl_cc_adjust_customer_addresses($data){
	$data['billing_address_1'] = explode(',', $data['billing_address_1'])[0];
	$data['shipping_address_1'] = explode(',', $data['shipping_address_1'])[0];
	return $data;
}
add_filter('woocommerce_checkout_posted_data', 'sl_cc_adjust_customer_addresses');

NOTE: The following snippet assumes that you have the “Remove Plus Code From Address” option turned On. Also, the logic is simple, we’re breaking up the address returned by Google and taking the first part of it which is usually the street address.

There are cases that might not be true, so you would have to change the snippet to handle this if you live in a country where Google doesn’t return the street address as the first part of an address.

The post Dissect street address only in saved order (not on checkout page) appeared first on Location Picker & Google Address Autofill Plugin for WooCommerce.

]]>
https://lpacwp.com/docs/dissect-address-only-when-saving-order/feed/ 0
Location services not working in webView App https://lpacwp.com/docs/location-services-not-working-in-webview-app/ https://lpacwp.com/docs/location-services-not-working-in-webview-app/#respond Mon, 18 Dec 2023 15:50:47 +0000 https://lpacwp.com/?post_type=docs&p=3904 If you’re building an mobile app version of your website that makes use of Web View and you realize that the map is not working, then the reason might be some missing configuration inside the mobile app. You should contact […]

The post Location services not working in webView App appeared first on Location Picker & Google Address Autofill Plugin for WooCommerce.

]]>
If you’re building an mobile app version of your website that makes use of Web View and you realize that the map is not working, then the reason might be some missing configuration inside the mobile app.

You should contact your Mobile App Developer and let them know that the app needs to pass on location service requests to the OS.

On iPhone this might be a more involved process. You can share the following comment from a stackoverflow question with the Developer:

If you are about to load your website inside an app using webView, make sure to add location permission descriptions to the info.plist file. Add NSLocationWhenInUseUsageDescription versus NSLocationAlwaysUsageDescription versus NSLocationUsageDescription as your needs.

For the sake of completeness, on iOS13, you can not get always permission. But this is not the point here and the point is you have to get the required permissions sometime before you need to get the location from GPS or it is not going to work at all.

Location services for Google Maps does work inside webView apps. The App Developer just needs to add the required configuration to make it possible, as these configurations are not something that needs/can be done on the side of the map on the website itself.

Some resources that might help:

https://stackoverflow.com/questions/57130901/getcurrentposition-in-js-does-not-work-on-ios

https://xabaras.medium.com/android-webview-handling-geolocation-permission-request-cc482f3de210

The post Location services not working in webView App appeared first on Location Picker & Google Address Autofill Plugin for WooCommerce.

]]>
https://lpacwp.com/docs/location-services-not-working-in-webview-app/feed/ 0
How to Add Custom Checkout Page Notice https://lpacwp.com/docs/how-to-add-custom-checkout-page-notice/ https://lpacwp.com/docs/how-to-add-custom-checkout-page-notice/#respond Thu, 12 Oct 2023 10:32:50 +0000 https://lpacwp.com/?post_type=docs&p=3819 You might want to provide your customers with a bit more details about how to checkout on your website. It’s possible to add a custom checkout notice to inform customers of how to go about placing an order. The following […]

The post How to Add Custom Checkout Page Notice appeared first on Location Picker & Google Address Autofill Plugin for WooCommerce.

]]>
You might want to provide your customers with a bit more details about how to checkout on your website. It’s possible to add a custom checkout notice to inform customers of how to go about placing an order.

The following snippet does just that, simply change out the part of the snippet where it says: *REPLACE WITH YOUR DESIRED TEXT* with the text you’d like displayed on the checkout page.

PHP
add_action( 'woocommerce_before_checkout_form', 'sl_cc_checkout_notice_1', 10 );
function sl_cc_checkout_notice_1() {
    wc_print_notice( sprintf(
        __("%s *REPLACE WITH YOUR DESIRED TEXT*", "woocommerce"),
        '<strong>' . __("Order Instructions:", "woocommerce") . '</strong>',
    ), 'success' );
}

The post How to Add Custom Checkout Page Notice appeared first on Location Picker & Google Address Autofill Plugin for WooCommerce.

]]>
https://lpacwp.com/docs/how-to-add-custom-checkout-page-notice/feed/ 0
Adjust shipping price based on cart subtotal https://lpacwp.com/docs/adjust-shipping-price-based-on-cart-subtotal/ https://lpacwp.com/docs/adjust-shipping-price-based-on-cart-subtotal/#respond Wed, 09 Aug 2023 18:36:47 +0000 https://lpacwp.com/?post_type=docs&p=3751 It’s possible to adjust the shipping price set by Kikote based on the customer’s cart total with the help of some code. The below example is for the Cost by Distance Range feature. In the code above, if the customer […]

The post Adjust shipping price based on cart subtotal appeared first on Location Picker & Google Address Autofill Plugin for WooCommerce.

]]>
It’s possible to adjust the shipping price set by Kikote based on the customer’s cart total with the help of some code. The below example is for the Cost by Distance Range feature.

PHP
function sl_cc_adjust_distance_range_shipping_cost($shipping_cost, $package, $wc_instance, $range_data){
 
$start_range = (int) $range_data['start_range'];
$end_range = (int) $range_data['end_range'];
$distance = $range_data['distance'];
$cart = $wc_instance->cart->get_subtotal();
    
    if($start_range === 60 && $end_range === 100 && $cart > 2000){
        return $distance * 1.5;
    }
 
    return $shipping_cost;
}
add_filter('kikote_distance_range_shipping_cost', 'sl_cc_adjust_distance_range_shipping_cost', 10, 4);

In the code above, if the customer is between the ranges of 60 and 100, and their cart subtotal is more than $2000, then the rate at which their shipping price will be calculated is $1.50 per unit distance.

It’s possible to do this for all Shipping workflows using the appropriate filter.

  • Cost by Region – kikote_region_shipping_cost (params: $region_cost, $customer_detected_region_costs, $wc_instance)
  • Cost by Distance Standard – kikote_distance_shipping_cost (params: $shipping_cost, $package, $wc_instance, $distance_data)
  • Cost by Distance Range – kikote_distance_range_shipping_cost (params: $shipping_cost, $package, $wc_instance, $distance_range_data)
  • Cost by Store Distance – kikote_store_distance_shipping_cost (params: $shipping_cost, $package, $wc_instance, $store_distance_data)
  • Cost by Store Location – kikote_store_shipping_cost (params: $store_shipping_cost, $currently_selected_store_details, $wc_instance)

The post Adjust shipping price based on cart subtotal appeared first on Location Picker & Google Address Autofill Plugin for WooCommerce.

]]>
https://lpacwp.com/docs/adjust-shipping-price-based-on-cart-subtotal/feed/ 0