easyappointments/assets/js/pages/backend_providers_helper.js

665 lines
25 KiB
JavaScript
Raw Normal View History

/* ----------------------------------------------------------------------------
* Easy!Appointments - Open Source Web Scheduler
*
* @package EasyAppointments
* @author A.Tselegidis <alextselegidis@gmail.com>
2021-12-18 19:43:45 +03:00
* @copyright Copyright (c) Alex Tselegidis
* @license https://opensource.org/licenses/GPL-3.0 - GPLv3
* @link https://easyappointments.org
* @since v1.0.0
* ---------------------------------------------------------------------------- */
(function () {
'use strict';
/**
* Providers Helper
*
* This class contains the Providers helper class declaration, along with the "Providers" tab
* event handlers. By dividing the backend/users tab functionality into separate files
* it is easier to maintain the code.
*
* @class ProvidersHelper
*/
var ProvidersHelper = function () {
this.filterResults = {}; // Store the results for later use.
this.filterLimit = 20;
};
/**
* Bind the event handlers for the backend/users "Providers" tab.
*/
ProvidersHelper.prototype.bindEventHandlers = function () {
/**
* Event: Filter Providers Form "Submit"
*
* Filter the provider records with the given key string.
*
* @param {jQuery.Event} event
*/
$('#providers').on(
'submit',
'#filter-providers form',
function (event) {
event.preventDefault();
var key = $('#filter-providers .key').val();
$('.selected').removeClass('selected');
this.resetForm();
this.filter(key);
}.bind(this)
);
/**
* Event: Filter Provider Row "Click"
*
* Display the selected provider data to the user.
*/
$('#providers').on(
'click',
'.provider-row',
function (event) {
if ($('#filter-providers .filter').prop('disabled')) {
$('#filter-providers .results').css('color', '#AAA');
return; // Exit because we are currently on edit mode.
}
var providerId = $(event.currentTarget).attr('data-id');
var provider = this.filterResults.find(function (filterResult) {
return Number(filterResult.id) === Number(providerId);
});
this.display(provider);
$('#filter-providers .selected').removeClass('selected');
$(event.currentTarget).addClass('selected');
$('#edit-provider, #delete-provider').prop('disabled', false);
}.bind(this)
);
/**
* Event: Add New Provider Button "Click"
*/
$('#providers').on(
'click',
'#add-provider',
function () {
this.resetForm();
$('#filter-providers button').prop('disabled', true);
$('#filter-providers .results').css('color', '#AAA');
$('#providers .add-edit-delete-group').hide();
$('#providers .save-cancel-group').show();
$('#providers .record-details').find('input, select, textarea').prop('disabled', false);
$('#provider-password, #provider-password-confirm').addClass('required');
$('#providers')
.find(
'.add-break, .edit-break, .delete-break, .add-working-plan-exception, .edit-working-plan-exception, .delete-working-plan-exception, #reset-working-plan'
)
.prop('disabled', false);
$('#provider-services input:checkbox').prop('disabled', false);
// Apply default working plan
BackendProviders.wp.setup(GlobalVariables.workingPlan);
BackendProviders.wp.timepickers(false);
}.bind(this)
);
/**
* Event: Edit Provider Button "Click"
*/
$('#providers').on('click', '#edit-provider', function () {
$('#providers .add-edit-delete-group').hide();
$('#providers .save-cancel-group').show();
$('#filter-providers button').prop('disabled', true);
$('#filter-providers .results').css('color', '#AAA');
$('#providers .record-details').find('input, select, textarea').prop('disabled', false);
$('#provider-password, #provider-password-confirm').removeClass('required');
$('#provider-services input:checkbox').prop('disabled', false);
$('#providers')
.find(
'.add-break, .edit-break, .delete-break, .add-working-plan-exception, .edit-working-plan-exception, .delete-working-plan-exception, #reset-working-plan'
)
.prop('disabled', false);
$('#providers input:checkbox').prop('disabled', false);
BackendProviders.wp.timepickers(false);
});
/**
* Event: Delete Provider Button "Click"
*/
$('#providers').on(
'click',
'#delete-provider',
function () {
var providerId = $('#provider-id').val();
var buttons = [
{
text: App.Lang.cancel,
click: function () {
$('#message-box').dialog('close');
}
},
{
text: App.Lang.delete,
click: function () {
this.delete(providerId);
$('#message-box').dialog('close');
}.bind(this)
}
];
GeneralFunctions.displayMessageBox(App.Lang.delete_provider, App.Lang.delete_record_prompt, buttons);
}.bind(this)
);
/**
* Event: Save Provider Button "Click"
*/
$('#providers').on(
'click',
'#save-provider',
function () {
var provider = {
first_name: $('#provider-first-name').val(),
last_name: $('#provider-last-name').val(),
email: $('#provider-email').val(),
mobile_number: $('#provider-mobile-number').val(),
phone_number: $('#provider-phone-number').val(),
address: $('#provider-address').val(),
city: $('#provider-city').val(),
state: $('#provider-state').val(),
zip_code: $('#provider-zip-code').val(),
notes: $('#provider-notes').val(),
timezone: $('#provider-timezone').val(),
settings: {
username: $('#provider-username').val(),
working_plan: JSON.stringify(BackendProviders.wp.get()),
working_plan_exceptions: JSON.stringify(BackendProviders.wp.getWorkingPlanExceptions()),
notifications: $('#provider-notifications').prop('checked'),
calendar_view: $('#provider-calendar-view').val()
}
};
// Include provider services.
provider.services = [];
$('#provider-services input:checkbox').each(function (index, checkbox) {
if ($(checkbox).prop('checked')) {
provider.services.push($(checkbox).attr('data-id'));
}
});
// Include password if changed.
if ($('#provider-password').val() !== '') {
provider.settings.password = $('#provider-password').val();
}
// Include id if changed.
if ($('#provider-id').val() !== '') {
provider.id = $('#provider-id').val();
}
if (!this.validate()) {
return;
}
this.save(provider);
}.bind(this)
);
/**
* Event: Cancel Provider Button "Click"
*
* Cancel add or edit of an provider record.
*/
$('#providers').on(
'click',
'#cancel-provider',
function () {
var id = $('#filter-providers .selected').attr('data-id');
this.resetForm();
if (id) {
this.select(id, true);
}
}.bind(this)
);
/**
* Event: Display Provider Details "Click"
*/
$('#providers').on('shown.bs.tab', 'a[data-toggle="tab"]', function () {
Backend.placeFooterToBottom();
});
/**
* Event: Reset Working Plan Button "Click".
*/
$('#providers').on('click', '#reset-working-plan', function () {
$('.breaks tbody').empty();
$('.working-plan-exceptions tbody').empty();
$('.work-start, .work-end').val('');
BackendProviders.wp.setup(GlobalVariables.workingPlan);
BackendProviders.wp.timepickers(false);
});
};
/**
* Remove the previously registered event handlers.
*/
ProvidersHelper.prototype.unbindEventHandlers = function () {
$('#providers')
.off('submit', '#filter-providers form')
.off('click', '#filter-providers .clear')
.off('click', '.provider-row')
.off('click', '#add-provider')
.off('click', '#edit-provider')
.off('click', '#delete-provider')
.off('click', '#save-provider')
.off('click', '#cancel-provider')
.off('shown.bs.tab', 'a[data-toggle="tab"]')
.off('click', '#reset-working-plan');
};
/**
* Save provider record to database.
*
* @param {Object} provider Contains the provider record data. If an 'id' value is provided
* then the update operation is going to be executed.
*/
ProvidersHelper.prototype.save = function (provider) {
var url = GlobalVariables.baseUrl + '/index.php/providers/' + (provider.id ? 'update' : 'create');
var data = {
csrf_token: GlobalVariables.csrfToken,
provider: JSON.stringify(provider)
};
$.post(url, data).done(
function (response) {
Backend.displayNotification(App.Lang.provider_saved);
this.resetForm();
$('#filter-providers .key').val('');
this.filter('', response.id, true);
}.bind(this)
);
};
/**
* Delete a provider record from database.
*
* @param {Number} id Record id to be deleted.
*/
ProvidersHelper.prototype.delete = function (id) {
var url = GlobalVariables.baseUrl + '/index.php/providers/destroy';
var data = {
csrf_token: GlobalVariables.csrfToken,
provider_id: id
};
$.post(url, data).done(
function () {
Backend.displayNotification(App.Lang.provider_deleted);
this.resetForm();
this.filter($('#filter-providers .key').val());
}.bind(this)
);
};
/**
* Validates a provider record.
*
* @return {Boolean} Returns the validation result.
*/
ProvidersHelper.prototype.validate = function () {
$('#providers .is-invalid').removeClass('is-invalid');
$('#providers .form-message').removeClass('alert-danger').hide();
try {
// Validate required fields.
var missingRequired = false;
$('#providers .required').each(function (index, requiredField) {
if (!$(requiredField).val()) {
$(requiredField).addClass('is-invalid');
missingRequired = true;
}
});
if (missingRequired) {
throw new Error(App.Lang.fields_are_required);
}
// Validate passwords.
if ($('#provider-password').val() !== $('#provider-password-confirm').val()) {
$('#provider-password, #provider-password-confirm').addClass('is-invalid');
throw new Error(App.Lang.passwords_mismatch);
}
if (
$('#provider-password').val().length < BackendProviders.MIN_PASSWORD_LENGTH &&
$('#provider-password').val() !== ''
) {
$('#provider-password, #provider-password-confirm').addClass('is-invalid');
throw new Error(
App.Lang.password_length_notice.replace('$number', BackendProviders.MIN_PASSWORD_LENGTH)
);
}
// Validate user email.
if (!GeneralFunctions.validateEmail($('#provider-email').val())) {
$('#provider-email').addClass('is-invalid');
throw new Error(App.Lang.invalid_email);
}
// Check if username exists
if ($('#provider-username').attr('already-exists') === 'true') {
$('#provider-username').addClass('is-invalid');
throw new Error(App.Lang.username_already_exists);
}
return true;
} catch (error) {
$('#providers .form-message').addClass('alert-danger').text(error.message).show();
return false;
}
};
/**
* Resets the provider tab form back to its initial state.
*/
ProvidersHelper.prototype.resetForm = function () {
$('#filter-providers .selected').removeClass('selected');
$('#filter-providers button').prop('disabled', false);
$('#filter-providers .results').css('color', '');
$('#providers .add-edit-delete-group').show();
$('#providers .save-cancel-group').hide();
$('#providers .record-details h3 a').remove();
$('#providers .record-details').find('input, select, textarea').val('').prop('disabled', true);
$('#providers .record-details #provider-calendar-view').val('default');
$('#providers .record-details #provider-timezone').val('UTC');
$('#providers .add-break, .add-working-plan-exception, #reset-working-plan').prop('disabled', true);
BackendProviders.wp.timepickers(true);
$('#providers .working-plan input:text').timepicker('destroy');
$('#providers .working-plan input:checkbox').prop('disabled', true);
$('.breaks').find('.edit-break, .delete-break').prop('disabled', true);
$('.working-plan-exceptions')
.find('.edit-working-plan-exception, .delete-working-plan-exception')
.prop('disabled', true);
$('#providers .record-details .is-invalid').removeClass('is-invalid');
$('#providers .record-details .form-message').hide();
$('#edit-provider, #delete-provider').prop('disabled', true);
$('#provider-services input:checkbox').prop('disabled', true).prop('checked', false);
$('#provider-services a').remove();
$('#providers .working-plan tbody').empty();
$('#providers .breaks tbody').empty();
$('#providers .working-plan-exceptions tbody').empty();
};
/**
* Display a provider record into the provider form.
*
* @param {Object} provider Contains the provider record data.
*/
ProvidersHelper.prototype.display = function (provider) {
$('#provider-id').val(provider.id);
$('#provider-first-name').val(provider.first_name);
$('#provider-last-name').val(provider.last_name);
$('#provider-email').val(provider.email);
$('#provider-mobile-number').val(provider.mobile_number);
$('#provider-phone-number').val(provider.phone_number);
$('#provider-address').val(provider.address);
$('#provider-city').val(provider.city);
$('#provider-state').val(provider.state);
$('#provider-zip-code').val(provider.zip_code);
$('#provider-notes').val(provider.notes);
$('#provider-timezone').val(provider.timezone);
$('#provider-username').val(provider.settings.username);
$('#provider-calendar-view').val(provider.settings.calendar_view);
$('#provider-notifications').prop('checked', Boolean(Number(provider.settings.notifications)));
// Add dedicated provider link.
var dedicatedUrl = GlobalVariables.baseUrl + '/index.php?provider=' + encodeURIComponent(provider.id);
var $link = $('<a/>', {
'href': dedicatedUrl,
'html': [
$('<span/>', {
'class': 'fas fa-link'
})
]
});
$('#providers .details-view h3').find('a').remove().end().append($link);
$('#provider-services a').remove();
$('#provider-services input:checkbox').prop('checked', false);
provider.services.forEach(function (providerServiceId) {
var $checkbox = $('#provider-services input[data-id="' + providerServiceId + '"]');
if (!$checkbox.length) {
return;
}
$checkbox.prop('checked', true);
// Add dedicated service-provider link.
dedicatedUrl =
GlobalVariables.baseUrl +
'/index.php?provider=' +
encodeURIComponent(provider.id) +
'&service=' +
encodeURIComponent(providerServiceId);
$link = $('<a/>', {
'href': dedicatedUrl,
'html': [
$('<span/>', {
'class': 'fas fa-link'
})
]
});
$checkbox.parent().append($link);
});
// Display working plan
var workingPlan = $.parseJSON(provider.settings.working_plan);
BackendProviders.wp.setup(workingPlan);
$('.working-plan').find('input').prop('disabled', true);
$('.breaks').find('.edit-break, .delete-break').prop('disabled', true);
$('#providers .working-plan-exceptions tbody').empty();
var workingPlanExceptions = $.parseJSON(provider.settings.working_plan_exceptions);
BackendProviders.wp.setupWorkingPlanExceptions(workingPlanExceptions);
$('.working-plan-exceptions')
.find('.edit-working-plan-exception, .delete-working-plan-exception')
.prop('disabled', true);
$('#providers .working-plan input:checkbox').prop('disabled', true);
Backend.placeFooterToBottom();
};
/**
* Filters provider records depending a string keyword.
*
* @param {string} keyword This is used to filter the provider records of the database.
* @param {numeric} selectId Optional, if set, when the function is complete a result row can be set as selected.
* @param {bool} display Optional (false), if true the selected record will be also displayed.
*/
ProvidersHelper.prototype.filter = function (keyword, selectId, display) {
display = display || false;
var url = GlobalVariables.baseUrl + '/index.php/providers/search';
var data = {
csrf_token: GlobalVariables.csrfToken,
keyword: keyword,
limit: this.filterLimit
};
$.post(url, data).done(
function (response) {
this.filterResults = response;
$('#filter-providers .results').empty();
response.forEach(
function (provider) {
$('#filter-providers .results').append(this.getFilterHtml(provider)).append($('<hr/>'));
}.bind(this)
);
if (!response.length) {
$('#filter-providers .results').append(
$('<em/>', {
'text': App.Lang.no_records_found
})
);
} else if (response.length === this.filterLimit) {
$('<button/>', {
'type': 'button',
'class': 'btn btn-outline-secondary w-100 load-more text-center',
'text': App.Lang.load_more,
'click': function () {
this.filterLimit += 20;
this.filter(keyword, selectId, display);
}.bind(this)
}).appendTo('#filter-providers .results');
}
if (selectId) {
this.select(selectId, display);
}
}.bind(this)
);
};
/**
* Get an provider row html code that is going to be displayed on the filter results list.
*
* @param {Object} provider Contains the provider record data.
*
* @return {String} The html code that represents the record on the filter results list.
*/
ProvidersHelper.prototype.getFilterHtml = function (provider) {
var name = provider.first_name + ' ' + provider.last_name;
var info = provider.email;
info = provider.mobile_number ? info + ', ' + provider.mobile_number : info;
info = provider.phone_number ? info + ', ' + provider.phone_number : info;
return $('<div/>', {
'class': 'provider-row entry',
'data-id': provider.id,
'html': [
$('<strong/>', {
'text': name
}),
$('<br/>'),
$('<span/>', {
'text': info
}),
$('<br/>')
]
});
};
/**
* Initialize the editable functionality to the break day table cells.
*
* @param {Object} $selector The cells to be initialized.
*/
ProvidersHelper.prototype.editableDayCell = function ($selector) {
var weekDays = {};
weekDays[App.Lang.monday] = 'Monday';
weekDays[App.Lang.tuesday] = 'Tuesday';
weekDays[App.Lang.wednesday] = 'Wednesday';
weekDays[App.Lang.thursday] = 'Thursday';
weekDays[App.Lang.friday] = 'Friday';
weekDays[App.Lang.saturday] = 'Saturday';
weekDays[App.Lang.sunday] = 'Sunday';
$selector.editable(
function (value, settings) {
return value;
},
{
type: 'select',
data: weekDays,
event: 'edit',
height: '30px',
submit: '<button type="button" class="d-none submit-editable">Submit</button>',
cancel: '<button type="button" class="d-none cancel-editable">Cancel</button>',
onblur: 'ignore',
onreset: function (settings, td) {
if (!BackendProviders.enableCancel) {
return false; // disable ESC button
}
},
onsubmit: function (settings, td) {
if (!BackendProviders.enableSubmit) {
return false; // disable Enter button
}
}
}
);
};
/**
* Initialize the editable functionality to the break time table cells.
*
* @param {jQuery} $selector The cells to be initialized.
*/
ProvidersHelper.prototype.editableTimeCell = function ($selector) {
$selector.editable(
function (value, settings) {
// Do not return the value because the user needs to press the "Save" button.
return value;
},
{
event: 'edit',
height: '25px',
submit: '<button type="button" class="d-none submit-editable">Submit</button>',
cancel: '<button type="button" class="d-none cancel-editable">Cancel</button>',
onblur: 'ignore',
onreset: function (settings, td) {
if (!BackendProviders.enableCancel) {
return false; // disable ESC button
}
},
onsubmit: function (settings, td) {
if (!BackendProviders.enableSubmit) {
return false; // disable Enter button
}
}
}
);
};
/**
* Select and display a providers filter result on the form.
*
* @param {Number} id Record id to be selected.
* @param {Boolean} display Optional (false), if true the record will be displayed on the form.
*/
ProvidersHelper.prototype.select = function (id, display) {
display = display || false;
// Select record in filter results.
$('#filter-providers .provider-row[data-id="' + id + '"]').addClass('selected');
// Display record in form (if display = true).
if (display) {
var provider = this.filterResults.find(
function (filterResult) {
return Number(filterResult.id) === Number(id);
}.bind(this)
);
this.display(provider);
$('#edit-provider, #delete-provider').prop('disabled', false);
}
};
window.ProvidersHelper = ProvidersHelper;
})();