Description
Beverage Finder helps breweries, wineries, distilleries, and beverage distributors show customers which retailers carry their products.
Features
- Interactive Google Map with a sortable list of nearby locations
- CSV import (works with Encompass sales reports or the included template)
- Edit any location in the admin: name, address, products, and coordinates
- Download all of your locations as a CSV
- Brand/product filter
- Visitor location via the browser’s built-in geolocation (no API needed)
- Custom map pin
- Location expiration based on last delivery date
- Unlimited locations
- Responsive and mobile friendly
How it works
Import a CSV that includes latitude and longitude for each location. Locations appear on the map immediately. Re-importing updates delivery dates and coordinates for existing retailer/brand combinations instead of creating duplicates.
Need coordinates for a large address list? You can look them up yourself on Google Maps, use any geocoding tool you like, or use the separate hosted service at beveragefinder.net, which exports a CSV you can import here. The plugin works fully without it and does not connect to it.
External Services
This plugin connects to the Google Maps Platform to display the map.
Google Maps JavaScript API (Google LLC)
- What it’s used for: rendering the interactive map, location markers, and the “your location” marker icon.
- When data is sent: every time a visitor views a page containing the
[beverage_finder]shortcode. - What is sent: your Maps API key, the page’s referring URL, the visitor’s IP address and browser details (as part of any request to Google), and the map coordinates being displayed.
- Terms of Service: https://cloud.google.com/maps-platform/terms
- Privacy Policy: https://policies.google.com/privacy
The visitor’s own location (if they allow it) is read by their browser and sent only to your WordPress site to sort results by distance.
Screenshots



Installation
- Upload the plugin folder to
/wp-content/plugins/, or install it from Plugins Add New. - Activate the plugin.
- Go to BevFinder in the admin menu and enter your Google Maps JavaScript API key.
- Import your locations CSV (including latitude and longitude).
- Add the
[beverage_finder]shortcode to any page or post.
FAQ
-
Do I need a Google Maps API key?
-
Yes. The map is displayed with the Google Maps JavaScript API. Create a key in the Google Cloud Console, enable the Maps JavaScript API, restrict the key to your domain, and paste it into BevFinder Maps.
-
What CSV format is required?
-
Use the template included in the plugin (BevFinder Show Instructions Download the CSV template). Columns, in order:
Distributor Number, Distributor Retailer ID, Retailer Name, Address, City, State, Zip, Distributor Product Num, Supplier Product Num, Brand Name, Product Name, On/Off Premise, Salesperson, Delivery Date, Latitude, Longitude
Rows without latitude/longitude are imported but won’t show on the map until coordinates are added.
-
How do I find latitude and longitude?
-
Search the address on Google Maps, right-click the pin, and click the coordinates to copy them (for example
37.7749, -122.4194). -
Is there a location limit?
-
No. Import as many locations as you like.
-
How does location expiration work?
-
Locations whose last delivery date is older than the number of days set in Expire Locations After are hidden from the map. Importing a newer delivery date shows them again. Set the value to 0 to never expire locations.
-
Can I fix a location without re-importing?
-
Yes. Under My Locations, search for it and click Edit. You can change the retailer name, address, brand and product names, coordinates, and whether it shows on the map.
The retailer name, address, and coordinates apply to every product at that location, so you only fix a moved store once. Edited locations are marked “Edited” in the list, and later CSV imports won’t overwrite them — imports only refresh their delivery date.
-
What happens when I delete all locations?
-
All locations are removed from your map. There is no undo.
-
Can I customize the map pin?
-
Yes. Upload an image in BevFinder Maps (minimum 44 x 60 px).
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Beverage Finder by Taps + Tables” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Beverage Finder by Taps + Tables” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
2.2.0
- Added a searchable location list with editing for name, address, products, coordinates, and map visibility.
- Edits to a retailer name, address, or coordinates now apply to every product at that location.
- Hand-edited locations are marked “Edited” and are no longer overwritten by CSV imports (delivery dates still refresh).
- Added “Download My Locations (CSV)” in the same column order as the import template.
- Added a Show/Hide button for the Google Maps API key.
- Map now pans with one finger; the scroll wheel scrolls the page and the +/- buttons zoom.
2.1.0
- CSV import now reads Latitude and Longitude columns.
- Location expiration now filters by last delivery date.
- Re-importing a deleted location restores it.
- Import requires a valid nonce and the manage_options capability.
- All database queries use prepared statements with identifier placeholders.
- Map info windows escape all location data.
- Removed unused settings and legacy code.
2.0.0
- Simplified admin panel.
- Fixed map display issue.