Added callbackFormVals callback so form values can be utilized

Author: bjorn2404

callbacks.md

@@ -31,6 +31,7 @@ $('#bh-sl-map-container').storeLocator({
 |---|---|
 | [callbackNotify](callbacks/callback-notification.md) | Notification callback |
 | [callbackRegion](callbacks/callback-region.md) | Region callback |
+| [callbackRegion](callbacks/callback-formvals.md) | Form Values callback |
 | [callbackBeforeSend](callbacks/callback-beforesend.md) | Before location data request callback |
 | [callbackDirectionsRequest](callbacks/callback-directionsrequest.md) | Directions request callback |
 | [callbackCloseDirections](callbacks/callback-closedirections.md) | Close directions callback |
@@ -45,4 +46,4 @@ $('#bh-sl-map-container').storeLocator({
 | [callbackMarkerClick](callbacks/callback-markerclick.md) | Marker click callback |
 | [callbackListClick](callbacks/callback-listclick.md) | Location list click callback |
 | [callbackPageChange](callbacks/callback-pagechange.md) | Page change callback |
-| [callbackFilters](callbacks/callback-filters.md) | Filters callback |
+| [callbackFilters](callbacks/callback-filters.md) | Filters callback |

callbacks/callback-formvals.md

@@ -0,0 +1,15 @@
+# callbackFormVals
+
+## Description
+
+Fires after the form values have been processed from the form. If you are planning on sending these values to a database
+make sure to sanitize the values first.
+
+## Parameters
+
+| Name | Type | Description |
+|---|---|---|
+| addressInput | string | User address input |
+| searchInput | string | User name search input when using nameSearch setting |
+| distance | string | User distance selection when using maxDistance setting |
+| region | string | User region selection when using regionID setting or callbackRegion callback |

dist/assets/js/plugins/storeLocator/jquery.storelocator.js

@@ -1,4 +1,4 @@
-/*! jQuery Google Maps Store Locator - v2.7.5 - 2017-11-05
+/*! jQuery Google Maps Store Locator - v2.7.5 - 2017-11-28
 * http://www.bjornblog.com/web/jquery-store-locator-plugin
 * Copyright (c) 2017 Bjorn Holine; Licensed MIT */
 
@@ -26,8 +26,8 @@
 		'addressID'                  : 'bh-sl-address',
 		'regionID'                   : 'bh-sl-region',
 		'mapSettings'                : {
-			mapTypeId      : google.maps.MapTypeId.ROADMAP,
-			zoom           : 12
+			mapTypeId: google.maps.MapTypeId.ROADMAP,
+			zoom     : 12
 		},
 		'markerImg'                  : null,
 		'markerDim'                  : null,
@@ -97,6 +97,7 @@
 		// Callbacks
 		'callbackNotify'             : null,
 		'callbackRegion'             : null,
+		'callbackFormVals'           : null,
 		'callbackBeforeSend'         : null,
 		'callbackSuccess'            : null,
 		'callbackModalOpen'          : null,
@@ -650,22 +651,22 @@
 						this.mapping(null);
 					}
 				}
+			}
 
-				// HTML5 auto geolocation API option
-				if (this.settings.autoGeocode === true && doAutoGeo === true) {
-					_this.writeDebug('Auto Geo');
+			// HTML5 auto geolocation API option
+			if (this.settings.autoGeocode === true && doAutoGeo === true) {
+				_this.writeDebug('Auto Geo');
 
-					_this.htmlGeocode();
-				}
+				_this.htmlGeocode();
+			}
 
-				// HTML5 geolocation API button option
-				if (this.settings.autoGeocode !== null) {
-					_this.writeDebug('Button Geo');
+			// HTML5 geolocation API button option
+			if (this.settings.autoGeocode !== null) {
+				_this.writeDebug('Button Geo');
 
-					$(document).on('click.'+pluginName, '#' + this.settings.geocodeID, function () {
-						_this.htmlGeocode();
-					});
-				}
+				$(document).on('click.'+pluginName, '#' + this.settings.geocodeID, function () {
+					_this.htmlGeocode();
+				});
 			}
 		},
 
@@ -1573,6 +1574,11 @@
 				region = $('#' + this.settings.regionID).val();
 			}
 
+			// Form values callback
+			if (this.settings.callbackFormVals) {
+				this.settings.callbackFormVals.call(this, addressInput, searchInput, distance, region);
+			}
+
 			if (addressInput === '' && searchInput === '') {
 				this._start();
 			}

dist/assets/js/plugins/storeLocator/jquery.storelocator.min.js

@@ -37,6 +37,7 @@ filtering.
 
 ### Version 2.7.5
 
+* Added callbackFormVals callback so form values can be utilized.
 * Fixed issue where HTML5 Geolocation was skipped when using the fullMapStartBlank setting.
 
 ### Version 2.7.4

readme.md

@@ -23,8 +23,8 @@
 		'addressID'                  : 'bh-sl-address',
 		'regionID'                   : 'bh-sl-region',
 		'mapSettings'                : {
-			mapTypeId      : google.maps.MapTypeId.ROADMAP,
-			zoom           : 12
+			mapTypeId: google.maps.MapTypeId.ROADMAP,
+			zoom     : 12
 		},
 		'markerImg'                  : null,
 		'markerDim'                  : null,
@@ -94,6 +94,7 @@
 		// Callbacks
 		'callbackNotify'             : null,
 		'callbackRegion'             : null,
+		'callbackFormVals'           : null,
 		'callbackBeforeSend'         : null,
 		'callbackSuccess'            : null,
 		'callbackModalOpen'          : null,
@@ -1570,6 +1571,11 @@
 				region = $('#' + this.settings.regionID).val();
 			}
 
+			// Form values callback
+			if (this.settings.callbackFormVals) {
+				this.settings.callbackFormVals.call(this, addressInput, searchInput, distance, region);
+			}
+
 			if (addressInput === '' && searchInput === '') {
 				this._start();
 			}