Added ability to indicate multiple query string parameter values (for checkboxes) with a comma separated list value, added functionality to select/check filters on load from query string parameter values

Author: bjorn2404

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

@@ -1,4 +1,4 @@
-/*! jQuery Google Maps Store Locator - v2.7.3 - 2017-04-26
+/*! jQuery Google Maps Store Locator - v2.7.3 - 2017-04-30
 * http://www.bjornblog.com/web/jquery-store-locator-plugin
 * Copyright (c) 2017 Bjorn Holine; Licensed MIT */
 
@@ -1750,22 +1750,71 @@
 			}
 		},
 
+        /**
+		 * Select the indicated values from query string parameters.
+		 *
+         * @param taxonomy {string} Current taxonomy.
+         * @param value {array} Query string array values.
+         */
+		selectQueryStringFilters: function( taxonomy, value ) {
+            this.writeDebug('selectQueryStringFilters', arguments);
+
+			var $taxGroupContainer = $('#' + this.settings.taxonomyFilters[taxonomy]);
+
+			// Handle checkboxes.
+			if ( $taxGroupContainer.find('input[type="checkbox"]').length ) {
+
+				for ( var i = 0; i < value.length; i++ ) {
+                    $taxGroupContainer.find('input:checkbox[value=' + value[i] + ']').prop('checked', true);
+				}
+
+            }
+
+            // Handle select fields.
+            if ( $taxGroupContainer.find('select').length ) {
+                // Only expecting one value for select fields.
+				$taxGroupContainer.find('option[value=' + value[0] + ']').prop('selected', true);
+            }
+
+            // Handle radio buttons.
+            if ( $taxGroupContainer.find('input[type="radio"]').length ) {
+				// Only one value for radio button.
+                $taxGroupContainer.find('input:radio[value=' + value[0] + ']').prop('checked', true);
+            }
+		},
+
 		/**
 		 * Check query string parameters for filter values.
 		 */
 		checkQueryStringFilters: function () {
 			this.writeDebug('checkQueryStringFilters',arguments);
+
 			// Loop through the filters.
 			for(var key in filters) {
 				if(filters.hasOwnProperty(key)) {
 					var filterVal = this.getQueryString(key);
 
+					// Check for multiple values separated by comma.
+					if ( filterVal.indexOf( ',' ) !== -1 ) {
+						filterVal = filterVal.split( ',' );
+					}
+
 					// Only add the taxonomy id if it doesn't already exist
 					if (typeof filterVal !== 'undefined' && filterVal !== '' && filters[key].indexOf(filterVal) === -1) {
-						filters[key] = [filterVal];
+						if ( Array.isArray( filterVal ) ) {
+                            filters[key] = filterVal;
+						} else {
+                            filters[key] = [filterVal];
+						}
+					}
+
+					// Select the filters indicated in the query string.
+					if ( filters[key].length ) {
+                        this.selectQueryStringFilters( key, filters[key] );
 					}
 				}
 			}
+
 		},
 
 		/**

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

@@ -37,7 +37,9 @@ filtering.
 
 ### Version 2.7.3
 
+* Added ability to indicate multiple query string parameter values (for checkboxes) with a comma separated list value.
 * Added autoCompleteDisableListener setting to disable the listener that immediately triggers a search when an auto complete location option is selected.
+* Added functionality to select/check filters on load from query string parameter values.
 * Added location details object to callbackListClick and callbackMarkerClick objects.
 * Fixed Handlebars targeting issue triggered by placing an unordered list within the location list template.
 * Updated callbackListClick documentation to include second market object parameter.

readme.md

@@ -1747,22 +1747,71 @@
 			}
 		},
 
+        /**
+		 * Select the indicated values from query string parameters.
+		 *
+         * @param taxonomy {string} Current taxonomy.
+         * @param value {array} Query string array values.
+         */
+		selectQueryStringFilters: function( taxonomy, value ) {
+            this.writeDebug('selectQueryStringFilters', arguments);
+
+			var $taxGroupContainer = $('#' + this.settings.taxonomyFilters[taxonomy]);
+
+			// Handle checkboxes.
+			if ( $taxGroupContainer.find('input[type="checkbox"]').length ) {
+
+				for ( var i = 0; i < value.length; i++ ) {
+                    $taxGroupContainer.find('input:checkbox[value=' + value[i] + ']').prop('checked', true);
+				}
+
+            }
+
+            // Handle select fields.
+            if ( $taxGroupContainer.find('select').length ) {
+                // Only expecting one value for select fields.
+				$taxGroupContainer.find('option[value=' + value[0] + ']').prop('selected', true);
+            }
+
+            // Handle radio buttons.
+            if ( $taxGroupContainer.find('input[type="radio"]').length ) {
+				// Only one value for radio button.
+                $taxGroupContainer.find('input:radio[value=' + value[0] + ']').prop('checked', true);
+            }
+		},
+
 		/**
 		 * Check query string parameters for filter values.
 		 */
 		checkQueryStringFilters: function () {
 			this.writeDebug('checkQueryStringFilters',arguments);
+
 			// Loop through the filters.
 			for(var key in filters) {
 				if(filters.hasOwnProperty(key)) {
 					var filterVal = this.getQueryString(key);
 
+					// Check for multiple values separated by comma.
+					if ( filterVal.indexOf( ',' ) !== -1 ) {
+						filterVal = filterVal.split( ',' );
+					}
+
 					// Only add the taxonomy id if it doesn't already exist
 					if (typeof filterVal !== 'undefined' && filterVal !== '' && filters[key].indexOf(filterVal) === -1) {
-						filters[key] = [filterVal];
+						if ( Array.isArray( filterVal ) ) {
+                            filters[key] = filterVal;
+						} else {
+                            filters[key] = [filterVal];
+						}
+					}
+
+					// Select the filters indicated in the query string.
+					if ( filters[key].length ) {
+                        this.selectQueryStringFilters( key, filters[key] );
 					}
 				}
 			}
+
 		},
 
 		/**