From 767fd85c1aba8f79591a2ea5a9250c4f47ec4f72 Mon Sep 17 00:00:00 2001
From: Kevin Cyster <kevinc@knowledgetree.com>
Date: Thu, 19 Feb 2009 12:38:41 +0200
Subject: [PATCH] Added webservice functionality for subscriptions

---
 ktapi/ktapi.inc.php | 172 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 172 insertions(+), 0 deletions(-)

diff --git a/ktapi/ktapi.inc.php b/ktapi/ktapi.inc.php
index 01ada2b..5dd0312 100644
--- a/ktapi/ktapi.inc.php
+++ b/ktapi/ktapi.inc.php
@@ -3386,6 +3386,178 @@ class KTAPI
 
         return $response;
 	}
+
+	/**
+	* Method to check if a document is subscribed
+	*
+	* @author KnowledgeTree Team
+	* @access public
+	* @param string $documentID The id of the document
+	* @return array $response The formatted response array
+	*/
+	public function is_document_subscribed($documentID)
+	{
+	    $document = $this->get_document_by_id($documentID);
+	    if(PEAR::isError($document)){
+	        $response['message'] = $document->getMessage();
+	        $response['status_code'] = 1;
+	        return $response;
+	    }
+
+	    $result = $document->isSubscribed();
+        $response['message'] = '';
+        $response['status_code'] = 0;
+	    if($result){
+	        $response['results']['subscribed'] = 'TRUE';
+	    }else{
+	        $response['results']['subscribed'] = 'FALSE';
+	    }
+        return $response;
+	}
+
+	/**
+	* Method to subscribe to a document
+	*
+	* @author KnowledgeTree Team
+	* @access public
+	* @param string $documentID The id of the document
+	* @return array $response The formatted response array
+	*/
+	public function subscribe_to_document($documentID)
+	{
+	    $document = $this->get_document_by_id($documentID);
+	    if(PEAR::isError($document)){
+	        $response['message'] = $document->getMessage();
+	        $response['status_code'] = 1;
+	        return $response;
+	    }
+
+	    $result = $document->subscribe();
+	    if($result === TRUE){
+            $response['message'] = '';
+            $response['status_code'] = 0;
+	        $response['results']['action_result'] = 'TRUE';
+	    }else{
+            $response['message'] = $result;
+            $response['status_code'] = 1;
+	    }
+        return $response;
+	}
+
+	/**
+	* Method to unsubscribe from a document
+	*
+	* @author KnowledgeTree Team
+	* @access public
+	* @param string $documentID The id of the document
+	* @return array $response The formatted response array
+	*/
+	public function unsubscribe_from_document($documentID)
+	{
+	    $document = $this->get_document_by_id($documentID);
+	    if(PEAR::isError($document)){
+	        $response['message'] = $document->getMessage();
+	        $response['status_code'] = 1;
+	        return $response;
+	    }
+
+	    $result = $document->unsubscribe();
+	    if($result === TRUE){
+            $response['message'] = '';
+            $response['status_code'] = 0;
+	        $response['results']['action_result'] = 'TRUE';
+	    }else{
+            $response['message'] = $result;
+            $response['status_code'] = 1;
+	    }
+        return $response;
+	}
+
+	/**
+	* Method to check if a folder is subscribed
+	*
+	* @author KnowledgeTree Team
+	* @access public
+	* @param string $folderID The id of the folder
+	* @return array $response The formatted response array
+	*/
+	public function is_folder_subscribed($folderID)
+	{
+	    $folder = $this->get_folder_by_id($folderID);
+	    if(PEAR::isError($folder)){
+	        $response['message'] = $folder->getMessage();
+	        $response['status_code'] = 1;
+	        return $response;
+	    }
+
+	    $result = $folder->isSubscribed();
+        $response['message'] = '';
+        $response['status_code'] = 0;
+	    if($result){
+	        $response['results']['subscribed'] = 'TRUE';
+	    }else{
+	        $response['results']['subscribed'] = 'FALSE';
+	    }
+        return $response;
+	}
+
+	/**
+	* Method to subscribe to a folder
+	*
+	* @author KnowledgeTree Team
+	* @access public
+	* @param string $folderID The id of the folder
+	* @return array $response The formatted response array
+	*/
+	public function subscribe_to_folder($folderID)
+	{
+	    $folder = $this->get_folder_by_id($folderID);
+	    if(PEAR::isError($folder)){
+	        $response['message'] = $folder->getMessage();
+	        $response['status_code'] = 1;
+	        return $response;
+	    }
+
+	    $result = $folder->subscribe();
+	    if($result === TRUE){
+            $response['message'] = '';
+            $response['status_code'] = 0;
+	        $response['results']['action_result'] = 'TRUE';
+	    }else{
+            $response['message'] = $result;
+            $response['status_code'] = 1;
+	    }
+        return $response;
+	}
+
+	/**
+	* Method to unsubscribe from a folder
+	*
+	* @author KnowledgeTree Team
+	* @access public
+	* @param string $folderID The id of the folder
+	* @return array $response The formatted response array
+	*/
+	public function unsubscribe_from_folder($folderID)
+	{
+	    $folder = $this->get_folder_by_id($folderID);
+	    if(PEAR::isError($folder)){
+	        $response['message'] = $folder->getMessage();
+	        $response['status_code'] = 1;
+	        return $response;
+	    }
+
+	    $result = $folder->unsubscribe();
+	    if($result === TRUE){
+            $response['message'] = '';
+            $response['status_code'] = 0;
+	        $response['results']['action_result'] = 'TRUE';
+	    }else{
+            $response['message'] = $result;
+            $response['status_code'] = 1;
+	    }
+        return $response;
+	}
 }
 
 
--
libgit2 0.21.4