ifl/iflrandevu
1
1
Fork 0
forked from mirrors/easyappointments
Code Issues 6 Pull requests Releases 3 Activity

Refactor the categories helper JS file so that it becomes a standalone module.

Browse source
This commit is contained in:
Alex Tselegidis 2022-01-10 09:26:28 +01:00
parent 195680e8b3
commit e2bffc5e95
5 changed files with 138 additions and 229 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

9
application/controllers/Categories.php
View file

@ -52,6 +52,11 @@ class Categories extends EA_Controller {
$role_slug = session('role_slug');
script_vars([
'user_id' => $user_id,
'role_slug' => $role_slug,
]);
html_vars([
'page_title' => lang('categories'),
'active_menu' => PRIV_SERVICES,
@ -100,7 +105,7 @@ class Categories extends EA_Controller {
{
try
{
$category = json_decode(request('category'), TRUE);
$category = request('category');
if (cannot('add', PRIV_SERVICES))
{
@ -127,7 +132,7 @@ class Categories extends EA_Controller {
{
try
{
$category = json_decode(request('category'), TRUE);
$category = request('category');
if (cannot('edit', PRIV_SERVICES))
{

27
application/views/pages/categories.php
View file

@ -87,27 +87,10 @@
<?php section('scripts') ?>
<script src="<?= asset_url('assets/js/pages/backend_categories_helper.js') ?>"></script>
<script src="<?= asset_url('assets/js/pages/backend_categories.js') ?>"></script>
<script>
var GlobalVariables = {
csrfToken: <?= json_encode($this->security->get_csrf_hash()) ?>,
baseUrl: <?= json_encode(config('base_url')) ?>,
dateFormat: <?= json_encode(setting('date_format')) ?>,
timeFormat: <?= json_encode(setting('time_format')) ?>,
timezones: <?= json_encode($timezones) ?>,
user: {
id: <?= session('user_id') ?>,
email: <?= json_encode(session('user_email')) ?>,
timezone: <?= json_encode(session('timezone')) ?>,
role_slug: <?= json_encode(session('role_slug')) ?>,
privileges: <?= json_encode($privileges) ?>
}
};
$(function () {
BackendCategories.initialize(true);
});
</script>
<script src="<?= asset_url('assets/js/utils/message.js') ?>"></script>
<script src="<?= asset_url('assets/js/utils/validation.js') ?>"></script>
<script src="<?= asset_url('assets/js/utils/url.js') ?>"></script>
<script src="<?= asset_url('assets/js/http/categories_http_client.js') ?>"></script>
<script src="<?= asset_url('assets/js/pages/categories.js') ?>"></script>
<?php section('scripts') ?>

20
assets/js/http/categories_http_client.js
View file

@ -11,7 +11,18 @@
App.Http.Categories = (function () {
/**
* Create an category.
* Save (create or update) a category.
*
* @param {Object} category
*
* @return {Object}
*/
function save(category) {
return category.id ? update(category) : create(category);
}
/**
* Create a category.
*
* @param {Object} category
*
@ -29,7 +40,7 @@ App.Http.Categories = (function () {
}
/**
* Update an category.
* Update a category.
*
* @param {Object} category
*
@ -47,7 +58,7 @@ App.Http.Categories = (function () {
}
/**
* Delete an category.
* Delete a category.
*
* @param {Number} categoryId
*
@ -89,7 +100,7 @@ App.Http.Categories = (function () {
}
/**
* Find an category.
* Find a category.
*
* @param {Number} categoryId
*
@ -107,6 +118,7 @@ App.Http.Categories = (function () {
}
return {
save,
create,
update,
destroy,

62
assets/js/pages/backend_categories.js
View file

@ -1,62 +0,0 @@
/* ----------------------------------------------------------------------------
* Easy!Appointments - Open Source Web Scheduler
*
* @package EasyAppointments
* @author A.Tselegidis <alextselegidis@gmail.com>
* @copyright Copyright (c) Alex Tselegidis
* @license https://opensource.org/licenses/GPL-3.0 - GPLv3
* @link https://easyappointments.org
* @since v1.0.0
* ---------------------------------------------------------------------------- */
window.BackendCategories = window.BackendCategories || {};
/**
* Backend Categories
*
* This namespace handles the js functionality of the backend categories page.
*
* @module BackendCategories
*/
(function (exports) {
'use strict';
/**
* Contains the basic record methods for the page.
*
* @type {CategoriesHelper}
*/
var helper;
var categoriesHelper = new CategoriesHelper();
/**
* Default initialize method of the page.
*
* @param {Boolean} [defaultEventHandlers] Optional (true), determines whether to bind the default event handlers.
*/
exports.initialize = function (defaultEventHandlers) {
defaultEventHandlers = defaultEventHandlers || true;
// Instantiate helper object (category helper by default).
helper = categoriesHelper;
helper.resetForm();
helper.filter('');
helper.bindEventHandlers();
if (defaultEventHandlers) {
bindEventHandlers();
}
Backend.placeFooterToBottom();
};
/**
* Binds the default event handlers of the backend categories page.
*
* Do not use this method if you include the "BackendCategories" namespace on another page.
*/
function bindEventHandlers() {
//
}
})(window.BackendCategories);

249
assets/js/pages/backend_categories_helper.js → assets/js/pages/categories.js
View file

@ -9,39 +9,26 @@
* @since v1.0.0
* ---------------------------------------------------------------------------- */
(function () {
'use strict';
/**
* CategoriesHelper Class
*
* This class contains the core method implementations that belong to the categories tab
* of the backend services page.
*
* @class CategoriesHelper
*/
function CategoriesHelper() {
this.filterResults = {};
this.filterLimit = 20;
}
App.Pages.Categories = (function () {
const $categories = $('#categories');
let filterResults = {};
let filterLimit = 20;
/**
* Binds the default event handlers of the categories tab.
*/
CategoriesHelper.prototype.bindEventHandlers = function () {
var instance = this;
function bindEventHandlers() {
/**
* Event: Filter Categories Form "Submit"
*
* @param {jQuery.Event} event
*/
$('#categories').on('submit', '#filter-categories form', function (event) {
$categories.on('submit', '#filter-categories form', function (event) {
event.preventDefault();
var key = $('#filter-categories .key').val();
const key = $('#filter-categories .key').val();
$('.selected').removeClass('selected');
instance.resetForm();
instance.filter(key);
resetForm();
filter(key);
});
/**
@ -49,19 +36,19 @@
*
* Displays the selected row data on the right side of the page.
*/
$('#categories').on('click', '.category-row', function () {
$categories.on('click', '.category-row', function () {
if ($('#filter-categories .filter').prop('disabled')) {
$('#filter-categories .results').css('color', '#AAA');
return; // exit because we are on edit mode
}
var categoryId = $(this).attr('data-id');
const categoryId = $(this).attr('data-id');
var category = instance.filterResults.find(function (filterResult) {
const category = filterResults.find(function (filterResult) {
return Number(filterResult.id) === Number(categoryId);
});
instance.display(category);
display(category);
$('#filter-categories .selected').removeClass('selected');
$(this).addClass('selected');
$('#edit-category, #delete-category').prop('disabled', false);
@ -70,8 +57,8 @@
/**
* Event: Add Category Button "Click"
*/
$('#categories').on('click', '#add-category', function () {
instance.resetForm();
$categories.on('click', '#add-category', function () {
resetForm();
$('#categories .add-edit-delete-group').hide();
$('#categories .save-cancel-group').show();
$('#categories .record-details').find('input, select, textarea').prop('disabled', false);
@ -82,7 +69,7 @@
/**
* Event: Edit Category Button "Click"
*/
$('#categories').on('click', '#edit-category', function () {
$categories.on('click', '#edit-category', function () {
$('#categories .add-edit-delete-group').hide();
$('#categories .save-cancel-group').show();
$('#categories .record-details').find('input, select, textarea').prop('disabled', false);
@ -93,10 +80,10 @@
/**
* Event: Delete Category Button "Click"
*/
$('#categories').on('click', '#delete-category', function () {
var categoryId = $('#category-id').val();
$categories.on('click', '#delete-category', function () {
const categoryId = $('#category-id').val();
var buttons = [
const buttons = [
{
text: App.Lang.cancel,
click: function () {
@ -106,20 +93,20 @@
{
text: App.Lang.delete,
click: function () {
instance.delete(categoryId);
remove(categoryId);
$('#message-box').dialog('close');
}
}
];
GeneralFunctions.displayMessageBox(App.Lang.delete_category, App.Lang.delete_record_prompt, buttons);
App.Utils.Message.show(App.Lang.delete_category, App.Lang.delete_record_prompt, buttons);
});
/**
* Event: Categories Save Button "Click"
*/
$('#categories').on('click', '#save-category', function () {
var category = {
$categories.on('click', '#save-category', function () {
const category = {
name: $('#category-name').val(),
description: $('#category-description').val()
};
@ -128,30 +115,30 @@
category.id = $('#category-id').val();
}
if (!instance.validate()) {
if (!validate()) {
return;
}
instance.save(category);
save(category);
});
/**
* Event: Cancel Category Button "Click"
*/
$('#categories').on('click', '#cancel-category', function () {
var id = $('#category-id').val();
instance.resetForm();
$categories.on('click', '#cancel-category', function () {
const id = $('#category-id').val();
resetForm();
if (id !== '') {
instance.select(id, true);
select(id, true);
}
});
};
}
/**
* Remove the previously registered event handlers.
*/
CategoriesHelper.prototype.unbindEventHandlers = function () {
$('#categories')
function unbindEventHandlers() {
$categories
.off('click', '#filter-categories .clear')
.off('submit', '#filter-categories form')
.off('click', '.category-row')
@ -160,7 +147,7 @@
.off('click', '#delete-category')
.off('click', '#save-category')
.off('click', '#cancel-category');
};
}
/**
* Filter service categories records.
@ -168,122 +155,93 @@
* @param {String} keyword This key string is used to filter the category records.
* @param {Number} selectId Optional, if set then after the filter operation the record with the given
* ID will be selected (but not displayed).
* @param {Boolean} display Optional (false), if true then the selected record will be displayed on the form.
* @param {Boolean} show Optional (false), if true then the selected record will be displayed on the form.
*/
CategoriesHelper.prototype.filter = function (keyword, selectId, display) {
var url = GlobalVariables.baseUrl + '/index.php/categories/search';
function filter(keyword, selectId = null, show = false) {
App.Http.Categories.search(keyword, filterLimit).then((response) => {
filterResults = response;
var data = {
csrf_token: GlobalVariables.csrfToken,
keyword: keyword,
limit: this.filterLimit
};
$('#filter-categories .results').empty();
$.post(url, data).done(
function (response) {
this.filterResults = response;
response.forEach(
function (category) {
$('#filter-categories .results').append(getFilterHtml(category)).append($('<hr/>'));
}.bind(this)
);
$('#filter-categories .results').empty();
response.forEach(
function (category) {
$('#filter-categories .results').append(this.getFilterHtml(category)).append($('<hr/>'));
}.bind(this)
if (response.length === 0) {
$('#filter-categories .results').append(
$('<em/>', {
'text': App.Lang.no_records_found
})
);
} else if (response.length === filterLimit) {
$('<button/>', {
'type': 'button',
'class': 'btn btn-outline-secondary w-100 load-more text-center',
'text': App.Lang.load_more,
'click': function () {
filterLimit += 20;
filter(keyword, selectId, show);
}.bind(this)
}).appendTo('#filter-categories .results');
}
if (response.length === 0) {
$('#filter-categories .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-categories .results');
}
if (selectId) {
this.select(selectId, display);
}
}.bind(this)
);
};
if (selectId) {
select(selectId, show);
}
});
}
/**
* Save a category record to the database (via AJAX post).
*
* @param {Object} category Contains the category data.
*/
CategoriesHelper.prototype.save = function (category) {
var url = GlobalVariables.baseUrl + '/index.php/categories/' + (category.id ? 'update' : 'create');
var data = {
csrf_token: GlobalVariables.csrfToken,
category: JSON.stringify(category)
};
$.post(url, data).done(
function (response) {
Backend.displayNotification(App.Lang.category_saved);
this.resetForm();
$('#filter-categories .key').val('');
this.filter('', response.id, true);
}.bind(this)
);
};
function save(category) {
App.Http.Categories.save(category).then((response) => {
Backend.displayNotification(App.Lang.category_saved);
resetForm();
$('#filter-categories .key').val('');
filter('', response.id, true);
});
}
/**
* Delete category record.
*
* @param {Number} id Record ID to be deleted.
*/
CategoriesHelper.prototype.delete = function (id) {
var url = GlobalVariables.baseUrl + '/index.php/categories/destroy';
var data = {
csrf_token: GlobalVariables.csrfToken,
category_id: id
};
$.post(url, data).done(
function () {
Backend.displayNotification(App.Lang.category_deleted);
this.resetForm();
this.filter($('#filter-categories .key').val());
}.bind(this)
);
};
function remove(id) {
App.Http.Categories.destroy(id).then(() => {
Backend.displayNotification(App.Lang.category_deleted);
resetForm();
filter($('#filter-categories .key').val());
});
}
/**
* Display a category record on the form.
*
* @param {Object} category Contains the category data.
*/
CategoriesHelper.prototype.display = function (category) {
function display(category) {
$('#category-id').val(category.id);
$('#category-name').val(category.name);
$('#category-description').val(category.description);
};
}
/**
* Validate category data before save (insert or update).
*
* @return {Boolean} Returns the validation result.
*/
CategoriesHelper.prototype.validate = function () {
function validate() {
$('#categories .is-invalid').removeClass('is-invalid');
$('#categories .form-message').removeClass('alert-danger').hide();
try {
var missingRequired = false;
let missingRequired = false;
$('#categories .required').each(function (index, requiredField) {
if (!$(requiredField).val()) {
@ -301,12 +259,12 @@
$('#categories .form-message').addClass('alert-danger').text(error.message).show();
return false;
}
};
}
/**
* Bring the category form back to its initial state.
*/
CategoriesHelper.prototype.resetForm = function () {
function resetForm() {
$('#filter-categories .selected').removeClass('selected');
$('#filter-categories button').prop('disabled', false);
$('#filter-categories .results').css('color', '');
@ -318,7 +276,7 @@
$('#categories .record-details .is-invalid').removeClass('is-invalid');
$('#categories .record-details .form-message').hide();
};
}
/**
* Get the filter results row HTML code.
@ -327,7 +285,7 @@
*
* @return {String} Returns the record HTML code.
*/
CategoriesHelper.prototype.getFilterHtml = function (category) {
function getFilterHtml(category) {
return $('<div/>', {
'class': 'category-row entry',
'data-id': category.id,
@ -338,7 +296,7 @@
$('<br/>')
]
});
};
}
/**
* Select a specific record from the current filter results.
@ -346,28 +304,41 @@
* If the category ID does not exist in the list then no record will be selected.
*
* @param {Number} id The record ID to be selected from the filter results.
* @param {Boolean} display Optional (false), if true then the method will display the record
* @param {Boolean} show Optional (false), if true then the method will display the record
* on the form.
*/
CategoriesHelper.prototype.select = function (id, display) {
display = display || false;
function select(id, show = false) {
$('#filter-categories .selected').removeClass('selected');
$('#filter-categories .category-row[data-id="' + id + '"]').addClass('selected');
if (display) {
var category = this.filterResults.find(
if (show) {
const category = filterResults.find(
function (category) {
return Number(category.id) === Number(id);
}.bind(this)
);
this.display(category);
display(category);
$('#edit-category, #delete-category').prop('disabled', false);
}
};
}
window.CategoriesHelper = CategoriesHelper;
function init() {
resetForm();
filter('');
bindEventHandlers();
}
document.addEventListener('DOMContentLoaded', init);
return {
filter,
save,
remove,
getFilterHtml,
resetForm,
select
};
})();