<?php
-if (! function_exists('versioned_asset')) {
+use BookStack\Ownable;
+
+if (!function_exists('versioned_asset')) {
/**
* Get the path to a versioned file.
*
- * @param string $file
+ * @param string $file
* @return string
*
* @throws \InvalidArgumentException
throw new InvalidArgumentException("File {$file} not defined in asset manifest.");
}
+}
+
+/**
+ * Check if the current user has a permission.
+ * If an ownable element is passed in the jointPermissions are checked against
+ * that particular item.
+ * @param $permission
+ * @param Ownable $ownable
+ * @return mixed
+ */
+function userCan($permission, Ownable $ownable = null)
+{
+ if ($ownable === null) {
+ return auth()->user() && auth()->user()->can($permission);
+ }
+
+ // Check permission on ownable item
+ $permissionService = app(\BookStack\Services\PermissionService::class);
+ return $permissionService->checkOwnableUserAccess($ownable, $permission);
+}
+
+/**
+ * Helper to access system settings.
+ * @param $key
+ * @param bool $default
+ * @return mixed
+ */
+function setting($key, $default = false)
+{
+ $settingService = app('BookStack\Services\SettingService');
+ return $settingService->get($key, $default);
+}
+
+/**
+ * Generate a url with multiple parameters for sorting purposes.
+ * Works out the logic to set the correct sorting direction
+ * Discards empty parameters and allows overriding.
+ * @param $path
+ * @param array $data
+ * @param array $overrideData
+ * @return string
+ */
+function sortUrl($path, $data, $overrideData = [])
+{
+ $queryStringSections = [];
+ $queryData = array_merge($data, $overrideData);
+
+ // Change sorting direction is already sorted on current attribute
+ if (isset($overrideData['sort']) && $overrideData['sort'] === $data['sort']) {
+ $queryData['order'] = ($data['order'] === 'asc') ? 'desc' : 'asc';
+ } else {
+ $queryData['order'] = 'asc';
+ }
+
+ foreach ($queryData as $name => $value) {
+ $trimmedVal = trim($value);
+ if ($trimmedVal === '') continue;
+ $queryStringSections[] = urlencode($name) . '=' . urlencode($trimmedVal);
+ }
+
+ if (count($queryStringSections) === 0) return $path;
+
+ return $path . '?' . implode('&', $queryStringSections);
}
\ No newline at end of file