phpvms/app/helpers.php

158 lines
3.8 KiB
PHP

<?php
if(!function_exists('get_truth_state')) {
/**
* Check if the passed state matches any of the states that
* we regard as being true or false
* @param $state
* @return bool
*/
function get_truth_state($state)
{
$enabledStates = [
'yes',
'y',
'on',
'true',
'1',
true,
];
if(is_string($state)) {
$state = strtolower($state);
}
return \in_array($state, $enabledStates, false);
}
}
if(!function_exists('list_to_assoc')) {
/**
* Converts a straight list into an assoc array with
* key and value being the same. Mainly for a select box
*
* e.g.:
* [ 0 => 'item1', 1 => 'item2']
* to:
* ['item1' => 'item1', 'item2' => 'item2']
*
* @param array $list
* @return array
*/
function list_to_assoc(array $list)
{
$ret = [];
foreach($list as $item) {
if(substr_count($item, '=')) {
[$item, $title] = explode('=', $item);
} else {
$title = $item;
}
$ret[$item] = $title;
}
return $ret;
}
}
if (!function_exists('skin_view')) {
/**
* Render a skin
* @param $template
* @param array $vars
* @param array $merge_data
* @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
*/
function skin_view($template, array $vars = [], $merge_data = [])
{
# Add the current skin name so we don't need to hardcode it in the templates
# Makes it a bit easier to create a new skin by modifying an existing one
$merge_data['SKIN_NAME'] = config('phpvms.skin');
$tpl = 'layouts/' . config('phpvms.skin') . '/' . $template;
# TODO: Look for an overridden template in a special folder
return view($tpl, $vars, $merge_data);
}
}
/**
* Shortcut for retrieving a setting value
*/
if (!function_exists('setting')) {
function setting($key, $default = null)
{
$settingRepo = app('setting');
try {
$value = $settingRepo->retrieve($key);
} catch (\App\Exceptions\SettingNotFound $e) {
return $default;
}
return $value;
}
}
/**
* Wrap the asset URL in the publicBaseUrl that's been
* set
*/
if (!function_exists('public_asset')) {
function public_asset($path, $parameters = [], $secure = null)
{
$publicBaseUrl = app()->publicUrlPath();
$path = $publicBaseUrl . $path;
$path = str_replace('//', '/', $path);
return url($path, $parameters, $secure);
}
}
/**
* Show a date/time in the proper timezone for a user
*/
if(!function_exists('show_datetime')) {
/**
* Format the a Carbon date into the datetime string
* but convert it into the user's timezone
* @param \Carbon\Carbon $date
* @return string
*/
function show_datetime(\Carbon\Carbon $date=null)
{
if(empty($date)) {
return '-';
}
$timezone = 'UTC';
if (Auth::check()) {
$timezone = Auth::user()->timezone ?: $timezone;
}
return $date->timezone($timezone)->toDayDateTimeString();
}
}
/**
* Show a date/time in the proper timezone for a user
*/
if (!function_exists('show_date')) {
/**
* Format the a Carbon date into the datetime string
* but convert it into the user's timezone
* @param \Carbon\Carbon $date
* @return string
*/
function show_date(\Carbon\Carbon $date)
{
$timezone = 'UTC';
if (Auth::check()) {
$timezone = Auth::user()->timezone ?: $timezone;
}
return $date->timezone($timezone)->toFormattedDateString();
}
}