First release.<\/p>"},"ratings":[],"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":3654769,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3654769,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3654769,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":{"groundwork-common-location-finder\/finder":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"groundwork-common-location-finder\/finder","title":"Location Finder","category":"widgets","icon":"location-alt","description":"A searchable map and list of your locations.","textdomain":"groundwork-common-location-finder","keywords":["map","locations","finder","directory"],"attributes":{"showMap":{"type":"boolean","default":true},"height":{"type":"number","default":0},"label":{"type":"string","default":""}},"supports":{"align":["wide","full"],"spacing":{"margin":true,"padding":true},"color":{"text":true,"background":true,"link":true},"typography":{"fontSize":true,"lineHeight":true},"html":false,"multiple":true},"editorScript":"file:.\/edit.js","render":"file:.\/render.php","style":"gwc-lfndr-finder","viewScript":"gwc-lfndr-finder"}},"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3654769,"resolution":"1","location":"assets","locale":"","width":1307,"height":863},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3654769,"resolution":"2","location":"assets","locale":"","width":404,"height":975},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3654769,"resolution":"3","location":"assets","locale":"","width":1307,"height":863},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3654769,"resolution":"4","location":"assets","locale":"","width":1307,"height":863},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3654769,"resolution":"5","location":"assets","locale":"","width":1307,"height":863},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3654769,"resolution":"6","location":"assets","locale":"","width":1307,"height":863}},"screenshots":{"1":"The finder on desktop \u2014 map, filters, and results side by side.","2":"On a phone, with the map above the list.","3":"A location's details, opened in place.","4":"Defining a field: type, label, and where it appears.","5":"Recurring hours \u2014 \"1st and 3rd Tuesday\" without a plugin-specific syntax.","6":"Appearance presets."}},"plugin_section":[],"plugin_tags":[4595,351,2909,16164,6102],"plugin_category":[49],"plugin_contributors":[276508],"plugin_business_model":[],"class_list":["post-350839","plugin","type-plugin","status-publish","hentry","plugin_tags-leaflet","plugin_tags-locations","plugin_tags-map","plugin_tags-openstreetmap","plugin_tags-store-locator","plugin_category-maps-and-location","plugin_contributors-groundworkcommon","plugin_committers-groundworkcommon"],"banners":{"banner":"https:\/\/ps.w.org\/groundwork-common-location-finder\/assets\/banner-772x250.png?rev=3654769","banner_2x":"https:\/\/ps.w.org\/groundwork-common-location-finder\/assets\/banner-1544x500.png?rev=3654769","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/groundwork-common-location-finder\/assets\/icon-256x256.png?rev=3654769","icon_2x":"https:\/\/ps.w.org\/groundwork-common-location-finder\/assets\/icon-256x256.png?rev=3654769","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/groundwork-common-location-finder\/assets\/screenshot-1.png?rev=3654769","caption":"The finder on desktop \u2014 map, filters, and results side by side."},{"src":"https:\/\/ps.w.org\/groundwork-common-location-finder\/assets\/screenshot-2.png?rev=3654769","caption":"On a phone, with the map above the list."},{"src":"https:\/\/ps.w.org\/groundwork-common-location-finder\/assets\/screenshot-3.png?rev=3654769","caption":"A location's details, opened in place."},{"src":"https:\/\/ps.w.org\/groundwork-common-location-finder\/assets\/screenshot-4.png?rev=3654769","caption":"Defining a field: type, label, and where it appears."},{"src":"https:\/\/ps.w.org\/groundwork-common-location-finder\/assets\/screenshot-5.png?rev=3654769","caption":"Recurring hours \u2014 \"1st and 3rd Tuesday\" without a plugin-specific syntax."},{"src":"https:\/\/ps.w.org\/groundwork-common-location-finder\/assets\/screenshot-6.png?rev=3654769","caption":"Appearance presets."}],"raw_content":"\n
Most location finders decide in advance what a location is: a store with a phone number, or a clinic with services. If your locations do not fit that shape, you end up storing \"Wheelchair accessible\" in a field labeled Fax.<\/p>\n\n
This plugin has three built-in fields \u2014 name, latitude, longitude<\/strong> \u2014 and nothing else. Every other field is one you define in wp-admin: its type, its label, whether it shows on the result card or only in the detail pane, whether it is searchable, whether it becomes a filter. A food bank defines Services and Eligibility. A clinic defines Specialties and Languages Spoken. Neither pretends to be the other.<\/p>\n\n Nine simple types \u2014 text, textarea, URL, email, phone, number, yes\/no, select, multi-select \u2014 plus three composites that are genuinely hard to do by hand:<\/p>\n\n A map with pins and a list beside it, on one screen. Type to search; the typeahead suggests location names, cities, and the values of your own choice fields. Filter with chips. Press the crosshair button on the map to sort by distance from where you are \u2014 it is a sort, not a radius, so the nearest location is always shown even when it is 40 miles away. Selecting a location opens its details in place, without a page load.<\/p>\n\n It works without JavaScript, too: the page renders a plain list of locations that search engines can read and JavaScript replaces on boot.<\/p>\n\n The stylesheet ships structure, not opinions. Colors come from If you do want to color it, the Appearance tab has fifteen presets and twenty-five individual settings. Preset colors are all checked to WCAG AA contrast. Settings that override your theme do so with custom properties and no The plugin sets no cookies, adds no tracking, and sends nothing about visitors to your server or anyone else's. Location data stays in your database. The locate button reads the browser's geolocation only after the visitor presses it, and the coordinates are used in the browser and never transmitted.<\/p>\n\n By default the map does not load until the visitor asks for it \u2014 see Ask before loading the map<\/em> below. When they do, the choice is remembered in See External services<\/em> below for what does leave the site.<\/p>\n\n This plugin relies on external services. Both are optional in the sense that they can be pointed elsewhere, but the defaults contact third parties, so here is exactly what is sent and when.<\/p>\n\n 1. Map tiles \u2014 OpenStreetMap or CARTO<\/strong><\/p>\n\n The map is drawn from tile images fetched by the visitor's browser<\/strong>, directly from the tile provider. That means the provider receives the visitor's IP address, user agent, and the map area being viewed. No other data is sent.<\/p>\n\n Because the request comes from the visitor rather than from your server, nothing server-side can prevent it once a map is on screen. So the plugin does not load tiles until the visitor asks it to.<\/strong> The map area shows a placeholder naming the provider and a Show map<\/em> button, and no request reaches the provider until that button is pressed. The search, filters, location list and detail pane all work regardless \u2014 a visitor who never loads the map still gets a working finder.<\/p>\n\n This is on by default and can be turned off under Locations \u2192 Settings \u2192 Behavior (Ask before loading the map<\/em>). It is skipped automatically when the tiles come from your own site, since there is no third party to ask about.<\/p>\n\n Which provider depends on the Map style setting under Locations \u2192 Settings \u2192 Appearance:<\/p>\n\n Attribution is a license condition, not decoration. The plugin prints the provider's required attribution on the map and it must not be removed.<\/p>\n\n 2. Address lookup \u2014 Nominatim (OpenStreetMap)<\/strong><\/p>\n\n Used only in wp-admin<\/strong>, and only when a logged-in editor types into the address field of a location and asks for suggestions. The address text typed into that box is sent to Nominatim's usage policy requires an identifying contact address in the request, so the plugin sends the site URL and the contact email from Locations \u2192 Settings \u2192 Advanced (your admin email, by default). Requests are throttled to one per second per user.<\/p>\n\n Terms: OSMF Nominatim usage policy<\/a>\nPrivacy: OSMF privacy policy<\/a><\/p>\n\n Not a service call:<\/strong> the Get directions<\/em> link points at Google Maps or Apple Maps. It is an ordinary link \u2014 nothing is sent until a visitor clicks it, and then it is their browser making the request, not your site.<\/p>\n\n This plugin is built and maintained by Groundwork Common, a technology practice for nonprofits: fractional technology leadership, project work, and training for organizations that need senior help and cannot carry a full-time technologist.<\/p>\n\n One of our working principles is that good technology work should leave an organization more capable, not more dependent on whoever did it. Releasing this plugin is that principle applied. A food bank or a clinic should be able to put its locations on a map without commissioning custom work or renting something this ordinary by the month.<\/p>\n\n If you find this plugin useful, three things genuinely help:<\/p>\n\nField types<\/h4>\n\n
\n
What visitors get<\/h4>\n\n
Theming<\/h4>\n\n
currentColor<\/code> and the CSS system colors, so the finder inherits your theme's palette, follows dark mode, and survives Windows High Contrast without configuration.<\/p>\n\n!important<\/code>, so a theme that deliberately styles the finder still wins.<\/p>\n\nPrivacy<\/h4>\n\n
sessionStorage<\/code> for that browsing session only. That is the one thing the plugin stores in a visitor's browser: a single flag, never sent anywhere, gone when the tab closes.<\/p>\n\nExternal services<\/h3>\n\n
\n
https:\/\/tile.openstreetmap.org<\/code>\nTerms: OSMF tile usage policy<\/a>\nPrivacy: OSMF privacy policy<\/a><\/li>\nhttps:\/\/basemaps.cartocdn.com<\/code> (CARTO)\nTerms: CARTO legal<\/a>\nPrivacy: CARTO privacy policy<\/a>\nNote: CARTO's free basemap tier is for non-commercial use. Commercial sites should use OpenStreetMap, or set a Custom tile URL for a provider they have an account with. The settings screen states this next to those three styles and again whenever one of them is the active choice.<\/li>\nhttps:\/\/nominatim.openstreetmap.org\/search<\/code> from your server, and the matching addresses and coordinates come back. Visitors never trigger it, and no visitor data is involved.<\/p>\n\nAbout Groundwork Common<\/h3>\n\n
\n