From 90b41f73e6879351e0b923b255adecfe6fd7fbc3 Mon Sep 17 00:00:00 2001
From: malle-pietje <erik@slooff.net>
Date: Sat, 10 Dec 2016 08:32:45 +0100
Subject: [PATCH] API Browser version 1.0.7, API client class version 1.0.10

- API Browser: minor code cleanup
- API Browser: improved/cleaner layout
- API Browser: added Source Integrity hashes for most external resources
- API client class: general code cleanup
---
 README.md              |    4 +-
 index.php              |  132 +-
 phpapi/class.unifi.php | 2781 +++++++++++++++++++++-------------------
 3 files changed, 1510 insertions(+), 1407 deletions(-)

diff --git a/README.md b/README.md
index 15b6e16..af2fd72 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
 ## UniFi API browser
 This tool is for browsing data that is exposed through Ubiquiti's UniFi Controller API, written in PHP, JavaScript and the [Bootstrap] (http://getbootstrap.com/) CSS framework. Please keep the following in mind:
 - not all data collections/API endpoints are supported (yet), see the list below of currently supported data collections/API endpoints
-- currently supports versions 4.x.x and 5.x.x of the UniFi Controller software (version 5.3.7 has been confirmed to work)
+- currently supports versions 4.x.x and 5.x.x of the UniFi Controller software (version 5.3.8 has been confirmed to work)
 - there is still work to be done to add/improve functionality and usability of this tool so suggestions/comments are welcome. Please use the github issue list or the Ubiquiti Community forums (https://community.ubnt.com/t5/UniFi-Wireless/UniFi-API-browser-tool-released/m-p/1392651) to share your ideas.
 - please read the Security Notice below before installing this tool!
 
@@ -69,7 +69,7 @@ Please note that the bundled API client supports many more API endpoints, not al
 The PHP API client that comes bundled with this tool is based on the work done by the following developers:
 - domwo: http://community.ubnt.com/t5/UniFi-Wireless/little-php-class-for-unifi-api/m-p/603051
 - fbagnol: https://github.com/fbagnol/class.unifi.php
-- and the API as published by Ubiquiti: https://www.ubnt.com/downloads/unifi/5.2.9/unifi_sh_api
+- and the API as published by Ubiquiti: https://www.ubnt.com/downloads/unifi/5.3.8/unifi_sh_api
 
 Other included libraries:
 - Bootstrap (version 3.3.6) http://getbootstrap.com/
diff --git a/index.php b/index.php
index 723b2bc..b10d876 100644
--- a/index.php
+++ b/index.php
@@ -3,18 +3,14 @@
  * UniFi API Browser
  *
  * This tool is for browsing data that is exposed through Ubiquiti's UniFi Controller API,
- * written in PHP, javascript and the Bootstrap CSS framework.
+ * written in PHP, JavaScript and the Bootstrap CSS framework.
  *
  * Please keep the following in mind:
- * - not all data collections/API endpoints are supported (yet), see the list below of
- *   the currently supported data collections/API endpoints
- * - currently only supports versions 4.x.x of the UniFi Controller software
- * - there is still work to be done to add/improve functionality and usability of this
- *   tool so suggestions/comments are welcome. Please use the github issue list or the
- *   Ubiquiti Community forums for this:
- *   https://community.ubnt.com/t5/UniFi-Wireless/UniFi-API-browser-tool-released/m-p/1392651
+ * - not all data collections/API endpoints are supported (yet), see the list of
+ *   the currently supported data collections/API endpoints in the README.md file
+ * - this tool currently supports versions 4.x and 5.x of the UniFi Controller software
  *
- * VERSION: 1.0.6
+ * VERSION: 1.0.7
  *
  * ------------------------------------------------------------------------------------
  *
@@ -24,11 +20,10 @@
  * with this package in the file LICENSE.md
  *
  */
-
-define('API_BROWSER_VERSION', '1.0.6');
+define('API_BROWSER_VERSION', '1.0.7');
 
 /**
- * to use the PHP $_SESSION array for temporary storage of variables, session_start() is required
+ * in order to use the PHP $_SESSION array for temporary storage of variables, session_start() is required
  */
 session_start();
 
@@ -60,8 +55,8 @@
  * - if the config.php file is unreadable or does not exist, an alert is displayed on the page
  */
 if(!is_readable('config.php')) {
-    $alert_message = '<div class="alert alert-danger" role="alert">The file config.php is not readable or does not exist.'
-                    . '<br>If you have not yet done so, please copy/rename the config.template.php file to config.php and modify'
+    $alert_message = '<div class="alert alert-danger" role="alert">The file <code>config.php</code> is not readable or does not exist.'
+                    . '<br>If you have not yet done so, please copy/rename the <code>config.template.php</code> file to <code>config.php</code> and modify '
                     . 'the contents as required.</div>';
 } else {
     include('config.php');
@@ -92,7 +87,7 @@
 
 /**
  * process the GET variables and store them in the $_SESSION array
- * if a GET variable is not set, get the values from $_SESSION (if available)
+ * if a GET variable is not set, get the values from the $_SESSION array (if available)
  *
  * Process in this order:
  * - controller_id
@@ -104,11 +99,17 @@
  * - theme
  */
 if (isset($_GET['controller_id'])) {
+    /**
+     * user has requested a controller switch
+     */
     $controller                = $controllers[$_GET['controller_id']];
     $controller_id             = $_GET['controller_id'];
     $_SESSION['controller']    = $controller;
     $_SESSION['controller_id'] = $_GET['controller_id'];
 
+    /**
+     * clear the variables from the $_SESSION array that are associated with the previous controller
+     */
     unset($_SESSION['site_id']);
     unset($_SESSION['site_name']);
     unset($_SESSION['sites']);
@@ -148,7 +149,7 @@
 }
 
 /**
- * get requested theme or use the theme stored in $_SESSION
+ * get requested theme or use the theme stored in the $_SESSION array
  */
 if (isset($_GET['theme'])) {
     $theme             = $_GET['theme'];
@@ -160,7 +161,7 @@
 }
 
 /**
- * get requested output_format or use the output_format stored in $_SESSION
+ * get requested output_format or use the output_format stored in the $_SESSION array
  */
 if (isset($_GET['output_format'])) {
     $output_format             = $_GET['output_format'];
@@ -172,7 +173,7 @@
 }
 
 /**
- * get requested action or use the action stored in $_SESSION
+ * get requested action or use the action stored in the $_SESSION array
  */
 if (isset($_GET['action'])) {
     $action             = $_GET['action'];
@@ -185,31 +186,31 @@
 
 /**
  * display info message when no controller, site or data collection is selected
- * placed here so they can be overwritten by more "severe" error messages later down
+ * placed here so they can be overwritten by more "severe" error messages later on
  */
 if ($action === '') {
-    $alert_message = '<div class="alert alert-info" role="alert">Please select a data collection/API endpoint from the drop-down menus'
+    $alert_message = '<div class="alert alert-info" role="alert">Please select a data collection/API endpoint from the dropdown menus'
                     . ' <i class="fa fa-arrow-circle-up"></i></div>';
 }
 
 if ($site_id === '' && isset($_SESSION['controller'])) {
-    $alert_message = '<div class="alert alert-info" role="alert">Please select a site from the drop-down menu <i class="fa fa-arrow-circle-up">'
+    $alert_message = '<div class="alert alert-info" role="alert">Please select a site from the Sites dropdown menu <i class="fa fa-arrow-circle-up">'
                     . '</i></div>';
 }
 
 if (!isset($_SESSION['controller'])) {
-    $alert_message = '<div class="alert alert-info" role="alert">Please select a controller from the drop-down menu <i class="fa fa-arrow-circle-up">'
+    $alert_message = '<div class="alert alert-info" role="alert">Please select a controller from the Controllers dropdown menu <i class="fa fa-arrow-circle-up">'
                     . '</i></div>';
 }
 
 /**
- * load the UniFi API client class and log in to the controller
+ * load the UniFi API client class and log in to the UniFi controller
  * - if an error occurs during the login process, an alert is displayed on the page
  */
 require('phpapi/class.unifi.php');
 
 /**
- * Do this when a controller has been selected and was stored in $_SESSION
+ * Do this when a controller has been selected and was stored in the $_SESSION array
  */
 if (isset($_SESSION['controller'])) {
     $unifidata        = new unifiapi($controller['user'], $controller['password'], $controller['url'], $site_id, $controller['version']);
@@ -223,7 +224,7 @@
     }
 
     /**
-     * Get the list of sites managed by the controller (if not already stored in $_SESSION)
+     * Get the list of sites managed by the UniFi controller (if not already stored in the $_SESSION array)
      */
     if (!isset($_SESSION['sites']) || $_SESSION['sites'] === '') {
         $sites  = $unifidata->list_sites();
@@ -233,7 +234,7 @@
     }
 
     /**
-     * Get the version of the controller (if not already stored in $_SESSION or when 'undetected')
+     * Get the version of the UniFi controller (if not already stored in the $_SESSION array or when 'undetected')
      */
     if (!isset($_SESSION['detected_controller_version']) || $_SESSION['detected_controller_version'] === 'undetected') {
         $site_info = $unifidata->stat_sysinfo();
@@ -395,7 +396,7 @@
 }
 
 /**
- * count the number of objects collected from the controller
+ * count the number of objects collected from the UniFi controller
  */
 if($action!=''){
     $objects_count = count($data);
@@ -405,13 +406,13 @@
  * create the url to the css file based on the selected theme (standard Bootstrap or one of the Bootswatch themes)
  */
 if ($theme === 'bootstrap') {
-    $cssurl = 'https://maxcdn.bootstrapcdn.com/bootstrap/3.3.6/css/bootstrap.min.css';
+    $cssurl = 'https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css';
 } else {
-    $cssurl = 'https://maxcdn.bootstrapcdn.com/bootswatch/3.3.6/' . $theme . '/bootstrap.min.css';
+    $cssurl = 'https://maxcdn.bootstrapcdn.com/bootswatch/3.3.7/' . $theme . '/bootstrap.min.css';
 }
 
 /**
- * execute timing of data collection from controller
+ * execute timing of data collection from UniFi controller
  */
 $time_2          = microtime(true);
 $time_after_load = $time_2 - $time_start;
@@ -481,9 +482,9 @@ function sites_sort($a, $b)
     <title>UniFi API browser</title>
     <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no">
     <!-- Latest compiled and minified versions of Bootstrap, Font-awesome and Highlight.js CSS, loaded from CDN -->
-    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.5.0/css/font-awesome.min.css">
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.7.0/css/font-awesome.min.css" integrity="sha384-wvfXpqpZZVQGK6TAh5PVlGOfQNHSoD2xbE+QkPxCAFlNEevoEH3Sl0sibVcOQVnN" crossorigin="anonymous">
     <link rel="stylesheet" href="<?php echo $cssurl ?>">
-    <link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.0.0/styles/default.min.css">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.8.0/styles/default.min.css" integrity="sha256-Zd1icfZ72UBmsId/mUcagrmN7IN5Qkrvh75ICHIQVTk=" crossorigin="anonymous" />
     <!-- custom CSS styling -->
     <style>
         body {
@@ -517,7 +518,7 @@ function sites_sort($a, $b)
                         <a id="controller-menu" href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false">
                             <?php
                             /**
-                             * here we display the controller name, if selected, else just label it
+                             * here we display the UniFi controller name, if selected, else just label it
                              */
                             if (isset($controller)) {
                                 echo $controller['name'];
@@ -531,7 +532,7 @@ function sites_sort($a, $b)
                             <li class="dropdown-header">Select a controller</li>
                             <?php
                             /**
-                             * here we loop through the configured controllers
+                             * here we loop through the configured UniFi controllers
                              */
                             foreach ($controllers as $key => $value) {
                                 echo '<li id="controller_' . $key . '"><a href="?controller_id=' . $key . '">' . $value['name'] . '</a></li>' . "\n";
@@ -540,7 +541,7 @@ function sites_sort($a, $b)
                          </ul>
                     </li>
                 <?php } ?>
-                <!-- only show the sites dropdown when a controller is selected -->
+                <!-- only show the sites dropdown when a controller has been selected -->
                 <?php if (isset($_SESSION['controller'])) { ?>
                     <li id="site-menu" class="dropdown">
                         <a id="site-menu" href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false">
@@ -587,6 +588,7 @@ function sites_sort($a, $b)
                             <span class="caret"></span>
                         </a>
                         <ul class="dropdown-menu">
+                            <li class="dropdown-header">Select a data collection</li>
                             <li id="list_clients"><a href="?action=list_clients">list online clients</a></li>
                             <li id="list_guests"><a href="?action=list_guests">list guests</a></li>
                             <li id="list_users"><a href="?action=list_users">list users</a></li>
@@ -603,6 +605,7 @@ function sites_sort($a, $b)
                             <span class="caret"></span>
                         </a>
                         <ul class="dropdown-menu">
+                            <li class="dropdown-header">Select a data collection</li>
                             <li id="list_devices"><a href="?action=list_devices">list devices</a></li>
                             <li id="list_wlan_groups"><a href="?action=list_wlan_groups">list wlan groups</a></li>
                             <li id="list_rogueaps"><a href="?action=list_rogueaps">list rogue access points</a></li>
@@ -614,6 +617,7 @@ function sites_sort($a, $b)
                             <span class="caret"></span>
                         </a>
                         <ul class="dropdown-menu">
+                            <li class="dropdown-header">Select a data collection</li>
                             <li id="stat_hourly_site"><a href="?action=stat_hourly_site">hourly site stats</a></li>
                             <li id="stat_daily_site"><a href="?action=stat_daily_site">daily site stats</a></li>
                             <?php if ($detected_controller_version != 'undetected' && version_compare($detected_controller_version, '5.2.9') >= 0) { ?>
@@ -635,6 +639,7 @@ function sites_sort($a, $b)
                             <span class="caret"></span>
                         </a>
                         <ul class="dropdown-menu">
+                            <li class="dropdown-header">Select a data collection</li>
                             <li id="stat_voucher"><a href="?action=stat_voucher">stat vouchers</a></li>
                             <li id="stat_payment"><a href="?action=stat_payment">stat payments</a></li>
                             <li role="separator" class="divider"></li>
@@ -647,6 +652,7 @@ function sites_sort($a, $b)
                             <span class="caret"></span>
                         </a>
                         <ul class="dropdown-menu">
+                            <li class="dropdown-header">Select a data collection</li>
                             <li id="list_sites"><a href="?action=list_sites">list sites on this controller</a></li>
                             <li id="stat_sysinfo"><a href="?action=stat_sysinfo">sysinfo</a></li>
                             <li id="list_self"><a href="?action=list_self">self</a></li>
@@ -669,6 +675,7 @@ function sites_sort($a, $b)
                             <span class="caret"></span>
                         </a>
                         <ul class="dropdown-menu">
+                            <li class="dropdown-header">Select a data collection</li>
                             <li id="list_alarms"><a href="?action=list_alarms">list alerts</a></li>
                             <li id="list_events"><a href="?action=list_events">list events</a></li>
                         </ul>
@@ -682,7 +689,7 @@ function sites_sort($a, $b)
                     </a>
                     <ul class="dropdown-menu">
                         <li class="dropdown-header">Select a theme</li>
-                        <li id="bootstrap"><a href="?theme=bootstrap">default Bootstrap</a></li>
+                        <li id="bootstrap"><a href="?theme=bootstrap">Bootstrap (default)</a></li>
                         <li id="cerulean"><a href="?theme=cerulean">Cerulean</a></li>
                         <li id="cosmo"><a href="?theme=cosmo">Cosmo</a></li>
                         <li id="cyborg"><a href="?theme=cyborg">Cyborg</a></li>
@@ -700,7 +707,7 @@ function sites_sort($a, $b)
                         <li id="united"><a href="?theme=united">United</a></li>
                         <li id="yeti"><a href="?theme=yeti">Yeti</a></li>
                         <li role="separator" class="divider"></li>
-                        <li id="info" data-toggle="modal" data-target="#aboutModal"><a href="#"><i class="fa fa-info-circle"></i> About</a></li>
+                        <li id="info" data-toggle="modal" data-target="#aboutModal"><a href="#"><i class="fa fa-info-circle"></i> About UniFi API Browser</a></li>
                     </ul>
                 </li>
             </ul>
@@ -711,6 +718,8 @@ function sites_sort($a, $b)
     <div id="alertPlaceholder">
         <?php echo $alert_message ?>
     </div>
+    <!-- data-panel, only to be displayed once a controller has been configured and an action has been selected -->
+    <?php if (isset($_SESSION['controller']) && $action) { ?>
     <div class="panel panel-default">
         <div class="panel-heading">
             <?php if ($site_id) { ?>
@@ -727,7 +736,7 @@ function sites_sort($a, $b)
         </div>
         <div class="panel-body">
             <!--only display panel content when an action has been selected-->
-            <?php if ($action !== '') { ?>
+            <?php if ($action !== '' && isset($_SESSION['controller'])) { ?>
             <!-- present the timing results using an HTML5 progress bar -->
             total elapsed time: <?php echo $time_total ?> seconds<br>
             <div class="progress">
@@ -751,9 +760,11 @@ function sites_sort($a, $b)
             <?php } ?>
         </div>
     </div>
+    <?php } ?>
+    <!-- /data-panel -->
 </div>
 <!-- Modal -->
-<div class="modal fade" id="aboutModal" tabindex="-1" role="dialog" aria-labelledby="myModalLabel">
+<div class="modal fade" id="aboutModal" tabindex="-1" role="dialog">
     <div class="modal-dialog" role="document">
         <div class="modal-content">
             <div class="modal-header">
@@ -766,11 +777,10 @@ function sites_sort($a, $b)
                         A tool for browsing the data collections which are exposed through Ubiquiti's UniFi Controller API.
                     </div>
                 </div>
-                <hr>
                 <div class="row">
-                    <div class="col-sm-8 col-sm-offset-2"><a href="https://github.com/malle-pietje/UniFi-API-browser"
+                    <div class="col-sm-8 col-sm-offset-1"><a href="https://github.com/malle-pietje/UniFi-API-browser"
                     target="_blank">UniFi API browser on Github</a></div>
-                    <div class="col-sm-8 col-sm-offset-2"><a href="http://community.ubnt.com/t5/UniFi-Wireless/UniFi-API-browser-tool-updates-and-discussion/m-p/1392651#U1392651"
+                    <div class="col-sm-8 col-sm-offset-1"><a href="http://community.ubnt.com/t5/UniFi-Wireless/UniFi-API-browser-tool-updates-and-discussion/m-p/1392651#U1392651"
                     target="_blank">UniFi API browser on Ubiquiti Community forum</a></div>
                 </div>
                 <hr>
@@ -809,33 +819,35 @@ function sites_sort($a, $b)
         </div>
     </div>
 </div>
-<!-- Latest compiled and minified JavaScript versions, loaded from CDN's -->
-<script src="https://code.jquery.com/jquery-2.2.0.min.js"></script>
-<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.6/js/bootstrap.min.js"></script>
-<script src="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.0.0/highlight.min.js"></script>
+<!-- Latest compiled and minified JavaScript versions, loaded from CDN's, now including Source Integrity hashes, just in case... -->
+<script src="https://code.jquery.com/jquery-2.2.4.min.js" integrity="sha256-BbhdlvQf/xTY9gja0Dq3HiwQF8LaCRTXxZKRutelT44=" crossorigin="anonymous"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js" integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa" crossorigin="anonymous"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.8.0/highlight.min.js" integrity="sha256-+mpyNVJsNt4rVXCw0F+pAOiB3YxmHgrbJsx4ecPuUaI=" crossorigin="anonymous"></script>
 <script>
+$(document).ready(function() {
     /**
-    * initialise the Highlighting.js library
-    */
-    hljs.initHighlightingOnLoad();
-</script>
-<script>
+     * initialise the Highlighting.js library, only when required
+     */
+    ('<?php echo $output_format ?>' == 'json_color') ? hljs.initHighlightingOnLoad() : false;
+
     /**
-    * highlight selected options in the pull down menus
-    * for $action, $site_id, $theme and $output_format:
-    */
-    $('#<?php echo $theme ?>').addClass('active').find('a').append(' <i class="fa fa-check"></i>');
-    $('#<?php echo $action ?>').addClass('active').find('a').append(' <i class="fa fa-check"></i>');
-    $('#<?php echo $site_id ?>').addClass('active').find('a').append(' <i class="fa fa-check"></i>');
+     * highlight and mark the selected options in the dropdown menus for $controller_id, $action, $site_id, $theme and $output_format
+     * NOTE:
+     * these actions are performed conditionally when values are set for the respective PHP variables
+     */
+    ('<?php echo $action ?>' != '') ? $('#<?php echo $action ?>').addClass('active').find('a').append(' <i class="fa fa-check"></i>') : false;
+    ('<?php echo $site_id ?>' != '') ? $('#<?php echo $site_id ?>').addClass('active').find('a').append(' <i class="fa fa-check"></i>') : false;
+    ('<?php echo $controller_id ?>' != '') ? $('#controller_<?php echo $controller_id ?>').addClass('active').find('a').append(' <i class="fa fa-check"></i>') : false;
     $('#<?php echo $output_format ?>').addClass('active').find('a').append(' <i class="fa fa-check"></i>');
-    $('#controller_<?php echo $controller_id ?>').addClass('active').find('a').append(' <i class="fa fa-check"></i>');
+    $('#<?php echo $theme ?>').addClass('active').find('a').append(' <i class="fa fa-check"></i>');
 
     /**
-    * enable Bootstrap tooltips
-    */
+     * enable Bootstrap tooltips
+     */
     $(function () {
         $('[data-toggle="tooltip"]').tooltip()
     })
+});
 </script>
 </body>
 </html>
\ No newline at end of file
diff --git a/phpapi/class.unifi.php b/phpapi/class.unifi.php
index b41a0bf..02fc5be 100644
--- a/phpapi/class.unifi.php
+++ b/phpapi/class.unifi.php
@@ -4,16 +4,16 @@
  *
  * This UniFi API client comes bundled with the UniFi API Browser tool and is based on the work done by
  * the following developers:
- *   domwo: http://community.ubnt.com/t5/UniFi-Wireless/little-php-class-for-unifi-api/m-p/603051
- *   fbagnol: https://github.com/fbagnol/class.unifi.php
+ *    domwo: http://community.ubnt.com/t5/UniFi-Wireless/little-php-class-for-unifi-api/m-p/603051
+ *    fbagnol: https://github.com/fbagnol/class.unifi.php
  * and the API as published by Ubiquiti:
- *   https://www.ubnt.com/downloads/unifi/5.2.9/unifi_sh_api
+ *    https://www.ubnt.com/downloads/unifi/5.3.8/unifi_sh_api
  *
- * VERSION: 1.0.9
+ * VERSION: 1.0.10
  *
  * NOTES:
- * - this Class will only work with UniFi Controller versions 4.x and higher. There are no checks to prevent
- *   you from trying to use it with a pre-4.x version controller.
+ * - this Class will only work with UniFi Controller versions 4.x and 5.x. There are no checks to prevent
+ *   you from trying to use it with other versions of the UniFi Controller.
  *
  * IMPORTANT CHANGES:
  * - function/method "get_vouchers" has been removed and has been replaced by "stat_voucher"
@@ -26,1387 +26,1478 @@
  * with this package in the file LICENSE.md
  *
  */
-
-define('API_CLASS_VERSION', '1.0.9');
+define('API_CLASS_VERSION', '1.0.10');
 
 class unifiapi {
-   public $user        = '';
-   public $password    = '';
-   public $site        = 'default';
-   public $baseurl     = 'https://127.0.0.1:8443';
-   public $version     = '4.8.20';
-   public $is_loggedin = FALSE;
-   private $cookies    = '/tmp/unifi_browser';
-   public $debug       = FALSE;
-
-   function __construct($user = '', $password = '', $baseurl = '', $site = '', $version = '') {
-      if (!empty($user)) $this->user         = $user;
-      if (!empty($password)) $this->password = $password;
-      if (!empty($baseurl)) $this->baseurl   = $baseurl;
-      if (!empty($site)) $this->site         = $site;
-      if (!empty($version)) $this->version   = $version;
-   }
-
-   function __destruct() {
-      if ($this->is_loggedin) {
-         $this->logout();
-      }
-   }
-
-   /**
-    * Login to UniFi Controller
-    */
-   public function login() {
-      $this->cookies = '';
-
-      $ch = $this->get_curl_obj();
-
-      curl_setopt($ch, CURLOPT_HEADER, 1);
-      curl_setopt($ch, CURLOPT_REFERER, $this->baseurl.'/login');
-      curl_setopt($ch, CURLOPT_URL, $this->baseurl.'/api/login');
-      curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(array('username' => $this->user, 'password' => $this->password)));
-
-      if ($this->debug === TRUE) {
-         curl_setopt($ch, CURLOPT_VERBOSE, TRUE);
-      }
-
-      if (($content = curl_exec($ch)) === FALSE) {
-         error_log('curl error: ' . curl_error($ch));
-      }
-
-      if ($this->debug === TRUE) {
-         print '<pre>';
-         print PHP_EOL.'-----------LOGIN-------------'.PHP_EOL;
-         print_r (curl_getinfo($ch));
-         print PHP_EOL.'----------RESPONSE-----------'.PHP_EOL;
-         print $content;
-         print PHP_EOL.'-----------------------------'.PHP_EOL;
-         print '</pre>';
-      }
-
-      $header_size = curl_getinfo($ch, CURLINFO_HEADER_SIZE);
-      $body        = trim(substr($content, $header_size));
-      $code        = curl_getinfo($ch, CURLINFO_HTTP_CODE);
-
-      curl_close ($ch);
-
-      preg_match_all('|Set-Cookie: (.*);|U', substr($content, 0, $header_size), $results);
-      if (isset($results[1])) {
-         $this->cookies = implode(';', $results[1]);
-         if (!empty($body)) {
-            if (($code >= 200) && ($code < 400)) {
-               if (strpos($this->cookies,'unifises') !== FALSE) {
-                  $this->is_loggedin = TRUE;
-               }
+    public  $user        = '';
+    public  $password    = '';
+    public  $site        = 'default';
+    public  $baseurl     = 'https://127.0.0.1:8443';
+    public  $version     = '4.8.20';
+    public  $is_loggedin = FALSE;
+    public  $debug       = TRUE;
+    private $cookies     = '';
+
+    function __construct($user = '', $password = '', $baseurl = '', $site = '', $version = '') {
+        if (!empty($user)) $this->user         = $user;
+        if (!empty($password)) $this->password = $password;
+        if (!empty($baseurl)) $this->baseurl   = $baseurl;
+        if (!empty($site)) $this->site         = $site;
+        if (!empty($version)) $this->version   = $version;
+    }
+
+    function __destruct() {
+        if ($this->is_loggedin) {
+            $this->logout();
+        }
+    }
+
+    /**
+     * Login to UniFi Controller
+     */
+    public function login() {
+        $this->cookies = '';
+
+        $ch = $this->get_curl_obj();
+
+        curl_setopt($ch, CURLOPT_HEADER, 1);
+        curl_setopt($ch, CURLOPT_REFERER, $this->baseurl.'/login');
+        curl_setopt($ch, CURLOPT_URL, $this->baseurl.'/api/login');
+        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(array('username' => $this->user, 'password' => $this->password)));
+
+        if ($this->debug === TRUE) {
+            curl_setopt($ch, CURLOPT_VERBOSE, TRUE);
+        }
+
+        if (($content = curl_exec($ch)) === FALSE) {
+            error_log('curl error: ' . curl_error($ch));
+        }
+
+        if ($this->debug === TRUE) {
+            print '<pre>';
+            print PHP_EOL.'-----------LOGIN-------------'.PHP_EOL;
+            print_r (curl_getinfo($ch));
+            print PHP_EOL.'----------RESPONSE-----------'.PHP_EOL;
+            print $content;
+            print PHP_EOL.'-----------------------------'.PHP_EOL;
+            print '</pre>';
+        }
+
+        $header_size = curl_getinfo($ch, CURLINFO_HEADER_SIZE);
+        $body        = trim(substr($content, $header_size));
+        $code        = curl_getinfo($ch, CURLINFO_HTTP_CODE);
+
+        curl_close ($ch);
+
+        preg_match_all('|Set-Cookie: (.*);|U', substr($content, 0, $header_size), $results);
+        if (isset($results[1])) {
+            $this->cookies = implode(';', $results[1]);
+            if (!empty($body)) {
+                if (($code >= 200) && ($code < 400)) {
+                    if (strpos($this->cookies,'unifises') !== FALSE) {
+                        $this->is_loggedin = TRUE;
+                    }
+                }
+                if ($code === 400) {
+                     error_log('we have received an HTTP response status: 400. Probably a controller login failure');
+                     return $code;
+                }
             }
-            if ($code === 400) {
-                error_log('we have received an HTTP response status: 400. Probably a controller login failure');
-                return $code;
+        }
+
+        return $this->is_loggedin;
+    }
+
+    /**
+     * Logout from UniFi Controller
+     */
+    public function logout() {
+        if (!$this->is_loggedin) return FALSE;
+        $content           = $this->exec_curl($this->baseurl.'/logout');
+        $this->is_loggedin = FALSE;
+        $this->cookies     = '';
+        return TRUE;
+    }
+
+    /**
+     * Authorize a client device
+     * -------------------------
+     * return TRUE on success
+     * required parameter <mac>     = client MAC address
+     * required parameter <minutes> = minutes (from now) until authorization expires
+     * optional parameter <up>      = upload speed limit in kbps
+     * optional parameter <down>    = download speed limit in kbps
+     * optional parameter <MBytes>  = data transfer limit in MB
+     * optional parameter <ap_mac>  = AP MAC address to which client is connected, should result in faster authorization
+     */
+    public function authorize_guest($mac, $minutes, $up = NULL, $down = NULL, $MBytes = NULL, $ap_mac = NULL) {
+        if (!$this->is_loggedin) return FALSE;
+        $mac    = strtolower($mac);
+        $return = FALSE;
+        $json   = array('cmd' => 'authorize-guest', 'mac' => $mac, 'minutes' => $minutes);
+
+        /**
+         * if we have received values for up/down/MBytes we append them to the payload array to be submitted
+         */
+        if (isset($up))     $json['up'] = $up;
+        if (isset($down))   $json['down'] = $down;
+        if (isset($MBytes)) $json['bytes'] = $MBytes;
+        if (isset($ap_mac)) $json['ap_mac'] = $ap_mac;
+        $json            = json_encode($json);
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/cmd/stamgr','json='.$json));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                $return = TRUE;
             }
-         }
-      }
-      return $this->is_loggedin;
-   }
-
-   /**
-    * Logout from UniFi Controller
-    */
-   public function logout() {
-      if (!$this->is_loggedin) return FALSE;
-      $content           = $this->exec_curl($this->baseurl.'/logout');
-      $this->is_loggedin = FALSE;
-      $this->cookies     = '';
-      return TRUE;
-   }
-
-   /**
-    * Authorize a client device
-    * -------------------------
-    * return TRUE on success
-    * required parameter <mac> = client MAC address
-    * required parameter <minutes> = minutes (from now) until authorization expires
-    * optional parameter <up> = upload speed limit in kbps
-    * optional parameter <down> = download speed limit in kbps
-    * optional parameter <MBytes> = data transfer limit in MB
-    * optional parameter <ap_mac> = AP MAC address to which client is connected, should result in faster authorization
-    */
-   public function authorize_guest($mac, $minutes, $up = NULL, $down = NULL, $MBytes = NULL, $ap_mac = NULL) {
-      if (!$this->is_loggedin) return FALSE;
-      $mac    = strtolower($mac);
-      $return = FALSE;
-      $json   = array('cmd' => 'authorize-guest', 'mac' => $mac, 'minutes' => $minutes);
-
-      /**
-       * if we have received values for up/down/MBytes we append them to the payload array to be submitted
-       */
-      if (isset($up))     $json['up'] = $up;
-      if (isset($down))   $json['down'] = $down;
-      if (isset($MBytes)) $json['bytes'] = $MBytes;
-      if (isset($ap_mac)) $json['ap_mac'] = $ap_mac;
-      $json            = json_encode($json);
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/cmd/stamgr','json='.$json));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            $return = TRUE;
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * Unauthorize a client device
-    * ---------------------------
-    * return TRUE on success
-    * required parameter <mac> = client MAC address
-    */
-   public function unauthorize_guest($mac) {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = FALSE;
-      $mac             = strtolower($mac);
-      $json            = json_encode(array('cmd' => 'unauthorize-guest', 'mac' => $mac));
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/cmd/stamgr','json='.$json));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            $return = TRUE;
-         }
-      }
-      return $return;
+        }
+
+        return $return;
     }
 
-   /**
-    * Reconnect a client device
-    * -------------------------
-    * return TRUE on success
-    * required parameter <mac> = client MAC address
-    */
-   public function reconnect_sta($mac) {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = FALSE;
-      $mac             = strtolower($mac);
-      $json            = json_encode(array('cmd' => 'kick-sta', 'mac' => $mac));
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/cmd/stamgr','json='.$json));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            $return = TRUE;
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * Block a client device
-    * ---------------------
-    * return TRUE on success
-    * required parameter <mac> = client MAC address
-    */
-   public function block_sta($mac) {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = FALSE;
-      $mac             = strtolower($mac);
-      $json            = json_encode(array('cmd' => 'block-sta', 'mac' => $mac));
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/cmd/stamgr','json='.$json));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            $return = TRUE;
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * Unblock a client device
-    * -----------------------
-    * return TRUE on success
-    * required parameter <mac> = client MAC address
-    */
-   public function unblock_sta($mac) {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = FALSE;
-      $mac             = strtolower($mac);
-      $json            = json_encode(array('cmd' => 'unblock-sta', 'mac' => $mac));
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/cmd/stamgr','json='.$json));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            $return = TRUE;
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * Add/modify a client device note
-    * -------------------------------
-    * return TRUE on success
-    * required parameter <user_id> = id of the user device to be modified
-    * optional parameter <note> = note to be applied to the user device
-    *
-    * NOTES:
-    * - when note is empty or not set, the existing note for the user will be removed and "noted" attribute set to FALSE
-    */
-   public function set_sta_note($user_id, $note = NULL) {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = FALSE;
-      $noted           = (is_null($note)) || (empty($note)) ? FALSE : TRUE;
-      $json            = json_encode(array('note' => $note, 'noted' => $noted));
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/upd/user/'.$user_id,'json='.$json));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            $return = TRUE;
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * Add/modify a client device name
-    * -------------------------------
-    * return TRUE on success
-    * required parameter <user_id> = id of the user device to be modified
-    * optional parameter <name> = name to be applied to the user device
-    *
-    * NOTES:
-    * - when name is empty or not set, the existing name for the user will be removed
-    */
-   public function set_sta_name($user_id, $name = NULL) {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = FALSE;
-      $json            = json_encode(array('name' => $name));
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/upd/user/'.$user_id,'json='.$json));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            $return = TRUE;
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * Daily stats method
-    * ------------------
-    * returns an array of daily stats objects
-    * optional parameter <start> = Unix timestamp in seconds
-    * optional parameter <end> = Unix timestamp in seconds
-    *
-    * NOTES:
-    * - defaults to the past 52*7*24 hours
-    * - bytes" are no longer returned with controller version 4.9.1 and later
-    */
-   public function stat_daily_site($start = NULL, $end = NULL) {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $end             = is_null($end) ? ((time()-(time() % 3600))*1000) : $end;
-      $start           = is_null($start) ? $end-(52*7*24*3600*1000) : $start;
-      $json            = json_encode(array('attrs' => array('bytes', 'wan-tx_bytes', 'wan-rx_bytes', 'wlan_bytes', 'num_sta', 'lan-num_sta', 'wlan-num_sta', 'time'), 'start' => $start, 'end' => $end));
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/report/daily.site','json='.$json));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $test) {
-                  $return[]= $test;
-               }
+    /**
+     * Unauthorize a client device
+     * ---------------------------
+     * return TRUE on success
+     * required parameter <mac> = client MAC address
+     */
+    public function unauthorize_guest($mac) {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = FALSE;
+        $mac             = strtolower($mac);
+        $json            = json_encode(array('cmd' => 'unauthorize-guest', 'mac' => $mac));
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/cmd/stamgr','json='.$json));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                $return = TRUE;
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * Hourly stats method for a site
-    * ------------------------------
-    * returns an array of hourly stats objects
-    * optional parameter <start> = Unix timestamp in seconds
-    * optional parameter <end> = Unix timestamp in seconds
-    *
-    * NOTES:
-    * - defaults to the past 7*24 hours
-    * - "bytes" are no longer returned with controller version 4.9.1 and later
-    */
-   public function stat_hourly_site($start = NULL, $end = NULL) {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $end             = is_null($end) ? ((time())*1000) : $end;
-      $start           = is_null($start) ? $end-(7*24*3600*1000) : $start;
-      $json            = json_encode(array('attrs' => array('bytes', 'wan-tx_bytes', 'wan-rx_bytes', 'wlan_bytes', 'num_sta', 'lan-num_sta', 'wlan-num_sta', 'time'), 'start' => $start, 'end' => $end));
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/report/hourly.site','json='.$json));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $test) {
-                  $return[]= $test;
-               }
+        }
+
+        return $return;
+     }
+
+    /**
+     * Reconnect a client device
+     * -------------------------
+     * return TRUE on success
+     * required parameter <mac> = client MAC address
+     */
+    public function reconnect_sta($mac) {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = FALSE;
+        $mac             = strtolower($mac);
+        $json            = json_encode(array('cmd' => 'kick-sta', 'mac' => $mac));
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/cmd/stamgr','json='.$json));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                $return = TRUE;
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * Hourly stats method for all access points
-    * -----------------------------------------
-    * returns an array of hourly stats objects
-    * optional parameter <start> = Unix timestamp in seconds
-    * optional parameter <end> = Unix timestamp in seconds
-    *
-    * NOTES:
-    * - defaults to the past 7*24 hours
-    * - UniFi controller does not keep these stats longer than 5 hours with versions < 4.6.6
-    */
-   public function stat_hourly_aps($start = NULL, $end = NULL) {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $end             = is_null($end) ? ((time())*1000) : $end;
-      $start           = is_null($start) ? $end-(7*24*3600*1000) : $start;
-      $json            = json_encode(array('attrs' => array('bytes', 'num_sta', 'time'), 'start' => $start, 'end' => $end));
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/report/hourly.ap','json='.$json));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $test) {
-                  $return[]= $test;
-               }
+        }
+
+        return $return;
+    }
+
+    /**
+     * Block a client device
+     * ---------------------
+     * return TRUE on success
+     * required parameter <mac> = client MAC address
+     */
+    public function block_sta($mac) {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = FALSE;
+        $mac             = strtolower($mac);
+        $json            = json_encode(array('cmd' => 'block-sta', 'mac' => $mac));
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/cmd/stamgr','json='.$json));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                $return = TRUE;
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * Show all login sessions
-    * -----------------------
-    * returns an array of login session objects for all devices
-    * optional parameter <start> = Unix timestamp in seconds
-    * optional parameter <end> = Unix timestamp in seconds
-    * optional parameter <mac> = client MAC address to return sessions for (can only be used when start and end are also provided)
-    *
-    * NOTES:
-    * - defaults to the past 7*24 hours
-    */
-   public function stat_sessions($start = NULL, $end = NULL, $mac = NULL) {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $end             = is_null($end) ? time() : $end;
-      $start           = is_null($start) ? $end-(7*24*3600) : $start;
-      $json            = array('type'=> 'all', 'start' => $start, 'end' => $end);
-      if (!is_null($mac)) $json['mac'] = $mac;
-      $json            = json_encode($json);
-      error_log($json);
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/session','json='.$json));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $session) {
-                  $return[]= $session;
-               }
+        }
+
+        return $return;
+    }
+
+    /**
+     * Unblock a client device
+     * -----------------------
+     * return TRUE on success
+     * required parameter <mac> = client MAC address
+     */
+    public function unblock_sta($mac) {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = FALSE;
+        $mac             = strtolower($mac);
+        $json            = json_encode(array('cmd' => 'unblock-sta', 'mac' => $mac));
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/cmd/stamgr','json='.$json));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                $return = TRUE;
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * Show latest 'n' login sessions for a single device
-    * --------------------------------------------------
-    * returns an array of latest login session objects for given client device
-    * required parameter <mac> = client MAC address
-    * optional parameter <limit> = maximum number of sessions to get (defaults to 5)
-    */
-   public function stat_sta_sessions_latest($mac, $limit = NULL) {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $limit           = is_null($limit) ? 5 : $limit;
-      $json            = json_encode(array('mac' => $mac, '_limit' => $limit, '_sort'=> '-assoc_time'));
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/session','json='.$json));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $session) {
-                  $return[]= $session;
-               }
+        }
+
+        return $return;
+    }
+
+    /**
+     * Add/modify a client device note
+     * -------------------------------
+     * return TRUE on success
+     * required parameter <user_id> = id of the user device to be modified
+     * optional parameter <note>    = note to be applied to the user device
+     *
+     * NOTES:
+     * - when note is empty or not set, the existing note for the user will be removed and "noted" attribute set to FALSE
+     */
+    public function set_sta_note($user_id, $note = NULL) {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = FALSE;
+        $noted           = (is_null($note)) || (empty($note)) ? FALSE : TRUE;
+        $json            = json_encode(array('note' => $note, 'noted' => $noted));
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/upd/user/'.$user_id,'json='.$json));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                $return = TRUE;
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * Show all authorizations
-    * -----------------------
-    * returns an array of authorization objects
-    * optional parameter <start> = Unix timestamp in seconds
-    * optional parameter <end> = Unix timestamp in seconds
-    *
-    * NOTES:
-    * - defaults to the past 7*24 hours
-    */
-   public function stat_auths($start = NULL, $end = NULL) {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $end             = is_null($end) ? time() : $end;
-      $start           = is_null($start) ? $end-(7*24*3600) : $start;
-      $json            = json_encode(array('start' => $start, 'end' => $end));
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/authorization','json='.$json));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $auth) {
-                  $return[]= $auth;
-               }
+        }
+
+        return $return;
+    }
+
+    /**
+     * Add/modify a client device name
+     * -------------------------------
+     * return TRUE on success
+     * required parameter <user_id> = id of the user device to be modified
+     * optional parameter <name>    = name to be applied to the user device
+     *
+     * NOTES:
+     * - when name is empty or not set, the existing name for the user will be removed
+     */
+    public function set_sta_name($user_id, $name = NULL) {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = FALSE;
+        $json            = json_encode(array('name' => $name));
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/upd/user/'.$user_id,'json='.$json));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                $return = TRUE;
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * List all client devices ever connected to the site
-    * --------------------------------------------------
-    * returns an array of client device objects
-    * optional parameter <historyhours> = hours to go back (default is 8760 hours or 1 year)
-    *
-    * NOTES:
-    * - <historyhours> is only used to select clients that were online within that period,
-    *   the returned stats per client are all-time totals, irrespective of the value of <historyhours>
-    */
-   public function stat_allusers($historyhours = 8760) {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $json            = json_encode(array('type' => 'all', 'conn' => 'all', 'within' => $historyhours));
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/alluser','json='.$json));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $stats) {
-                  $return[]= $stats;
-               }
+        }
+
+        return $return;
+    }
+
+    /**
+     * Daily stats method
+     * ------------------
+     * returns an array of daily stats objects
+     * optional parameter <start> = Unix timestamp in seconds
+     * optional parameter <end>   = Unix timestamp in seconds
+     *
+     * NOTES:
+     * - defaults to the past 52*7*24 hours
+     * - bytes" are no longer returned with controller version 4.9.1 and later
+     */
+    public function stat_daily_site($start = NULL, $end = NULL) {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = array();
+        $end             = is_null($end) ? ((time()-(time() % 3600))*1000) : $end;
+        $start           = is_null($start) ? $end-(52*7*24*3600*1000) : $start;
+        $json            = json_encode(array('attrs' => array('bytes', 'wan-tx_bytes', 'wan-rx_bytes', 'wlan_bytes', 'num_sta', 'lan-num_sta', 'wlan-num_sta', 'time'), 'start' => $start, 'end' => $end));
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/report/daily.site','json='.$json));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $test) {
+                        $return[]= $test;
+                    }
+                }
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * List guest devices
-    * ------------------
-    * returns an array of guest device objects with valid access
-    * optional parameter <within> = time frame in hours to go back to list guests with valid access (default = 24*365 hours)
-    */
-   public function list_guests($within = 8760) {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $json            = json_encode(array('within' => $within));
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/guest','json='.$json));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $guest) {
-                  $return[]= $guest;
-               }
+        }
+
+        return $return;
+    }
+
+    /**
+     * Hourly stats method for a site
+     * ------------------------------
+     * returns an array of hourly stats objects
+     * optional parameter <start> = Unix timestamp in seconds
+     * optional parameter <end>   = Unix timestamp in seconds
+     *
+     * NOTES:
+     * - defaults to the past 7*24 hours
+     * - "bytes" are no longer returned with controller version 4.9.1 and later
+     */
+    public function stat_hourly_site($start = NULL, $end = NULL) {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = array();
+        $end             = is_null($end) ? ((time())*1000) : $end;
+        $start           = is_null($start) ? $end-(7*24*3600*1000) : $start;
+        $json            = json_encode(array('attrs' => array('bytes', 'wan-tx_bytes', 'wan-rx_bytes', 'wlan_bytes', 'num_sta', 'lan-num_sta', 'wlan-num_sta', 'time'), 'start' => $start, 'end' => $end));
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/report/hourly.site','json='.$json));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $test) {
+                        $return[]= $test;
+                    }
+                }
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * List client devices
-    * -------------------
-    * returns an array of client device objects
-    */
-   public function list_clients() {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/sta'));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $client) {
-                  $return[]= $client;
-               }
+        }
+
+        return $return;
+    }
+
+    /**
+     * Hourly stats method for all access points
+     * -----------------------------------------
+     * returns an array of hourly stats objects
+     * optional parameter <start> = Unix timestamp in seconds
+     * optional parameter <end>   = Unix timestamp in seconds
+     *
+     * NOTES:
+     * - defaults to the past 7*24 hours
+     * - UniFi controller does not keep these stats longer than 5 hours with versions < 4.6.6
+     */
+    public function stat_hourly_aps($start = NULL, $end = NULL) {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = array();
+        $end             = is_null($end) ? ((time())*1000) : $end;
+        $start           = is_null($start) ? $end-(7*24*3600*1000) : $start;
+        $json            = json_encode(array('attrs' => array('bytes', 'num_sta', 'time'), 'start' => $start, 'end' => $end));
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/report/hourly.ap','json='.$json));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $test) {
+                        $return[]= $test;
+                    }
+                }
+            }
+        }
+
+        return $return;
+    }
+
+    /**
+     * Show all login sessions
+     * -----------------------
+     * returns an array of login session objects for all devices
+     * optional parameter <start> = Unix timestamp in seconds
+     * optional parameter <end>   = Unix timestamp in seconds
+     * optional parameter <mac>   = client MAC address to return sessions for (can only be used when start and end are also provided)
+     *
+     * NOTES:
+     * - defaults to the past 7*24 hours
+     */
+    public function stat_sessions($start = NULL, $end = NULL, $mac = NULL) {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = array();
+        $end             = is_null($end) ? time() : $end;
+        $start           = is_null($start) ? $end-(7*24*3600) : $start;
+        $json            = array('type'=> 'all', 'start' => $start, 'end' => $end);
+        if (!is_null($mac)) $json['mac'] = $mac;
+        $json            = json_encode($json);
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/session','json='.$json));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $session) {
+                        $return[]= $session;
+                    }
+                }
+            }
+        }
+
+        return $return;
+    }
+
+    /**
+     * Show latest 'n' login sessions for a single device
+     * --------------------------------------------------
+     * returns an array of latest login session objects for given client device
+     * required parameter <mac>   = client MAC address
+     * optional parameter <limit> = maximum number of sessions to get (defaults to 5)
+     */
+    public function stat_sta_sessions_latest($mac, $limit = NULL) {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = array();
+        $limit           = is_null($limit) ? 5 : $limit;
+        $json            = json_encode(array('mac' => $mac, '_limit' => $limit, '_sort'=> '-assoc_time'));
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/session','json='.$json));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $session) {
+                        $return[]= $session;
+                    }
+                }
+            }
+        }
+
+        return $return;
+    }
+
+    /**
+     * Show all authorizations
+     * -----------------------
+     * returns an array of authorization objects
+     * optional parameter <start> = Unix timestamp in seconds
+     * optional parameter <end>   = Unix timestamp in seconds
+     *
+     * NOTES:
+     * - defaults to the past 7*24 hours
+     */
+    public function stat_auths($start = NULL, $end = NULL) {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = array();
+        $end             = is_null($end) ? time() : $end;
+        $start           = is_null($start) ? $end-(7*24*3600) : $start;
+        $json            = json_encode(array('start' => $start, 'end' => $end));
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/authorization','json='.$json));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $auth) {
+                        $return[]= $auth;
+                    }
+                }
+            }
+        }
+
+        return $return;
+    }
+
+    /**
+     * List all client devices ever connected to the site
+     * --------------------------------------------------
+     * returns an array of client device objects
+     * optional parameter <historyhours> = hours to go back (default is 8760 hours or 1 year)
+     *
+     * NOTES:
+     * - <historyhours> is only used to select clients that were online within that period,
+     *    the returned stats per client are all-time totals, irrespective of the value of <historyhours>
+     */
+    public function stat_allusers($historyhours = 8760) {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = array();
+        $json            = json_encode(array('type' => 'all', 'conn' => 'all', 'within' => $historyhours));
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/alluser','json='.$json));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $stats) {
+                        $return[]= $stats;
+                    }
+                }
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * Get data for a single client device
-    * -----------------------------------
-    * returns an object with the client device information
-    * required parameter <client_mac>
-    */
-   public function stat_client($client_mac) {
-      if (!$this->is_loggedin) return FALSE;
-      $return           = FALSE;
+        }
+
+        return $return;
+    }
+
+    /**
+     * List guest devices
+     * ------------------
+     * returns an array of guest device objects with valid access
+     * optional parameter <within> = time frame in hours to go back to list guests with valid access (default = 24*365 hours)
+     */
+    public function list_guests($within = 8760) {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = array();
+        $json            = json_encode(array('within' => $within));
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/guest','json='.$json));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $guest) {
+                        $return[]= $guest;
+                    }
+                }
+            }
+        }
+
+        return $return;
+    }
+
+    /**
+     * List client devices
+     * -------------------
+     * returns an array of client device objects
+     */
+    public function list_clients() {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = array();
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/sta'));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $client) {
+                        $return[]= $client;
+                    }
+                }
+            }
+        }
+
+        return $return;
+    }
+
+    /**
+     * Get data for a single client device
+     * -----------------------------------
+     * returns an object with the client device information
+     * required parameter <client_mac> = client MAC address
+     */
+    public function stat_client($client_mac) {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = FALSE;
 	    $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/user/'.$client_mac));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $client) {
-                  $return[]= $client;
-               }
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $client) {
+                        $return[]= $client;
+                    }
+                }
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * List user groups
-    * ----------------
-    * returns an array of user group objects
-    */
-   public function list_usergroups() {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/list/usergroup'));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $usergroup) {
-                  $return[]= $usergroup;
-               }
+        }
+
+        return $return;
+    }
+
+    /**
+     * List user groups
+     * ----------------
+     * returns an array of user group objects
+     */
+    public function list_usergroups() {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = array();
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/list/usergroup'));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $usergroup) {
+                        $return[]= $usergroup;
+                    }
+                }
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * Assign user device to another group
-    * -----------------------------------
-    * return TRUE on success
-    * required parameter <user_id> = id of the user device to be modified
-    * required parameter <group_id> = id of the user group to assign user to
-    */
-   public function set_usergroup($user_id, $group_id) {
-      if (!$this->is_loggedin) return FALSE;
-      $return           = FALSE;
-      $json             = json_encode(array('usergroup_id' => $group_id));
+        }
+
+        return $return;
+    }
+
+    /**
+     * Assign user device to another group
+     * -----------------------------------
+     * return TRUE on success
+     * required parameter <user_id>  = id of the user device to be modified
+     * required parameter <group_id> = id of the user group to assign user to
+     */
+    public function set_usergroup($user_id, $group_id) {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = FALSE;
+        $json            = json_encode(array('usergroup_id' => $group_id));
 	    $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/upd/user/'.$user_id,'json='.$json));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            $return = TRUE;
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * List health metrics
-    * -------------------
-    * returns an array of health metric objects
-    */
-   public function list_health() {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/health'));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $health) {
-                  $return[]= $health;
-               }
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                $return = TRUE;
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * List dashboard metrics
-    * ----------------------
-    * returns an array of dashboard metric objects (available since controller version 4.9.1.alpha)
-    */
-   public function list_dashboard() {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/dashboard'));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $dashboard) {
-                  $return[]= $dashboard;
-               }
+        }
+
+        return $return;
+    }
+
+    /**
+     * List health metrics
+     * -------------------
+     * returns an array of health metric objects
+     */
+    public function list_health() {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = array();
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/health'));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $health) {
+                        $return[]= $health;
+                    }
+                }
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * List user devices
-    * -----------------
-    * returns an array of known user device objects
-    */
-   public function list_users() {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/list/user'));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $user) {
-                  $return[]= $user;
-               }
+        }
+
+        return $return;
+    }
+
+    /**
+     * List dashboard metrics
+     * ----------------------
+     * returns an array of dashboard metric objects (available since controller version 4.9.1.alpha)
+     */
+    public function list_dashboard() {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = array();
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/dashboard'));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $dashboard) {
+                        $return[]= $dashboard;
+                    }
+                }
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * List access points and other devices under management of the controller (USW and/or USG devices)
-    * ------------------------------------------------------------------------------------------------
-    * returns an array of known device objects (or a single device when using the <device_mac> parameter)
-    * optional parameter <device_mac> = the MAC address of a single device for which the call must be made
-    */
-   public function list_aps($device_mac = NULL) {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/device/'.$device_mac));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $ap) {
-                  $return[]= $ap;
-               }
+        }
+
+        return $return;
+    }
+
+    /**
+     * List user devices
+     * -----------------
+     * returns an array of known user device objects
+     */
+    public function list_users() {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = array();
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/list/user'));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $user) {
+                        $return[]= $user;
+                    }
+                }
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * List rogue access points
-    * ------------------------
-    * returns an array of known rogue access point objects
-    * optional parameter <within> = hours to go back to list discovered "rogue" access points (default = 24 hours)
-    */
-   public function list_rogueaps($within = '24') {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $json            = json_encode(array('within' => $within));
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/rogueap','json='.$json));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $rogue) {
-                  $return[]= $rogue;
-               }
+        }
+
+        return $return;
+    }
+
+    /**
+     * List access points and other devices under management of the controller (USW and/or USG devices)
+     * ------------------------------------------------------------------------------------------------
+     * returns an array of known device objects (or a single device when using the <device_mac> parameter)
+     * optional parameter <device_mac> = the MAC address of a single device for which the call must be made
+     */
+    public function list_aps($device_mac = NULL) {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = array();
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/device/'.$device_mac));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $ap) {
+                        $return[]= $ap;
+                    }
+                }
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * List sites
-    * ----------
-    * returns a list sites hosted on this controller with some details
-    */
-   public function list_sites() {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/self/sites'));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $site) {
-                  $return[]= $site;
-               }
+        }
+
+        return $return;
+    }
+
+    /**
+     * List rogue access points
+     * ------------------------
+     * returns an array of known rogue access point objects
+     * optional parameter <within> = hours to go back to list discovered "rogue" access points (default = 24 hours)
+     */
+    public function list_rogueaps($within = '24') {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = array();
+        $json            = json_encode(array('within' => $within));
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/rogueap','json='.$json));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $rogue) {
+                        $return[]= $rogue;
+                    }
+                }
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * List sites stats
-    * ----------------
-    * returns statistics for all sites hosted on this controller
-    * NOTE: this endpoint was introduced with controller version 5.2.9
-    */
-   public function stat_sites() {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/stat/sites'));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $site) {
-                  $return[]= $site;
-               }
+        }
+
+        return $return;
+    }
+
+    /**
+     * List sites
+     * ----------
+     * returns a list sites hosted on this controller with some details
+     */
+    public function list_sites() {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = array();
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/self/sites'));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $site) {
+                        $return[]= $site;
+                    }
+                }
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * Add a site
-    * ----------
-    * returns an array containing a single object with attributes of the new site ("_id", "desc", "name") on success
-    * required parameter <description> = the long name for the new site
-    * NOTE: immediately after being added, the new site will be available in the output of the "list_sites" function
-    */
-   public function add_site($description) {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = FALSE;
-      $json            = json_encode(array('desc' => $description, 'cmd' => 'add-site'));
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/cmd/sitemgr','json='.$json));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $site) {
-                  $return[]= $site;
-               }
+        }
+
+        return $return;
+    }
+
+    /**
+     * List sites stats
+     * ----------------
+     * returns statistics for all sites hosted on this controller
+     * NOTE: this endpoint was introduced with controller version 5.2.9
+     */
+    public function stat_sites() {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = array();
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/stat/sites'));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $site) {
+                        $return[]= $site;
+                    }
+                }
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * List wlan_groups
-    * ----------------
-    * returns an array of known wlan_groups
-    */
-   public function list_wlan_groups() {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/list/wlangroup'));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $wlan_group) {
-                  $return[]= $wlan_group;
-               }
+        }
+
+        return $return;
+    }
+
+    /**
+     * Add a site
+     * ----------
+     * returns an array containing a single object with attributes of the new site ("_id", "desc", "name") on success
+     * required parameter <description> = the long name for the new site
+     * NOTE: immediately after being added, the new site will be available in the output of the "list_sites" function
+     */
+    public function add_site($description) {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = FALSE;
+        $json            = json_encode(array('desc' => $description, 'cmd' => 'add-site'));
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/cmd/sitemgr','json='.$json));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $site) {
+                        $return[]= $site;
+                    }
+                }
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * List sysinfo
-    * ------------
-    * returns an array of known sysinfo data
-    */
-   public function stat_sysinfo() {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/sysinfo'));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $sysinfo) {
-                  $return[]= $sysinfo;
-               }
+        }
+
+        return $return;
+    }
+
+    /**
+     * List wlan_groups
+     * ----------------
+     * returns an array of known wlan_groups
+     */
+    public function list_wlan_groups() {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = array();
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/list/wlangroup'));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $wlan_group) {
+                        $return[]= $wlan_group;
+                    }
+                }
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * List self
-    * ---------
-    * returns an array of information about the logged in user
-    */
-   public function list_self() {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/self'));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $selfinfo) {
-                  $return[]= $selfinfo;
-               }
+        }
+
+        return $return;
+    }
+
+    /**
+     * List sysinfo
+     * ------------
+     * returns an array of known sysinfo data
+     */
+    public function stat_sysinfo() {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = array();
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/sysinfo'));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $sysinfo) {
+                        $return[]= $sysinfo;
+                    }
+                }
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * List networkconf
-    * ----------------
-    * returns an array of network configuration data
-    */
-   public function list_networkconf() {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/list/networkconf'));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $networkconf) {
-                  $return[]= $networkconf;
-               }
+        }
+
+        return $return;
+    }
+
+    /**
+     * List self
+     * ---------
+     * returns an array of information about the logged in user
+     */
+    public function list_self() {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = array();
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/self'));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $selfinfo) {
+                        $return[]= $selfinfo;
+                    }
+                }
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * List vouchers
-    * -------------
-    * returns an array of hotspot voucher objects
-    * optional parameter <create_time> = Unix timestamp in seconds
-    */
-   public function stat_voucher($create_time = NULL) {
-      if (!$this->is_loggedin) return FALSE;
-      $return = array();
-      $json   = json_encode(array());
-      if (trim($create_time) != NULL) {
-        $json=json_encode(array('create_time' => $create_time));
-      }
-      $content_decoded  = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/voucher','json='.$json));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $voucher) {
-                  $return[]= $voucher;
-               }
+        }
+
+        return $return;
+    }
+
+    /**
+     * List networkconf
+     * ----------------
+     * returns an array of network configuration data
+     */
+    public function list_networkconf() {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = array();
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/list/networkconf'));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $networkconf) {
+                        $return[]= $networkconf;
+                    }
+                }
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * List payments
-    * -------------
-    * returns an array of hotspot payments
-    */
-   public function stat_payment() {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/payment'));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $payment) {
-                  $return[]= $payment;
-               }
+        }
+
+        return $return;
+    }
+
+    /**
+     * List vouchers
+     * -------------
+     * returns an array of hotspot voucher objects
+     * optional parameter <create_time> = Unix timestamp in seconds
+     */
+    public function stat_voucher($create_time = NULL) {
+        if (!$this->is_loggedin) return FALSE;
+        $return = array();
+        if (trim($create_time) != NULL) {
+            $json = json_encode(array('create_time' => $create_time));
+        } else {
+            $json = json_encode(array());
+        }
+
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/voucher','json='.$json));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $voucher) {
+                        $return[]= $voucher;
+                    }
+                }
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * List hotspot operators
-    * ----------------------
-    * returns an array of hotspot operators
-    */
-   public function list_hotspotop() {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/list/hotspotop'));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $hotspotop) {
-                  $return[]= $hotspotop;
-               }
+        }
+
+        return $return;
+    }
+
+    /**
+     * List payments
+     * -------------
+     * returns an array of hotspot payments
+     * optional parameter <within> = number of hours to go back to fetch payments
+     */
+    public function stat_payment($within = NULL) {
+        if (!$this->is_loggedin) return FALSE;
+        $return = array();
+        if ($within != NULL) {
+          $url_suffix = '?within='.$within;
+        } else {
+          $url_suffix = '';
+        }
+
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/payment'.$url_suffix));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $payment) {
+                        $return[]= $payment;
+                    }
+                }
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * Create voucher(s)
-    * -----------------
-    * returns an array of voucher codes (NOTE: without the "-" in the middle) by calling the stat_voucher method
-    * required parameter <minutes> = minutes the voucher is valid after activation
-    * optional parameter <number_of_vouchers_to_create> = number of vouchers to create, default value is 1
-    * optional parameter <quota> = single-use or multi-use vouchers, string value '0' is for multi-use, '1' is for single-use
-    * optional parameter <note> = note text to add to voucher when printing
-    * optional parameter <up> = upload speed limit in kbps
-    * optional parameter <down> = download speed limit in kbps
-    * optional parameter <MBytes> = data transfer limit in MB
-    */
-   public function create_voucher($minutes, $number_of_vouchers_to_create = 1, $quota = '0', $note = NULL, $up = NULL, $down = NULL, $MBytes = NULL) {
-      if (!$this->is_loggedin) return FALSE;
-      $return = array();
-      $json   = array('cmd' => 'create-voucher', 'expire' => $minutes, 'n' => $number_of_vouchers_to_create, 'quota' => $quota);
-      /**
-       * if we have received values for note/up/down/MBytes we append them to the payload array to be submitted
-       */
-      if (isset($note))   $json['note'] = trim($note);
-      if (isset($up))     $json['up'] = $up;
-      if (isset($down))   $json['down'] = $down;
-      if (isset($MBytes)) $json['bytes'] = $MBytes;
-      $json            = json_encode($json);
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/cmd/hotspot','json='.$json));
-      if ($content_decoded->meta->rc == 'ok') {
-         if (is_array($content_decoded->data)) {
-            $obj = $content_decoded->data[0];
-            foreach ($this->stat_voucher($obj->create_time) as $voucher)  {
-               $return[]= $voucher->code;
+        }
+
+        return $return;
+    }
+
+    /**
+     * Create hotspot operator
+     * -----------------------
+     * return TRUE upon success
+     * required parameter <name>       = name for the hotspot operator
+     * required parameter <x_password> = clear text password for the hotspot operator
+     * optional parameter <note>       = note to attach to the hotspot operator
+     */
+    public function create_hotspotop($name, $x_password, $note = NULL) {
+        if (!$this->is_loggedin) return FALSE;
+        $return = FALSE;
+        $json   = array('name' => $name, 'x_password' => $x_password);
+        /**
+         * if we have received a value for note, we append it to the payload array to be submitted
+         */
+        if (isset($note)) $json['note'] = trim($note);
+        $json            = json_encode($json);
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/rest/hotspotop','json='.$json));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                $return = TRUE;
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * Revoke voucher
-    * --------------
-    * return TRUE on success
-    * required parameter <voucher_id> = _id of the voucher to revoke
-    */
-   public function revoke_voucher($voucher_id) {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = FALSE;
-      $json            = json_encode(array('_id' => $voucher_id, 'cmd' => 'delete-voucher'));
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/cmd/hotspot','json='.$json));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            $return = TRUE;
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * List port forwarding stats
-    * --------------------------
-    * returns an array of port forwarding stats
-    */
-   public function list_portforward_stats() {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/portforward'));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $portforward) {
-                  $return[]= $portforward;
-               }
+        }
+
+        return $return;
+    }
+
+    /**
+     * List hotspot operators
+     * ----------------------
+     * returns an array of hotspot operators
+     */
+    public function list_hotspotop() {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = array();
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/list/hotspotop'));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $hotspotop) {
+                        $return[]= $hotspotop;
+                    }
+                }
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * List port forwarding settings
-    * -----------------------------
-    * returns an array of port forwarding settings
-    */
-   public function list_portforwarding() {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/list/portforward'));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
+        }
+
+        return $return;
+    }
+
+    /**
+     * Create voucher(s)
+     * -----------------
+     * returns an array of voucher codes (NOTE: without the "-" in the middle) by calling the stat_voucher method
+     * required parameter <minutes> = minutes the voucher is valid after activation
+     * optional parameter <count>   = number of vouchers to create, default value is 1
+     * optional parameter <quota>   = single-use or multi-use vouchers, string value '0' is for multi-use, '1' is for single-use
+     * optional parameter <note>    = note text to add to voucher when printing
+     * optional parameter <up>      = upload speed limit in kbps
+     * optional parameter <down>    = download speed limit in kbps
+     * optional parameter <MBytes>  = data transfer limit in MB
+     */
+    public function create_voucher($minutes, $count = 1, $quota = '0', $note = NULL, $up = NULL, $down = NULL, $MBytes = NULL) {
+        if (!$this->is_loggedin) return FALSE;
+        $return = array();
+        $json   = array('cmd' => 'create-voucher', 'expire' => $minutes, 'n' => $count, 'quota' => $quota);
+        /**
+         * if we have received values for note/up/down/MBytes we append them to the payload array to be submitted
+         */
+        if (isset($note))    $json['note'] = trim($note);
+        if (isset($up))      $json['up'] = $up;
+        if (isset($down))    $json['down'] = $down;
+        if (isset($MBytes))  $json['bytes'] = $MBytes;
+        $json            = json_encode($json);
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/cmd/hotspot','json='.$json));
+        if ($content_decoded->meta->rc == 'ok') {
             if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $portforward) {
-                  $return[]= $portforward;
-               }
+                $obj = $content_decoded->data[0];
+                foreach ($this->stat_voucher($obj->create_time) as $voucher)  {
+                    $return[]= $voucher->code;
+                }
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * List dynamic DNS settings
-    * -------------------------
-    * returns an array of dynamic DNS settings
-    */
-   public function list_dynamicdns() {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/list/dynamicdns'));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $dynamicdns) {
-                  $return[]= $dynamicdns;
-               }
+        }
+
+        return $return;
+    }
+
+    /**
+     * Revoke voucher
+     * --------------
+     * return TRUE on success
+     * required parameter <voucher_id> = _id of the voucher to revoke
+     */
+    public function revoke_voucher($voucher_id) {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = FALSE;
+        $json            = json_encode(array('_id' => $voucher_id, 'cmd' => 'delete-voucher'));
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/cmd/hotspot','json='.$json));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                $return = TRUE;
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * List port configuration
-    * -----------------------
-    * returns an array of port configurations
-    */
-   public function list_portconf() {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/list/portconf'));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $portconf) {
-                  $return[]= $portconf;
-               }
+        }
+
+        return $return;
+    }
+
+    /**
+     * List port forwarding stats
+     * --------------------------
+     * returns an array of port forwarding stats
+     */
+    public function list_portforward_stats() {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = array();
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/portforward'));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $portforward) {
+                        $return[]= $portforward;
+                    }
+                }
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * List VoIP extensions
-    * --------------------
-    * returns an array of VoIP extensions
-    */
-   public function list_extension() {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/list/extension'));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $extension) {
-                  $return[]= $extension;
-               }
+        }
+
+        return $return;
+    }
+
+    /**
+     * List port forwarding settings
+     * -----------------------------
+     * returns an array of port forwarding settings
+     */
+    public function list_portforwarding() {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = array();
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/list/portforward'));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $portforward) {
+                        $return[]= $portforward;
+                    }
+                }
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * List site settings
-    * ------------------
-    * returns an array of site configuration settings
-    */
-   public function list_settings() {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/get/setting'));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $setting) {
-                  $return[]= $setting;
-               }
+        }
+
+        return $return;
+    }
+
+    /**
+     * List dynamic DNS settings
+     * -------------------------
+     * returns an array of dynamic DNS settings
+     */
+    public function list_dynamicdns() {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = array();
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/list/dynamicdns'));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $dynamicdns) {
+                        $return[]= $dynamicdns;
+                    }
+                }
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * Reboot an access point
-    * ----------------------
-    * return TRUE on success
-    * required parameter <mac> = device MAC address
-    */
-   public function restart_ap($mac) {
-      if (!$this->is_loggedin) return FALSE;
-      $mac             = strtolower($mac);
-      $return          = FALSE;
-      $json            = json_encode(array('cmd' => 'restart', 'mac' => $mac));
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/cmd/devmgr','json='.$json));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            $return = TRUE;
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * Start flashing LED of an access point for locating purposes
-    * -----------------------------------------------------------
-    * return TRUE on success
-    * required parameter <mac> = device MAC address
-    */
-   public function set_locate_ap($mac) {
-      if (!$this->is_loggedin) return FALSE;
-      $mac             = strtolower($mac);
-      $return          = FALSE;
-      $json            = json_encode(array('cmd' => 'set-locate', 'mac' => $mac));
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/cmd/devmgr','json='.$json));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            $return = TRUE;
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * Stop flashing LED of an access point for locating purposes
-    * ----------------------------------------------------------
-    * return TRUE on success
-    * required parameter <mac> = device MAC address
-    */
-   public function unset_locate_ap($mac) {
-      if (!$this->is_loggedin) return FALSE;
-      $mac             = strtolower($mac);
-      $return          = FALSE;
-      $json            = json_encode(array('cmd' => 'unset-locate', 'mac' => $mac));
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/cmd/devmgr','json='.$json));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            $return = TRUE;
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * Switch LEDs of all the access points ON
-    * ---------------------------------------
-    * return TRUE on success
-    */
-   public function site_ledson() {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = FALSE;
-      $json            = json_encode(array('led_enabled' => TRUE));
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/set/setting/mgmt','json='.$json));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            $return = TRUE;
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * Switch LEDs of all the access points OFF
-    * ----------------------------------------
-    * return TRUE on success
-    */
-   public function site_ledsoff() {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = FALSE;
-      $json            = json_encode(array('led_enabled' => FALSE));
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/set/setting/mgmt','json='.$json));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            $return = TRUE;
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * Set access point radio settings
-    * -------------------------------
-    * return TRUE on success
-    * required parameter <ap_id>
-    * required parameter <radio>(default=ng)
-    * required parameter <channel>
-    * required parameter <ht>(default=20)
-    * required parameter <tx_power_mode>
-    * required parameter <tx_power>(default=0)
-    */
-   public function set_ap_radiosettings($ap_id, $radio, $channel, $ht, $tx_power_mode, $tx_power) {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = FALSE;
-      $jsonsettings    = json_encode(array('radio' => $radio, 'channel' => $channel, 'ht' => $ht, 'tx_power_mode' => $tx_power_mode, 'tx_power' =>$tx_power));
-      $json            = '{"radio_table": ['.$jsonsettings.']}';
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/upd/device/'.$ap_id,'json='.$json));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            $return = TRUE;
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * Set guest login settings
-    * ------------------------
-    * return TRUE on success
-    * required parameter <portal_enabled>
-    * required parameter <portal_customized>
-    * required parameter <redirect_enabled>
-    * required parameter <redirect_url>
-    * required parameter <x_password>
-    * required parameter <expire_number>
-    * required parameter <expire_unit>
-    * required parameter <site_id>
-    *
-    * NOTES:
-    * - both portal parameters are set to the same value!
-   */
-   public function set_guestlogin_settings($portal_enabled, $portal_customized, $redirect_enabled, $redirect_url, $x_password, $expire_number, $expire_unit, $site_id) {
-      if (!$this->is_loggedin) return FALSE;
-      $return = FALSE;
-      $json = json_encode(array('portal_enabled' => $portal_enabled, 'portal_customized' => $portal_customized,
-                                'redirect_enabled' => $redirect_enabled, 'redirect_url' => $redirect_url,
-                                'x_password' => $x_password, 'expire_number' => $expire_number,
-                                'expire_unit' => $expire_unit, 'site_id' => $site_id), JSON_UNESCAPED_SLASHES);
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/set/setting/guest_access','json='.$json));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            $return = TRUE;
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * Rename access point
-    * -------------------
-    * return TRUE on success
-    * required parameter <ap_id>
-    * required parameter <apname>
-    */
-   public function rename_ap($ap_id, $apname) {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = FALSE;
-      $json            = json_encode(array('name' => $apname));
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/upd/device/'.$ap_id,'json='.$json));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            $return = TRUE;
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * Set wlan settings
-    * -----------------
-    * return TRUE on success
-    * required parameter <wlan_id>
-    * required parameter <x_passphrase> = new pre-shared key, minimal length is 8 characters, maximum length is 63
-    * optional parameter <name>
-    */
-   public function set_wlansettings($wlan_id, $x_passphrase, $name = NULL) {
-      if (!$this->is_loggedin) return FALSE;
-      $return = FALSE;
-      $json            = array('x_passphrase' => $x_passphrase);
-      if (!is_null($name)) $json['name'] = $name;
-      $json            = json_encode($json);
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/upd/wlanconf/'.$wlan_id,'json='.$json));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            $return = TRUE;
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * List events
-    * -----------
-    * returns an array of known events
-    */
-   public function list_events() {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/event'));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $event) {
-                  $return[]= $event;
-               }
+        }
+
+        return $return;
+    }
+
+    /**
+     * List port configuration
+     * -----------------------
+     * returns an array of port configurations
+     */
+    public function list_portconf() {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = array();
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/list/portconf'));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $portconf) {
+                        $return[]= $portconf;
+                    }
+                }
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * List wireless settings
-    * ----------------------
-    * returns an array of wireless networks and settings
-    */
-   public function list_wlanconf() {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/list/wlanconf'));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $wlan) {
-                  $return[]= $wlan;
-               }
+        }
+
+        return $return;
+    }
+
+    /**
+     * List VoIP extensions
+     * --------------------
+     * returns an array of VoIP extensions
+     */
+    public function list_extension() {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = array();
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/list/extension'));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $extension) {
+                        $return[]= $extension;
+                    }
+                }
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * List alarms
-    * -----------
-    * returns an array of known alarms
-    */
-   public function list_alarms() {
-      if (!$this->is_loggedin) return FALSE;
-      $return          = array();
-      $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/list/alarm'));
-      if (isset($content_decoded->meta->rc)) {
-         if ($content_decoded->meta->rc == 'ok') {
-            if (is_array($content_decoded->data)) {
-               foreach ($content_decoded->data as $alarm) {
-                  $return[]= $alarm;
-               }
+        }
+
+        return $return;
+    }
+
+    /**
+     * List site settings
+     * ------------------
+     * returns an array of site configuration settings
+     */
+    public function list_settings() {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = array();
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/get/setting'));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $setting) {
+                        $return[]= $setting;
+                    }
+                }
             }
-         }
-      }
-      return $return;
-   }
-
-   /**
-    * Internal (private) functions from here
-    */
-   private function exec_curl($url, $data = '') {
-      $ch = $this->get_curl_obj();
-      curl_setopt($ch, CURLOPT_URL, $url);
-
-      if (trim($data) != '') {
-         curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
-      } else {
-         curl_setopt($ch, CURLOPT_POST, FALSE);
-      }
-
-      if (($content = curl_exec($ch)) === FALSE) {
-         error_log('curl error: ' . curl_error($ch));
-      }
-
-      if ($this->debug === TRUE) {
-         print '<pre>';
-         print PHP_EOL.'---------cURL INFO-----------'.PHP_EOL;
-         print_r (curl_getinfo($ch));
-         print PHP_EOL.'-------URL & PAYLOAD---------'.PHP_EOL;
-         print $url.PHP_EOL;
-         print $data;
-         print PHP_EOL.'---------RESPONSE------------'.PHP_EOL;
-         print $content;
-         print PHP_EOL.'-----------------------------'.PHP_EOL;
-         print '</pre>';
-      }
-      curl_close ($ch);
-      return $content;
-   }
-
-   private function get_curl_obj() {
-      $ch = curl_init();
-      curl_setopt($ch, CURLOPT_POST, TRUE);
-      curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
-      curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);
-      curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
-
-      if ($this->debug === TRUE) {
-         curl_setopt($ch, CURLOPT_VERBOSE, TRUE);
-      }
-
-      if ($this->cookies != '') {
-         curl_setopt($ch, CURLOPT_COOKIESESSION, TRUE);
-         curl_setopt($ch, CURLOPT_COOKIE, $this->cookies);
-      }
-      return $ch;
-   }
-}
-?>
\ No newline at end of file
+        }
+
+        return $return;
+    }
+
+    /**
+     * Reboot an access point
+     * ----------------------
+     * return TRUE on success
+     * required parameter <mac> = device MAC address
+     */
+    public function restart_ap($mac) {
+        if (!$this->is_loggedin) return FALSE;
+        $mac             = strtolower($mac);
+        $return          = FALSE;
+        $json            = json_encode(array('cmd' => 'restart', 'mac' => $mac));
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/cmd/devmgr','json='.$json));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                $return = TRUE;
+            }
+        }
+
+        return $return;
+    }
+
+    /**
+     * Start flashing LED of an access point for locating purposes
+     * -----------------------------------------------------------
+     * return TRUE on success
+     * required parameter <mac> = device MAC address
+     */
+    public function set_locate_ap($mac) {
+        if (!$this->is_loggedin) return FALSE;
+        $mac             = strtolower($mac);
+        $return          = FALSE;
+        $json            = json_encode(array('cmd' => 'set-locate', 'mac' => $mac));
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/cmd/devmgr','json='.$json));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                $return = TRUE;
+            }
+        }
+
+        return $return;
+    }
+
+    /**
+     * Stop flashing LED of an access point for locating purposes
+     * ----------------------------------------------------------
+     * return TRUE on success
+     * required parameter <mac> = device MAC address
+     */
+    public function unset_locate_ap($mac) {
+        if (!$this->is_loggedin) return FALSE;
+        $mac             = strtolower($mac);
+        $return          = FALSE;
+        $json            = json_encode(array('cmd' => 'unset-locate', 'mac' => $mac));
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/cmd/devmgr','json='.$json));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                $return = TRUE;
+            }
+        }
+
+        return $return;
+    }
+
+    /**
+     * Switch LEDs of all the access points ON
+     * ---------------------------------------
+     * return TRUE on success
+     */
+    public function site_ledson() {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = FALSE;
+        $json            = json_encode(array('led_enabled' => TRUE));
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/set/setting/mgmt','json='.$json));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                $return = TRUE;
+            }
+        }
+
+        return $return;
+    }
+
+    /**
+     * Switch LEDs of all the access points OFF
+     * ----------------------------------------
+     * return TRUE on success
+     */
+    public function site_ledsoff() {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = FALSE;
+        $json            = json_encode(array('led_enabled' => FALSE));
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/set/setting/mgmt','json='.$json));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                $return = TRUE;
+            }
+        }
+
+        return $return;
+    }
+
+    /**
+     * Set access point radio settings
+     * -------------------------------
+     * return TRUE on success
+     * required parameter <ap_id>
+     * required parameter <radio>(default=ng)
+     * required parameter <channel>
+     * required parameter <ht>(default=20)
+     * required parameter <tx_power_mode>
+     * required parameter <tx_power>(default=0)
+     */
+    public function set_ap_radiosettings($ap_id, $radio, $channel, $ht, $tx_power_mode, $tx_power) {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = FALSE;
+        $jsonsettings    = json_encode(array('radio' => $radio, 'channel' => $channel, 'ht' => $ht, 'tx_power_mode' => $tx_power_mode, 'tx_power' =>$tx_power));
+        $json            = '{"radio_table": ['.$jsonsettings.']}';
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/upd/device/'.$ap_id,'json='.$json));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                $return = TRUE;
+            }
+        }
+
+        return $return;
+    }
+
+    /**
+     * Set guest login settings
+     * ------------------------
+     * return TRUE on success
+     * required parameter <portal_enabled>
+     * required parameter <portal_customized>
+     * required parameter <redirect_enabled>
+     * required parameter <redirect_url>
+     * required parameter <x_password>
+     * required parameter <expire_number>
+     * required parameter <expire_unit>
+     * required parameter <site_id>
+     *
+     * NOTES:
+     * - both portal parameters are set to the same value!
+     */
+    public function set_guestlogin_settings($portal_enabled, $portal_customized, $redirect_enabled, $redirect_url, $x_password, $expire_number, $expire_unit, $site_id) {
+        if (!$this->is_loggedin) return FALSE;
+        $return = FALSE;
+        $json   = json_encode(array('portal_enabled' => $portal_enabled, 'portal_customized' => $portal_customized,
+                                    'redirect_enabled' => $redirect_enabled, 'redirect_url' => $redirect_url,
+                                    'x_password' => $x_password, 'expire_number' => $expire_number,
+                                    'expire_unit' => $expire_unit, 'site_id' => $site_id), JSON_UNESCAPED_SLASHES);
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/set/setting/guest_access','json='.$json));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                $return = TRUE;
+            }
+        }
+
+        return $return;
+    }
+
+    /**
+     * Rename access point
+     * -------------------
+     * return TRUE on success
+     * required parameter <ap_id>
+     * required parameter <apname>
+     */
+    public function rename_ap($ap_id, $apname) {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = FALSE;
+        $json            = json_encode(array('name' => $apname));
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/upd/device/'.$ap_id,'json='.$json));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                $return = TRUE;
+            }
+        }
+
+        return $return;
+    }
+
+    /**
+     * Set wlan settings
+     * -----------------
+     * return TRUE on success
+     * required parameter <wlan_id>
+     * required parameter <x_passphrase> = new pre-shared key, minimal length is 8 characters, maximum length is 63
+     * optional parameter <name>
+     */
+    public function set_wlansettings($wlan_id, $x_passphrase, $name = NULL) {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = FALSE;
+        $json            = array('x_passphrase' => $x_passphrase);
+        if (!is_null($name)) $json['name'] = $name;
+        $json            = json_encode($json);
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/upd/wlanconf/'.$wlan_id,'json='.$json));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                $return = TRUE;
+            }
+        }
+
+        return $return;
+    }
+
+    /**
+     * List events
+     * -----------
+     * returns an array of known events
+     */
+    public function list_events() {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = array();
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/stat/event'));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $event) {
+                        $return[]= $event;
+                    }
+                }
+            }
+        }
+
+        return $return;
+    }
+
+    /**
+     * List wireless settings
+     * ----------------------
+     * returns an array of wireless networks and settings
+     */
+    public function list_wlanconf() {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = array();
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/list/wlanconf'));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $wlan) {
+                        $return[]= $wlan;
+                    }
+                }
+            }
+        }
+
+        return $return;
+    }
+
+    /**
+     * List alarms
+     * -----------
+     * returns an array of known alarms
+     */
+    public function list_alarms() {
+        if (!$this->is_loggedin) return FALSE;
+        $return          = array();
+        $content_decoded = json_decode($this->exec_curl($this->baseurl.'/api/s/'.$this->site.'/list/alarm'));
+        if (isset($content_decoded->meta->rc)) {
+            if ($content_decoded->meta->rc == 'ok') {
+                if (is_array($content_decoded->data)) {
+                    foreach ($content_decoded->data as $alarm) {
+                        $return[]= $alarm;
+                    }
+                }
+            }
+        }
+
+        return $return;
+    }
+
+    /**
+     * Internal (private) functions from here
+     */
+    private function exec_curl($url, $data = '') {
+        $ch = $this->get_curl_obj();
+        curl_setopt($ch, CURLOPT_URL, $url);
+
+        if (trim($data) != '') {
+            curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
+            curl_setopt($ch, CURLOPT_PUT, true);
+        } else {
+            curl_setopt($ch, CURLOPT_POST, FALSE);
+        }
+
+        if (($content = curl_exec($ch)) === FALSE) {
+            error_log('curl error: ' . curl_error($ch));
+        }
+
+        if ($this->debug === TRUE) {
+            print '<pre>';
+            print PHP_EOL.'---------cURL INFO-----------'.PHP_EOL;
+            print_r (curl_getinfo($ch));
+            print PHP_EOL.'-------URL & PAYLOAD---------'.PHP_EOL;
+            print $url.PHP_EOL;
+            print $data;
+            print PHP_EOL.'---------RESPONSE------------'.PHP_EOL;
+            print $content;
+            print PHP_EOL.'-----------------------------'.PHP_EOL;
+            print '</pre>';
+        }
+
+        curl_close ($ch);
+        return $content;
+    }
+
+    private function get_curl_obj() {
+        $ch = curl_init();
+        curl_setopt($ch, CURLOPT_POST, TRUE);
+        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
+        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);
+        curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
+
+        if ($this->debug === TRUE) {
+            curl_setopt($ch, CURLOPT_VERBOSE, TRUE);
+        }
+
+        if ($this->cookies != '') {
+            curl_setopt($ch, CURLOPT_COOKIESESSION, TRUE);
+            curl_setopt($ch, CURLOPT_COOKIE, $this->cookies);
+        }
+
+        return $ch;
+    }
+}
\ No newline at end of file