/** * Groups API interface * * @author Pierre HUBERT */ ComunicWeb.components.groups.interface = { /** * Create a group * * @param {String} name The name of the group to create * @param {Function} callback */ create: function(name, callback){ //Perform a request over the API var apiURI = "groups/create"; var params = { name: name }; ComunicWeb.common.api.makeAPIrequest(apiURI, params, true, callback); }, /** * Get information about a group * * @param {Number} id The ID of the target group * @param {Function} callback Callback */ getInfo: function(id, callback){ //Perform the request over the API var apiURI = "groups/get_info"; var params = { id: id }; ComunicWeb.common.api.makeAPIrequest(apiURI, params, true, callback); }, /** * Get advanced information about a group * * @param {Number} id The ID of the target group * @param {Function} callback Callback */ getAdvancedInfo: function(id, callback){ //Perform the request over the API var apiURI = "groups/get_advanced_info"; var params = { id: id }; ComunicWeb.common.api.makeAPIrequest(apiURI, params, true, callback); }, /** * Get the settings of a group * * @param {Number} id The ID of the target group * @param {Function} callback */ getSettings: function(id, callback){ //Perform the request over the API var apiURI = "groups/get_settings"; var params = { id: id }; ComunicWeb.common.api.makeAPIrequest(apiURI, params, true, callback); }, /** * Set (update) the settings of a group * * @param {Number} id The ID of the target group * @param {Object} settings The new settings to apply to * the group * @param {Function} callback */ setSettings: function(id, settings, callback){ //Perform the request over the API var apiURI = "groups/set_settings"; settings.id = id; ComunicWeb.common.api.makeAPIrequest(apiURI, settings, true, callback); }, /** * Upload a new group logo * * @param {Number} id The ID of the target group * @param {FormData} data The form data that contains the * new logo (parameter name : logo) * @param {Function} callback */ uploadLogo: function(id, data, callback){ //Perform the request over the API var apiURI = "groups/upload_logo"; data.append("id", id); ComunicWeb.common.api.makeFormDatarequest(apiURI, data, true, callback); }, /** * Delete user logo * * @param {Number} id The ID of the target group * @param {Function} callback */ deleteLogo: function(id, callback){ //Perform the request over the API var apiURI = "groups/delete_logo"; var params = { id: id }; ComunicWeb.common.api.makeAPIrequest(apiURI, params, true, callback); }, /** * Respond to a group invitation * * @param {Number} id The ID of the target group * @param {Boolean} accept Specify whether the invitation was * accepted or not * @param {Function} callback */ respondInvitation: function(id, accept, callback) { //Perform the request over the API var apiURI = "groups/respond_invitation"; var params = { id: id, accept: accept }; ComunicWeb.common.api.makeAPIrequest(apiURI, params, true, callback); }, /** * Cancel a membership request * * @param {Number} id The ID of the target group * @param {Function} callback */ cancelRequest: function(id, callback){ //Perform the request over the API var apiURI = "groups/cancel_request"; var params = { id: id }; ComunicWeb.common.api.makeAPIrequest(apiURI, params, true, callback); }, /** * Send a request to join a group * * @param {Number} id The ID of the target group * @param {Function} callback */ sendRequest: function(id, callback){ //Perform the request over the API var apiURI = "groups/send_request"; var params = { id: id }; ComunicWeb.common.api.makeAPIrequest(apiURI, params, true, callback); }, /** * Get the members of a group * * @param {Number} id The ID of the target group * @param {Function} callback */ getMembers: function(id, callback){ //Perform the request over the API var apiURI = "groups/get_members"; var params = { id: id }; ComunicWeb.common.api.makeAPIrequest(apiURI, params, true, callback); } };