Beverage Finder by Taps + Tables
| 开发者 |
tapsandtables
chadelkins |
|---|---|
| 更新时间 | 2026年9月24日 00:15 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- 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
- Works great as a beer finder or product locator
- Find your product at stores, bars, restaurants, or other retailer
安装:
- 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.
屏幕截图:
常见问题:
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).
更新日志:
- 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.
- 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.
- Simplified admin panel.
- Fixed map display issue.