mirror of
https://github.com/snipe/snipe-it.git
synced 2024-09-20 07:47:41 -07:00
482 lines
15 KiB
PHP
482 lines
15 KiB
PHP
<?php
|
|
namespace App\Helpers;
|
|
|
|
use DB;
|
|
use App\Models\Statuslabel;
|
|
use App\Models\Location;
|
|
use App\Models\AssetModel;
|
|
use App\Models\Company;
|
|
use App\Models\User;
|
|
use App\Models\Manufacturer;
|
|
use App\Models\Supplier;
|
|
use App\Models\Category;
|
|
use App\Models\Depreciation;
|
|
use App\Models\CustomFieldset;
|
|
use App\Models\CustomField;
|
|
use App\Models\Component;
|
|
use App\Models\Accessory;
|
|
use App\Models\Consumable;
|
|
use App\Models\Asset;
|
|
|
|
/*
|
|
* To change this license header, choose License Headers in Project Properties.
|
|
* To change this template file, choose Tools | Templates
|
|
* and open the template in the editor.
|
|
*/
|
|
class Helper
|
|
{
|
|
|
|
|
|
public static function parseEscapedMarkedown($str) {
|
|
$Parsedown = new \Parsedown();
|
|
|
|
if ($str) {
|
|
return $Parsedown->text(e($str));
|
|
}
|
|
}
|
|
|
|
|
|
// This doesn't do anything yet
|
|
public static function parseEmailList($emails)
|
|
{
|
|
$emails_array = explode(',', $emails);
|
|
return array_walk($emails_array, 'trim_value');
|
|
}
|
|
|
|
public static function formatCurrencyOutput($cost)
|
|
{
|
|
// The importer has formatted number strings since v3, so the value might be a string, or an integer.
|
|
// If it's a number, format it as a string
|
|
if (is_numeric($cost)) {
|
|
return number_format($cost, 2, '.', '');
|
|
}
|
|
// It's already been parsed.
|
|
return $cost;
|
|
}
|
|
|
|
// This doesn't do anything yet
|
|
public static function trim_value(&$value)
|
|
{
|
|
return trim($value);
|
|
}
|
|
|
|
// Static colors for pie charts
|
|
public static function chartColors()
|
|
{
|
|
$colors = [
|
|
'#f56954',
|
|
'#00a65a',
|
|
'#f39c12',
|
|
'#00c0ef',
|
|
'#3c8dbc',
|
|
'#d2d6de',
|
|
'#3c8dbc',
|
|
'#3c8dbc',
|
|
'#3c8dbc',
|
|
|
|
];
|
|
return $colors;
|
|
}
|
|
|
|
// Static background (highlight) colors for pie charts
|
|
// This is not currently used, but might be in the near future.
|
|
public static function chartBackgroundColors()
|
|
{
|
|
$colors = [
|
|
'#f56954',
|
|
'#00a65a',
|
|
'#f39c12',
|
|
'#00c0ef',
|
|
'#3c8dbc',
|
|
'#d2d6de',
|
|
'#3c8dbc',
|
|
'#3c8dbc',
|
|
'#3c8dbc',
|
|
|
|
];
|
|
return $colors;
|
|
}
|
|
|
|
|
|
|
|
public static function ParseFloat($floatString)
|
|
{
|
|
// use comma for thousands until local info is property used
|
|
$LocaleInfo = localeconv();
|
|
$floatString = str_replace(",", "", $floatString);
|
|
$floatString = str_replace($LocaleInfo["decimal_point"], ".", $floatString);
|
|
return floatval($floatString);
|
|
}
|
|
|
|
|
|
public static function modelList()
|
|
{
|
|
$models = AssetModel::with('manufacturer')->get();
|
|
$model_array[''] = trans('general.select_model');
|
|
foreach ($models as $model) {
|
|
$model_array[$model->id] = $model->displayModelName();
|
|
}
|
|
return $model_array;
|
|
}
|
|
|
|
public static function companyList()
|
|
{
|
|
$company_list = array('0' => trans('general.select_company')) + DB::table('companies')
|
|
->orderBy('name', 'asc')
|
|
->pluck('name', 'id');
|
|
return $company_list;
|
|
}
|
|
|
|
|
|
public static function categoryList($category_type = null)
|
|
{
|
|
$categories = Category::orderBy('name', 'asc')
|
|
->whereNull('deleted_at')
|
|
->orderBy('name', 'asc');
|
|
if(!empty($category_type))
|
|
$categories = $categories->where('category_type', '=', $category_type);
|
|
$category_list = array('' => trans('general.select_category')) + $categories->pluck('name', 'id')->toArray();
|
|
return $category_list;
|
|
}
|
|
|
|
public static function suppliersList()
|
|
{
|
|
$supplier_list = array('' => trans('general.select_supplier')) + Supplier::orderBy('name', 'asc')
|
|
->orderBy('name', 'asc')
|
|
->pluck('name', 'id')->toArray();
|
|
return $supplier_list;
|
|
}
|
|
|
|
public static function statusLabelList()
|
|
{
|
|
$statuslabel_list = array('' => trans('general.select_statuslabel')) + Statuslabel::orderBy('name', 'asc')
|
|
->pluck('name', 'id')->toArray();
|
|
return $statuslabel_list;
|
|
}
|
|
|
|
public static function locationsList()
|
|
{
|
|
$location_list = array('' => trans('general.select_location')) + Location::orderBy('name', 'asc')
|
|
->pluck('name', 'id')->toArray();
|
|
return $location_list;
|
|
}
|
|
|
|
public static function manufacturerList()
|
|
{
|
|
$manufacturer_list = array('' => trans('general.select_manufacturer')) +
|
|
Manufacturer::orderBy('name', 'asc')
|
|
->pluck('name', 'id')->toArray();
|
|
return $manufacturer_list;
|
|
}
|
|
|
|
public static function statusTypeList()
|
|
{
|
|
$statuslabel_types = array('' => trans('admin/hardware/form.select_statustype')) + array('undeployable' => trans('admin/hardware/general.undeployable')) + array('pending' => trans('admin/hardware/general.pending')) + array('archived' => trans('admin/hardware/general.archived')) + array('deployable' => trans('admin/hardware/general.deployable'));
|
|
return $statuslabel_types;
|
|
}
|
|
|
|
public static function managerList()
|
|
{
|
|
$manager_list = array('' => trans('general.select_user')) +
|
|
User::where('deleted_at', '=', null)
|
|
->orderBy('last_name', 'asc')
|
|
->orderBy('first_name', 'asc')->get()
|
|
->lists('complete_name', 'id')->toArray();
|
|
|
|
return $manager_list;
|
|
}
|
|
|
|
public static function depreciationList()
|
|
{
|
|
$depreciation_list = ['' => 'Do Not Depreciate'] + Depreciation::orderBy('name', 'asc')
|
|
->pluck('name', 'id')->toArray();
|
|
return $depreciation_list;
|
|
}
|
|
|
|
public static function categoryTypeList()
|
|
{
|
|
$category_types = array('' => '','accessory' => 'Accessory', 'asset' => 'Asset', 'consumable' => 'Consumable','component' => 'Component');
|
|
return $category_types;
|
|
}
|
|
|
|
public static function usersList()
|
|
{
|
|
$users_list = array( '' => trans('general.select_user')) +
|
|
User::where('deleted_at', '=', null)
|
|
->where('show_in_list','=',1)
|
|
->orderBy('last_name', 'asc')
|
|
->orderBy('first_name', 'asc')->get()
|
|
->lists('complete_name', 'id')->toArray();
|
|
|
|
return $users_list;
|
|
}
|
|
|
|
public static function assetsList()
|
|
{
|
|
$assets_list = array('' => trans('general.select_asset')) + Asset::orderBy('name', 'asc')
|
|
->whereNull('deleted_at')
|
|
->pluck('name', 'id')->toArray();
|
|
return $assets_list;
|
|
}
|
|
|
|
public static function detailedAssetList()
|
|
{
|
|
|
|
$assets = array('' => trans('general.select_asset')) + Company::scopeCompanyables(Asset::all(), 'assets.company_id')->lists('detailed_name', 'id')->toArray();
|
|
return $assets;
|
|
}
|
|
|
|
|
|
public static function customFieldsetList()
|
|
{
|
|
$customfields = array('' => trans('admin/models/general.no_custom_field')) + CustomFieldset::pluck('name', 'id')->toArray();
|
|
return $customfields;
|
|
}
|
|
|
|
public static function predefined_formats()
|
|
{
|
|
$keys=array_keys(CustomField::$PredefinedFormats);
|
|
$stuff=array_combine($keys, $keys);
|
|
return $stuff+["custom" => "Custom Format..."];
|
|
}
|
|
|
|
public static function barcodeDimensions($barcode_type = 'QRCODE')
|
|
{
|
|
if ($barcode_type == 'C128') {
|
|
$size['height'] = '-1';
|
|
$size['width'] = '-10';
|
|
} elseif ($barcode_type == 'PDF417') {
|
|
$size['height'] = '-3';
|
|
$size['width'] = '-10';
|
|
} else {
|
|
$size['height'] = '-3';
|
|
$size['width'] = '-3';
|
|
}
|
|
return $size;
|
|
}
|
|
|
|
public static function generateRandomString($length = 10)
|
|
{
|
|
$characters = '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';
|
|
$charactersLength = strlen($characters);
|
|
$randomString = '';
|
|
for ($i = 0; $i < $length; $i++) {
|
|
$randomString .= $characters[rand(0, $charactersLength - 1)];
|
|
}
|
|
return $randomString;
|
|
}
|
|
|
|
/**
|
|
* This nasty little method gets the low inventory info for the
|
|
* alert dropdown
|
|
**/
|
|
public static function checkLowInventory()
|
|
{
|
|
$consumables = Consumable::with('users')->whereNotNull('min_amt')->get();
|
|
$accessories = Accessory::with('users')->whereNotNull('min_amt')->get();
|
|
$components = Component::with('assets')->whereNotNull('min_amt')->get();
|
|
|
|
$avail_consumables = 0;
|
|
$items_array = array();
|
|
$all_count = 0;
|
|
|
|
foreach ($consumables as $consumable) {
|
|
$avail = $consumable->numRemaining();
|
|
if ($avail < ($consumable->min_amt) + \App\Models\Setting::getSettings()->alert_threshold) {
|
|
if ($consumable->total_qty > 0) {
|
|
$percent = number_format((($consumable->numRemaining() / $consumable->total_qty) * 100), 0);
|
|
} else {
|
|
$percent = 100;
|
|
}
|
|
|
|
$items_array[$all_count]['id'] = $consumable->id;
|
|
$items_array[$all_count]['name'] = $consumable->name;
|
|
$items_array[$all_count]['type'] = 'consumables';
|
|
$items_array[$all_count]['percent'] = $percent;
|
|
$items_array[$all_count]['remaining']=$consumable->numRemaining();
|
|
$items_array[$all_count]['min_amt']=$consumable->min_amt;
|
|
$all_count++;
|
|
}
|
|
|
|
|
|
}
|
|
|
|
foreach ($accessories as $accessory) {
|
|
$avail = $accessory->numRemaining();
|
|
if ($avail < ($accessory->min_amt) + \App\Models\Setting::getSettings()->alert_threshold) {
|
|
|
|
if ($accessory->total_qty > 0) {
|
|
$percent = number_format((($accessory->numRemaining() / $accessory->total_qty) * 100), 0);
|
|
} else {
|
|
$percent = 100;
|
|
}
|
|
|
|
$items_array[$all_count]['id'] = $accessory->id;
|
|
$items_array[$all_count]['name'] = $accessory->name;
|
|
$items_array[$all_count]['type'] = 'accessories';
|
|
$items_array[$all_count]['percent'] = $percent;
|
|
$items_array[$all_count]['remaining']=$accessory->numRemaining();
|
|
$items_array[$all_count]['min_amt']=$accessory->min_amt;
|
|
$all_count++;
|
|
}
|
|
|
|
}
|
|
|
|
foreach ($components as $component) {
|
|
$avail = $component->numRemaining();
|
|
if ($avail < ($component->min_amt) + \App\Models\Setting::getSettings()->alert_threshold) {
|
|
if ($component->total_qty > 0) {
|
|
$percent = number_format((($component->numRemaining() / $component->total_qty) * 100), 0);
|
|
} else {
|
|
$percent = 100;
|
|
}
|
|
|
|
$items_array[$all_count]['id'] = $component->id;
|
|
$items_array[$all_count]['name'] = $component->name;
|
|
$items_array[$all_count]['type'] = 'components';
|
|
$items_array[$all_count]['percent'] = $percent;
|
|
$items_array[$all_count]['remaining']=$component->numRemaining();
|
|
$items_array[$all_count]['min_amt']=$component->min_amt;
|
|
$all_count++;
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
return $items_array;
|
|
|
|
|
|
}
|
|
|
|
|
|
public static function checkUploadIsImage($file)
|
|
{
|
|
// Check if the file is an image, so we can show a preview
|
|
$finfo = @finfo_open(FILEINFO_MIME_TYPE); // return mime type ala mimetype extension
|
|
$filetype = @finfo_file($finfo, $file);
|
|
finfo_close($finfo);
|
|
|
|
if (($filetype=="image/jpeg") || ($filetype=="image/jpg") || ($filetype=="image/png") || ($filetype=="image/bmp") || ($filetype=="image/gif")) {
|
|
return $filetype;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Walks through the permissions in the permissions config file and determines if
|
|
* permissions are granted based on a $selected_arr array.
|
|
*
|
|
* The $permissions array is a multidimensional array broke down by section.
|
|
* (Licenses, Assets, etc)
|
|
*
|
|
* The $selected_arr should be a flattened array that contains just the
|
|
* corresponding permission name and a true or false boolean to determine
|
|
* if that group/user has been granted that permission.
|
|
*
|
|
* @author [A. Gianotto] [<snipe@snipe.net]
|
|
* @param array $permissions
|
|
* @param array $selected_arr
|
|
* @since [v1.0]
|
|
* @return Array
|
|
*/
|
|
public static function selectedPermissionsArray($permissions, $selected_arr = array())
|
|
{
|
|
|
|
|
|
$permissions_arr = array();
|
|
|
|
foreach ($permissions as $permission) {
|
|
|
|
for ($x = 0; $x < count($permission); $x++) {
|
|
$permission_name = $permission[$x]['permission'];
|
|
|
|
if ($permission[$x]['display'] === true) {
|
|
|
|
if ($selected_arr) {
|
|
if (array_key_exists($permission_name,$selected_arr)) {
|
|
$permissions_arr[$permission_name] = $selected_arr[$permission_name];
|
|
} else {
|
|
$permissions_arr[$permission_name] = '0';
|
|
}
|
|
} else {
|
|
$permissions_arr[$permission_name] = '0';
|
|
}
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
return $permissions_arr;
|
|
}
|
|
|
|
/**
|
|
* Introspects into the model validation to see if the field passed is required.
|
|
* This is used by the blades to add a required class onto the HTML element.
|
|
* This isn't critical, but is helpful to keep form fields in sync with the actual
|
|
* model level validation.
|
|
*
|
|
* This does not currently handle form request validation requiredness :(
|
|
*
|
|
* @author [A. Gianotto] [<snipe@snipe.net>]
|
|
* @since [v3.0]
|
|
* @return boolean
|
|
*/
|
|
public static function checkIfRequired($class, $field) {
|
|
$rules = $class::rules();
|
|
foreach ($rules as $rule_name => $rule) {
|
|
if ($rule_name == $field) {
|
|
if (strpos($rule, 'required') === false) {
|
|
return false;
|
|
} else {
|
|
return true;
|
|
}
|
|
|
|
}
|
|
}
|
|
}
|
|
|
|
|
|
/**
|
|
* Check to see if the given key exists in the array, and trim excess white space before returning it
|
|
*
|
|
* @author Daniel Melzter
|
|
* @since 3.0
|
|
* @param $array array
|
|
* @param $key string
|
|
* @param $default string
|
|
* @return string
|
|
*/
|
|
public static function array_smart_fetch(array $array, $key, $default = '')
|
|
{
|
|
array_change_key_case($array, CASE_LOWER);
|
|
return array_key_exists(strtolower($key), array_change_key_case($array)) ? e(trim($array[ $key ])) : $default;
|
|
}
|
|
|
|
/**
|
|
* Check to see if the given key exists in the array, and trim excess white space before returning it
|
|
*
|
|
* @author A. Gianotto
|
|
* @since 3.2
|
|
* @param $array array
|
|
* @return string
|
|
*/
|
|
public static function getLastDateFromHistoryArray(array $array)
|
|
{
|
|
foreach ($array as $key => $value) {
|
|
// echo '<pre>';
|
|
// echo 'last:'.$key;
|
|
// print_r($array);
|
|
// echo '</pre>';
|
|
}
|
|
}
|
|
|
|
|
|
|
|
|
|
}
|