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.

FAQ

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 Widget”(을)를 번역하세요.

개발에 관심이 있으십니까?

코드 탐색하기는, SVN 저장소를 확인하시거나, 개발 기록RSS로 구독하세요.

변경이력

1.0.0

  • Initial shortcode plugin for the official BeachFinder public widget.