MAINHACK

Viewing / Editing File: Helpers.php

<?php

/**
 * create a unique id
 * @return string a truely random unique id example: 5ed8a52d8a0b830247500
 */
function modules_unique_id($name = '') {
    return random_string(20) . str_unique();
}

/**
 * create a unique string
 * @return string a truely random unique id example: 5ed8a52d8a0b830247500
 */
function str_unique() {
    return str_replace('.', '', uniqid('', true));
}

function random_string($length = 10) {
    return str_alphnumeric($length);
}

/**
 * generate random alphanumeric string
 * [example] U7gf5dD
 * @return string
 */
function str_alphnumeric($length = 10) {

$string = '';

// You can define your own characters here.
    $characters = "23457562948562749466789ABCDEFHJKLMNPRTVWXYZ23456789";

for ($p = 0; $p < $length; $p++) {
        $string .= $characters[mt_rand(0, strlen($characters) - 1)];
    }

return $string;
}

/**
 * generate random alphebet string
 * [example] SfgrtJDheyt
 * @return string
 */
function str_alpha($length = 10) {

$string = '';

// You can define your own characters here.
    $characters = "ABCDEFHJKLMNPRTVWXYZabcdefghijklmnopqrstuvwxyz";

for ($p = 0; $p < $length; $p++) {
        $string .= $characters[mt_rand(0, strlen($characters) - 1)];
    }

return $string;
}

/**
 * generate random secure password
 * @param $length length of the password
 * @return string
 */
function generatePassword($length = 15) {

$string = '';

// You can define your own characters here.
    $characters = "#@234575629485!@#$62749466789AB@!##!#@#CDEFHJKLMNPRTVWXYabcdefghijkmnopqrstuvwxyz";

for ($p = 0; $p < $length; $p++) {
        $string .= $characters[mt_rand(0, strlen($characters) - 1)];
    }

return $string;
}

/**
 * set a dropdown as 'selected' based on supplied database value and option value
 * @param string $actual_value value normally coming from database
 * @param string $option_value value of the particular select option
 * @return string
 */
function runtimePreselected($actual_value = '', $option_value = '') {
    if ($option_value == $actual_value) {
        return 'selected';
    }
    return;
}

/**
 * set a checkbox as 'chcked' based on supplied database value and option value
 * @param string $actual_value value normally coming from database
 * @param string $option_value value of the particular checkbox
 * @return string
 */
function runtimePreChecked2($actual_value = '', $option_value = '') {
    if ($option_value == $actual_value) {
        return 'checked';
    }
    return;
}

/**
 * returns "selected" for dropdown list preselection
 * checks if provided value is in provided arrat
 * @example:
 *     <option value="active" {{ runtimePreselectedInArray(project['project_status'], 'active') }}>Active</option>
 * @param $value string actul value coing from database
 * @param $list array the haystack to check againt
 * @return string
 */
function runtimePreselectedInArray($value = '', $list = array()) {

if (!is_array($list) || $value == '') {
        return;
    }

//case  insensitive (unlike in_array)
    foreach ($list as $var) {
        if (strtolower($var) == strtolower($value)) {
            return 'selected';
        }
    }

return;
}

//keywords
    $checked = [
        2, //task completed status
        'yes',
        'on',
        'active',
        'enabled',
        'checked',
        'selected',
        'billable',
        'global',
        'sandbox',
        'completed',
        'toggled', //customfields
        'displayed', //tables config
        'show'];

if (in_array($option_value, $checked) || $option_value == $value) {
        return 'checked';
    }
    return;
}

/**
 * returns "active" for css buttons etc
 * @param $option_value value typicaly coming from the database
 * @return string
 */
function runtimeActive($option_value = '') {

//keywords
    $checked = array('yes', 'active', 'enabled', 'kanban');
    if (in_array($option_value, $checked)) {
        return 'active';
    }

return;
}

/**
 * check if string is empty. If its is, return a placeholder like '---'
 * @param string $var the string to be checked
 * @return string
 */
function runtimeCheckBlank($var = '') {
    if ($var == '' || $var == NULL) {
        return '---';
    }
    return $var;
}

/**
 * user preference on left menu (collapsed or open)
 * @param string $var current users setting
 * @return string css setting
 */
function runtimePreferenceLeftmenuPosition($var = '') {
    if ($var == 'collapsed') {
        return 'mini-sidebar';
    }
    return;
}

/**
 * user preference on left menu (collapsed or open)
 * @param string $var current users setting
 * @return string css setting
 */
function runtimePreferenceStatsPanelPosition($var = '') {
    if ($var == 'collapsed') {
        return 'hidden';
    }
    return;
}

/**
 * user preference on left menu (collapsed or open)
 * @param string $var current users setting
 * @return string css setting
 */
function runtimeMomentFormat($var = '') {

switch ($var) {

case 'd-m-Y':
        return 'DD-MM-YYYY';
        break;
    case 'd/m/Y':
        return 'DD/MM/YYYY';
        break;
    case 'm-d-Y':
        return 'MM-DD-YYYY';
        break;
    case 'm/d/Y':
        return 'MM/DD/YYYY';
        break;
    case 'Y-m-d':
        return 'YYYY-MM-DD';
        break;
    case 'Y/m/d':
        return 'YYYY/MM/DD';
        break;
    case 'Y-d-m':
        return 'YYYY-DD-MMMM';
        break;
    case 'Y/d/m':
        return 'YYYY/DD/MM';
        break;
    default:
        return 'MM-DD-YYYY';
        break;
    }
}

/**
 * Takes the current url and updates the page number to
 * to the specified one. If no page number existed in url
 * it will simply be added
 * @param string $name The name of the user
 * @param int $id The user id
 * @return bool
 */
function loadMoreButtonUrl($page = '', $type = '') {
    //get an array of all the current url queries
    $queries = request()->query();
    //update/add page number
    $queries['page'] = $page;
    $queries['source'] = $type;
    $queries['action'] = 'load';

//return a full url with updated value
    $url = request()->fullUrlWithQuery($queries);

//remove unwanted (system_languages%5B2%5D=afrikaans) etc from the url. These are coming from the languages dropdown
    $url = preg_replace('/&system_languages%5B[\d]+%5D=[\w]+/', '', $url);
    $url = preg_replace('/&visibility_left_menu_toggle_button=[\w]+/', '', $url);
    $url = preg_replace('/&system_language=[\w]+/', '', $url);
    $url = preg_replace('/&user_has_due_reminder=[\w]+/', '', $url);
    $url = preg_replace('/&toggle=[\w]+/', '', $url);

//fix - enforce ssl
    if (env('ENFORCE_SSL')) {
        $url = str_replace('http://', 'https://', $url);
    }

//return url
    return $url;
}

/**
 * takes url coming from sorting menu links and flips
 * the current sorting to opposite, for next time
 * @param string $url the current url
 * @param string $current_sorting the current sorting
 * @return bool
 */
function flipSortingUrl($url = '', $current_sorting = '') {

//no sorting found in url
    if (!in_array($current_sorting, array('desc', 'asc'))) {
        return $url;
    }

//flip it
    if ($current_sorting == 'desc') {
        return str_replace('desc', 'asc', $url);
    } else {
        return str_replace('asc', 'desc', $url);
    }

}

/**
 * get the users avatar. if it does not exist return the default avatar
 * @return string
 */
function getUsersAvatar($directory = '', $filename = '', $user_id = '') {

//dd($user_id);

if ($user_id === 0) {
        return url('storage/avatars/system/avatar.jpg');
    }

//from database
    $avatar = "/avatars/$directory/$filename";
    //check if exists
    if (Storage::exists($avatar) && $filename != '' && $directory != '') {
        return url(Storage::url($avatar));
    }
    //default avatar
    return url('storage/avatars/system/default_avatar.jpg');
}

/**
 * used to return the 'system' users name, based on user_id = 0
 * @return string
 */
function checkUsersName($first_name = '', $user_id = '') {

if ($user_id === 0) {
        return __('lang.system_bot_name');
    }

//return actual user's first name
    return $first_name;
}

/**
 * bootstrap label class, based on status
 * @return string bootstrap label class
 */
function runtimeClientStatusLabel($status = '') {
    switch ($status) {
    case 'active':
        return 'label-outline-info';
        break;
    case 'suspended':
        return 'label-outline-warning';
        break;
    }
}

/**
 * bootstrap class, based on value
 * @param string value the status of the task
 * @param string type lable|background
 * @return string bootstrap label class
 */
function runtimeProjectStatusColors($value = '', $type = 'label') {

//default colour
    $colour = 'default';

//get the css value from config
    foreach (config('settings.project_statuses') as $key => $css) {
        if ($value == $key) {
            $colour = $css;
        }
    }

//return the css
    return bootstrapColors($colour, $type);
}

/**
 * bootstrap class, based on value
 * @param string value the status of the task
 * @param string type lable|background
 * @return string bootstrap label class
 */
function runtimeExpenseStatusColors($value = '', $type = 'label') {

//get the settings value
    switch ($value) {
    case 'billable':
        $colour = 'info';
        break;
    case 'not_billabled':
        $colour = 'default';
        break;
    case 'invoiced':
        $colour = 'success';
        break;
    case 'not_invoiced':
        $colour = 'default';
        break;
    default:
        $colour = 'default';
        break;
    }

//return the css
    return bootstrapColors($colour, $type);
}

/**
 * bootstrap class, based on value
 * @param string value the status of the task
 * @param string type lable|background
 * @return string bootstrap label class
 */
function runtimeInvoiceStatusColors($value = '', $type = 'label') {

//default colour
    $colour = 'default';

//get the css value from config
    foreach (config('settings.invoice_statuses') as $key => $css) {
        if ($value == $key) {
            $colour = $css;
        }
    }

//return the css
    return bootstrapColors($colour, $type);
}

/**
 * bootstrap class, based on value
 * @param string value the status of the task
 * @param string type lable|background
 * @return string bootstrap label class
 */
function runtimeEstimateStatusColors($value = '', $type = 'label') {

//get the css value from config
    foreach (config('settings.estimate_statuses') as $key => $css) {
        if ($value == $key) {
            $colour = $css;
        }
    }

//return the css
    return bootstrapColors($colour, $type);
}

//default colour
    $colour = 'default';

//get the css value from config
    foreach (config('settings.task_statuses') as $key => $css) {
        if ($value == $key) {
            $colour = $css;
        }
    }

//return the css
    return bootstrapColors($colour, $type);
}

//default colour
    $colour = 'default';

//get the css value from config
    foreach (config('system.lead_statuses') as $key => $css) {
        if ($value == $key) {
            $colour = $css;
        }
    }

//return the css
    return bootstrapColors($colour, $type);
}

//default colour
    $colour = 'default';

//get the css value from config
    foreach (config('settings.task_priority') as $key => $css) {
        if ($value == $key) {
            $colour = $css;
        }
    }

//return the css
    return bootstrapColors($colour, $type);
}

/**
 * bootstrap class, based on value
 * @param string value the status of the ticket
 * @param string type lable|background
 * @return string bootstrap label class
 */
function runtimeTicketStatusColors($value = '', $type = 'label') {

//default colour
    $colour = 'default';

//get the css value from config
    foreach (config('settings.ticket_statuses') as $key => $css) {
        if ($value == $key) {
            $colour = $css;
        }
    }

//return the css
    return bootstrapColors($colour, $type);
}

//default colour
    $colour = 'default';

//get the css value from config
    foreach (config('settings.ticket_priority') as $key => $css) {
        if ($value == $key) {
            $colour = $css;
        }
    }

//return the css
    return bootstrapColors($colour, $type);
}

/**
 * bootstrap class, based on value
 * @param string $status the status of the ticket
 * @param string $type lable|background
 * @return string bootstrap label class
 */
function runtimeSubscriptionsColors($status = '', $type = 'label') {

//default colour
    $colour = 'default';

switch ($status) {

case 'pending':
        $colour = 'default';
        break;

case 'active':
        $colour = 'success';
        break;

case 'failed':
        $colour = 'warning';
        break;

case 'cancelled':
        $colour = 'danger';
        break;
    }

//return the css
    return bootstrapColors($colour, $type);
}

/**
 * used by runtime functions to return the css
 * @param string value the status of the task
 * @param string type lable|background
 * @return string
 */
function bootstrapColors($colour = '', $type = '') {

switch ($colour) {
    case 'default':
        if ($type == 'label') {
            return 'label-outline-default';
        }
        if ($type == 'background') {
            return 'bg-default';
        }
        if ($type == 'text') {
            return 'text-default';
        }
        break;
    case 'info':
        if ($type == 'label') {
            return 'label-outline-info';
        }
        if ($type == 'background') {
            return 'bg-info';
        }
        if ($type == 'text') {
            return 'text-info';
        }
        break;
    case 'success':
        if ($type == 'label') {
            return 'label-outline-success';
        }
        if ($type == 'background') {
            return 'bg-success';
        }
        if ($type == 'text') {
            return 'text-success';
        }
        break;

case 'warning':
        if ($type == 'label') {
            return 'label-outline-warning';
        }
        if ($type == 'background') {
            return 'bg-warning';
        }
        if ($type == 'text') {
            return 'text-warning';
        }
        break;
    case 'danger':
        if ($type == 'label') {
            return 'label-outline-danger';
        }
        if ($type == 'background') {
            return 'bg-danger';
        }
        if ($type == 'text') {
            return 'text-danger';
        }
        break;
    case 'megna':
        if ($type == 'label') {
            return 'label-outline-megna';
        }
        if ($type == 'background') {
            return 'bg-megna';
        }
        if ($type == 'text') {
            return 'text-megna';
        }
        break;
    case 'purple':
        if ($type == 'label') {
            return 'label-outline-purple';
        }
        if ($type == 'background') {
            return 'bg-purple';
        }
        if ($type == 'text') {
            return 'text-purple';
        }
        break;
    case 'green':
        if ($type == 'label') {
            return 'label-outline-green';
        }
        if ($type == 'background') {
            return 'bg-green';
        }
        if ($type == 'text') {
            return 'text-green';
        }
        break;
    case 'lime':
        if ($type == 'label') {
            return 'label-outline-lime';
        }
        if ($type == 'background') {
            return 'bg-lime';
        }
        if ($type == 'text') {
            return 'text-lime';
        }
        break;
    case 'brown':
        if ($type == 'label') {
            return 'label-outline-brown';
        }
        if ($type == 'background') {
            return 'bg-brown';
        }
        if ($type == 'text') {
            return 'text-brown';
        }
        break;
    case 'primary':
        if ($type == 'label') {
            return 'label-outline-purple';
        }
        if ($type == 'background') {
            return 'bg-purple';
        }
        if ($type == 'text') {
            return 'text-purple';
        }
        break;
    default:
        if ($type == 'label') {
            return 'label-outline-info';
        }
        if ($type == 'background') {
            return 'bg-info';
        }
        if ($type == 'text') {
            return 'text-info';
        }
        break;
    }
}

/**
 * used by runtime functions to return the css
 * @param string value the status of the task board
 * @param string type tasks|leads
 * @return string
 */
function runtimeKanbanBoardColors($status = '') {

return 'border-' . $status;

}

/**
 * Apply correct language for values language coming from the database
 * e.g. project status etc
 * if no lang was found, return origianl text
 * @return string bootstrap label class
 */
function runtimeLang($lang = '') {
    $language = strtolower($lang);
    $language = str_replace(' ', '_', $lang);
    if (Lang::has("lang.$language")) {
        return __("lang.$language");
    } else {
        return str_replace('_', ' ', $lang);
    }
}

/**
 * language for modules
 * e.g. project status etc
 * if no lang was found, return origianl text
 * @return string bootstrap label class
 */
function runtimeLangModules($lang = '') {
    $language = strtolower($lang);
    $language = str_replace(' ', '_', $lang);
    try {
        return __($lang);
    } catch (Exception $e) {
        return str_replace('_', ' ', $lang);
    }
}

/**
 * change to [app/systen] lang and translate supplied string
 * afterwards, change back to [user] land
 * @return string bootstrap label class
 */
function runtimeSystemLang($lang = '') {

//[UPCOMING] - set system language

$language = strtolower($lang);
    if (Lang::has("lang.$language")) {
        return __("lang.$language");
    } else {
        return str_replace('_', ' ', $lang);
    }
}

/**
 * Format the date accoring to the system setting
 * @return string bootstrap label class
 */
function runtimeDate($date = '', $alternative = '---') {

if ($date == '0000-00-00' || $date == '0000-00-00 00:00:00' || $date == '---') {
        return $alternative;
    }

if ($date != '') {
        $date_format = config('system.settings_system_date_format');
        return \Carbon\Carbon::parse($date)->format($date_format);
    }

return $alternative;
}

/**
 * Format the time accoring to the system setting
 * @return string bootstrap label class
 */
function runtimeTime($date = '') {

if ($date == '0000-00-00' || $date == '0000-00-00 00:00:00') {
        return '---';
    }

if ($date != '') {
        return \Carbon\Carbon::parse($date)->format('H:i');
    }

return '---';
}

/**
 * Format time from 00:00:00 to just 00:00 without seconds
 * @return string
 */
function runtimeSimpleTime($time = '') {
    return substr($time, 0, 5);
}

/**
 * Format the datepicker date accoring to the system (settings_system_datepicker_format)
 * @return string bootstrap label class
 */
function runtimeDatepickerDate($date = '') {
    if ($date != '') {
        switch (config('system.settings_system_datepicker_format')) {
        case 'mm-dd-yyyy':
            $date_format = 'm-d-Y';
            break;
        case 'yyyy-mm-dd':
            $date_format = 'Y-m-d';
            break;
        default:
            $date_format = 'd-m-Y';
        }
        return \Carbon\Carbon::parse($date)->format($date_format);
    }
    return;
}

/**
 * Format the date accoring to the system setting
 * @return string bootstrap label class
 */
function runtimeDateAgo($date = '') {

if ($date == '0000-00-00' || $date == '0000-00-00 00:00:00') {
        return '---';
    }

if ($date != '') {
        $result = \Carbon\Carbon::parse($date)->diffForHumans();
        $result = strtolower($result);

//lang replacements
        $result = str_replace('years ago', __('lang.date_years_ago'), $result);
        $result = str_replace('year ago', __('lang.date_year_ago'), $result);
        $result = str_replace('months ago', __('lang.date_months_ago'), $result);
        $result = str_replace('month ago', __('lang.date_month_ago'), $result);
        $result = str_replace('days ago', __('lang.date_days_ago'), $result);
        $result = str_replace('day ago', __('lang.date_day_ago'), $result);
        $result = str_replace('hours ago', __('lang.date_hours_ago'), $result);
        $result = str_replace('hour ago', __('lang.date_hour_ago'), $result);
        $result = str_replace('minutes ago', __('lang.date_minutes_ago'), $result);
        $result = str_replace('minute ago', __('lang.date_minute_ago'), $result);
        $result = str_replace('seconds ago', __('lang.date_seconds_ago'), $result);
        $result = str_replace('second ago', __('lang.date_second_ago'), $result);

return $result;
    }

return '---';
}

/**
 * Check if select2 should allow users own tags
 * @return string select2 css setting for allowing tags or null
 */
function runtimeAllowUserTags() {
    if (config('system.settings_tags_allow_users_create') == 'yes') {
        return 'select2-tags';
    } else {
        return 'select2-basic';
    }
}

/**
 * Check a custom leads source is the one selected in the database
 * return a standard html <option> for that sources, preselected
 * @return string select2 css setting for allowing tags or null
 */
function runtimeLeadSourceCustom($list = array(), $value = '') {
    //validate
    if (!is_array($list) || $value == '') {
        return '';
    }
    //check if is in array (case insensitive)
    if (!in_array(strtolower($value), array_map('strtolower', $list))) {
        return '<option value="' . $value . '" selected>' . $value . '</option>';
    }
}

/**
 * convert seconds to human readable 00:00:00
 * @return string human readable time
 */
function runtimeSecondsHumanReadable($seconds = 0, $show_seconds = true) {

$second = '<span class="timer-deliminator">:</span>';

if (!is_numeric($seconds)) {
        return ($show_seconds) ? '00' . $second . '00' . $second . '00' : '00' . $second . '00';
    }

$H = floor($seconds / 3600);
    $i = ($seconds / 60) % 60;
    $s = $seconds % 60;
    if ($show_seconds) {
        return sprintf("%02d" . $second . "%02d" . $second . "%02d", $H, $i, $s);
    } else {
        return sprintf("%02d" . $second . "%02d", $H, $i);
    }
}

/**
 * Convert seconds to human-readable time format HH:MM
 *
 * @param int $seconds The total number of seconds.
 * @return string Human-readable time in HH:MM format.
 */
function runtimeSecondsHumanReadableShort($seconds = 0) {
    $delimiter = '<span class="timer-deliminator">:</span>';

// Validate the input
    if (!is_numeric($seconds)) {
        // Return '00:00' if the input is not a number
        return '00' . $delimiter . '00';
    }

// Calculate hours and minutes
    $hours = floor($seconds / 3600);
    $minutes = floor(($seconds % 3600) / 60);

// Format and return the result
    return sprintf("%02d%s%02d", $hours, $delimiter, $minutes);
}

/**
 * convert seconds to whole hours
 * @return string human readable time
 */
function runtimeSecondsWholeHours($seconds = 0) {

//sanity
    if (!is_numeric($seconds)) {
        $seconds = 0;
    }

//get whole hours
    $hours = floor($seconds / 3600);
    return $hours;
}

/**
 * convert whole minutes (after removing whole hours)
 * @return string human readable time
 */
function runtimeSecondsWholeMinutes($seconds = 0) {

//sanity
    if (!is_numeric($seconds)) {
        $seconds = 0;
    }

$minutes = floor(($seconds / 60) % 60);
    return $minutes;
}

/**
 * convert whole minutes (after removing whole hours)
 * @return string human readable time
 */
function runtimeSecondsWholeMinutesZero($seconds = 0) {

//sanity
    if (!is_numeric($seconds)) {
        $seconds = 0;
    }

$minutes = floor(($seconds / 60) % 60);

if ($minutes < 10) {
        return '0' . $minutes;
    }
    return $minutes;
}

/**
 * checks what the admin default setting are for:
 *   - task_client_visibility
 *   - task_billable
 *  used to check/uncheck checkboxes in the create task modal
 * @param string check
 * @return string checked | null
 */
function runtimeTasksDefaults($check = '') {

//tasks visible to clients
    if ($check == 'task_client_visibility') {
        return (config('system.settings_tasks_client_visibility') == 'visible') ? 'checked' : '';
    }
    //tasks visible to clients
    if ($check == 'task_billable') {
        return (config('system.settings_tasks_billable') == 'billable') ? 'checked' : '';
    }

return;
}

/**
 * return formatted invoice id (e.g. INV000024)
 * @param numeric bill_invoiceid
 * @return string checked | null
 */
function runtimeInvoiceIdFormat($bill_invoiceid = '') {
    //add the zero's
    $prefix = config('system.settings_invoices_prefix');
    //return
    if (is_numeric($bill_invoiceid)) {
        return $prefix . str_pad($bill_invoiceid, 6, '0', STR_PAD_LEFT);
    } else {
        return '---';
    }
}

/**
 * return formatted estimate id  (e.g. EST000024)
 * @param numeric bill_invoiceid
 * @return string checked | null
 */
function runtimeEstimateIdFormat($bill_estimateid = '') {
    //add the zero's
    $prefix = config('system.settings_estimates_prefix');
    //return
    if (is_numeric($bill_estimateid)) {
        return $prefix . str_pad($bill_estimateid, 6, '0', STR_PAD_LEFT);
    } else {
        return '---';
    }
}

/**
 * return formatted subscription id (e.g. SUB-000024)
 * @param numeric bill_invoiceid
 * @return string checked | null
 */
function runtimeSubscriptionIdFormat($subscription_id = '') {
    //add the zero's
    $prefix = config('system.settings_subscriptions_prefix');
    //return
    if (is_numeric($subscription_id)) {
        return $prefix . str_pad($subscription_id, 6, '0', STR_PAD_LEFT);
    } else {
        return '---';
    }
}

/**
 * return human readabe file size e.g. 10MB
 * @param numeric file size in bytes
 * @return string checked | null
 */
function humanFileSize($bytes) {
    if ($bytes == 0) {
        return "0.00 B";
    }

$s = array('B', 'KB', 'MB', 'GB', 'TB', 'PB');
    $e = floor(log($bytes, 1024));

return round($bytes / pow(1024, $e), 2) . $s[$e];
}

/**
 * takes a filename and creates a thumbnail name. For consistent use in app
 * e.g. 'Some File.jpg' > 'thumb_Some_File.jpg'
 * @param string original filename
 * @return string thumbnail name
 */
function generateThumbnailName($filename = '') {
    return 'thumb_' . strtolower(preg_replace('/[^a-zA-Z0-9.]+/', '_', $filename));
}

/**
 * whether or not to allow modals to close on body click
 * this setting s coming from the admin settings
 * @return string bootstrap data attibutes for disallowing modals to close on body click
 */
function runtimeAllowCloseModalOptions() {
    if (config('system.settings_system_close_modals_body_click') == 'yes') {
        return;
    }
    return 'data-keyboard="false" data-backdrop="static"';
}

/**
 * Calculates the lenght of the 'progress' bars shown on the project home page
 * for the varios invoices statuse
 * @param numeric $all_invoices the total invoices value
 * @param numeric $compare_invoices the value of the invoices being compared
 * @return string html style string
 */
function runtimeProjectInvoicesBars($all_invoices = '', $compare_invoices = '') {

//invalid data
    if (!is_numeric($all_invoices) || !is_numeric($compare_invoices)) {
        return 'w-0 h-px-3';
    }

//invalid data
    if ($compare_invoices > $all_invoices) {
        return 'w-0 h-px-3';
    }

//convert to cents
    $all_invoices = $all_invoices * 100;
    $compare_invoices = $compare_invoices * 100;

if ($all_invoices == 0) {
        $percentage = 0;
    } else {
        $percentage = round(($compare_invoices / $all_invoices) * 100);
    }

return 'w-' . $percentage . ' h-px-3';

}

/**
 * Remove unwanted characters from a tag
 *
 * @return string cleaned tag
 */
function cleanTag($tag = '') {
    //add dashes
    $tag = str_replace(' ', '-', $tag);

//change to lowercase
    $tag = strtolower($tag);

//remove none alpha-numeric characters - not sure how good this will be with none latin languages
    //$tag = preg_replace('/[^a-zA-Z0-9.]+/', '', $tag);
    return $tag;
}

/**
 * json response for a success notification popup
 */
function success($message = '') {

//is there a message
    $message = ($message != '') ? $message : __('lang.request_has_been_completed');

//notice
    $jsondata['notification'] = array('type' => 'success', 'value' => $message);

//response
    return $jsondata;
}

/**
 * json response for an error notification popup
 */
function eror($message = '') {

//is there a message
    $message = ($message != '') ? $message : __('lang.request_could_not_be_completed');

//notice
    $jsondata['notification'] = array('type' => 'error', 'value' => $message);

//response
    return $jsondata;
}

/**
 * return a nice slug for the database
 */
function createSlug($id = '', $text = '') {

//response
    return str_slug($id . '-' . $text);
}

/**
 * checks timers running status and returns css color to match
 * @return string hidden | visible
 */
function runtimeTimerStatus($running = false) {
    if ($running) {
        return 'btn-outline-danger';
    }
    return 'btn-outline-default';
}

/**
 * checks timers running status and returns correct tooltip
 * @return string hidden | visible
 */
function runtimeTimerTooltip($running = false) {
    if ($running) {
        return __('lang.stop_timer');
    }
    return __('lang.start_timer');
}

/**
 * disable 'billable' option if expense has already been invoiced
 * @return string
 */
function runtimeExpenseBillable($value = '') {
    if ($value == 'invoiced') {
        return 'disabled';
    }
}

/**
 * disable based on user permissions
 * @return string
 */
function runtimeChecklistCheckbox($value = '') {
    if ($value !== true) {
        return 'disabled';
    }
}

/**
 * return a formatted number (php number_format) (1,230.00)
 * @param string $number
 * @return string formatted number
 */
function runtimeNumberFormat($number = '') {

//validation
    if (!is_numeric($number)) {
        $number = 0;
    }

//decimal point
    $decimal_points = (config('system.settings_system_currency_hide_decimal') == 'yes') ? 0 : 2;

//decimal separator
    $decimal = runtimeCurrrencySeperators(config('system.settings_system_decimal_separator'));

//thousand separator
    $thousands = runtimeCurrrencySeperators(config('system.settings_system_thousand_separator'));

//format the number
    return number_format($number, $decimal_points, $decimal, $thousands);
}

/**
 * return a number usable in excel
 * @param string $number
 * @return string formatted number
 */
function runtimeExcelNumberFormat($number = '') {

//validation
    if (!is_numeric($number)) {
        $number = 0;
    }

//format the number
    return number_format($number, 0, '.', '');
}

/**
 * convert database symbol name into actual characters
 */
function runtimeCurrrencySeperators($value) {
    switch ($value) {
    case 'comma':
        $symbol = ",";
        break;
    case 'fullstop':
        $symbol = ".";
        break;
    case 'apostrophe':
        $symbol = "'";
        break;
    case 'space':
        $symbol = " ";
        break;
    default:
        $symbol = "";
        break;
    }
    return $symbol;
}

/**
 * convert bootstrap color codes to their css equivalent
 */
function runtimeColorCode($value) {
    switch ($value) {
    case 'default':
        $color = "#cccccc";
        break;
    case 'info':
        $color = "#20aee3";
        break;
    case 'success':
        $color = "#24d2b5";
        break;
    case 'danger':
        $color = "#ff5c6c";
        break;
    case 'warning':
        $color = "#ff9041";
        break;
    case 'primary':
        $color = "#6772e5";
        break;
    case 'lime':
        $color = "#cddc39";
        break;
    case 'brown':
        $color = "#795548";
        break;
    default:
        $color = "#cccccc";
        break;
    }
    return $color;
}

/**
 * return a formtted value with a currency symbol ($1,230.00)
 * @param string $number current users setting
 * @param string $spanid if we want to wrap the figure in a span
 * @return string css setting
 */
function runtimeMoneyFormat($number = '', $span_id = "") {

$number = runtimeNumberFormat($number);

//are we wrapping in a span
    if ($span_id != '') {
        $number = '<span id="' . $span_id . '">' . $number . '</span>';
    }

return config('system.currency_symbol_left') . $number . config('system.currency_symbol_right');
}

/**
 * appends additional query string data to a url.
 * e.g. ?invoiceresource_type=project&?invoiceresource_id=28
 * Data is set via the [index] middleware
 * @param string $var current users setting
 * @return string css setting
 */
function urlResource($url = '') {

if (request()->filled('resource_query')) {
        if (strpos($url, '?') !== false) {
            $url = $url . '&' . request('resource_query');
        } else {
            $url = $url . '?' . request('resource_query');
        }
    }

//return complete ur;
    return url($url);
}

/**
 * allow for dynamic manipulation of hard coded urls
 * @param string $url url string from balde or response etc
 * @return string url parses by laravel url helper
 */
function _url($url = '') {

/**
     * --------------------------------------------------------------------------------------------------
     * [REMAPPING URLS]
     *
     * remapping changes a hard coded url like
     *           <a href="{{ _url('/projects') }}"... becomes same as <a href="{{ _url('/moviess') }}"
     *
     * mapping comes from an array place inside settings.php (example below)
     *     'url_mapping' => [
     *         'projects' => 'movies',
     *      ],
     *
     * ---------------------------------------------------------------------------------------------------
     */
    if (config()->has('settings.url_mapping')) {
        $mapping = config('settings.url_mapping');
        if (is_array($mapping)) {
            foreach ($mapping as $key => $value) {
                if ($value != '') {
                    $url = str_replace($key, $value, $url);
                }
            }
        }
    }

//process and return the url as normal
    return url($url);
}

/**
 * disabling contacts checkboxes
 * @param string $var indenty of the checkbox
 * @return string css
 */
function runtimeDisabledContactsChecboxes($var = '') {
    if ($var == 'yes') {
        return 'disabled';
    }
}

/**
 * disabling contacts checkboxes
 * @param string $var indenty of the checkbox
 * @return string css
 */
function runtimeDisabledTimesheetsCheckboxes($var = false) {
    if ($var) {
        return 'disabled';
    }
}

/**
 * disabling account owner checkbox
 * @param string $var indenty of the checkbox
 * @return string css
 */
function runtimeAccountOwnerDisabled($var = '') {
    if ($var == 'yes') {
        return 'disabled';
    }
}

/**
 * checking account owner checkbox
 * @param string $var indenty of the checkbox
 * @return string css
 */
function runtimeAccountOwnerCheckbox($var = '') {
    if ($var == 'yes') {
        return 'checked';
    }
}

/**
 * Optionally show placeholder [disabled] actions buttons (e.g. delete/edit buttons etc), when the user does not have required permissions
 * @return string css
 */
function runtimePlaceholdeActionsButtons() {
    if (!config('settings.placeholder_actions_buttons')) {
        return 'hidden';
    }
}

/**
 * returns fommated date for pre-filling date fields
 * formatted as dd-mm-yyyy | mm-dd-yyyy
 * @return string css
 */
function runtimeTodaysDate() {

if (config('system.settings_system_datepicker_format') == 'dd-mm-yyyy') {
        return \Carbon\Carbon::now()->format('d-m-Y');
    } else {
        return \Carbon\Carbon::now()->format('m-d-Y');
    }
}

/**
 * returns fommated date for mysql database
 * formatted as yyyy-mm-dd
 * @return string css
 */
function runtimeTodaysDateMySQL() {

return \Carbon\Carbon::now()->format('Y-m-d');

}

/**
 * converting various database values/statuses etc to lang
 * thisis useful when the database value is not human friendly
 * @param $value string database value
 * @param $field string the database column where the value is coming from
 * @return string css
 */
function runtimeDBlang($value = '', $field = '') {

//task visibility
    if ($field == 'task_client_visibility') {
        switch ($value) {
        case 'yes':
            return runtimeLang('visible');
            break;
        case 'no':
            return runtimeLang('hidden');
            break;
        }
    }

//task milestone title
    if ($field == 'task_milestone') {
        switch ($value) {
        case 'uncategorised':
            return runtimeLang('uncategorised');
            break;
        default:
            return $value;
            break;
        }
    }

}

/**
 * returns html activator (class | text | id) etc needed to enable editing/deleting a resource
 * @param string value normally coming from the database
 * @param string type e.g. edit-task-checklist
 * @return string html activator string
 */
function runtimePermissions($type = '', $value = '') {

//get the settings value
    switch ($type) {

//edit task or lead checklist
    case 'task-edit-checklist':
    case 'lead-edit-checklist':
        return ($value === true) ? 'js-card-checklist-toggle' : '';
        break;

//edit task or lead description
    case 'lead-edit-title':
    case 'task-edit-title':
        return ($value === true) ? 'card-title-editable' : 'foo-bar';
        break;

//assign users
    case 'task-assign-users':
        return ($value === true) ? 'js-card-settings-button-static' : '';
        break;
    }

}

/**
 * add 'hidden' class for timers that are stopped
 * @param string value normally coming from the database
 * @return string html activator string
 */
function runtimeTimerVisibility($value = '', $type = '') {

if (($value === true || $value == 1)) {
        if ($type == 'running') {
            return 'visible-inline-block';
        }
    } else {
        if ($type == 'stopped') {
            return 'visible-inline-block';
        }
    }
}

/**
 * add 'running' class for timers that are running
 * @param string value normally coming from the database
 * @return string html activator string
 */
function runtimeTimerRunningStatus($value = '') {
    if ($value == 'running') {
        return 'timer-running';
    }
}

/**
 * check if user has a running timer and st visibility of clock icon
 * @param string value normally coming from the database
 * @return string css hidden|null
 */
function runtimeCardMyRunningTimer($value = '') {

if ($value === true) {
        return '';
    } else {
        return 'hidden-forced';
    }
}

/**
 * show bell red icon if users has unread notifications
 * @param string value normally coming from the database
 * @return string css hidden|null
 */
function runtimeVisibilityNotificationIcon($count = 0) {
    if ($count === 0) {
        return 'hidden';
    }
    return '';
}

/**show if a template is for client or team
 * @return string css hidden|null
 */
function runtimeEmailTemplates($value = '') {
    if ($value == 'client') {
        return ' - (' . __('lang.client') . ')';
    }
    if ($value == 'team') {
        return ' - (' . __('lang.team') . ')';
    }
    if ($value == 'everyone') {
        return ' - (' . __('lang.all') . ')';
    }
    return '';
}

/**
 * display correct invoice status visibility (on invoice page)
 * @return string hidden|null
 */
function runtimeInvoiceStatus($lable = 'foo', $value = 'bar') {
    if ($lable == $value) {
        return '';
    }
    return 'hidden';
}

/**
 * display correct invoice status
 * @return string hidden|null
 */
function runtimeInvoiceAttachedProject($type = 'attached', $value = '') {
    if ($type == 'project-title' && !is_numeric($value)) {
        return 'hidden';
    }
    if ($type == 'alternative-title' && is_numeric($value)) {
        return 'hidden';
    }
}

/**
 * add css class 'hidden' to an element
 * @return string hidden|null
 */
function runtimeVisibility($type = 'invoice-recurring-icon', $value = '', $value2 = '') {

//invoice recurring icon
    if ($type == 'invoice-recurring-icon') {
        return ($value == 'yes') ? '' : 'hidden';
    }

//invoice actions menu - view child invoices
    if ($type == 'invoice-view-child-invoices') {
        return ($value == 'yes') ? '' : 'hidden';
    }

//invoice actions menu - stop recurring
    if ($type == 'invoice-stop-recurring') {
        return ($value == 'yes') ? '' : 'hidden';
    }

//invoice coluns - inline tax
    if ($type == 'invoice-column-inline-tax') {
        return ($value == 'inline') ? '' : 'hidden';
    }

//attach/detttach invoice dropdown links
    if ($type == 'attach-invoice') {
        return (is_numeric($value)) ? 'hidden' : '';
    }
    if ($type == 'dettach-invoice') {
        return (is_numeric($value)) ? '' : 'hidden';
    }

//topnav timer
    if ($type == 'topnav-timer') {
        return ($value == 'show') ? '' : 'hidden';
    }

//edit client modal -module settings
    if ($type == 'client_app_modules_pemissions') {
        return ($value == 'custom') ? '' : 'hidden';
    }

//proposal or invoce statuses
    if ($type == 'document-status') {
        return ($value == $value2) ? 'hidden' : '';
    }

//file folders management
    if ($type == 'settings-file-folders-manage') {
        return ($value == 'disabled') ? 'hidden' : '';
    }

//estimate automation icon
    if ($type == 'estimate-automation-icon') {
        return ($value == 'disabled') ? 'hidden' : '';
    }

//proposal automation icon
    if ($type == 'proposal-automation-icon') {
        return ($value == 'disabled') ? 'hidden' : '';
    }
}

/**
 * friend theme name, from the directory name
 * @return string
 */
function runtimeThemeName($name = '') {

$ar = ['_', '-'];

return ucwords(str_replace($ar, ' ', $name));

}

/**
 * display correct estimate status visibility (on estimate page)
 * @return string hidden|null
 */
function runtimeEstimateStatus($lable = 'foo', $value = 'bar') {
    if ($lable == $value) {
        return '';
    }
    return 'hidden';
}

/**
 * convert dollars to cents
 * @return numeric amount in cents
 */
function runtimeAmountInCents($amount = 0) {
    return $amount * 100;
}

/**
 * convert dollars to cents
 * @return numeric amount in cents
 */
function pretty_print($var = []) {
    echo "<pre>";
    print_r($var);
    echo "</pre>";
    die();
}

/**
 * return the url to logo
 * @return string
 */
function runtimeLogoSmall() {
    $logo = config('system.settings_system_logo_small_name');
    $version = config('system.settings_system_logo_versioning');
    return url("storage/logos/app/$logo?v=$version");
}

/**
 * return the url to logo
 * @return string
 */
function runtimeLogoLarge() {
    $logo = config('system.settings_system_logo_large_name');
    $version = config('system.settings_system_logo_versioning');
    return url("storage/logos/app/$logo?v=$version");
}

/**
 * set the bootstrap col-size for crumbs. If none is provided, set the default size col-lg-5
 * this was an afterthought, so some controllers are not setting this, hence the default size
 * @return string
 */
function runtimeCrumbsColumnSize($size = '') {
    if ($size != '') {
        return $size;
    } else {
        return 'col-lg-5';
    }
}

function runtimeSanitizeHTML($text = '') {

$text = str_replace('<script>', '', $text);
    $text = str_replace('</script>', '', $text);
    return $text;
}

/**
 * clean a language string to remove html tags and trim shite spaces
 * @return string
 */

function cleanLang($str = '') {
    //remove double quotes
    $str = str_replace('"', '', $str);
    //trim html
    return trim(strip_tags($str));
}

/**
 * this is a trusted transactional email template, coming from the database
 * @return string
 */

function cleanEmail($text = '') {
    $text = str_replace('<script>', '', $text);
    $text = str_replace('</script>', '', $text);
    return $text;
}

/**
 * clean a string to remove html tags and trim shite spaces
 * @return string
 */

function safestr($str = '') {
    return trim($str);
}

/**
 * check if a string has HTML tags
 * @return bool
 */
function hasHTML($str = '') {
    if ($str != strip_tags($str)) {
        return true;
    }
    return false;
}

/**
 * return a name or string for unkownn/delete users
 * @return string
 */

function runtimeUnkownUser($str = '') {
    return __('lang.unknown');
}

/**
 * return some common paths
 * [EXAMPLE] /home/mydomain/publc_html
 * @return string
 */
function path_root($str = '') {
    return BASE_DIR;
}

/**
 * return some common paths
 * [EXAMPLE] /home/mydomain/publc_html/storage
 * @return string
 */
function path_storage($str = '') {
    if ($str != '') {
        $str = ltrim($str, '/');
        return BASE_DIR . '/storage/' . $str;
    } else {
        return BASE_DIR . '/storage';
    }
}

/**
 * return some common paths
 * [EXAMPLE] /home/mydomain/publc_html/storage/temp
 * @return string
 */
function path_temp($str = '') {
    return BASE_DIR . '/storage/temp';
}

/**
 * return some common paths
 * [EXAMPLE] /home/mydomain/publc_html/application
 * @return string
 */
function path_application($str = '') {
    return BASE_DIR . '/application';
}

/**
 * return some common paths
 * [EXAMPLE] /home/mydomain/publc_html/application/storage/logs
 * @return string
 */
function path_logs($str = '') {
    return BASE_DIR . '/application/storage/logs';
}

/**
 * return translated pricing from Stripe's PRICE object
 * @param string $interval e.g. day|week|month|year
 * @param int $interval_count e.g. 2 (for 2 weeks)
 * @return string e.g. Month | 2 Months
 */
function subscriptionFormatRenewalInterval($interval_count = 1, $interval = '') {

//validate
    if ($interval == '') {
        return '---';
    }

//translate intervals
    $lang = [
        'day' => ucwords(__('lang.day')),
        'week' => ucwords(__('lang.week')),
        'month' => ucwords(__('lang.month')),
        'year' => ucwords(__('lang.year')),
    ];

$lang_plural = [
        'day' => ucwords(__('lang.days')),
        'week' => ucwords(__('lang.weeks')),
        'month' => ucwords(__('lang.months')),
        'year' => ucwords(__('lang.years')),
    ];

//validate
    if (!array_key_exists($interval, $lang) || !is_numeric($interval_count)) {
        return;
    }

if ($interval_count > 1) {
        return $interval_count . ' ' . $lang_plural[$interval];
    } else {
        return $lang[$interval];
    }

}

/**
 * return formatted money. If currency is system one, then use system settings
 * else use Akounting money formattings
 * @source https://github.com/akaunting/money
 * @param int $amount
 * @param string $currency e.g. USG
 * @return string e.g. Month | 2 Months
 */
function subscriptionFormatMoney($amount = '', $currency = '') {

//currency is same as system
    if (strtolower($currency) == strtolower(config('system.settings_system_currency_code'))) {
        return runtimeMoneyFormat($amount);
    }

//format using Akounting
    return money($amount, $currency);

}

/**
 * return session error message, it exists and reset the session error data
 * else use Akounting money formattings
 * @source https://github.com/akaunting/money
 * @param int $amount
 * @param string $currency e.g. USG
 * @return string e.g. Month | 2 Months
 */
function sessionErrorMessage() {

//get message
    $message = session('error_message');

//do we have an error message
    if ($message != '') {
        //reset message
        session(['error_message' => '']);
        return $message;
    } else {
        return __('lang.error_request_could_not_be_completed');
    }

}

/**
 * return a 'yes' or 'no' value for storing in database
 * value of coming from a checkbox (on or null)
 * @return string
 */
function runtimeDBCheckBoxYesNo($value = '') {
    if ($value == 'on') {
        return 'yes';
    } else {
        return 'no';
    }
}

/**
 * return a 'enabled' or 'disabled' value for storing in database
 * value of coming from a checkbox (on or null)
 * @return string
 */
function runtimeDBCheckBoxEnabledDisabled($value = '') {
    if ($value == 'on') {
        return 'enabled';
    } else {
        return 'disabled';
    }
}

/**
 * if a custom field is required, it will add the 'required' class to make
 * the form field label bold
 * @return string
 */
function runtimeCustomFieldsRequiredCSS($value = '') {
    if ($value == 'yes') {
        return 'required';
    }
    return;
}

/**
 * if a custom field is required, it will add the '*'
 * to show that a field is required
 * @return string
 */
function runtimeCustomFieldsRequiredAsterix($value = '') {
    if ($value == 'yes') {
        //return '*'; not using this anymore, just using bold font
    }
    return;
}

/**
 * return the custom field value for a given custom field
 * @paran string $file_name the name of the files, from the custom fields table
 * @paran string $file_name the name of the files, from the custom fields table
 * @return string
 */
function customFieldValue($name = '', $obj = '', $type = 'text') {

//text
    if ($type == 'text') {
        return ($obj[$name] == '') ? '---' : $obj[$name];
    }

//check box
    if ($type == 'checkbox') {
        return ($obj[$name] == 'on') ? __('lang.checked_custom_fields') : '---';
    }

//date
    if ($type == 'date') {
        return runtimeDate($obj[$name]);
    }

return $obj[$name];
}

/**
 * same as above, but used for display and returns more ---'s
 * @paran string $file_name the name of the files, from the custom fields table
 * @paran string $file_name the name of the files, from the custom fields table
 * @return string
 */
function customFieldValueDisplay($name = '', $obj = '', $type = 'text') {

//text
    if ($obj[$name] == '') {
        $obj[$name] = '---';
    }

//date
    if ($type == 'date') {
        return runtimeDate($obj[$name]);
    }

//checkbox
    if ($type == 'checkbox') {
        return ($obj[$name] == 'on') ? __('lang.selected') : '---';
    }

//numbers
    if ($type == 'number' || $type == 'decimal') {
        return ($obj[$name] == 0) ? '---' : $obj[$name];
    }

return $obj[$name];
}

/**
 * show the correct drop down menu for (archiving or activating)
 * @param $actual_value string yes|no|active|etc [this value comes from the database]
 * @return string hidden | visible
 */
function runtimeActivateOrAchive($type = '', $value = '') {

//archive drop down button
    if ($type == 'archive-button' && $value == "archived") {
        return 'hidden';
    }

//archive drop down button
    if ($type == 'activate-button' && $value == "active") {
        return 'hidden';
    }

//archived icon
    if ($type == 'archived-icon' && $value == "active") {
        return 'hidden';
    }

//archived item notice
    if ($type == 'archived-notice' && $value == "active") {
        return 'hidden';
    }

return;
}

/**
 * show archiving buttons and labels
 * @return bool
 */
function runtimeArchivingOptions() {

if (auth()->user()->is_team) {
        return true;
    }

}

/**
 * Remove unwanted characters from a tag
 *
 * @return string cleaned tag
 */
function _clean($string = '') {
    //return clean($string);
    return $string;
}

/**
 * determine if the settings icon should be displayed for the custom field
 * @return string
 */
function runtimeCustomFieldsSettingsVisibility($value = '') {
    if ($value == '') {
        return 'hidden';
    }
    return;
}

/**
 * set active tabs menu for custom fields
 * @return string
 */
function runtimeCustomsFieldsTabs($value1 = '', $value2 = '') {
    if ($value1 == $value2 && $value1 != '') {
        return 'active';
    }
    return;
}

/**
 * convert a json payload into select <options>
 * @param string $payload the json string from the database
 * @param bool $selected if the options should be preselected (needed in the setting side, where we want to show as tags)
 * @return string
 */
function runtimeCustomFieldsJsonLists($payload = '', $selected = false) {

//validate
    if ($payload == '' || $payload == null) {
        return;
    }

//take payload and change decode to an array
    $options = json_decode($payload);

//create the select <options>
    if ($options) {
        $select = ($selected) ? 'selected' : '';
        $list = '';
        foreach ($options as $option) {
            $list .= "<option value=\"$option\" $select>$option</option>";
        }
        return $list;
    }

}

/**
 * check if the current user has permission to delete selected user
 * @param obj $user user model
 * @return string
 */
function runtimeTeamPermissionDelete($user = '') {

//no permissions generally
    if (!auth()->user()->is_admin && auth()->user()->role->role_team != 3) {
        return false;
    }

//cannot delete primary admin
    if ($user->primary_admin == 'yes') {
        return false;
    }

//cannot delete yourself
    if ($user->id == auth()->user()->id) {
        return false;
    }

//cannot delete admin user if you are not an admin user
    if ($user->is_admin && !auth()->user()->is_admin) {
        return false;
    }

return true;
}

/**
 * check if the current user has permission to edit selected user
 * @param obj $user user model
 * @return bool
 */
function runtimeTeamPermissionEdit($user = '') {

//no permissions generally
    if (!auth()->user()->is_admin && auth()->user()->role->role_team != 3) {
        return false;
    }

//cannot edit primary admin
    if ($user->primary_admin == 'yes') {
        return false;
    }

//cannot edit admin user if you are not an admin user
    if ($user->is_admin && !auth()->user()->is_admin) {
        return false;
    }

return true;
}

/**
 * permission to add an administrator level user
 * @param int $role role id
 * @return bool
 */
function runtimeTeamCreateAdminPermissions($role = '') {

//not an admin role
    if ($role > 1) {
        return true;
    }

//no permissions generally
    if (auth()->user()->is_admin) {
        return true;
    }

return false;
}

/**
 * check if any item in the list is true (i.e. visible) so as to make whole menu visible
 * @param array $list bool states of menu items in the group
 * @return bool
 */
function runtimeGroupMenuVibility($list = []) {

foreach ($list as $value) {
        if ($value === true) {
            return true;
        }
    }
    return false;
}

/**
 * temporarily add full path for ajax repsonse with image paths. relative paths
 * are not alwyas working for images
 * @param string $test text body (usually a comment or tinymce text area)
 * @return bool
 */
function runtimeTempImagePathFix($text = '') {

return preg_replace('%src="storage/files%', 'src="/storage/files', $text);

}

/**
 * @param bool $required
 * @return string
 */
function runtimeWebformRequiredBold($required) {

return ($required === true) ? 'required' : '';

}

/**
 * @param bool $required
 * @return string
 */
function runtimeWebformRequiredAsterix($required) {

return ($required === true) ? '*' : '';

}

/**
 * Visibility of various form fiels in the add-edit modal for articles
 * @param string value normally coming from the database
 * @return string css hidden|null
 */
function runtimeVisibilityKBArticle($field = '', $category_type = '') {

//we are creating in a type of category that matches this content type (so show the editor or the embed box, respectively)
    if ($field != '') {
        if ($field == $category_type) {
            return;
        }
    }

//hide this element
    return 'hidden';
}

/**
 * for correcting symbols that are not showing, such as euro
 * @param string $number current users setting
 * @param string $spanid if we want to wrap the figure in a span
 * @return string css setting
 */
function runtimeMoneyFormatPDF($number = '', $span_id = "") {

$number = runtimeNumberFormat($number);

//are we wrapping in a span
    if ($span_id != '') {
        $number = '<span id="' . $span_id . '">' . $number . '</span>';
    }

return runtimePDFCharacters(config('system.currency_symbol_left')) . $number . runtimePDFCharacters(config('system.currency_symbol_right'));
}

/** -------------------------------------------------------------------------
 * A fix for some currency symbolsnow showing correctly in the PDF
 * To add new currencies, add a pair of the currency and its corresponding
 * html code.
 *
 * You then use this function in the PDF templatem, in every place that a
 * currency symbol is displayed
 *
 * @param string $value the real currency symply (e.g. $)
 * @return string corresponding html code for the currency symbol
 * -------------------------------------------------------------------------*/
function runtimePDFCharacters($value = '') {

//currency symbols (you can add more here)
    $search = array('€', '?');

//corresponding HTML codes for the currency symbols (in the correct order as above)
    $replace = array('&euro;', '&#8363;');

//return the html code for the currency symbol
    return str_replace($search, $replace, $value);

}

/** -------------------------------------------------------------------------
 * Delete all flash messages (success & error). This is needed when sometimes
 * we are using ajax and keep getting a previous flash message.
 *
 * Just add this to any method in the controllers
 *
 * @return null
 * -------------------------------------------------------------------------*/
function runtimeClearFlashMessages() {

request()->session()->forget('flash-error-message');
    request()->session()->forget('error-notification-long');
    request()->session()->forget('success-notification');
    request()->session()->forget('success-notification-long');

}

/**
 * get a cover image for projects for task covers
 * @return string
 */
function getCoverImage($directory = '', $filename = '', $type = 'background') {

//check if cover exists
    if (Storage::exists("/files/$directory/$filename") && $filename != '' && $directory != '') {

if ($type == 'background') {
            return "style=\"background-image: url(storage/files/$directory/$filename)\"";
        }

if ($type == 'image') {
            return url("storage/files/$directory/$filename");
        }
    }

//default placeholder cover
    return "style=\"background-image: url('public/images/placeholder.jpg')\"";
}

/**
 * get a cover image for projects for task covers
 * @return string
 */
function checkCoverImage($directory = '', $filename = '') {

//check if cover exists
    if (Storage::exists("/files/$directory/$filename") && $filename != '' && $directory != '') {
        return true;
    }

return false;
}

/**
 * return a singular or translated string
 * @param string $interval e.g. day|week|month|year
 * @param int $interval_count e.g. 2 (for 2 weeks)
 * @return string e.g. Month | 2 Months
 */
function runtimeIntervalPlural($interval_count = 1, $interval = '') {

//validate
    if ($interval == '') {
        return '---';
    }

//validate
    if (!array_key_exists($interval, $lang) || !is_numeric($interval_count)) {
        return;
    }

if ($interval_count == 1) {
        return $interval_count . ' ' . $lang[$interval];
    } else {
        return $interval_count . ' ' . $lang_plural[$interval];
    }

}

/**
 * show or hide task recurring icom
 * @param string $var current users setting
 * @return string css setting
 */
function runtimeTaskRecurringIcon($var = '') {
    if ($var != 'yes') {
        return 'hidden';
    }
    return;
}

/**
 * return formatted proposal id (e.g. PROP000024)
 * @param numeric bill_invoiceid
 * @return string checked | null
 */
function runtimeProposalIdFormat($proposal_id = '') {
    //add the zero's
    $prefix = config('system.settings_proposals_prefix');
    //return
    if (is_numeric($proposal_id)) {
        return $prefix . str_pad($proposal_id, 5, '0', STR_PAD_LEFT);
    } else {
        return '---';
    }
}

/**
 * return formatted contract id (e.g. CONTR000024)
 * @param numeric bill_invoiceid
 * @return string checked | null
 */
function runtimeContractIdFormat($contract_id = '') {
    //add the zero's
    $prefix = config('system.settings_contracts_prefix');
    //return
    if (is_numeric($contract_id)) {
        return $prefix . str_pad($contract_id, 5, '0', STR_PAD_LEFT);
    } else {
        return '---';
    }
}

//get the settings value
    switch ($value) {
    case 'draft':
        $colour = 'default';
        break;
    case 'new':
        $colour = 'info';
        break;
    case 'accepted':
        $colour = 'success';
        break;
    case 'declined':
        $colour = 'danger';
        break;
    case 'revised':
        $colour = 'primary';
        break;
    case 'expired':
        $colour = 'warning';
        break;
    default:
        $colour = 'default';
        break;
    }

//return the css
    return bootstrapColors($colour, $type);
}

/**
 * bootstrap class, based on value
 * @param string value the status of the task
 * @param string type lable|background
 * @return string bootstrap label class
 */
function runtimeContractStatusColors($value = '', $type = 'label') {

//get the settings value
    switch ($value) {
    case 'draft':
        $colour = 'default';
        break;
    case 'awaiting_signatures':
        $colour = 'warning';
        break;
    case 'active':
        $colour = 'success';
        break;
    case 'expired':
        $colour = 'danger';
        break;
    default:
        $colour = 'default';
        break;
    }

//return the css
    return bootstrapColors($colour, $type);
}

/**
 * return lead name with title
 * @return string
 */
function runtimeLeadNameTitle($lead_firstname = '', $lead_lastname = '', $lead_title = '') {

return $lead_firstname . ' ' . $lead_lastname;

}

/**
 * get the cover image for projects for task covers
 * @return string
 */
function getDocumentHeroImage($directory = '', $filename = '', $updated = 'no', $type = '') {

//use image updated by the user
    if ($updated == 'yes') {
        if (Storage::exists("/files/$directory/$filename") && $filename != '' && $directory != '') {
            return "style=\"background-image: url(storage/files/$directory/$filename)\"";
        }
    }

//default placeholder cover
    if ($type == 'proposal') {
        return "style=\"background-image: url('public/documents/images/default-background.jpg')\"";
    }

//default placeholder cover
    if ($type == 'contract') {
        return "style=\"background-image: url('public/documents/images/default-background-contracts.jpg')\"";
    }

}

/**
 * set the color of text from a dbase value
 * @return string
 */
function getFontColor($color = '') {

//no color
    if ($color == '') {
        return;
    }

//default placeholder cover
    return "style=\"color: $color\"";
}

/**
 * check if the document is is editing mode
 * @return string
 */
function documentEditingModeCheck1($mode = '') {

//no color
    if ($mode == 'editing') {
        return 'js-doc-editing';
    }
    return;
}

/**
 * check if the document is is editing mode
 * @return string
 */
function documentEditingModeCheck2($mode = '') {

//no color
    if ($mode != 'editing') {
        return 'hidden';
    }
    return;
}

/**
 * show the correct ribbon,based on status
 * @param string $value the actual value of the button (i.e. its css status)
 * @param string $status the database status of the document
 */
function documentRibbonVisibility($value = 'foo', $status = 'bar') {

//hide the button
    if ($value != $status) {
        return 'hidden';
    }
    return;
}

/**
 * various element visibity for estimates automation
 * @param string $value determining value
 */
function estimateAutomationVisibility($value = '') {

//hide the button
    if ($value == 'no' || $value == 'disabled') {
        return 'hidden';
    }
    return;
}

/**
 * various element visibity for projects automation
 * @param string $value determining value
 */
function projectAutomationVisibility($value = '') {

//hide the button
    if ($value == 'no' || $value == 'disabled') {
        return 'hidden';
    }
    return;
}

/**
 * various element visibity for projects automation
 * @param string $value determining value
 */
function projectAutomationHourlyVisibility($value = '') {

//hide the button
    if ($value != 'yes') {
        return 'hidden';
    }
    return;
}

/**
 * check if a task has a depency preventing it from being complete
 * ...this will disable the checkbox for completing a task.
 * @param string $value determining value
 */
function runtimeTaskDependencyLock($value = '') {

//hide the button
    if ($value > 0) {
        return 'disabled';
    }
    return;
}

/**
 * show the correct label. Including the 'fulfilled' label
 * @param string $value determining value
 */
function runtimeTaskDependencyColors($value = '', $status = '') {

//hide the button
    if ($status == 'fulfilled') {
        return 'fulfilled';
    }
    return $value;
}

/**
 * stript tags from rish html of product items
 * @param string $value determining value
 */
function runtimeProductStripTags($value = '') {

//add spaces instead of breakd and paragraphs
    $value = str_replace('<br />', ' ', $value);
    $value = str_replace('<p>', ' ', $value);

return strip_tags($value);
}
/**
 * active state for default folder
 * @param string value normally coming from the database
 * @return string css hidden|null
 */
function runtimeFileFoldersActive($value = '', $folder_id = 0) {

if ($folder_id > 0 && $value == $folder_id) {
        return 'active';
    }
}

/**
 * various element visibity for projects automation
 * @param string $value determining value
 */
function projectAutomationEstimateStatuses($value = '') {

//hide the button
    if ($value != 'yes') {
        return 'hidden';
    }
    return;
}

/**
 * disable editing of system tax rates
 * @return string
 */
function runtimeSystemTaxRate($value = '') {
    if ($value == 'system') {
        return 'disabled';
    }
}

/**
 * precheck line items tax rates
 * @return string
 */
function runtimeInlineTaxPreselected($tax_taxrateid = '', $lineitem_id = '') {

//validate
    if (!is_numeric($lineitem_id)) {
        return;
    }

//validate taxes
    if (!is_numeric($tax_taxrateid)) {
        return;
    }

Log::info("tax_lineitem_id $lineitem_id | tax_taxrateid $tax_taxrateid");
    //get taxes for this line item
    if (\App\Models\Tax::Where('tax_lineitem_id', $lineitem_id)->Where('tax_taxrateid', $tax_taxrateid)->exists()) {
        return 'selected';
    }

}

/**
 * show or hide the dimensions part of the form
 * @param string $value determining value
 */
function runtimeVisibilityItemsType($value = '') {

//hide the button
    if ($value != 'dimensions') {
        return 'hidden';
    }
    return;
}

/**
 * bootstrap class, based on value
 * @param string value the status of the task
 * @param string type lable|background
 * @return string bootstrap label class
 */
function runtimeItemTypeStatusColors($value = '', $type = 'label') {

//get the settings value
    switch ($value) {
    case 'standard':
        $colour = 'default';
        break;
    case 'dimensions':
        $colour = 'info';
        break;
    default:
        $colour = 'default';
        break;
    }

//return the css
    return bootstrapColors($colour, $type);
}

/**
 * enable or disablethe tax drp down, for line items that are marked as tax exempt
 * @param string $value determining value
 */
function runtimeLineItemTaxStatus($value = '') {

//hide the button
    if ($value == 'exempt') {
        return 'disabled';
    }
    return;
}

/**
 * dynamic url for changing bill tax type
 * @param obj $bill estimate or invoice
 * @return string url
 */
function runtimeBillTaxTypeURL($bill = '') {

//estimate
    if ($bill->bill_type == 'estimate') {
        return url('/estimates/' . $bill->bill_estimateid . '/change-tax-type');
    }

//invoice
    if ($bill->bill_type == 'invoice') {
        return url('/invoices/' . $bill->bill_invoiceid . '/change-tax-type');
    }
}

/**
 * dynamic url for attaching files to invoices and estimates
 * @param obj $bill estimate or invoice
 * @return string url
 */
function runtimeURLBillAttachFiles($bill = '') {

//estimate
    if ($bill->bill_type == 'estimate') {
        return url('/estimates/' . $bill->bill_estimateid . '/attach-files');
    }

//invoice
    if ($bill->bill_type == 'invoice') {
        return url('/invoices/' . $bill->bill_invoiceid . '/attach-files');
    }
}

/**
 * create a unique id to messaging links
 * @param string $source unique user id
 * @param string $target unique user id
 * @return string url
 */
function messagesUniqueID($source = '', $target = '') {

$id = "conversation_$source" . "_" . $target;

return (str_replace('.', '_', $id));

}

/**
 * create a unique id for each message
 * @param string $unique_id unique message id
 * @return string url
 */
function messageUniqueID($unique_id = '') {

$id = "message_id_$unique_id";

return (str_replace('.', '_', $id));

}

/**
 * create a unique id for thecounter
 * @param string $target unique user id
 * @return string url
 */
function messagesCounterUniqueID($target = '') {

$counter = "messages_counter_$target";

return (str_replace('.', '_', $counter));

}

/**
 * create a unique id for thecounter
 * @param string $status users currents status
 * @param string $type lang|label will create css for a label or the lang for online/offline
 * @return string url
 */
function runtimeMessagesUserStatus($status = false, $type = '') {

//labels
    if ($type == 'label' && $status) {
        return 'text-success';
    }
    if ($type == 'label' && !$status) {
        return 'text-muted';
    }

//lang
    if ($type == 'lang' && $status) {
        return __('lang.online');
    }
    if ($type == 'lang' && !$status) {
        return __('lang.offline');
    }

}

/**
 * return the correct css class, for a completed task
 * @param numeric $status status
 * @return string css class for completed task
 */
function runtimeTaskCompletedStatus($status = '') {

if ($status == 2) {

return 'task-completed';
    }

}

/**
 * generate the CSS <style> tag for custom invoice and estimate PDF bils
 * @param string $css
 * @return string
 */
function customDPFCSS($css = '') {

$css = str_replace('<style>', '', $css);
    $css = str_replace('</style>', '', $css);

return "<style>\n" . $css . "\n</style>";

}

/**
 * Convert seconds to hours, minutes, seconds.
 *
 * @param int $seconds
 * @return array
 */
function hourMinuteSeconds($duration = 0, $type = '') {

$hours = 0;
    $minutes = 0;
    $seconds = 0;

//avoid divisiob by zero
    if ($duration > 0) {
        $hours = floor($duration / 3600);
        $minutes = floor(($duration / 60) % 60);
        $seconds = $duration % 60;
    }
    switch ($type) {
    case 'hours':
        return $hours;
    case 'minutes':
        return $minutes;
    case 'seconds':
        return $seconds;
    }

}

/**
 * check if the user should see the reply editing options
 *
 * @param int $seconds
 * @return array
 */
function permissionEditTicketReply($reply = []) {

//validate
    if (!isset($reply->ticketreply_id)) {
        return false;
    }

//admin user
    if (auth()->user()->is_admin) {
        return true;
    }

//team member & original poster of the reply
    if (auth()->user()->is_team && $reply->ticketreply_creatorid == auth()->id()) {
        return true;
    }

return false;

}

/**
 * check if the user should see the project billing tab
 *
 * @param int $seconds
 * @return array
 */
function menuVisibilityProjectBillingTab() {

if (config('settings.project_permissions_view_invoices')) {
        return;
    }

if (auth()->user()->role->role_estimates >= 1) {
        return;
    }

if (config('settings.project_permissions_view_payments')) {
        return;
    }

if (config('settings.project_permissions_view_expenses')) {
        return;
    }

if (config('settings.project_permissions_view_timesheets')) {
        return;
    }

return 'hidden';
}

/**
 * format the displayed custom field data, based on data type (e.g. date)
 * @param string $value the data
 * @param string $type example (date, dropdown, etc)
 * @return string
 */
function runtimeCustomFieldsFormat($value = '', $type = '') {

if ($type == 'date' && $value != '') {
        return runtimeDate($value);
    }

//default
    return $value;
}

/**
 * Build a URL with optional parameters, the ability to remove specified parameters,
 *
 * @param array $new_params
 * @param array $remove_params
 * @return string
 */
function urlBuilder($new_params = [], $remove_params = []) {
    // Get the current URL
    $url = url()->current();

// Get the current query parameters
    $current_params = request()->query();

// Remove specified parameters
    if (is_array($remove_params)) {
        foreach ($remove_params as $param) {
            unset($current_params[$param]);
        }
    } elseif (is_string($remove_params)) {
        unset($current_params[$remove_params]);
    }

// Merge with new parameters
    $params = array_merge($current_params, $new_params);

// Create the new URL
    $new_url = $url . '?' . http_build_query($params);

//clean it up
    $new_url = urldecode($new_url);

return $new_url;
}

/**
 * check if we are truncating the string
 * @param string $str
 * @param int $limit
 * @return string
 */
function str_limit_reports($str = '', $limit = 10) {

//check settings
    if (config('system.settings2_tweak_reports_truncate_long_text') == 'yes' && is_numeric($limit)) {
        return str_limit($str, $limit);
    }

return $str;
}

/**
 * convert month name to its numeric value
 * @return string human readable time
 */
function runtimeMonthNumeric($month = '') {

$month = strtolower($month);

switch ($month) {
    case 'january':
        return 1;
    case 'february':
        return 2;
    case 'march':
        return 3;
    case 'april':
        return 4;
    case 'may':
        return 5;
    case 'june':
        return 6;
    case 'july':
        return 7;
    case 'august':
        return 8;
    case 'september':
        return 9;
    case 'october':
        return 10;
    case 'november':
        return 11;
    case 'december':
        return 12;
    default:
        return 0;
    }
}

/**
 * Show the correct email settings form
 * @param string $value the data
 * @param string $type example (date, dropdown, etc)
 * @return string
 */
function runtimeVisibilitySection($value = '', $type = '') {

if ($value != $type) {
        return 'hidden';
    }
}

/**
 * returns a custom field name as used in importing excel files
 * @return string 'CustomField30'
 */
function customFieldImportingName($field = 'bar') {
    $arr = ['client_', 'lead_', 'project_', 'task_', 'ticket_'];
    $field = str_replace($arr, '', $field);
    $field = str_replace('custom_', 'Custom', $field);
    $field = str_replace('field_', 'Field', $field);
    return $field;
}

/**
 * check if a category has items and disable the cbeck box
 * @return string
 */
function runtimeCategoryItemsDisabledCheck($value = '') {

if ($value == 0) {
        return 'disabled';
    }
}

/**
 * return a name or string for unkownn/delete users
 * @return string
 */

function runtimeUser($first_name = '', $last_name = '') {

if ($first_name != '' || $last_name != '') {
        return $first_name . ' ' . $last_name;
    }

return __('lang.unknown');
}

/**
 * return the query string on the current loaded URL
 * @return string
 */

function urlQuery() {

$url = parse_url(url()->full());
    $query = $url['query'];
    parse_str($query, $query_params);

return $query_params;
}

/**
 * enable or disable the publish date
 * @return string
 */
function runtimePublihItemDate($value = '') {

if ($value != 'scheduled') {
        return 'disabled';
    }
}

/**
 * enable or disable the publish date
 * @return string
 */
function runtimePublihItemButtonLang($value = '') {

if ($value == 'instant') {
        return __('lang.publish');
    } else {
        return __('lang.schedule');
    }
}

/**
 * show or hide the 'set cover' link
 * @return string
 */
function runtimeCoverImageAddButton($value = '', $id = '') {
    if ($value == $id) {
        return 'hidden';
    }
}

/**
 * show or hide the 'remove cover' link
 * @return string
 */
function runtimeCoverImageRemoveButton($value = '', $id = '') {
    if ($value != $id) {
        return 'hidden';
    }
}

/**
 * set initial visibility of the cover image container
 * @return string
 */
function runtimeKanbanCoverImage($value = '') {
    if ($value != 'yes') {
        return 'hidden';
    }
}

/**
 * set the background image using inline style css
 * @return string
 */
function runtimeCoverImage($image_directory = '', $image_url = '') {
    if ($image_url != '' && $image_directory != '') {

//get the url and remove spaces and clean it up
        $url = url("/storage/files/$image_directory/$image_url");
        $url = str_replace(' ', '%20', $url);
        $url = trim($url);

return 'style="background-image: url(' . $url . ');"';
    }
}

/**
 * set active canned category on menu
 * @return string
 */
function runtimeCannedCategory($value = '') {
    if ($value == -1) {
        return 'active';
    }
}

/**
 * set active search category on menu
 * @return string
 */
function runtimeSearchCurrentMenu($menu = 'foo', $value = 'bar') {

if ($menu == $value) {
        return 'active';
    }
}

/**
 * set the maximum results
 * @return string
 */
function runtimeSearchDisplyLimit($search_type = '') {

// was the search on the 'group' screen or category screen
    if ($search_type == 'all') {
        return config('system.settings2_search_category_limit');
    } else {
        return config('system.settings_system_pagination_limits');
    }
}

/**
 * show or hide the sharing dropdown
 * @return string
 */
function calendarSharing($sharing = '') {

if ($sharing != 'selected-users') {
        return 'hidden';
    }

}

/**
 * various element visibity for proposals automation
 * @param string $value determining value
 */
function proposalAutomationVisibility($value = '') {

//hide the button
    if ($value == 'no' || $value == 'disabled') {
        return 'hidden';
    }
    return;
}

/**
 * task status name
 * @param mixed $value the task status (old version of the new version based on an custom status id)
 */
function taskStatusName($value = '') {

//validate
    if ($value == '') {
        return '---';
    }

//new status names
    if (is_numeric($value)) {
        $statuses = config('system.task_custom_statuses');
        if (is_array($statuses) && array_key_exists($value, $statuses)) {
            return $statuses[$value];
        } else {
            return '---';
        }
    }

//old name
    return runtimeLang($value);
}

/**
 * lead status name
 * @param mixed $value the lead status (old version of the new version based on an custom status id)
 */
function leadStatusName($value = '') {

//validate
    if ($value == '') {
        return '---';
    }

//new status names
    if (is_numeric($value)) {
        $statuses = config('system.lead_custom_statuses');
        if (is_array($statuses) && array_key_exists($value, $statuses)) {
            return $statuses[$value];
        } else {
            return '---';
        }
    }

//old name
    return runtimeLang($value);
}

/**
 * ticket status name
 * @param mixed $value the ticket status (old version of the new version based on an custom status id)
 */
function ticketStatusName($value = '') {

//validate
    if ($value == '') {
        return '---';
    }

//new status names
    if (is_numeric($value)) {
        $statuses = config('system.ticket_custom_statuses');
        if (is_array($statuses) && array_key_exists($value, $statuses)) {
            return $statuses[$value];
        } else {
            return '---';
        }
    }

//old name
    return runtimeLang($value);
}

/**
 * disabling all day checkbox for projects and tasks
 * @param string $resource_type type of calendar resource
 * @return string css
 */
function runtimeDisabledCalenderAllDayCheckbox($resource_type = '') {
    if ($resource_type == 'project' || $resource_type == 'task') {
        return 'disabled';
    }
}

/**
 * shows a tool tip if the event is a project or task and it can only be set as an all day
 * @param string $resource_type type of calendar resource
 * @return string css
 */
function runtimeDisabledCalenderAllDayTooltip($resource_type = '') {
    if ($resource_type == '' || $resource_type == 'calendarevent') {
        return 'hidden';
    }
}

/**
 * various element visibity for tickets imap settings
 * @param string $value determining value
 */
function ticketsImapSettingsVisibility($value = '') {

//imap is disabled
    if ($value != 'enabled') {
        return 'hidden';
    }
    return;
}

/*
 * bootstrap label class, based on user type
 * @return string bootstrap label class
 */
function runtimeUserTypeLabel($type = '') {
    switch ($type) {
    case 'team':
        return 'label-outline-info';
        break;
    case 'client':
        return 'label-outline-success';
        break;
    default:
        return 'label-outline-default';
        break;
    }
}

/**
 * [modules]
 * @return string a truely random unique id example: 5ed8a52d8a0b830247500
 */
function textareaFormat($name = '') {
    return random_string(20) . str_unique();
}

/**
 * Converts HTML content to plain text by decoding HTML entities,
 * removing HTML tags, and replacing block-level elements and newlines with spaces.
 *
 * @param string $html The HTML content to convert.
 * @return string The plain text result.
 */
function convert_html_to_plain_text($html) {
    // Decode HTML entities to their corresponding characters
    $text = html_entity_decode($html, ENT_QUOTES | ENT_HTML5, 'UTF-8');

// Replace block-level elements and line breaks with spaces
    $search = [
        '@<head[^>]*?>.*?</head>@siu',
        '@<style[^>]*?>.*?</style>@siu',
        '@<script[^>]*?>.*?</script>@siu',
        '@<object[^>]*?>.*?</object>@siu',
        '@<embed[^>]*?>.*?</embed>@siu',
        '@<applet[^>]*?>.*?</applet>@siu',
        '@<noframes[^>]*?>.*?</noframes>@siu',
        '@<noscript[^>]*?>.*?</noscript>@siu',
        '@<noembed[^>]*?>.*?</noembed>@siu',
        '@<br[^>]*>@siu',
        '@<hr[^>]*>@siu',
        '@</?p[^>]*>@siu',
        '@</?div[^>]*>@siu',
        '@</?li[^>]*>@siu',
        '@</?ul[^>]*>@siu',
        '@</?ol[^>]*>@siu',
        '@</?h[1-6][^>]*>@siu',
        '@</?table[^>]*>@siu',
        '@</?tr[^>]*>@siu',
        '@</?td[^>]*>@siu',
        '@</?th[^>]*>@siu',
        '@\n@', // Newlines
        '@\r@', // Carriage returns
    ];
    $text = preg_replace($search, ' ', $text);

// Strip any remaining HTML tags
    $text = strip_tags($text);

// Replace multiple whitespace characters (spaces, tabs, newlines) with a single space
    $text = preg_replace('/\s+/', ' ', $text);

// Trim leading and trailing spaces
    $text = trim($text);

return $text;
}

/**
 * parse an email and replace placeholder {variables} with actual data
 *
 * @param string $content the text that has the placeholder variables. e.g. email subject or email body
 * @param array $payload the payload that has the vraibles and their correspoding data
 *
 * @return string the content with the variables replaced with actual data
 */
function parseEmailVariables($content = '', $payload = []) {

//validate
    if ($content == '' || !is_array($payload)) {
        return $content;
    }

//parse the content and inject actual data
    $parsed = preg_replace_callback('/{(.*?)}/', function ($matches) use ($payload) {
        list($shortcode, $index) = $matches;
        //if shortcode is found, replace or return as is
        if (isset($payload[$index])) {
            return $payload[$index];
        } else {
            return $shortcode;
        }
    }, $content);

//return
    return $parsed;

}

/**
 * fix the name used by modules so that it only have alph numeric and is lowercase
 * This is important for various ways in which the module name will be used in the CRM
 * [TODO] - move this into ModulesHelper.php
 *
 * @param string $name the module name
 *
 * @return string the fixed name
 */
function modulesSanitizeModuleName($module_name = '') {

// Sanitize the module name: replace non-alphanumeric characters with underscores and convert to lowercase
    $module_name = strtolower(preg_replace('/[^a-zA-Z0-9]+/', '_', $module_name));

// Remove leading/trailing underscores
    $module_name = trim($module_name, '_');

return $module_name;

}

/**
 * ISO4127 Currencies
 * Based on the settings in the currencies table. Using this for modules for now, but will add
 * ability to modify and add new currencies to this table.
 * @param string $number unformatted numerical value
 * @param string $currency_code ISO curreny code (i.e. USD)
 * @return string a formatted money string e.g. $1,324.99
 */
function moneyFormat($number = '', $currency_code = '') {

//validate both required attributes have been passed to the function
    if ($number == '' || $currency_code == '') {
        return $number;
    }

//get currency from config (already loaded during bootstrapping)
    $currency = collect(config('currencies'))->firstWhere('currency_code', strtoupper($currency_code));

//if currency does not exist, just return the $number as it was passed
    if (!$currency) {
        return $number;
    }

//number of decimal places to use
    $decimals = (config('system.settings_system_currency_hide_decimal') == 'yes') ? 0 : 2;

//format the number with correct separators
    $formatted = number_format(
        $number,
        $decimals,
        str_replace('&nbsp;', ' ', $currency->currency_decimal_separator),
        str_replace('&nbsp;', ' ', $currency->currency_thousands_separator)
    );

//place currency symbol on correct side
    if ($currency->currency_symbol_position == 'left') {
        $formatted = $currency->currency_symbol . $formatted;
    } else {
        $formatted = $formatted . $currency->currency_symbol;
    }

return $formatted;
}

/**
 * Recurring payments cycle language
 * @param string $cycle e.g. month, year, etc
 * @param int $interval e.g. 1, 2 etc
 * @return string month | 3 months
 */
function recurringCycleFormat($cycle = '', $interval = 1) {

switch ($cycle) {
    case 'day':
    case 'daily':
        return ($interval > 1) ? $interval . ' ' . __('lang.days') : __('lang.day');
        break;
    case 'week':
    case 'weekly':
        return ($interval > 1) ? $interval . ' ' . __('lang.weeks') : __('lang.week');
        break;
    case 'month':
    case 'monthly':
        return ($interval > 1) ? $interval . ' ' . __('lang.months') : __('lang.month');
        break;
    case 'year':
    case 'yearly':
        return ($interval > 1) ? $interval . ' ' . __('lang.years') : __('lang.year');
        break;
    default:
        $foo = $bar;
    }

}

/**
 * format a checklist comment for use in email the templates. 
 * This added the original checklist as part of the comment passed to the email template
 * @param object $comment comment model
 * @param int $checklist checklist model
 * @return string month | 3 months
 */
function formatChecklistComment($comment = [], $checklist = []) {

$posted_by = $comment->first_name ?? __('lang.comment');

$message = '<div style="margin-bottom:15px;background-color: #ffffff;padding: 8px;border-radius: 8px;margin-left: 5px;margin-right: 5px;margin-top: 10px;">
    <strong>' . __('lang.checklist') . ': </strong>' . $checklist->checklist_text . '</div>
    <div style="padding-left: 8px; padding-right: 8px;margin-bottom: 15px;"><strong>' . $posted_by . ':</strong> ' . $comment->comment_text . '</div>';

return $message;
}

/**
 * Convert textarea content to HTML with proper formatting
 *
 * @param string $text The raw text from textarea
 * @param array $options Configuration options that can be passed as an array
 * @return string Formatted HTML
 */
function convertTextareaToHtml($text, $options = []) {

// Default options
    $defaultOptions = [
        'convert_urls' => true, // Convert URLs to clickable links
        'convert_emails' => false, // Convert emails to clickable links
        'nl2br' => true, // Convert newlines to <br> tags
        'preserve_paragraphs' => true, // Convert double newlines to paragraphs
        'strip_tags' => false, // Strip existing HTML tags for security
        'trim_whitespace' => true, // Trim excess whitespace
        'max_length' => null, // Maximum character length (null for no limit)
    ];

$options = array_merge($defaultOptions, $options);

// Return empty string if input is null or empty
    if (empty($text)) {
        return '';
    }

// Trim whitespace if enabled
    if ($options['trim_whitespace']) {
        $text = trim($text);
    }

// Truncate if max length is specified
    if ($options['max_length'] && strlen($text) > $options['max_length']) {
        $text = substr($text, 0, $options['max_length']) . '...';
    }

// Strip HTML tags for security if enabled
    if ($options['strip_tags']) {
        $text = strip_tags($text);
    }

// Escape HTML entities
    $text = htmlspecialchars($text, ENT_QUOTES, 'UTF-8');

// Convert URLs to clickable links
    if ($options['convert_urls']) {
        $text = preg_replace(
            '/(https?:\/\/[^\s<>"]+)/i',
            '<a href="$1" target="_blank" rel="noopener noreferrer">$1</a>',
            $text
        );
    }

// Convert email addresses to clickable links
    if ($options['convert_emails']) {
        $text = preg_replace(
            '/([a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,})/i',
            '<a href="mailto:$1">$1</a>',
            $text
        );
    }

// Handle paragraph formatting vs simple line breaks
    if ($options['preserve_paragraphs']) {
        // Convert double newlines to paragraph breaks
        $paragraphs = preg_split('/\n\s*\n/', $text);
        $paragraphs = array_map('trim', $paragraphs);
        $paragraphs = array_filter($paragraphs); // Remove empty paragraphs

if (!empty($paragraphs)) {
            $text = '<p>' . implode('</p><p>', $paragraphs) . '</p>';

// Convert single newlines within paragraphs to <br> if nl2br is enabled
            if ($options['nl2br']) {
                $text = preg_replace('/(?<!<p>)\n(?!<\/p>)/', '<br>', $text);
            }
        }
    } else {
        // Simple newline to <br> conversion
        if ($options['nl2br']) {
            $text = nl2br($text);
        }
    }

return $text;
}

Cancel / Back

[ MAINHACK ]

Viewing / Editing File: Helpers.php

Server Info

System Features

User Info