shortcodes/us-tides.php

<?php 
/*

    Copyright 2012-2015 Bobbing Wide (email : herb@bobbingwide.com )

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License version 2,
    as published by the Free Software Foundation.

    You may NOT assume that you can use any other version of the GPL.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    The license for this software can likely be found here:
    http://www.gnu.org/licenses/gpl-2.0.html

*/


/* function us_get_tide_info() – Code copied and cobbled from http://snippet.me/wordpress/wordpress-plugin-info-api/
having referred to http://ckon.wordpress.com/2010/07/20/undocumented-wordpress-org-plugin-api/
get XML information using simple xml load file */


/* function us_time_of_day_secs() – Obtain tide information using the shortcode [us_tides tide_url=’tide feed xml url’]
The format of the feed is expected to be as in the following output from bw_trace */


/* 
SimpleXMLElement Object
(
    [origin] => NOAA/NOS/CO-OPS
    [disclaimer] => Disclaimer: These data are based upon the latest information available as of the date of your request, and may differ from the published tide tables. 
    [producttype] =>  Annual Tide Prediction 
    [stationname] => Threemile Cut entrance, Darien River
    [state] => GA
    [stationid] => 8675843
    [stationtype] => Subordinate
    [referencedToStationName] => SAVANNAH RIVER ENTRANCE, FORT PULASKI
    [referencedToStationId] => 8675843
    [HeightOffsetLow] => *1.05
    [HeightOffsetHigh] => * 1.03
    [TimeOffsetLow] => 55
    [TimeOffsetHigh] => 44
    [BeginDate] => 20111231 00:00
    [EndDate] => 20121231 23:59
    [dataUnits] => feet(ft) also in centimeters(cm)
    [Timezone] => LST/LDT
    [Datum] => MLLW
    [IntervalType] => High/Low Tide Predictions
    [data] => SimpleXMLElement Object
        (
            [item] => Array
                (
                    [0] => SimpleXMLElement Object
                        (
                            [date] => 2011/12/31
                            [day] => Sat
                            [time] => 01:16 AM
                            [predictions_in_ft] => 6.6
                            [predictions_in_cm] => 201
                            [highlow] => H
                        )

                    [1] => SimpleXMLElement Object
                        (
                            [date] => 2011/12/31
                            [day] => Sat
                            [time] => 07:36 AM
                            [predictions_in_ft] => 1.1
                            [predictions_in_cm] => 34
                            [highlow] => L
                        )

                    [2] => SimpleXMLElement Object
                        (
                            [date] => 2011/12/31
                            [day] => Sat
                            [time] => 01:43 PM
                            [predictions_in_ft] => 6.3
                            [predictions_in_cm] => 192
                            [highlow] => H
                        )

                    [3] => SimpleXMLElement Object
                        (
                            [date] => 2011/12/31
                            [day] => Sat
                            [time] => 08:03 PM
                            [predictions_in_ft] => 0.7
                            [predictions_in_cm] => 21
                            [highlow] => L
                        )