rvp_php_sdk.class.php

<?php
/***************************************************************************************************************************/
defined( 'RVP_PHP_SDK_ACCESS' ) or die ( 'Cannot Execute Directly' );   // Makes sure that this file is in the correct context.
require_once(dirname(__FILE__).'/rvp_php_sdk_login.class.php');
require_once(dirname(__FILE__).'/rvp_php_sdk_user.class.php');
require_once(dirname(__FILE__).'/rvp_php_sdk_place.class.php');
require_once(dirname(__FILE__).'/rvp_php_sdk_thing.class.php');
require_once(dirname(__FILE__).'/lang/common.php');

define('__SDK_VERSION__', '1.0.0.2000');

/****************************************************************************************************************************/
class RVP_PHP_SDK {
    protected   $_server_uri;           
    protected   $_sdk_lang;             
    protected   $_server_secret;        
    protected   $_api_key;              
    protected   $_login_timeout;        
    protected   $_login_time_limit;     
    protected   $_error;                
    protected   $_my_login_info;        
    protected   $_my_user_info;         
    protected   $_last_response_code;   
    protected   $_available_plugins;    
    protected   $_localizations;        
    protected   $_localized_errors;     
    
    /************************************************************************************************************************/    
    /*################################################ INTERNAL STATIC METHODS #############################################*/
    /************************************************************************************************************************/
    /***********************/
    protected static function _get_string_match_table() {
        return  [
                    'name'              =>  'search_name',
                    'tag0'              =>  'search_tag0',
                    'tag1'              =>  'search_tag1',
                    'tag2'              =>  'search_tag2',
                    'tag3'              =>  'search_tag3',
                    'tag4'              =>  'search_tag4',
                    'tag5'              =>  'search_tag5',
                    'tag6'              =>  'search_tag6',
                    'tag7'              =>  'search_tag7',
                    'tag8'              =>  'search_tag8',
                    'tag9'              =>  'search_tag9',
                    'description'       =>  'search_description',
                    'surname'           =>  'search_surname',
                    'middle_name'       =>  'search_middle_name',
                    'given_name'        =>  'search_given_name',
                    'nickname'          =>  'search_nickname',
                    'prefix'            =>  'search_prefix',
                    'suffix'            =>  'search_suffix',
                    'venue'             =>  'search_venue',
                    'street'            =>  'search_street_address',
                    'street_address'    =>  'search_street_address',
                    'extra_information' =>  'search_extra_information',
                    'city'              =>  'search_town',
                    'town'              =>  'search_town',
                    'county'            =>  'search_county',
                    'state'             =>  'search_state',
                    'province'          =>  'search_state',
                    'postal_code'       =>  'search_postal_code',
                    'zip_code'          =>  'search_postal_code',
                    'nation'            =>  'search_nation',
                ];
    }
    
    /***********************/
    protected static function _get_tag_match(   $in_string  
                                            ) {
        $ret = $in_string;
        $table = static::_get_string_match_table();
        
        if (isset($table[$ret]) && $table[$ret]) {
            $ret = $table[$ret];
        }
        
        return $ret;
    }

    /************************************************************************************************************************/    
    /*#################################################### INTERNAL METHODS ################################################*/
    /************************************************************************************************************************/
    /***********************/
    protected function _call_REST_API(  $method,                
                                        $url_extension,         
                                        $data_input = NULL,     
                                        $display_log = false    
                                        ) {
    
        $method = strtoupper(trim($method));            // Make sure the method is always uppercase.
        // Initialize function local variables.
        $file = NULL;               // This will be a file handle, for uploads.
        $content_type = NULL;       // This is used to signal the content-type for uploaded files.
        $file_size = 0;             // This is the size, in bytes, of uploaded files.
        $temp_file_name = NULL;     // This is a temporary file that is used to hold files before they are sent to the server.
        $file_data = NULL;
        
        // If data is provided by the caller, we read it into a temporary location, and Base64-encode it.
        if ($data_input) {

            $file_data = base64_encode($data_input['data']);
        
            $temp_file_name = tempnam(sys_get_temp_dir(), 'RVP');
    
            $file = fopen($temp_file_name, 'w');
    
            fwrite($file, $file_data, strlen($file_data));
    
            fclose($file);
    
            $content_type = $data_input['type'].':base64';
            $file_size = filesize($temp_file_name);
    
            $file = fopen($temp_file_name, 'rb');
        }

        $curl = curl_init();                    // Initialize the cURL handle.
        
        // Different methods require different ways of dealing with any file that has been passed in.
        // The file is ignored for GET and DELETE.
        // We ask the server not to send us EXPECT (HTTP 100) calls for POST and PUT.
        switch ($method) {
            case "POST":
                curl_setopt($curl, CURLOPT_POST, true);
            
                // POST sends the file as a standard multipart/form-data item.
                if ($file) {
                    curl_setopt($curl, CURLOPT_SAFE_UPLOAD, true);
                    curl_setopt($curl, CURLOPT_HTTPHEADER, ['Expect:', 'Content-type: multipart/form-data']);
                    $post = Array('payload'=> curl_file_create($temp_file_name, $content_type));
                    curl_setopt($curl, CURLOPT_POSTFIELDS, $post);
                } else {
                    curl_setopt($curl, CURLOPT_HTTPHEADER, ['Expect:']);
                }
                break;
            
            case "PUT":
                curl_setopt($curl, CURLOPT_HTTPHEADER, ['Expect:']);
                curl_setopt($curl, CURLOPT_PUT, true);
            
                // PUT requires a direct inline file transfer.
                if ($file) {
                    curl_setopt($curl, CURLOPT_SAFE_UPLOAD, true);
                    curl_setopt($curl, CURLOPT_INFILE, $file);
                    curl_setopt($curl, CURLOPT_INFILESIZE, $file_size);
                }
                break;
            
            case "DELETE":
                curl_setopt($curl, CURLOPT_CUSTOMREQUEST, "DELETE");
        }
    
        // Authentication. We provide the Server Secret and the API key here.
        if (isset($this->_server_secret) && isset($this->_api_key)) {
            curl_setopt($curl, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
            curl_setopt($curl, CURLOPT_USERPWD, $this->_server_secret.':'.$this->_api_key);
            
            // This is because some servers may intercept the auth headers, so we also supply the credentials as URL query arguments.
            if (isset($url_extension) && (false !== strpos($url_extension, '?'))) {  // See if we need to append, or begin a new query.
                $url_extension .= '&';
            } else {
                $url_extension .= '?';
            }
            
            $url_extension .= 'login_server_secret='.urlencode($this->_server_secret).'&login_api_key='.urlencode($this->_api_key);
        }

        curl_setopt($curl, CURLOPT_HEADER, false);          // Do not return any headers, please.
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);   // Please return to sender as a function response.
        curl_setopt($curl, CURLOPT_VERBOSE, false);         // Let's keep this thing simple.
        $url = $this->_server_uri.'/'.trim($url_extension, '/');
        curl_setopt($curl, CURLOPT_URL, $url);  // This is the URL we are calling.

        // This is if we want to see a display log (echoed directly).
        if (isset($display_log) && $display_log) {
            curl_setopt($curl, CURLOPT_HEADERFUNCTION, function ( $curl, $header_line ) {
                                                                                            echo "<pre>$header_line</pre>";
                                                                                            return strlen($header_line);
                                                                                        });
            echo('<div style="margin:1em">');
            echo("<h4>Sending REST $method CALL:</h4>");
            echo('<div>URL: <code>'.htmlspecialchars($url).'</code></div>');

            if ($this->_api_key) {
                echo('<div>API KEY:<pre>'.htmlspecialchars($this->_api_key).'</pre></div>');
            } else {
                echo('<div>NO API KEY</div>');
            }
        }
    
        $result = curl_exec($curl); // Do it to it.
    
        $this->_last_response_code = curl_getinfo($curl, CURLINFO_HTTP_CODE);

        curl_close($curl);  // Bye, now.
    
        // More reportage.
        if (isset($display_log) && $display_log) {
            if (isset($file_data)) {
                $len = floatval(strlen($file_data));
                
                if (0 == $len) {
                    echo('<p><strong>ADDITIONAL DATA LENGTH IS ZERO!</strong></p>');
                } elseif ( 1024 > $len) {
                    echo('<p><strong>ADDITIONAL DATA LENGTH:</strong> <big><code>'.$len.' Bytes</code></big></p>');
                } elseif ( (1024 * 1024) > $len) {
                    echo('<p><strong>ADDITIONAL DATA LENGTH:</strong> <big><code>'.($len / 1024).' Kilobytes</code></big></p>');
                } elseif ( (1024 * 1024 * 1024) > $len) {
                    echo('<p><strong>ADDITIONAL DATA LENGTH:</strong> <big><code>'.($len / (1024 * 1024)).' Megabytes</code></big></p>');
                } elseif ( (1024 * 1024 * 1024 * 1024) > $len) {
                    echo('<p><strong>ADDITIONAL DATA LENGTH:</strong> <big><code>'.($len / (1024 * 1024 * 1024)).' Gigabytes</code></big></p>');
                }
                echo('<p><strong>ADDITIONAL DATA SHA:</strong> <big><code>'.sha1($file_data).'</code></big></p>');
            }
            
            if (isset($httpCode) && $httpCode) {
                echo('<div>HTTP CODE:<code>'.htmlspecialchars($httpCode, true).'</code></div>');
            }
        
            if ((2048 * 1024) <= strlen($result)) { // Anything over 2MB gets spewed to a file.
                $integer = 1;
                $original_file_name = dirname(dirname(__FILE__)).'/text-dump-result';
                $file_name = $original_file_name.'.txt';
                while(file_exists($file_name)) {
                    $file_name = $original_file_name.'-'.$integer.'.txt';
                    $integer++;
                }
                $file_handle = fopen($file_name, 'w');
                fwrite($file_handle, $result);
                fclose($file_handle);
                echo('<div>RESULT SAVED TO FILE" '.$file_name.'.</div>');
            } else {
                echo('<div>RESULT:<pre>'.htmlspecialchars(print_r(chunk_split($result, 1024), true)).'</pre></div>');
            }
            echo("</div>");
        }
    
        // If we had a file open for transfer, we close it now.
        if ($file) {
            fclose($file);
        }

        return $result;
    }
    
    /***********************/
    protected function _decode_handlers (   $in_handlers    
                                        ) {
        $ret = NULL;
        $plugin_list = [];
        if (isset($in_handlers->people) && is_array($in_handlers->people) && count($in_handlers->people)) {
            $plugin_list['people'] = $in_handlers->people;
        }
        if (isset($in_handlers->places) && is_array($in_handlers->places) && count($in_handlers->places)) {
            $plugin_list['places'] = $in_handlers->places;
        }
        if (isset($in_handlers->things) && is_array($in_handlers->things) && count($in_handlers->things)) {
            $plugin_list['things'] = $in_handlers->things;
        }
        
        if (isset($plugin_list) && is_array($plugin_list) && count($plugin_list)) {
            $ret = [];
            foreach ($plugin_list as $plugin => $list) {
                sort($list);
                foreach ($list as $id) {
                    $id = intval($id);
                
                    if (1 < $id) {
                        switch ($plugin) {
                            case 'people':
                                $new_object = new RVP_PHP_SDK_User($this, $id);
                                if (isset($new_object) && ($new_object instanceof RVP_PHP_SDK_User)) {
                                    $ret[] = $new_object;
                                } else {
                                    $this->set_error(_ERR_INTERNAL_ERR__);
                                    return NULL;
                                }
                                break;
                            
                            case 'places':
                                $new_object = new RVP_PHP_SDK_Place($this, $id);
                                if (isset($new_object) && ($new_object instanceof RVP_PHP_SDK_Place)) {
                                    $ret[] = $new_object;
                                } else {
                                    $this->set_error(_ERR_INTERNAL_ERR__);
                                    return NULL;
                                }
                                break;
                            
                            case 'things':
                                $new_object = new RVP_PHP_SDK_Thing($this, $id);
                                if (isset($new_object) && ($new_object instanceof RVP_PHP_SDK_Thing)) {
                                    $ret[] = $new_object;
                                } else {
                                    $this->set_error(_ERR_INTERNAL_ERR__);
                                    return NULL;
                                }
                                break;  
                        }
                    }
                }
            }
        }
        
        return $ret;
    }
    
    /***********************/
    protected function _load_localizations() {
        $locale_dir = dirname(__FILE__).'/lang';
        $locale_name_array = [];
        foreach (new DirectoryIterator($locale_dir) as $fileInfo) {
            if (($fileInfo->getExtension() === 'php') && ('index.php' != $fileInfo->getBasename()) && ('common.php' != $fileInfo->getBasename())) {
                $locale_name_array[] = $fileInfo->getBasename('.php');
            }
        }
        
        $this->_localizations = [];
        
        // Read each available file, and add it to our list.
        foreach ($locale_name_array as $locale) {
            if ($locale != $this->_sdk_lang) {
                $this->_localizations[] = $locale;
            }
        }
        
        sort($this->_localizations); // Simple alpha-sort.
        array_unshift($this->_localizations, $this->_sdk_lang); // Make sure the first one is always our default.
    }
    
    /***********************/
    protected function _get_my_info() {
        $ret = NULL;
        
        if ($this->is_logged_in()) {
            $info = $this->fetch_data('json/people/logins/my_info');
            if ($info) {
                $temp = json_decode($info);
                if (isset($temp) && isset($temp->people) && isset($temp->people->logins) && isset($temp->people->logins->my_info)) {
                    $login_info = $temp->people->logins->my_info;
                    if (isset($login_info->user_object_id) && (1 < intval($login_info->user_object_id))) {
                        $ret = ['login' => $login_info];
                        $info = $this->fetch_data('json/people/people/my_info');
                        if ($info) {
                            $temp = json_decode($info);
                            if (isset($temp) && isset($temp->people) && isset($temp->people->people) && isset($temp->people->people->my_info)) {
                                $user_info = $temp->people->people->my_info;
                                $ret['user'] = $user_info;
                            } else {
                                $this->set_error(_ERR_COMM_ERR__);
                            }
                        } else {
                            $this->set_error(_ERR_NO_RESULTS__);
                        }
                    } else {
                        $ret = ['login' => $login_info];
                    }
                }
            } else {
                $this->set_error(_ERR_NO_RESULTS__);
            }
        }
        
        return $ret;
    }
    
    /***********************/
    protected function _get_plugins() {
        $ret = NULL;
        
        $info = $this->fetch_data('json/baseline');
        if ($info) {
            $temp = json_decode($info);
            if (isset($temp) && isset($temp->baseline) && isset($temp->baseline->plugins) && is_array($temp->baseline->plugins)) {
                return $temp->baseline->plugins;
            } else {
                $this->set_error(_ERR_COMM_ERR__);
            }
        } else {
            $this->set_error(_ERR_NO_RESULTS__);
        }
        
        return $ret;
    }
    
    /***********************/
    protected function _set_up_login_info() {
        if ($this->_api_key) {
            $this->_my_login_info = NULL;
            $this->_my_user_info = NULL;
        
            $info = $this->_get_my_info();
        
            if (!$this->get_error()) {
                if (isset($info['login'])) {
                    $this->_my_login_info = new RVP_PHP_SDK_Login($this, $info['login']->id, $info['login'], true);
            
                    if (!($this->_my_login_info instanceof RVP_PHP_SDK_Login)) {
                        $this->set_error(_ERR_INTERNAL_ERR__);
                        $this->logout();
                        $this->_api_key = NULL;
                        $this->_login_time_limit = -1;
                        $this->_my_login_info = NULL;
                        $this->_my_user_info = NULL;
                        return false;
                    }
                }
        
                if (isset($info['user'])) {
                    $this->_my_user_info = new RVP_PHP_SDK_User($this, $info['user']->id, $info['user'], true);
            
                    if (!($this->_my_user_info instanceof RVP_PHP_SDK_User)) {
                        $this->set_error(_ERR_INTERNAL_ERR__);
                        $this->logout();
                        $this->_api_key = NULL;
                        $this->_login_time_limit = -1;
                        $this->_my_login_info = NULL;
                        $this->_my_user_info = NULL;
                        return false;
                    }
                }
        
                return true;
            }
            
            $this->_api_key = NULL;
        }
        
        return false;
    }

    /************************************************************************************************************************/    
    /*#################################################### PUBLIC METHODS ##################################################*/
    /************************************************************************************************************************/
    /***********************/
    function __construct(   $in_server_uri,         
                            $in_server_secret,      
                            $in_username = NULL,    
                            $in_password = NULL,    
                            $in_login_timeout = 0   
                        ) {
        $this->_server_uri = trim($in_server_uri, '/'); // This is the server's base URI.
        $this->_server_secret  = $in_server_secret;     // This is the secret that we need to provide with authentication.
        $this->_api_key = NULL;                         // If we log in, this will be non-NULL, and will contain the active API key for this instance.
        $this->_login_time_limit = -1;                  // No timeout to start.
        $this->_login_timeout = $in_login_timeout;      // Save this for posterity.
        $this->_my_login_info = NULL;                   // If we have logged in, we have the info for our login here.
        $this->_my_user_info = NULL;                    // If we have logged in, we have the info for our user (if available) here.
        
        $this->clear_error();                           // Start off clean.
        $this->set_lang('en');                          // Set to default (English). The implementor should call this after instantiation to change.
        
        $this->_available_plugins = $this->_get_plugins();
        
        if ($this->valid()) {
            if ($in_username && $in_password && $in_login_timeout) {
                $this->login($in_username, $in_password, $in_login_timeout);
            }
        }
    }
    
    /***********************/
    function __destruct() {
        $this->logout();    // Don't bother checking for current login. Just call logout().
    }
    
    /***********************/
    function set_lang(  $in_lang    
                    ) {
        $this->_sdk_lang = $in_lang;
        
        $this->_load_localizations();
    }
    
    /***********************/
    function login( $in_username,           
                    $in_password,           
                    $in_login_timeout = -1  
                    ) {
        if (!$this->_api_key && $this->valid()) {
            $this->_login_time_limit = (0 < $in_login_timeout) ? (floatval($in_login_timeout) + microtime(true)) : -1;
            $api_key = $this->fetch_data('login', 'login_id='.urlencode($in_username).'&password='.urlencode($in_password));
            
            if (isset($api_key) && $api_key) {  // If we logged in, then we get our info.
                $this->_api_key = $api_key;
                return $this->_set_up_login_info();
            } else {
                $this->set_error(_ERR_INVALID_LOGIN__);
                $this->_api_key = NULL;
                $this->_login_time_limit = -1;
                $this->_my_login_info = NULL;
                $this->_my_user_info = NULL;
            }
        } else {
            $this->set_error(_ERR_PREV_LOGIN__);
        }
        
        return false;
    }
    
    /***********************/
    function logout() {
        if ($this->is_logged_in()) {
            $this->_call_REST_API('GET', 'logout'); // We call this directly, because we will not be using a return type.

            if (205 == intval($this->_last_response_code)) {
                $this->_api_key = NULL;
                $this->_login_time_limit = -1;
                $this->_my_login_info = NULL;
                $this->_my_user_info = NULL;
                return true;
            } else {
                $this->set_error(_ERR_COMM_ERR__);
            }
        } else {
            $this->set_error(_ERR_NOT_LOGGED_IN__);
            $this->_api_key = NULL;
            $this->_login_time_limit = -1;
            $this->_my_login_info = NULL;
            $this->_my_user_info = NULL;
        }
        
        return false;
    }
    
    /***********************/
    function get_error() {
        $ret = NULL;
        
        if ($this->_error) {
            $message_class = 'RVP_Locale_'.$this->_sdk_lang;
            require_once(dirname(__FILE__).'/lang/'.$this->_sdk_lang.'.php');
            $ret = ['code' => intval($this->_error)];
            $ret['message'] = $message_class::get_error_message($ret['code']);
        }
        
        return $ret;
    }
    
    /***********************/
    function set_error( $in_code    
                        ) {
        $this->_error = isset($in_code) && (0 != intval($in_code)) ? intval($in_code) : NULL;
    }
    
    /***********************/
    function clear_error() {
        $this->set_error(NULL);
    }
    
    /***********************/
    function valid() {
        return isset($this->_available_plugins) && is_array($this->_available_plugins) && (3 < count($this->_available_plugins));
    }
 
    /***********************/
    function force_reload() {
        return $this->_set_up_login_info();
    }
    
    /***********************/
    function is_logged_in() {
        return isset($this->_api_key) && (0 < $this->login_time_left());
    }
    
    /***********************/
    function is_manager() {
        if ($this->is_logged_in() && isset($this->_my_login_info)) {
            return $this->_my_login_info->is_manager();
        }
        
        return false;
    }
    
    /***********************/
    function is_main_admin() {
        if ($this->is_manager() && isset($this->_my_login_info)) {
            return $this->_my_login_info->is_main_admin();
        }
        
        return false;
    }
    
    /***********************/
    function current_login_id() {
        if ($this->is_logged_in() && isset($this->_my_login_info)) {
            return $this->_my_login_info->id();
        }
        
        return NULL;
    }
    
    /***********************/
    function current_login_id_string() {
        if ($this->is_logged_in() && isset($this->_my_login_info)) {
            return $this->_my_login_info->login_id();
        }
        
        return NULL;
    }
    
    /***********************/
    function current_login_object() {
        $ret = NULL;
        
        if ($this->is_logged_in() && isset($this->_my_login_info)) {
            $ret = new RVP_PHP_SDK_Login($this, $this->_my_login_info->login_id());
        }
        
        return $ret;
    }
    
    /***********************/
    function login_time_left() {
        if (0 < $this->_login_time_limit) {
            return floor(100 * max($this->_login_time_limit - microtime(true), 0)) / 100;
        }
        
        return 0;
    }
    
    /***********************/
    function my_info() {
        if ($this->is_logged_in() && isset($this->_my_login_info)) {
            $ret = ['login' => $this->_my_login_info];
            
            if (isset($this->_my_user_info)) {
                $ret['user'] = $this->_my_user_info;
            }
            
            return $ret;
        } else {
            return NULL;
        }
    }
    
    /***********************/
    function my_tokens() {
        $ret = NULL;
        if ($this->is_logged_in() && isset($this->_my_login_info)) {
            $ret = $this->_my_login_info->security_tokens();
        }
   
        return $ret;
    }
    
    /***********************/
    function plugins() {
        $ret = [];
        
        if ($this->valid()) {
            $ret = $this->_available_plugins;
        }
        
        return $ret;
    }
    
    /***********************/
    function change_my_password_to( $in_new_password    
                                    ) {
        $ret = NULL;
        
        if ($this->is_logged_in() && !$this->is_main_admin()) {
            $my_login_id = $this->_my_login_info->login_id();
            $result = $this->put_data('json/people/logins/my_info', 'password='.urlencode($in_new_password));
            
            if (isset($result)) {
                $result = json_decode($result);
                // The reason for this crazy Fabergé egg, is because it's easier to debug a nested set of comparisons.
                if (isset($result)) {
                    if (isset($result->people)) {
                        if (isset($result->people->logins)) {
                            if (isset($result->people->logins->changed_logins)) {
                                if (is_array($result->people->logins->changed_logins)) {
                                    if ((1 == count($result->people->logins->changed_logins))) {
                                        if (isset($result->people->logins->changed_logins[0])) {
                                            if (isset($result->people->logins->changed_logins[0]->after)) {
                                                if (isset($result->people->logins->changed_logins[0]->after->password)) {
                                                    if (($in_new_password == $result->people->logins->changed_logins[0]->after->password)) {
                                                        $this->_api_key = NULL;
                                                        $ret = $this->login($my_login_id, $in_new_password, $this->_login_timeout);
                                                    }
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
        
        return $ret;
    }
    
    /***********************/
    function fetch_data(    $in_plugin_path,            
                            $in_query_args = NULL       
                        ) {
        if (isset($in_query_args) && trim($in_query_args)) {
            $in_plugin_path .= '?'.ltrim($in_query_args, '&');
        }
        
        $response = $this->_call_REST_API('GET', $in_plugin_path);
        
        return $response;
    }
    
    /***********************/
    function put_data(  $in_plugin_path,        
                        $in_query_args,         
                        $in_data_object = NULL  
                    ) {
        $response = NULL;

        if ($this->is_logged_in() && isset($in_plugin_path) && trim($in_plugin_path) && isset($in_query_args) && trim($in_query_args)) {
            $in_plugin_path .= '?'.ltrim($in_query_args, '&');
            $response = $this->_call_REST_API('PUT', $in_plugin_path, $in_data_object);
        } elseif ($this->is_logged_in()) {
            $this->set_error(_ERR_NOT_AUTHORIZED__);
        } else {
            $this->set_error(_ERR_INVALID_PARAMETERS__);
        }
        
        return $response;
    }
    
    /***********************/
    function post_data( $in_plugin_path,        
                        $in_query_args = NULL,  
                        $in_data_object = NULL  
                        ) {
        $response = NULL;
        
        if ($this->is_logged_in() && isset($in_plugin_path) && trim($in_plugin_path)) {
            if (isset($in_query_args) && trim($in_query_args)) {
                $in_plugin_path .= '?'.ltrim($in_query_args, '&');
            }
            
            $response = $this->_call_REST_API('POST', $in_plugin_path, $in_data_object);
        } elseif ($this->is_logged_in()) {
            $this->set_error(_ERR_NOT_AUTHORIZED__);
        } else {
            $this->set_error(_ERR_INVALID_PARAMETERS__);
        }
        
        return $response;
    }
    
    /***********************/
    function delete_data(   $in_plugin_path 
                        ) {
        $response = NULL;
        
        if ($this->is_logged_in() && isset($in_plugin_path) && trim($in_plugin_path)) {
            $response = $this->_call_REST_API('DELETE', $in_plugin_path);
        } elseif ($this->is_logged_in()) {
            $this->set_error(_ERR_NOT_AUTHORIZED__);
        } else {
            $this->set_error(_ERR_INVALID_PARAMETERS__);
        }
        
        return $response;
    }
    
    /***********************/
    function get_objects() {
        $func_args = func_get_args();
        
        // If they passed an array as the only argument, then we switch to that.
        if (is_array($func_args) && (1 == count($func_args)) && is_array($func_args[0]) && count($func_args[0])) {
            $func_args = $func_args[0];
        }
        
        $ret = [];

        $args = array_map('intval', $func_args);
        $arg_array = array_chunk($args, 10);    // Split into groups of 10, so we don't create too large a GET request.
        
        foreach($arg_array as $args) {
            $handlers = $this->fetch_data('json/baseline/handlers/'.implode(',', $args));
            if (isset($handlers)) {
                $handlers = json_decode($handlers);
                if (isset($handlers) && isset($handlers->baseline)) {
                    $results = $this->_decode_handlers($handlers->baseline);
                    
                    if (isset($results) && is_array($results) && count($results)) {
                        $ret = array_merge($ret, $results);
                    }
                }
            } else {
                $this->set_error(_ERR_COMM_ERR__);
                return NULL;
            }
        }
        
        if (isset($ret) && is_array($ret) && (1 < count($ret))) {
            usort($ret, function($a, $b) {
                            if ($a->id() == $b->id()) {
                                return 0;
                            }
                        
                            if ($a->id() < $b->id()) {
                                return -1;
                            }
                        
                            return 1;
                        }
            );
        }
        
        return $ret;
    }
    
    /***********************/
    function get_user_info( $in_user_id 
                            ) {
        $ret = NULL;
        
        if ($this->is_logged_in()) {
            $info = $this->fetch_data('json/people/people/'.intval($in_user_id), 'show_details');
            if ($info) {
                $temp = json_decode($info);
                if (isset($temp) && isset($temp->people) && isset($temp->people->people) && isset($temp->people->people[0])) {
                    $ret = new RVP_PHP_SDK_User($this, $temp->people->people[0]->id, $temp->people->people[0], true);
                    if (!isset($ret) || !($ret instanceof RVP_PHP_SDK_User)) {
                        $this->set_error(_ERR_INTERNAL_ERR__);
                        $ret = NULL;
                    }
                }
            } else {
                $this->set_error(_ERR_COMM_ERR__);
            }
        }
        
        return $ret;
    }
    
    /***********************/
    function get_login_info(    $in_login_id    
                            ) {
        $ret = NULL;
        
        if ($this->is_logged_in()) {
            $info = $this->fetch_data('json/people/logins/'.intval($in_login_id), 'show_details');
            if ($info) {
                $temp = json_decode($info);
                if (isset($temp) && isset($temp->people) && isset($temp->people->logins) && isset($temp->people->logins[0])) {
                    $ret = new RVP_PHP_SDK_Login($this, $temp->people->logins[0]->id, $temp->people->logins[0], true);
                    if (!isset($ret) || !($ret instanceof RVP_PHP_SDK_Login)) {
                        $this->set_error(_ERR_INTERNAL_ERR__);
                        $ret = NULL;
                    }
                }
            } else {
                $this->set_error(_ERR_COMM_ERR__);
            }
        }
        
        return $ret;
    }
    
    /***********************/
    function get_place_info(    $in_place_id    
                            ) {
        $ret = NULL;
        
        $info = $this->fetch_data('json/places/'.intval($in_place_id), 'show_details');
        if ($info) {
            $temp = json_decode($info);
            if (isset($temp) && isset($temp->places) && isset($temp->places->results) && is_array($temp->places->results) && isset($temp->places->results[0])) {
                $ret = new RVP_PHP_SDK_Place($this, $temp->places->results[0]->id, $temp->places->results[0], true);
                if (!isset($ret) || !($ret instanceof RVP_PHP_SDK_Place)) {
                    $this->set_error(_ERR_INTERNAL_ERR__);
                    $ret = NULL;
                }
            }
        } else {
            $this->set_error(_ERR_COMM_ERR__);
        }
        
        return $ret;
    }
    
    /***********************/
    function get_thing_info(    $in_thing_id    
                            ) {
        $ret = NULL;
        
        $info = $this->fetch_data('json/things/'.urlencode($in_thing_id), 'show_details');
        if ($info) {
            $temp = json_decode($info);
            if (isset($temp) && isset($temp->things) && isset($temp->things[0])) {
                $ret = new RVP_PHP_SDK_Thing($this, $temp->things[0]->id, $temp->things[0], true);
                if (!isset($ret) || !($ret instanceof RVP_PHP_SDK_Thing)) {
                    $this->set_error(_ERR_INTERNAL_ERR__);
                    $ret = NULL;
                }
            }
        } else {
            $this->set_error(_ERR_COMM_ERR__);
        }
        
        return $ret;
    }
    
    /***********************/
    function general_search(    $in_text_array = [],    
                                $in_location = NULL,    
                                $in_writeable = false   
                                ) {
        $ret = [];
        
        $added_parameters = '';
        
        if (is_array($in_text_array) && count($in_text_array)) {
            foreach ($in_text_array as $key => $value) {
                $added_parameters .= urlencode(self::_get_tag_match($key)).'='.urlencode($value);
            }
        }
        
        if ($in_writeable && $this->is_logged_in()) {   // We ignore writeable if we are not logged in.
            $added_parameters .= '&writeable';
        }
        
        if (NULL !== $in_location) {
            $added_parameters .= '&search_latitude='.floatval($in_location['latitude']).'&search_longitude='.floatval($in_location['longitude']).'&search_radius='.floatval($in_location['radius']);
        }
        
        $handlers = $this->fetch_data('json/baseline/search/', $added_parameters);
        if (isset($handlers)) {
            $handlers = json_decode($handlers);
            if (isset($handlers) && isset($handlers->baseline)) {
                $ret = $this->_decode_handlers($handlers->baseline);
        
                if (isset($ret) && is_array($ret) && (0 < count($ret))) {
                    usort($ret, function($a, $b) {
                                    if ($a->id() == $b->id()) {
                                        return 0;
                                    }
                        
                                    if ($a->id() < $b->id()) {
                                        return -1;
                                    }
                        
                                    return 1;
                                }
                    );
                }
            }
        } else {
            $this->set_error(_ERR_COMM_ERR__);
            return [];
        }
        
        return $ret;
    }
    
    /***********************/
    function people_search(     $in_text_array = [],    
                                $in_location = NULL,            
                                $in_get_logins_only = false,    
                                $in_writeable = false           
                                ) {
        $ret = [];
        
        $added_parameters = '';
        
        if (is_array($in_text_array) && count($in_text_array)) {
            foreach ($in_text_array as $key => $value) {
                $added_parameters .= urlencode(self::_get_tag_match($key)).'='.urlencode($value);
            }
        }

        if ($in_get_logins_only) {
            $added_parameters .= '&login_user';
        }
        
        if ($in_writeable && $this->is_logged_in()) {   // We ignore writeable if we are not logged in.
            $added_parameters .= '&writeable';
        }
        
        if (NULL !== $in_location) {
            $added_parameters .= '&search_latitude='.floatval($in_location['latitude']).'&search_longitude='.floatval($in_location['longitude']).'&search_radius='.floatval($in_location['radius']);
        }
        
        $response = $this->fetch_data('json/people/people/', $added_parameters);
        if (isset($response)) {
            $response = json_decode($response);
            if (isset($response) && isset($response->people) && isset($response->people->people)) {
                $ret = [];
                $people = (array)$response->people->people;
                foreach ($people as $person) {
                    if (isset($person->id)) {
                        if ($in_get_logins_only && isset($person->associated_login)) {
                            $new_object = new RVP_PHP_SDK_Login($this, $person->associated_login->id, $person->associated_login, true);
                            if (isset($new_object) && ($new_object instanceof RVP_PHP_SDK_Login)) {
                                $ret[] = $new_object;
                            } else {
                                $this->set_error(_ERR_INTERNAL_ERR__);
                                return [];
                            }
                        } elseif (!$in_get_logins_only) {
                            $new_object = new RVP_PHP_SDK_User($this, $person->id, $person);
                            if (isset($new_object) && ($new_object instanceof RVP_PHP_SDK_User)) {
                                $ret[] = $new_object;
                            } else {
                                $this->set_error(_ERR_INTERNAL_ERR__);
                                return [];
                            }
                        }
                    }
                }
        
                if (isset($ret) && is_array($ret) && (0 < count($ret))) {
                    usort($ret, function($a, $b) {
                                    if ($a->id() == $b->id()) {
                                        return 0;
                                    }
                        
                                    if ($a->id() < $b->id()) {
                                        return -1;
                                    }
                        
                                    return 1;
                                }
                    );
                }
            }
        } else {
            $this->set_error(_ERR_COMM_ERR__);
            return [];
        }
        
        return $ret;
    }
    
    /***********************/
    function places_search(     $in_text_array = [],    
                                $in_location = NULL,    
                                $in_writeable = false   
                                ) {
        $ret = [];
        
        $added_parameters = '';
        
        if (is_array($in_text_array) && count($in_text_array)) {
            foreach ($in_text_array as $key => $value) {
                $added_parameters .= urlencode(self::_get_tag_match($key)).'='.urlencode($value);
            }
        }
        
        if ($in_writeable && $this->is_logged_in()) {   // We ignore writeable if we are not logged in.
            $added_parameters .= '&writeable';
        }
        
        if (NULL !== $in_location) {
            $added_parameters .= '&search_latitude='.floatval($in_location['latitude']).'&search_longitude='.floatval($in_location['longitude']).'&search_radius='.floatval($in_location['radius']);
        }
        
        $response = $this->fetch_data('json/places/', $added_parameters);
        if (isset($response)) {
            $response = json_decode($response);
            if (isset($response) && isset($response->places) && isset($response->places->results) && is_array($response->places->results) && count($response->places->results)) {
                $ret = [];
                foreach ($response->places->results as $place) {
                    $new_object = new RVP_PHP_SDK_Place($this, $place->id, $place);
                    if (isset($new_object) && ($new_object instanceof RVP_PHP_SDK_Place)) {
                        $ret[] = $new_object;
                    } else {
                        $this->set_error(_ERR_INTERNAL_ERR__);
                        return [];
                    }
                }
        
                if (isset($ret) && is_array($ret) && (0 < count($ret))) {
                    usort($ret, function($a, $b) {
                                    if ($a->id() == $b->id()) {
                                        return 0;
                                    }
                        
                                    if ($a->id() < $b->id()) {
                                        return -1;
                                    }
                        
                                    return 1;
                                }
                    );
                }
            }
        } else {
            $this->set_error(_ERR_COMM_ERR__);
            return [];
        }
        
        return $ret;
    }
    
    /***********************/
    function things_search(     $in_text_array = [],    
                                $in_location = NULL,    
                                $in_writeable = false   
                                ) {
        $ret = [];
        
        $added_parameters = '';
        
        if (is_array($in_text_array) && count($in_text_array)) {
            foreach ($in_text_array as $key => $value) {
                $added_parameters .= urlencode(self::_get_tag_match($key)).'='.urlencode($value);
            }
        }
        
        if ($in_writeable && $this->is_logged_in()) {   // We ignore writeable if we are not logged in.
            $added_parameters .= '&writeable';
        }
        
        if (NULL !== $in_location) {
            $added_parameters .= '&search_latitude='.floatval($in_location['latitude']).'&search_longitude='.floatval($in_location['longitude']).'&search_radius='.floatval($in_location['radius']);
        }
        
        $response = $this->fetch_data('json/things/', $added_parameters);
        if (isset($response)) {
            $response = json_decode($response);
            if (isset($response) && isset($response->things) && is_array($response->things) && count($response->things)) {
                $ret = [];
                foreach ($response->things as $thing) {
                    $new_object = new RVP_PHP_SDK_Thing($this, $thing->id, $thing);
                    if (isset($new_object) && ($new_object instanceof RVP_PHP_SDK_Thing)) {
                        $ret[] = $new_object;
                    } else {
                        $this->set_error(_ERR_INTERNAL_ERR__);
                        return [];
                    }
                }
        
                if (isset($ret) && is_array($ret) && (0 < count($ret))) {
                    usort($ret, function($a, $b) {
                                    if ($a->id() == $b->id()) {
                                        return 0;
                                    }
                        
                                    if ($a->id() < $b->id()) {
                                        return -1;
                                    }
                        
                                    return 1;
                                }
                    );
                }
            }
        } else {
            $this->set_error(_ERR_COMM_ERR__);
            return [];
        }
        
        return $ret;
    }
    
    /***********************/
    function general_location_search(   $in_location    
                                    ) {
        return $this->general_search(NULL, $in_location);
    }
    
    /***********************/
    function people_location_search(    $in_location,               
                                        $in_get_logins_only = false 
                                    ) {
        return $this->people_search(NULL, $in_location, $in_get_logins_only);
    }
    
    /***********************/
    function place_location_search( $in_location    
                                    ) {
        return $this->places_search(NULL, $in_location);
    }
    
    /***********************/
    function thing_location_search( $in_location    
                                    ) {
        return $this->things_search(NULL, $in_location);
    }
    
    /***********************/
    function auto_radius_search(    $in_center_point,                   
                                    $in_target_number = 10,             
                                    $in_search_type = 'all',            
                                    $in_search_string_criteria = NULL,  
                                    $in_step_size_in_km = 0.5,          
                                    $in_max_width_in_km = 100,          
                                    $step_callback = NULL               
                                ) {
        $radius = 0.0;
        $results = [];
        $location = ['latitude' => floatval($in_center_point['latitude']), 'longitude' => floatval($in_center_point['longitude']), 'radius' => $radius];
    
        while (($in_target_number > count($results)) && ($in_max_width_in_km >= ($radius + $in_step_size_in_km))) {
            $radius += floatval($in_step_size_in_km);
            $location['radius'] = $radius;
            switch (strtolower(trim($in_search_type))) {
                case    'people':
                case    'users':
                    $in_search_type = 'users';
                case    'logins':
                    $results = $this->people_search($in_search_string_criteria, $location, ('logins' == $in_search_type));
                    break;
            
                case    'places':
                    $results = $this->places_search($in_search_string_criteria, $location);
                    break;
            
                case    'things':
                    $results = $this->things_search($in_search_string_criteria, $location);
                    break;
            
                default:
                    $in_search_type = 'all';
                    $results = $this->general_search($in_search_string_criteria, $location);
                    break;
            }
            
            // The user can provide a callback that gets a report, and can abort the search.
            if (isset($step_callback)) {
                $abort = false;
                
                if (is_array($step_callback) && (2 == count($step_callback))) {
                    $object = $step_callback[0];
                    $method = $step_callback[1];
                    if (method_exists($object, $method)) {
                        $abort = $object->$method($this, $results, strtolower(trim($in_search_type)), $in_target_number, $in_step_size_in_km, $in_max_width_in_km, $location, $in_search_string_criteria);
                    }
                } elseif (function_exists($step_callback)) {
                    $abort = $step_callback($this, $results, strtolower(trim($in_search_type)), $in_target_number, $in_step_size_in_km, $in_max_width_in_km, $location, $in_search_string_criteria);
                }
                
                if ($abort) {
                    break;
                }
            }
        }
        
        return $results;
    }
                                    
    /***********************/
    function bulk_upload(   $in_csv_data    
                        ) {
        if ($this->is_main_admin()) {
            return json_decode($this->post_data('json/baseline/bulk-loader', NULL, ['data' => $in_csv_data, 'type' => 'text/csv']));
        } else {
            $this->set_error(_ERR_NOT_AUTHORIZED__);
            return NULL;
        }
    }
    
    /***********************/
    function backup() {
        if ($this->is_main_admin()) {
            return $this->fetch_data('csv/baseline/backup');
        } else {
            $this->set_error(_ERR_NOT_AUTHORIZED__);
            return NULL;
        }
    }
    
    /***********************/
    function get_serverinfo() {
        if ($this->is_main_admin()) {
            $result = json_decode($this->fetch_data('json/baseline/serverinfo'));
            if (isset($result->baseline) && isset($result->baseline->serverinfo)) {
                return $result->baseline->serverinfo;
            }
        } else {
            $this->set_error(_ERR_NOT_AUTHORIZED__);
        }
        
        return NULL;
    }
    
    /***********************/
    function test_visibility(   $in_id,                 
                                $in_is_token = false    
                            ) {
        $ret = NULL;
        
        $in_id = intval($in_id);    // Make sure that we're an integer.
        
        // We have our basic standards.
        if ((1 < $in_id) || ($in_is_token && (0 <= $in_id))) {
            $uri = 'json/baseline/visibility/'. ($in_is_token ? 'token/' : '');
            $uri .= $in_id;
            $response = $this->fetch_data($uri);
            if (isset($response)) {
                $response = json_decode($response);
                if (isset($response) && isset($response->baseline)) {
                    $response = $response->baseline;
                    if (isset($response->token) && isset($response->token->login_ids) && is_array($response->token->login_ids) && count($response->token->login_ids)) {
                        $ret = $response->token->login_ids;
                    } elseif (isset($response->id) && isset($response->id->id)) {
                        $response = $response->id;
                        $ret = ['id' => $response->id];
                        if (isset($response->writeable)) {
                            $ret['writeable'] = true;
                        }
                        if (isset($response->read_login_ids) && is_array($response->read_login_ids) && count($response->read_login_ids)) {
                            $ret['read_login_ids'] = $response->read_login_ids;
                        }
                        if (isset($response->write_login_ids) && is_array($response->write_login_ids) && count($response->write_login_ids)) {
                            $ret['write_login_ids'] = $response->write_login_ids;
                        }
                    }
                }
            } else {
            }
        } else {
            $this->set_error(_ERR_INVALID_PARAMETERS__);
            return NULL;
        }
        
        return $ret;
    }
    
    /***********************/
    function new_user(  $in_user_name,          
                        $in_tokens,             
                        $in_login_id = NULL     
                    ) {
        $ret = NULL;
        $need_a_write_in = false;   // This will be true, if we need to force a write token.
        $login_id = (isset($in_login_id) && trim($in_login_id)) ? trim($in_login_id) : NULL; // See if we have a login ID.
            
        if ($this->is_manager()) {  // Must be a manager.
            if ($login_id) { // some prerequisites.
                // We test to see if the login they want is already in use.
                $uri = 'json/people/logins/'.$login_id.'?test';
                $response = $this->fetch_data($uri);
                if (isset($response)) {
                    $response = json_decode($response);
                    if (isset($response) && isset($response->people) && isset($response->people->logins) && isset($response->people->logins->login_exists) && $response->people->logins->login_exists) {
                        $this->set_error(_ERR_INVALID_LOGIN_ID__);
                        return NULL;
                    } else {
                        if (!isset($in_tokens) || !is_array($in_tokens) || !isset($in_tokens['write']) || !intval($in_tokens['write'])) {   // If a valid write token was not supplied, we'll need to add one.
                            $need_a_write_in = true;
                        }
                    }
                } else {
                    $this->set_error(_ERR_COMM_ERR__);
                    return NULL;
                }
            } else {    // If we are not creating a login, then we are required to have a valid write token.
                if (!isset($in_tokens) || !isset($in_tokens['write']) || (1 > intval($in_tokens['write'])) || !in_array(intval($in_tokens['write']), $this->my_tokens())) {
                    $this->set_error(_ERR_INVALID_PARAMETERS__);
                    return NULL;
                }
            }
            
        } else {
            $this->set_error(_ERR_NOT_AUTHORIZED__);
            return NULL;
        }
        
        // If we got here, then we're clear, so far.
        $uri = 'json/people/people';
        $params = '';
        if ($login_id) {
            $params .= '&login_id='.urlencode($login_id);
        }
        
        if (isset($in_tokens) && is_array($in_tokens) && count($in_tokens) && isset($in_tokens['read'])) {
            $params .= '&read_token='.intval($in_tokens['read']);
        }
        
        if (isset($in_tokens) && is_array($in_tokens) && count($in_tokens) && isset($in_tokens['write']) && (0 < intval($in_tokens['write']))) {
            $params .= '&write_token='.intval($in_tokens['write']);
        }
        
        if (isset($in_tokens) && is_array($in_tokens) && count($in_tokens) && isset($in_tokens['tokens'])) {
            $params .= '&tokens='.implode(',', array_map('intval', $in_tokens['tokens']));
        }
        
        $uri .= '/?'.trim($params, "\&");
         
        $response = $this->post_data($uri);
        
        if (isset($response)) {
            $response = json_decode($response);
            
            if (isset($response) && isset($response->people) && isset($response->people->people) && isset($response->people->people->new_user)) {
                $ret = [];
                
                if (isset($response->people->people->new_user->associated_login)) {
                    $ret['login_id'] = $response->people->people->new_user->associated_login->login_id;
                    $ret['password'] = $response->people->people->new_user->associated_login->password;
                    unset($response->people->people->new_user->associated_login->password);
                    $id = $response->people->people->new_user->associated_login->id;
                    $response->people->people->new_user->associated_login_id = $id;
                    $ret['login'] = new RVP_PHP_SDK_Login($this, $id, $response->people->people->new_user->associated_login, true);
                    unset($response->people->people->new_user->associated_login);
                }
                
                $ret['user'] = new RVP_PHP_SDK_User($this, $response->people->people->new_user->id, $response->people->people->new_user, true);
            }
        }
        
        return $ret;
    }
    
    /***********************/
    function new_place( $in_place_name,         
                        $in_tokens = [],        
                        $in_latitude = NULL,    
                        $in_longitude = NULL,   
                        $in_fuzz_factor = NULL  
                        ) {
        $ret = NULL;
        
        if ($this->is_logged_in()) {    // Must be logged in.
            $uri = 'json/places';
            $params = '';
            if ($in_place_name) {
                $params .= '&name='.urlencode($in_place_name);
            }
        
            if ($in_latitude) {
                $params .= '&latitude='.floatval($in_latitude);
            }
        
            if ($in_longitude) {
                $params .= '&longitude='.floatval($in_longitude);
            }
        
            if ($in_fuzz_factor) {
                $params .= '&fuzz_factor='.floatval($in_fuzz_factor);
            }
        
            if (isset($in_tokens) && is_array($in_tokens) && count($in_tokens) && isset($in_tokens['read'])) {
                $params .= '&read_token='.intval($in_tokens['read']);
            }
        
            if (isset($in_tokens) && is_array($in_tokens) && count($in_tokens) && isset($in_tokens['write']) && (0 < intval($in_tokens['write']))) {
                $params .= '&write_token='.intval($in_tokens['write']);
            }
        
            $params = trim($params, "\&");
         
            $response = $this->post_data($uri, $params);
        
            if (isset($response)) {
                $response = json_decode($response);
            
                if (isset($response) && isset($response->places) && isset($response->places->new_place)) {
                    $response = $response->places->new_place;
                    
                    $ret = new RVP_PHP_SDK_Place($this, $response->id, $response, true);
                }
            }
        } else {
            $this->set_error(_ERR_NOT_AUTHORIZED__);
            return NULL;
        }
        
        return $ret;
    }
    
    /***********************/
    function new_thing( $in_thing_key,                  
                        $in_thing_value,                
                        $in_tokens = [],                
                        $in_thing_name = NULL,          
                        $in_thing_description = NULL    
                        ) {
        $ret = NULL;
        
        if ($this->is_logged_in() && isset($in_thing_key) && $in_thing_key && isset($in_thing_value) && $in_thing_value) {    // Must be logged in, and we must have the required parameters.
            $uri = 'json/things';
            $params = '';
            
            $in_thing_key = trim($in_thing_key);
            
            if (false !== strpos($in_thing_key, ',')) {    // Cannot have commas in the key.
                $in_thing_key = NULL;
            }
            
            if ($in_thing_key) {
                $params .= '&key='.urlencode($in_thing_key);
            }
            
            if (isset($in_tokens) && is_array($in_tokens) && count($in_tokens) && isset($in_tokens['read'])) {
                $params .= '&read_token='.intval($in_tokens['read']);
            }
            
            if (isset($in_tokens) && is_array($in_tokens) && count($in_tokens) && isset($in_tokens['write']) && (0 < intval($in_tokens['write']))) {
                $params .= '&write_token='.intval($in_tokens['write']);
            }

            if ($in_thing_name) {
                $params .= '&name='.urlencode($in_thing_name);
            }
        
            if ($in_thing_description) {
                $params .= '&description='.urlencode($in_thing_description);
            }
        
            $params = trim($params, "\&");
            
            $temp_file = tempnam(sys_get_temp_dir(), 'RVP');  
            file_put_contents($temp_file , $in_thing_value);
            $finfo = finfo_open(FILEINFO_MIME_TYPE);  
            $content_type = finfo_file($finfo, $temp_file);
            unlink($temp_file);
            $payload = ['data' => $in_thing_value, 'type' => $content_type];
     
            $response = $this->post_data($uri, $params, $payload);
        
            if (isset($response)) {
                $response = json_decode($response);
            
                if (isset($response) && isset($response->things) && isset($response->things->new_thing)) {
                    $response = $response->things->new_thing;
                    
                    $ret = new RVP_PHP_SDK_Thing($this, $response->id, $response, true);
                }
            }
        } else {
            // If they are logged in, then they are authorized, but they don't have required parameters.
            $this->set_error($this->is_logged_in() ? _ERR_INVALID_PARAMETERS__ : _ERR_NOT_AUTHORIZED__);
            return NULL;
        }
        
        return $ret;
    }
    
    /***********************/
    function delete_user(   $in_object  
                        ) {
        $ret = false;
        
        if ($this->is_manager() && isset($in_object)) {  // Must be at least a manager.
            $user_id = 0;
            $login_id = 0;
            
            if ($in_object instanceof RVP_PHP_SDK_User) {
                if ($in_object->writeable()) {  // Have to be able to edit.
                    $user_id = $in_object->id();
                }
            } elseif ($in_object instanceof RVP_PHP_SDK_Login) {
                if ($in_object->writeable()) {  // Have to be able to edit.
                    $login_id = $in_object->id();
                }
            } else {
                $user_id = intval($in_object);
            }
            
            if ($user_id || $login_id) {    // We need to have something to proceed.
                $uri = 'json/people';
                $ret = true;
                
                if ($user_id) {
                    $response = $this->delete_data($uri.'/people/'.$user_id);
        
                    if (isset($response)) {
                        $response = json_decode($response);
            
                        if (!(isset($response) && isset($response->people->people) && isset($response->people->people->deleted_users) && is_array($response->people->people->deleted_users) && (1 == count($response->people->people->deleted_users)) && ($user_id == $response->people->people->deleted_users[0]->id))) {
                            $this->set_error(_ERR_COMM_ERR__);
                            $ret = false;
                        } elseif (isset($response->people->people->deleted_users[0]->associated_login_id)) {
                            $login_id = intval($response->people->people->deleted_users[0]->associated_login_id);
                        } elseif (isset($response->people->people->deleted_users[0]->associated_login)) {
                            $login_id = intval($response->people->people->deleted_users[0]->associated_login->id);
                        }
                    } else {
                        $this->set_error(_ERR_COMM_ERR__);
                        $ret = false;
                    }
                }
                
                if ($ret && $login_id) {
                    $response = $this->delete_data($uri.'/logins/'.$login_id);
        
                    if (isset($response)) {
                        $response = json_decode($response);
            
                        if (!(isset($response) && isset($response->people->logins) && isset($response->people->logins->deleted_logins) && is_array($response->people->logins->deleted_logins) && (1 == count($response->people->logins->deleted_logins)) && ($login_id == $response->people->logins->deleted_logins[0]->id))) {
                            $this->set_error(_ERR_COMM_ERR__);
                            $ret = false;
                        }
                    } else {
                        $this->set_error(_ERR_COMM_ERR__);
                        $ret = false;
                    }
                }
            }
        } else {
            // If they are logged in as a manager, then they are authorized, but they don't have required parameters.
            $this->set_error($this->is_manager() ? _ERR_INVALID_PARAMETERS__ : _ERR_NOT_AUTHORIZED__);
        }
        
        return $ret;
    }
    
    /***********************/
    function delete_place(  $in_object  
                        ) {
        $ret = false;
        
        if ($this->is_logged_in() && isset($in_object)) {  // Must be logged in.
            $place_id = 0;
            
            if ($in_object instanceof RVP_PHP_SDK_Place) {
                $place_id = $in_object->id();
            } else {
                $place_id = intval($in_object);
            }
            
            if ($place_id) {    // Assuming that we have an ID...
                if (isset($this->test_visibility($place_id)['writeable'])) { // We must be able to write.
                    $uri = 'json/places/'.$place_id;
                    $ret = true;
                    $response = $this->delete_data($uri);
        
                    if (isset($response)) {
                        $response = json_decode($response);
            
                        if (!(isset($response) && isset($response->places) && isset($response->places->deleted_places) && is_array($response->places->deleted_places) && (1 == count($response->places->deleted_places)) && ($place_id == $response->places->deleted_places[0]->id))) {
                            $this->set_error(_ERR_COMM_ERR__);
                            $ret = false;
                        }
                    }
                } else {
                    $this->set_error(_ERR_NOT_AUTHORIZED__);
                }
            }
        } else {
            // If they are logged in, then they are authorized, but they don't have required parameters.
            $this->set_error($this->is_logged_in() ? _ERR_INVALID_PARAMETERS__ : _ERR_NOT_AUTHORIZED__);
        }
        
        return $ret;
    }
    
    /***********************/
    function delete_thing(  $in_object  
                        ) {
        $ret = false;
        
        if ($this->is_logged_in() && isset($in_object)) {  // Must be logged in.
            $thing_id = 0;
            
            if ($in_object instanceof RVP_PHP_SDK_thing) {
                $thing_id = $in_object->id();
            } else {    // This is how we resolve string keys. Just fetch the damn object, and extract its ID.
                $thing = $this->get_thing_info($in_object);
                if (isset($thing) && ($thing instanceof RVP_PHP_SDK_thing)) {
                    $thing_id = intval($thing->id());
                }
            }
            
            if ($thing_id) {    // Assuming that we have an ID...
                if (isset($this->test_visibility($thing_id)['writeable'])) { // We must be able to write.
                    $uri = 'json/things/'.$thing_id;
                    $ret = true;
                    $response = $this->delete_data($uri);
        
                    if (isset($response)) {
                        $response = json_decode($response);
            
                        if (!(isset($response) && isset($response->things) && isset($response->things->deleted_things) && is_array($response->things->deleted_things) && (1 == count($response->things->deleted_things)))) {
                            $this->set_error(_ERR_COMM_ERR__);
                            $ret = false;
                        }
                    }
                } else {
                    $this->set_error(_ERR_NOT_AUTHORIZED__);
                }
            }
        } else {
            // If they are logged in, then they are authorized, but they don't have required parameters.
            $this->set_error($this->is_logged_in() ? _ERR_INVALID_PARAMETERS__ : _ERR_NOT_AUTHORIZED__);
        }
        
        return $ret;
    }
};