mirror of
https://github.com/snipe/snipe-it.git
synced 2024-09-20 07:47:41 -07:00
0c912bcf49
This does two main things: 1) The importer now imports as numbers, not parsed strings. This allows is to format values on output instead of input, which is what was happening in most places. 2) Add a Helper::parseCurrencyString method and port everything to use this. This checks to see if the value is numeric or empty, and returns the appropriate value in all cases. Should fix all known occurances of number_format expections.
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 parseCurrencyString($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 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>';
|
|
}
|
|
}
|
|
|
|
|
|
|
|
|
|
}
|