Title: Beverage Finder by Taps + Tables
Author: BevFinder
Published: <strong>22 سپتامبر 2026</strong>
Last modified: 23 سپتامبر 2026

---

جستجوی افزونه‌ها

![](https://ps.w.org/beverage-finder/assets/icon-256x256.png?rev=3707779)

# Beverage Finder by Taps + Tables

 توسط [BevFinder](https://profiles.wordpress.org/tapsandtables/)

[دانلود](https://downloads.wordpress.org/plugin/beverage-finder.2.3.0.zip)

 * [جزئیات](https://fa.wordpress.org/plugins/beverage-finder/#description)
 * [نقد و بررسی‌ها](https://fa.wordpress.org/plugins/beverage-finder/#reviews)
 *  [نصب](https://fa.wordpress.org/plugins/beverage-finder/#installation)
 * [توسعه](https://fa.wordpress.org/plugins/beverage-finder/#developers)

 [پشتیبانی](https://wordpress.org/support/plugin/beverage-finder/)

## توضیحات

Beverage Finder is a beer finder, beverage finder, and store locator for breweries,
wineries, distilleries, and beverage brands. Show customers where to buy your products
with an interactive map and searchable list of retail locations.

**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
 * Delete and restore locations one at a time, in bulk, or all at once
 * Setup checklist that shows exactly what’s left to do
 * Optional one-click address-to-coordinates lookup with a beveragefinder.net account
 * 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

**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.

Only have street addresses? You can look up coordinates yourself on Google Maps,
fill them in with any geocoding tool and re-import, or connect an optional [beveragefinder.net](https://beveragefinder.net/wordpress)
account and click **Get Coordinates** on the BevFinder  Get Lat / Long screen. The
account is a paid service with a free starter plan. Everything else in the plugin
works fully without it, and the plugin only contacts beveragefinder.net when you
click one of its buttons.

### External Services

This plugin connects to the Google Maps Platform to display the map, and — only 
if you choose to — to beveragefinder.net to convert addresses into coordinates.

**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.

**beveragefinder.net address lookup** (Taps + Tables)

 * What it’s used for: converting the street addresses of your locations into latitude/
   longitude, and showing your plan’s usage. beveragefinder.net uses the US Census
   Geocoder, with the Google Geocoding API as a fallback.
 * When data is sent: only when a site administrator saves a beveragefinder.net 
   WordPress API Key on BevFinder  Get Lat / Long and then clicks **Get Coordinates**
   or **Check account**. Nothing is sent automatically, on a schedule, or from the
   front end.
 * What is sent: the WordPress API Key, your site URL, the plugin version, and the
   street address, city, state, and ZIP of locations that have no coordinates (or
   whose Google-provided coordinates are more than 30 days old, which Google’s terms
   require be refreshed). Retailer names, products, and sales data are not sent.
 * Terms of Service: https://beveragefinder.net/terms
 * Privacy Policy: https://beveragefinder.net/privacy

## عکس‌های صفحه

[⌊Map and nearby locations list.⌉⌊Map and nearby locations list.⌉[

Map and nearby locations list.

[⌊Map and nearby locations list.⌉⌊Map and nearby locations list.⌉[

Map and nearby locations list.

[⌊BevFinder settings screen.⌉⌊BevFinder settings screen.⌉[

BevFinder settings screen.

## نصب

 1. Upload the plugin folder to `/wp-content/plugins/`, or install it from Plugins  
    Add New.
 2. Activate the plugin.
 3. Go to **BevFinder  Instructions** and follow the setup checklist.
 4. Enter your Google Maps JavaScript API key on **BevFinder  Settings**.
 5. Import your locations CSV on **BevFinder  Locations**.
 6. 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](https://console.cloud.google.com), enable the Maps JavaScript
API, restrict the key to your domain, and paste it into BevFinder  Settings.

### What CSV format is required?

Use the template included in the plugin (BevFinder  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`), then paste them into the location
on BevFinder  Locations  Edit.

For many addresses, connect a beveragefinder.net account on BevFinder  Get Lat /
Long and click Get Coordinates. Each unique address is one lookup, and the free 
plan includes 10 a month. Addresses that already have coordinates are never sent,
except Google-placed coordinates older than 30 days, which Google’s terms require
be refreshed.

### 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. On BevFinder  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 locations?

They are removed from your map but not erased. Deleted locations are listed under
Locations  Deleted, where you can restore them individually, in bulk, or all at 
once with Restore All. Re-importing a CSV also restores any matching deleted rows.
Deleting the plugin from the Plugins screen permanently removes all location data.

### Is BevFinder Pro required?

No. BevFinder Pro is the optional beveragefinder.net account that converts addresses
to coordinates for you. Importing, editing, and mapping unlimited locations is free.

### Can I customize the map pin?

Yes. Upload an image in BevFinder  Settings (minimum 44 x 60 px).

## نقد و بررسی‌ها

نقد و بررسی‌ای برای این افزونه یافت نشد.

## توسعه دهندگان و همکاران

“Beverage Finder by Taps + Tables” نرم افزار متن باز است. افراد زیر در این افزونه
مشارکت کرده‌اند.

مشارکت کنندگان

 *   [ BevFinder ](https://profiles.wordpress.org/tapsandtables/)
 *   [ chadelkins ](https://profiles.wordpress.org/chadelkins/)

[ترجمه “Beverage Finder by Taps + Tables” به زبان شما.](https://translate.wordpress.org/projects/wp-plugins/beverage-finder)

### علاقه‌ مند به توسعه هستید؟

[کد را مرور کنید](https://plugins.trac.wordpress.org/browser/beverage-finder/)، 
[مخزن SVN](https://plugins.svn.wordpress.org/beverage-finder/) را بررسی کنید، یا
از طریق [RSS](https://plugins.trac.wordpress.org/log/beverage-finder/?limit=100&mode=stop_on_copy&format=rss)
در [گزارش توسعه](https://plugins.trac.wordpress.org/log/beverage-finder/) مشترک 
شوید.

## گزارش تغییرات

#### 2.3.0

 * New admin layout with tabs: Instructions, Settings, Locations, Get Lat / Long,
   and BevFinder Pro.
 * Instructions now include a live setup checklist and a full CSV column reference.
 * Locations: Active, Not on map, and Deleted views with counts; select rows to 
   delete or restore them.
 * Added Restore All. Delete All now clearly explains that deleted locations can
   be restored.
 * Import summary links straight to getting coordinates for rows that don’t have
   any.
 * Optional: connect a beveragefinder.net account and click Get Coordinates to fill
   in missing latitude/longitude.
 * Addresses that can’t be found are flagged so they aren’t looked up again until
   you fix them.
 * Coordinates placed by Google are refreshed after 30 days when you next click 
   Get Coordinates, as Google’s terms require.
 * Download My Locations now exports active locations only.
 * Settings and Get Coordinates links on the Plugins screen.

#### 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.

## اطلاعات

 *  نگارش **2.3.0**
 *  آخرین به‌روزرسانی **3 روز پیش**
 *  نصب‌های فعال **کمتر از 10**
 *  نگارش وردپرس ** 6.2 یا بالاتر **
 *  آزمایش‌شده تا **7.1.2**
 *  نگارش PHP ** 7.4 یا بالاتر **
 *  زبان
 * [English (US)](https://wordpress.org/plugins/beverage-finder/)
 * برچسب
 * [product-locator](https://fa.wordpress.org/plugins/tags/product-locator/)[Store locator](https://fa.wordpress.org/plugins/tags/store-locator/)
   [where to buy](https://fa.wordpress.org/plugins/tags/where-to-buy/)
 *  [نمایش پیشرفته](https://fa.wordpress.org/plugins/beverage-finder/advanced/)

## امتیازها

هنوز هیچ نقدی ارسال نشده است.

[بررسی شما](https://wordpress.org/support/plugin/beverage-finder/reviews/#new-post)

[مشاهدهٔ همهٔ بررسی‌ها](https://wordpress.org/support/plugin/beverage-finder/reviews/)

## مشارکت کنندگان

 *   [ BevFinder ](https://profiles.wordpress.org/tapsandtables/)
 *   [ chadelkins ](https://profiles.wordpress.org/chadelkins/)

## پشتیبانی

چیزی برای گفتن دارید؟ نیاز به کمک دارید؟

 [مشاهده انجمن پشتیبانی](https://wordpress.org/support/plugin/beverage-finder/)