From 1d70e373f35d22873438f215a1df769cfb2f3907 Mon Sep 17 00:00:00 2001
From: Pierre <pierre@hubert.fr>
Date: Sat, 10 Jun 2017 10:07:03 +0200
Subject: [PATCH] Progress on create a conversation way

---
 RestControllers/conversationsController.php | 35 +++++++++++++
 classes/components/conversations.php        | 22 ++++++++
 functions/requests.php                      | 56 +++++++++++++++++++++
 3 files changed, 113 insertions(+)
 create mode 100644 RestControllers/conversationsController.php
 create mode 100644 classes/components/conversations.php
 create mode 100644 functions/requests.php

diff --git a/RestControllers/conversationsController.php b/RestControllers/conversationsController.php
new file mode 100644
index 0000000..6f5a689
--- /dev/null
+++ b/RestControllers/conversationsController.php
@@ -0,0 +1,35 @@
+<?php
+/**
+ * Conversations controller
+ *
+ * @author Pierre HUBERT
+ */
+
+class conversationsController{
+
+	/**
+	 * Create a new conversation
+	 *
+	 * @url POST /conversations/create
+	 */
+	public function createConversation(){
+		user_login_required();
+
+		//Check for parametres
+		if(!check_post_parametres(array("name", "follow", "users")))
+			Rest_fatal_error(501, "Please check parametres passed with the request !");
+		
+		//Extract parametres
+		$conversationName = ($_POST["name"] == "false" ? false : $_POST['name']);
+		$followConversation = ($_POST['follow'] == "true" ? true : false);
+		$users = users_list_to_array($_POST['users']);
+
+		//Check users
+		if(count($users) < 1)
+			Rest_fatal_erro(501, "Please select at least one user !");
+		
+		//Perform the request
+		
+	}
+
+}
\ No newline at end of file
diff --git a/classes/components/conversations.php b/classes/components/conversations.php
new file mode 100644
index 0000000..a4ec1a7
--- /dev/null
+++ b/classes/components/conversations.php
@@ -0,0 +1,22 @@
+<?php
+/**
+ * Conversations component
+ *
+ * @author Pierre HUBERT
+ */
+
+class conversations {
+
+	/**
+	 * Create a new conversation
+	 *
+	 * @param Integer $userID The ID of the user creating the conversation
+	 * @param Boolean $follow Defines if the user creating the conversation will follow it 
+	 * @param Array $usersList The list of users following the conversation
+	 * @param Mixed $name Optionnal, the name of the conversation
+	 */
+
+}
+
+//Register component
+Components::register("conversations", new conversations());
\ No newline at end of file
diff --git a/functions/requests.php b/functions/requests.php
new file mode 100644
index 0000000..638cc8b
--- /dev/null
+++ b/functions/requests.php
@@ -0,0 +1,56 @@
+<?php
+/**
+ * Requests functions
+ *
+ * @author Pierre HUBERT
+ */
+
+/**
+ * Check $_POST parametres associated to a request
+ *
+ * @param Array $varList The list of variables to check
+ * @return Boolean True or false depending of the success of the operation
+ */
+function check_post_parametres(array $varList){
+
+	//Check each fields
+	foreach($varList as $process){
+
+		//Check variable existence
+		if(!isset($_POST[$process]))
+			return false; //The variable does not exists
+		
+		//Check variable content
+		if($_POST[$process] == "")
+			return false; //The variable is empty
+
+	}
+
+	//If we arrive there, it is a success
+	return true;
+}
+
+/**
+ * Convert a list of user comma-separated to an array
+ *
+ * @param String $list The input list
+ * @return Array The list of user / an empty list in case of errors
+ */
+function users_list_to_array($list) : array{
+	//Split the list into an array
+	$array = explode(",", $list);
+	$usersList = array();
+
+	foreach($array as $process){
+
+		//Check the entry is valid
+		if(floor($process*1) < 1)
+			return array();
+		
+		//Add the entry to the list
+		$usersList[] = floor($process*1);
+	}
+
+	//Return the result
+	return $usersList;
+}
\ No newline at end of file