From e9816310fcb009713b3eb13bcec40d1c7f68ed38 Mon Sep 17 00:00:00 2001
From: Sam Tuke <samtuke@owncloud.com>
Date: Sat, 14 Jun 2014 16:57:18 +0200
Subject: [PATCH] Documented function apiUrl

---
 plugins/restapi_test/main.php | 27 +++++++++++++++++----------
 1 file changed, 17 insertions(+), 10 deletions(-)

diff --git a/plugins/restapi_test/main.php b/plugins/restapi_test/main.php
index d67f7c1..82e29b4 100644
--- a/plugins/restapi_test/main.php
+++ b/plugins/restapi_test/main.php
@@ -345,26 +345,33 @@
 
 <?php
 
+    /**
+     * @return $trimmedUrl
+     */
     function apiUrl( $website ){
 
         $url = '';
+        
         if( !empty( $_SERVER["HTTPS"] ) ){
-            if($_SERVER["HTTPS"]!=="off")
+            
+            // Check which protocol to use
+            if($_SERVER["HTTPS"]!=="off") {
                 $url = 'https://'; //https
-            else
+            } else {
                 $url = 'http://'; //http
-        }
-        else
+            }
+        } else {
             $url = 'http://'; //http
-
+        }
+        
         $api_url = str_replace( 'page=main&pi=restapi_test', 'page=call&pi=restapi', $_SERVER['REQUEST_URI'] );
-        $api_url = str_replace( 'page=main&pi=restapi', 'page=call&pi=restapi', $api_url );
+        $api_url1 = str_replace( 'page=main&pi=restapi', 'page=call&pi=restapi', $api_url );
 
-        $url = $url . $website . $api_url;
-        $url = rtrim($url,'/');
+        $concatenatedUrl = $url . $website . $api_url1;
+        $trimmedUrl = rtrim($concatenatedUrl,'/');
 
-        return $url;
+        return $trimmedUrl;
 
     }
-
+    
 ?>