1 files changed, 431 insertions, 0 deletions
diff --git a/widgets/weather/lib/forecast.io.php b/widgets/weather/lib/forecast.io.php
new file mode 100644
index 00000000..a3fdd0b2
--- /dev/null
+++ b/widgets/weather/lib/forecast.io.php
@@ -0,0 +1,431 @@
+<?php
+/**
+ * Helper Class for forecast.io webservice
+ */
+
+class ForecastIO{
+
+  private $api_key;
+  const API_ENDPOINT = 'https://api.forecast.io/forecast/';
+
+  /**
+   * Create a new instance
+   *
+   * @param String $api_key
+   */
+  function __construct($api_key) {
+
+    $this->api_key = $api_key;
+
+  }
+
+
+  private function requestData($latitude, $longitude, $units, $language = 'en', $timestamp = false, $exclusions = false) {
+
+    $validUnits = array('auto', 'us', 'si', 'ca', 'uk');
+
+    if (in_array($units, $validUnits)) {
+
+      $request_url = self::API_ENDPOINT .
+        $this->api_key . '/' .
+        $latitude . ',' . $longitude .
+        '?units=' . $units . '&lang=' . $language .
+        ( $timestamp ? ',' . $timestamp : '' ) .
+        ( $exclusions ? '&exclude=' . $exclusions : '' );
+      
+      /**
+        * Use Buffer to cache API-requests if initialized
+        * (if not, just get the latest data)
+        * 
+        * More info: http://git.io/FoO2Qw
+        */
+      
+      if(class_exists('Buffer')) {
+        $cache = new Buffer();
+        $content = $cache->data($request_url);
+      } else {
+        $content = file_get_contents($request_url);
+      }
+
+    } else {
+
+      return false;
+
+    }
+
+    if (!empty($content)) {
+
+      return json_decode($content);
+
+    } else {
+
+      return false;
+
+    }
+
+
+  }
+
+  /**
+   * Will return the current conditions
+   *
+   * @param float $latitude
+   * @param float $longitude
+   * @return \ForecastIOConditions|boolean
+   */
+  function getCurrentConditions($latitude, $longitude, $units = 'auto', $language) {
+
+    $data = $this->requestData($latitude, $longitude, $units, $language);
+
+    if ($data !== false) {
+
+      return new ForecastIOConditions($data->currently);
+
+    } else {
+
+      return false;
+
+    }
+
+  }
+
+  /**
+   * Will return historical conditions for day of given timestamp
+   *
+   * @param float $latitude
+   * @param float $longitude
+   * @param int $timestamp
+   * @return \ForecastIOConditions|boolean
+   */
+  function getHistoricalConditions($latitude, $longitude, $units = 'auto', $language, $timestamp) {
+
+    $exclusions = 'currently,minutely,hourly,alerts,flags';
+
+    $data = $this->requestData($latitude, $longitude, $units, $language, $timestamp, $exclusions);
+
+    if ($data !== false) {
+
+      return new ForecastIOConditions($data->daily->data[0]);
+
+    } else {
+
+      return false;
+
+    }
+
+  }
+
+  /**
+   * Will return conditions on hourly basis for today
+   *
+   * @param type $latitude
+   * @param type $longitude
+   * @return \ForecastIOConditions|boolean
+   */
+  function getForecastToday($latitude, $longitude, $units = 'auto', $language) {
+
+    $data = $this->requestData($latitude, $longitude, $units, $language);
+
+    if ($data !== false) {
+
+      $conditions = array();
+
+      $today = date('Y-m-d');
+
+      foreach ($data->hourly->data as $raw_data) {
+
+        if (date('Y-m-d', $raw_data->time) == $today) {
+
+          $conditions[] = new ForecastIOConditions($raw_data);
+
+        }
+
+      }
+
+      return $conditions;
+
+    } else {
+
+      return false;
+
+    }
+
+  }
+
+
+  /**
+   * Will return daily conditions for next seven days
+   *
+   * @param float $latitude
+   * @param float $longitude
+   * @return \ForecastIOConditions|boolean
+   */
+  function getForecastWeek($latitude, $longitude, $units = 'auto', $language) {
+
+    $data = $this->requestData($latitude, $longitude, $units, $language);
+
+    if ($data !== false) {
+
+      $conditions = array();
+
+      foreach ($data->daily->data as $raw_data) {
+
+        $conditions[] = new ForecastIOConditions($raw_data);
+
+      }
+
+      return $conditions;
+
+    } else {
+
+      return false;
+
+    }
+
+  }
+
+
+}
+
+
+/**
+ * Wrapper for get data by getters
+ */
+class ForecastIOConditions{
+
+  private $raw_data;
+
+  function __construct($raw_data) {
+
+    $this->raw_data = $raw_data;
+
+  }
+
+  /**
+   * Will return the temperature
+   *
+   * @return String
+   */
+  function getTemperature() {
+
+    return $this->raw_data->temperature;
+
+  }
+
+  /**
+   * get the min temperature
+   *
+   * only available for week forecast
+   *
+   * @return type
+   */
+  function getMinTemperature() {
+
+    return $this->raw_data->temperatureMin;
+
+  }
+
+  /**
+   * get max temperature
+   *
+   * only available for week forecast
+   *
+   * @return type
+   */
+  function getMaxTemperature() {
+
+    return $this->raw_data->temperatureMax;
+
+  }
+
+  /**
+   * get apparent temperature (heat index/wind chill)
+   *
+   * only available for current conditions
+   *
+   * @return type
+   */
+  function getApparentTemperature() {
+
+    return $this->raw_data->apparentTemperature;
+
+  }
+
+  /**
+   * Get the summary of the conditions
+   *
+   * @return String
+   */
+  function getSummary() {
+
+    return $this->raw_data->summary;
+
+  }
+
+  /**
+   * Get the icon of the conditions
+   *
+   * @return String
+   */
+  function getIcon() {
+
+    return $this->raw_data->icon;
+
+  }
+
+  /**
+   * Get the time, when $format not set timestamp else formatted time
+   *
+   * @param String $format
+   * @return String
+   */
+  function getTime($format = null) {
+
+    if (!isset($format)) {
+
+      return $this->raw_data->time;
+
+    } else {
+
+      return date($format, $this->raw_data->time);
+
+    }
+
+  }
+
+  /**
+   * Get the pressure
+   *
+   * @return String
+   */
+  function getPressure() {
+
+    return $this->raw_data->pressure;
+
+  }
+
+  /**
+   * Get the dew point
+   *
+   * Available in the current conditions
+   *
+   * @return String
+   */
+  function getDewPoint() {
+
+    return $this->raw_data->dewPoint;
+
+  }
+
+  /**
+   * get humidity
+   *
+   * @return String
+   */
+  function getHumidity() {
+
+    return $this->raw_data->humidity;
+
+  }
+
+  /**
+   * Get the wind speed
+   *
+   * @return String
+   */
+  function getWindSpeed() {
+
+    return $this->raw_data->windSpeed;
+
+  }
+
+  /**
+   * Get wind direction
+   *
+   * @return type
+   */
+  function getWindBearing() {
+
+    return $this->raw_data->windBearing;
+
+  }
+
+  /**
+   * get precipitation type
+   *
+   * @return type
+   */
+  function getPrecipitationType() {
+
+    return $this->raw_data->precipType;
+
+  }
+
+  /**
+   * get the probability 0..1 of precipitation type
+   *
+   * @return type
+   */
+  function getPrecipitationProbability() {
+
+    return $this->raw_data->precipProbability;
+
+  }
+
+  /**
+   * Get the cloud cover
+   *
+   * @return type
+   */
+  function getCloudCover() {
+
+    return $this->raw_data->cloudCover;
+
+  }
+
+
+
+  /**
+   * get sunrise time
+   *
+   * only available for week forecast
+   *
+   * @return type
+   */
+  function getSunrise($format=null) {
+
+    if (!isset($format)) {
+
+      return $this->raw_data->sunriseTime;
+
+    } else {
+
+      return date($format, $this->raw_data->sunriseTime);
+
+    }
+
+  }
+
+  /**
+   * get sunset time
+   *
+   * only available for week forecast
+   *
+   * @return type
+   */
+  function getSunset($format=null) {
+
+    if (!isset($format)) {
+
+      return $this->raw_data->sunsetTime;
+
+    } else {
+
+      return date($format, $this->raw_data->sunsetTime);
+
+    }
+
+  }
+
+}
+?>