=== DiveTripPlanner – Cave conditions ===
Contributors: divetripplanner
Tags: diving, cave diving, scuba, conditions, widget
Requires at least: 5.8
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Show today's conditions at cave diving sites on your site: status, visibility, water level and water temperature, updated daily.

== Description ==

DiveTripPlanner (divetripplanner.com) keeps cave pages for cave divers worldwide, with each cave's status, warnings, visibility reports, the water level of a nearby gauge where there is one, and the water temperature. This plugin puts that on your own site.

* **Your own caves** – for dive centres, dive schools and instructors listed on DiveTripPlanner: the caves where you guide or teach, as a block or slim for a sidebar.
* **One cave** – as a block, or as a strip on one line above a post.
* **A region** – its caves, water and current conditions.

A closure or warning always comes first. Everything is updated every day from the same data as the cave pages. Always plan a dive with the cave page and on site; the block does not replace training or local knowledge.

Make the block at https://divetripplanner.com/en/widgets and copy its shortcode, for example:

`[divetripplanner region="lot" cave="ressel" lang="en" label="Émergence du Ressel on DiveTripPlanner"]`

Or add the DiveTripPlanner block in the block editor and fill in the same values in its sidebar.

== External services ==

This plugin shows content from divetripplanner.com, run by De Schiffart Media BV.

* **What and when:** wherever the shortcode or block is on a page, the visitor's browser loads the block from divetripplanner.com in an iframe (https://divetripplanner.com/embed/…).
* **What is sent:** what any browser sends when it loads a page: the visitor's IP address, browser (user agent) and the address of the block. The block sets no cookies, runs no scripts and does not track visitors. The plugin itself sends nothing and stores nothing.
* **Privacy statement:** https://divetripplanner.com/en/privacy

== Installation ==

1. Upload the plugin (Plugins › Add New Plugin › Upload Plugin) and activate it.
2. Make your block at https://divetripplanner.com/en/widgets and copy its shortcode.
3. Paste the shortcode in a post, page or widget, or use the DiveTripPlanner block.

== Frequently Asked Questions ==

= Does it cost anything? =

No. Under every block is a plain link to the page on divetripplanner.com; please leave it in place.

= Where do I find the ids? =

In the builder on https://divetripplanner.com/en/widgets, which prints the whole shortcode. The ids are also in the addresses of the cave pages: /en/cave-diving/<region>/<cave>.

= My dive centre is not listed =

Sign up for free on divetripplanner.com; once your listing is live, your own block is there too.

== Changelog ==

= 1.0.0 =
* First version: shortcode and block for a provider's caves (normal or slim), a cave (block or strip) and a region.
