Enhancements in the backend_services_helper.js comments.

This commit is contained in:
Alex Tselegidis 2016-05-15 12:12:46 +02:00
parent b88fd19912
commit 4efa760bdd

View file

@ -9,6 +9,10 @@
* @since v1.0.0 * @since v1.0.0
* ---------------------------------------------------------------------------- */ * ---------------------------------------------------------------------------- */
(function() {
'use strict';
/** /**
* ServicesHelper * ServicesHelper
* *
@ -16,10 +20,6 @@
* *
* @class ServicesHelper * @class ServicesHelper
*/ */
(function() {
'use strict';
function ServicesHelper() { function ServicesHelper() {
this.filterResults = {}; this.filterResults = {};
}; };
@ -29,6 +29,8 @@
/** /**
* Event: Filter Services Form "Submit" * Event: Filter Services Form "Submit"
*
* @param {jQuery.Event} event
*/ */
$('#filter-services form').submit(function(event) { $('#filter-services form').submit(function(event) {
var key = $('#filter-services .key').val(); var key = $('#filter-services .key').val();
@ -168,7 +170,7 @@
/** /**
* Save service record to database. * Save service record to database.
* *
* @param {object} service Contains the service record data. If an 'id' value is provided * @param {Object} service Contains the service record data. If an 'id' value is provided
* then the update operation is going to be executed. * then the update operation is going to be executed.
*/ */
ServicesHelper.prototype.save = function(service) { ServicesHelper.prototype.save = function(service) {
@ -193,13 +195,13 @@
/** /**
* Delete a service record from database. * Delete a service record from database.
* *
* @param {numeric} id Record id to be deleted. * @param {Number} id Record ID to be deleted.
*/ */
ServicesHelper.prototype.delete = function(id) { ServicesHelper.prototype.delete = function(id) {
var postUrl = GlobalVariables.baseUrl + '/index.php/backend_api/ajax_delete_service', var postUrl = GlobalVariables.baseUrl + '/index.php/backend_api/ajax_delete_service',
postData = { postData = {
'csrfToken': GlobalVariables.csrfToken, csrfToken: GlobalVariables.csrfToken,
'service_id': id service_id: id
}; };
$.post(postUrl, postData, function(response) { $.post(postUrl, postData, function(response) {
@ -217,8 +219,9 @@
/** /**
* Validates a service record. * Validates a service record.
* *
* @param {object} service Contains the service data. * @param {Object} service Contains the service data.
* @returns {bool} Returns the validation result. *
* @return {Boolean} Returns the validation result.
*/ */
ServicesHelper.prototype.validate = function(service) { ServicesHelper.prototype.validate = function(service) {
$('#services .required').css('border', ''); $('#services .required').css('border', '');
@ -265,7 +268,7 @@
/** /**
* Display a service record into the service form. * Display a service record into the service form.
* *
* @param {object} service Contains the service record data. * @param {Object} service Contains the service record data.
*/ */
ServicesHelper.prototype.display = function(service) { ServicesHelper.prototype.display = function(service) {
$('#service-id').val(service.id); $('#service-id').val(service.id);
@ -282,11 +285,10 @@
/** /**
* Filters service records depending a string key. * Filters service records depending a string key.
* *
* @param {string} key This is used to filter the service records of the database. * @param {String} key This is used to filter the service records of the database.
* @param {numeric} selectId (OPTIONAL = undefined) If set then after the filter * @param {Number} selectId Optional, if set then after the filter operation the record with this
* operation the record with this id will be selected (but not displayed). * ID will be selected (but not displayed).
* @param {bool} display (OPTIONAL = false) If true then the selected record will * @param {Boolean} display Optional (false), if true then the selected record will be displayed on the form.
* be displayed on the form.
*/ */
ServicesHelper.prototype.filter = function(key, selectId, display) { ServicesHelper.prototype.filter = function(key, selectId, display) {
display = display || false; display = display || false;
@ -323,10 +325,13 @@
}; };
/** /**
* Get a service row html code that is going to be displayed on the filter results list. * Get Filter HTML
* *
* @param {object} service Contains the service record data. * Get a service row HTML code that is going to be displayed on the filter results list.
* @returns {string} The html code that represents the record on the filter results list. *
* @param {Object} service Contains the service record data.
*
* @return {String} The HTML code that represents the record on the filter results list.
*/ */
ServicesHelper.prototype.getFilterHtml = function(service) { ServicesHelper.prototype.getFilterHtml = function(service) {
var html = var html =
@ -343,9 +348,8 @@
* Select a specific record from the current filter results. If the service id does not exist * Select a specific record from the current filter results. If the service id does not exist
* in the list then no record will be selected. * in the list then no record will be selected.
* *
* @param {numeric} id The record id to be selected from the filter results. * @param {Number} id The record id to be selected from the filter results.
* @param {bool} display (OPTIONAL = false) If true then the method will display the record * @param {Boolean} display Optional (false), if true then the method will display the record on the form.
* on the form.
*/ */
ServicesHelper.prototype.select = function(id, display) { ServicesHelper.prototype.select = function(id, display) {
display = display || false; display = display || false;