Title: BeachFinder Widget
Author: beachfinder
Published: <strong>2026 年 7 月 5 日</strong>
Last modified: 2026 年 7 月 5 日

---

搜尋外掛

![](https://s.w.org/plugins/geopattern-icon/beachfinder-widget.svg)

# BeachFinder Widget

 由 [beachfinder](https://profiles.wordpress.org/beachfinder/) 開發

[下載](https://downloads.wordpress.org/plugin/beachfinder-widget.1.0.0.zip)

 * [詳細資料](https://tw.wordpress.org/plugins/beachfinder-widget/#description)
 * [使用者評論](https://tw.wordpress.org/plugins/beachfinder-widget/#reviews)
 *  [安裝方式](https://tw.wordpress.org/plugins/beachfinder-widget/#installation)
 * [開發資訊](https://tw.wordpress.org/plugins/beachfinder-widget/#developers)

 [技術支援](https://wordpress.org/support/plugin/beachfinder-widget/)

## 外掛說明

BeachFinder Widget adds the `[beachfinder_widget]` shortcode. It renders an iframe
pointing to the official BeachFinder widget at `https://getbeachfinder.com/widget/
beach-conditions`.

The shortcode accepts optional parameters for location, display text, language, 
search radius, result limit, theme and height.

### External service

This plugin connects to BeachFinder at `https://getbeachfinder.com` to display the
beach conditions widget. The widget is loaded in an iframe from `https://getbeachfinder.
com/widget/beach-conditions`.

When the iframe loads, the visitor’s browser makes a request to BeachFinder. The
request can include shortcode settings such as latitude, longitude, radius, result
limit, language, title and theme. Standard HTTP request data such as IP address,
user agent and referrer may also be received by BeachFinder. BeachFinder may store
the host domain, host page path, widget settings, and hashed IP address and user
agent for analytics, abuse prevention and service reliability.

No BeachFinder account or API key is required to use this plugin.

BeachFinder privacy policy: https://getbeachfinder.com/privacy.html

BeachFinder terms of service: https://getbeachfinder.com/terms.html

### Usage

Default widget:

    ```
    [beachfinder_widget]
    ```

Configured widget:

    ```
    [beachfinder_widget lat="45.526" lng="4.919" title="Conditions de baignade autour de Vienne" lang="fr" radius="50" limit="8" theme="light" height="720"]
    ```

Supported parameters:

 * `lat` – Latitude for the initial location.
 * `lng` – Longitude for the initial location.
 * `title` – Widget title and iframe title.
 * `lang` – Interface language, for example `fr` or `en`.
 * `radius` – Search radius in kilometers. Values are clamped between 5 and 80.
 * `limit` – Maximum number of results to display. Values are clamped between 1 
   and 8.
 * `theme` – Widget theme, either `light` or `dark`.
 * `height` – Iframe minimum height in pixels. Values are clamped between 420 and
   1200.

Empty parameters are ignored. Invalid numeric values are ignored. Non-empty valid
parameters are passed to the BeachFinder widget URL as query string values.

## 安裝方式

 1. Upload the `beachfinder-widget` folder to `/wp-content/plugins/`.
 2. In WordPress admin, open Plugins and activate “BeachFinder Widget”.
 3. Add a Shortcode block to a page or post.
 4. Insert `[beachfinder_widget]` or a configured shortcode.

## 常見問題集

### Does this plugin require a BeachFinder API key?

No. The plugin only embeds the public BeachFinder widget.

### Can I use it in a theme template?

Yes. Use WordPress’ `do_shortcode()` function:

    ```
    <?php echo do_shortcode('[beachfinder_widget lat="45.526" lng="4.919" lang="fr"]'); ?>
    ```

## 使用者評論

這個外掛目前沒有任何使用者評論。

## 參與者及開發者

以下人員參與了開源軟體〈BeachFinder Widget〉的開發相關工作。

參與者

 *   [ beachfinder ](https://profiles.wordpress.org/beachfinder/)

[將〈BeachFinder Widget〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/beachfinder-widget)

### 對開發相關資訊感興趣？

任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/beachfinder-widget/)、
查看 [SVN 存放庫](https://plugins.svn.wordpress.org/beachfinder-widget/)，或透過
[RSS](https://plugins.trac.wordpress.org/log/beachfinder-widget/?limit=100&mode=stop_on_copy&format=rss)
訂閱[開發記錄](https://plugins.trac.wordpress.org/log/beachfinder-widget/)。

## 變更記錄

#### 1.0.0

 * Initial shortcode plugin for the official BeachFinder public widget.

## 中繼資料

 *  版本 **1.0.0**
 *  最後更新 **2 週前**
 *  啟用安裝數 **少於 10 次**
 *  WordPress 版本需求 ** 5.8 或更新版本 **
 *  已測試相容的 WordPress 版本 **6.9.5**
 *  PHP 版本需求 ** 7.4 或更新版本 **
 *  語言
 * [English (US)](https://wordpress.org/plugins/beachfinder-widget/)
 * 標籤:
 * [beach](https://tw.wordpress.org/plugins/tags/beach/)[travel](https://tw.wordpress.org/plugins/tags/travel/)
   [weather](https://tw.wordpress.org/plugins/tags/weather/)[widget](https://tw.wordpress.org/plugins/tags/widget/)
 *  [進階檢視](https://tw.wordpress.org/plugins/beachfinder-widget/advanced/)

## 評分

這個項目尚無任何評論記錄。

[Your review](https://wordpress.org/support/plugin/beachfinder-widget/reviews/#new-post)

[查看全部使用者評論](https://wordpress.org/support/plugin/beachfinder-widget/reviews/)

## 參與者

 *   [ beachfinder ](https://profiles.wordpress.org/beachfinder/)

## 技術支援

使用者可在技術支援論壇提出意見反應或使用問題。

 [檢視技術支援論壇](https://wordpress.org/support/plugin/beachfinder-widget/)