uk-tides

Description

uk-tides displays tide times and heights for a particular location in the UK.
The information that is displayed is obtained from the RSS feed for tidetimes.org.uk (e.g. https://www.tidetimes.org.uk/chichester-harbour-entrance-tide-times.rss )
or tidetimes.co.uk ( e.g https://www.tidetimes.co.uk/rss/chichester-harbour-entrance-tide-times ).
The data is cached until midnight. This plugin implements a lazy smart shortcode using the API provided by the oik plugin.

You implement this on your website using the [bw_tides] shortcode.

The syntax is:

[bw_tides
tideurl=”https://www.tidetimes.org.uk/chichester-harbour-entrance-tide-times.rss|other – RSS feed URL for location”
store=”1|store key – unique key for caching result”]

Examples:
[bw_tides] with no parameters will display the tide times and heights for Chichester Harbour Entrance. The information will be cached in store=1 until midnight.

[bw_tides store=bw_tides_pompey tideurl=”https://www.tidetimes.org.uk/portsmouth”] will display the tide times and heights obtained from
https://www.tidetimes.org.uk/portsmouth-tide-times.rss and cache the result in a store named ‘bw_tides_pompey’

Note: Using the store parameter allows you to display tide time and height information for more than one location.

Examples:
If you prefer you can use tidetimes.co.uk as the source for tidal information.

[bw_tides tideurl=”https://www.tidetimes.co.uk/rss/chichester-harbour-entrance-tide-times”]

Screenshots

  • Sample output for Portsmouth, Hants - from tidetimes.org.uk
  • Sample output for Portsmouth, Hants - from tidetimes.co.uk

FAQ

Installation
  1. Upload the contents of the uk-tides plugin to the `/wp-content/plugins/uk-tides’ directory
  2. Activate the uk-tides plugin through the ‘Plugins’ menu in WordPress
  3. Whenever you want to produce UK Tide times and heights for the current date use the [bw_tides] shortcode.

Note: uk-tides is dependent upon the oik plugin. You can activate it but it will not work unless oik is also activated.
Download oik from oik download

How do I find the value for tideurl?
  • Visit www.tidetimes.org.uk,
  • click on the location of your choice,
  • click on the RSS feed icon,
  • copy the URL from the feed

e.g. for Brighton Marina the value for tideurl is https://www.tidetimes.org.uk/brighton-marina-tide-times.rss

OR

  • Visit www.tidetimes.co.uk,
  • click on the location of your choice,
  • click on the RSS feed icon,
  • copy the URL from the feed
    e.g. for Brighton Marina the balue for tideurl is https://www.tidetimes.co.uk/rss/brighton-marina-tide-times
Doesn’t [bw_tides] already exist in oik?

Not anymore. It was disabled in oik version 1.11

What if I don’t live in the UK?

uk-tides currently only works for the UK and Ireland since the information is obtained from https://www.tidetimes.org.uk or https://www.tidetimes.co.uk
If you can point us to a resource for other locations then it should be possible to develop a very similar solution.

For saltwater tide times and heights for the US see US-tides WordPress plugin

Isn’t there some JavaScript that does something similar?

Yes. See https://www.tidetimes.org.uk/widgets or https://www.tidetimes.co.uk/widgets

You may find the output harder to (re)style.

Further reading

If you want to read more about the oik plugins then please visit the
oik plugin “OIK – OIK Information Kit”

Contributors & Developers

“uk-tides” is open source software. The following people have contributed to this plugin.

Contributors

Translate “uk-tides” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.6.4

  • Changed: Further improve ability to style the output of the bw_tides shortcode,[github bobbingwide uk-tides issue 5]
  • Changed: Now depends on oik v3.1 or higher
  • Tested: With WordPress 4.7.3 and WordPress Multisite
  • Tested: With PHP 7.1

1.6.3

  • Fixed: Avoid Fatal errors when oik not activated processing ‘oik_add_shortcodes’ action [github bobbingwide uk-tides issue 2]
  • Tested: With WordPress 4.6.1
  • Tested: Compatability with oik up to 3.0.3

1.6.2

  • Fixed: Uncaught exception ‘Serialization of ‘SimpleXMLElement’ when tracing GitHub Issue 1

1.6.1

  • Changed: Updated oik-activation logic
  • Changed: Now dependent upon oik v2.5 or higher
  • Tested: With WordPress 4.4

1.6

  • Added: force=true parameter to force data refresh
  • Changed: Improved support for styling with CSS
  • Changed: better support for tidetimes.co.uk feed
  • Changed: store= parameter now also used as a CSS class for the outer span
  • Tested: With WordPress 4.1 and WordPress Multi Site

1.5

  • Changed: Added initial support for tidetimes.co.uk – slightly different output
  • Tested: With WordPress 4.1-beta2 and WordPress Multi Site

1.4

  • Changed: Now dependent upon oik v2.2 or higher
  • Tested: With WordPress 4.0 and WordPress Multi Site

1.3

  • Tested: With WordPress 3.8.1
  • Changed: Plugin dependency checking

1.2

  • Tested: With WordPress 3.8
  • Changed: Minor changes for improved API documentation

1.1

  • Changed: The generated output is formatted with divs and spans to enable styling with CSS

1.0

  • initial version. Works with oik version 1.11