BonPlaya - Nearby Beaches

开发者	mva7
更新时间	2026年9月21日 03:50
PHP版本:	8.2 及以上
WordPress版本:	7.1
版权:	GPL-3.0-only
版权网址:	版权信息

下载

0.1.0 0.1.1 0.2.0 0.2.1 0.2.2 0.3.0 0.3.1

详情介绍:

Show beaches near a place you choose. Add them with a block, a widget, or a shortcode: a photo list, a short list, or a map only. Each beach can have its own page, with several Commons photos when they exist. Set the origin on a map, load beaches from OpenStreetMap, and optionally save Wikimedia Commons photos to your Media Library. You can link to reviews on BonPlaya.com (full, subtle, or none). The plugin does not track visitors. Details on external services, privacy, and the BonPlaya name are in the FAQ.

安装:

Upload the plugin zip via Plugins → Add New → Upload Plugin, or copy the bonplaya-nearby-beaches folder into /wp-content/plugins/.
Activate BonPlaya - Nearby Beaches.
Open BonPlaya in the admin menu. Set latitude and longitude (or search on the map) and a radius.
Save. Changing the location or radius updates nearby beaches automatically. Use BonPlaya → Update data to refresh beaches or photos by hand.
Add beaches to a page with the Nearby beaches block, the widget, or a shortcode. Default is a list with photos and a map.

屏幕截图:

升级注意事项:

0.3.1 Fixes the beach photo gallery freezing after fast thumbnail clicks. 0.3.0 Beach pages can show several Commons photos. Open Update data and click Refresh photos to import extras. 0.2.2 Clearer empty message when no beaches are selected for a post. 0.2.1 Plugin Check compliance for Overpass errors and the settings redirect. 0.2.0 Maps, miles or kilometres, custom distance text, and a separate Update data screen. Saving a new location refreshes beaches there automatically. 0.1.1 Photo import queue, Overpass fallback, and clearer settings progress. 0.1.0 Initial public release licensing.

常见问题:

How do I show beaches on a page?

Use the Nearby beaches block, the widget, or a shortcode. Same layouts in all three: List with photos and map [bonplaya_beaches] Photos, names, distances, and a map. Short list with map [bonplaya_beaches format="minimal"] Names and distances, with a map. No photos. Map only [bonplaya_beaches format="map"] Only the map. Click a pin for the name. limit is 1–30. On a list, add map="0" if you do not want the map. source="post" shows beaches named in that post.

May I copy this plugin and keep the BonPlaya name?

No. The code is GPL-3.0-only; the BonPlaya name and branding are trademarks. A fork must use a different name and identity. See NOTICE.

Does this send visitor data to BonPlaya?

No. Beach data is fetched server-side. Public pages do not call BonPlaya APIs. Integration mode only controls whether public HTML links to BonPlaya.com.

Which external services does this plugin use?

The public site does not call Overpass, Wikidata, Wikimedia Commons, MyMemory, or BonPlaya APIs from the visitor’s browser. Those requests are made by your WordPress server (MyMemory only on a cache miss). When a map is shown, the visitor browser loads bundled Leaflet and OpenStreetMap raster tiles. OpenStreetMap / Overpass — Nearby natural=beach objects (server), plus geocoding (admin) and map tiles (admin settings and public maps). Overpass runs on admin refresh and scheduled sync. Nominatim runs only when an administrator searches the settings map. Sent: origin coordinates and radius; search text; tile x/y/z when a map is shown; site URL in the User-Agent. OSM copyright, Overpass, Overpass Kumi, Nominatim policy, OSM privacy. Wikidata — Descriptions, Commons image claims (P18), and Commons category (P373) for OSM objects with a Wikidata id. During photo enrich after sync, or via Update data. Sent: entity ids. Licensing, privacy. Wikimedia Commons — Image metadata and downloads into the Media Library (resized locally), including extra files from a beach Commons category. Public pages never hotlink Commons. During photo enrich. Sent: file titles and category searches. Reusing content, privacy. MyMemory — Translation of cached English summaries into nl, es, de, fr, it, or pt. Cache-first; one server call on first miss. Sent: summary text, language pair, optional contact email from settings, site URL in the User-Agent. Terms. BonPlaya sitemap — Read-only fetch of https://bonplaya.com/sitemap.xml for optional review links in Full integration. After a successful sync if the URL list is older than the cache TTL. Plugin info, terms, privacy.

Does this plugin track visitors?

No. It does not set analytics or advertising cookies and does not insert hidden affiliate or tracking links. Visitor browsers load OpenStreetMap tiles only when a map is shown. Visible BonPlaya.com links appear only if you set integration to Full or Subtle. BonPlaya privacy: https://bonplaya.com/en/info/privacy BonPlaya terms: https://bonplaya.com/en/info/terms

更新日志:

0.3.1

Beach gallery: fast clicks on thumbnails no longer freeze the page.

0.3.0

Beach pages can show up to five Commons photos in a gallery, with a larger view in a modal.
Extra photos come from the Wikidata image and the Commons category, not only a single file.
After this update, a BonPlaya notice appears when extra photos are available. Refresh photos dismisses it.
Optional checkbox on Update data to restore photos deleted from the Media Library.
Photo progress counts beaches that have photos available, and prefers those still missing a lookup.
Updated screenshots.

0.2.2

When a list uses beaches named in the post, an empty selection says “No beaches selected by admin.” instead of asking to refresh.

0.2.1

Plugin Check: escape Overpass error text; geo-save redirect no longer reads an unverified GET page param.

0.2.0

Map of nearby beaches on lists, the widget, the block, and beach pages. Optional map-only layout. The current beach is highlighted.
Kilometers or miles for distances and the search radius. Optional custom text after the distance (for example “from the hotel”).
New Update data screen to refresh beaches and photos. Saving a new location or radius starts that update automatically.
Photo import shows progress, how many beaches have a photo, a green notice when it finishes, and a reason if it stops.
Photo credits are quieter than the BonPlaya source line.
Clearer layout names: list with photos, short list, or map only. Directory description is shorter; service details are in the FAQ.
Updated screenshots.

0.1.1

Settings: progress for Refresh now and Refresh photos; notices stay on the update card.
Photo import no longer re-queues beaches that have no Commons file.
Overpass: retry and a second public instance when the first times out.
Distance text: “from our location”.
Directory icon, banner, and screenshots.

0.1.0

First public license: GPL-3.0-only and trademark notice.
WordPress.org readme: External Services and Privacy.