LÁZÁR Imre AI Agent
9c9a0366e8
Akeeba Backup Core (Akeeba Ltd) + FOF 2.4.3/FOF30 3.3.4/FEF libraries; exact 6.1.1 not publicly downloadable -> deployed files (code only, no backup archives). Signed-off-by: LÁZÁR Imre <imre@illusion.hu> Assisted-by: claude-code@claude-opus-4-8
440 lines
10 KiB
PHP
440 lines
10 KiB
PHP
<?php
|
||
/**
|
||
* @package FOF
|
||
* @copyright Copyright (c)2010-2018 Nicholas K. Dionysopoulos / Akeeba Ltd
|
||
* @license GNU GPL version 2 or later
|
||
*
|
||
* Based on the Seesion package of Aura for PHP – https://github.com/auraphp/Aura.Session
|
||
*/
|
||
|
||
namespace FOF30\Utils;
|
||
|
||
use JCache;
|
||
use JHtml;
|
||
use JFactory;
|
||
use JText;
|
||
|
||
defined('_JEXEC') or die;
|
||
|
||
/**
|
||
* Returns arrays of JHtml select options for Joomla-specific information such as access levels.
|
||
*/
|
||
class SelectOptions
|
||
{
|
||
private static $cache = [];
|
||
|
||
/**
|
||
* Magic method to handle static calls
|
||
*
|
||
* @param string $name The name of the static method being called
|
||
* @param string $arguments Ignored.
|
||
*
|
||
* @since 3.3.0
|
||
*
|
||
* @return mixed
|
||
*/
|
||
public static function __callStatic($name, $arguments)
|
||
{
|
||
return self::getOptions($name, $arguments);
|
||
}
|
||
|
||
/**
|
||
* Get a list of Joomla options of the type you specify. Supported types
|
||
* - access View access levels
|
||
* - usergroups User groups
|
||
* - cachehandlers Cache handlers
|
||
* - components Installed components accessible by the current user
|
||
* - languages Site or administrator languages
|
||
* - published Published status
|
||
*
|
||
* Global params:
|
||
* - cache Should I returned cached data? Default: true.
|
||
*
|
||
* See the private static methods of this class for more information on params.
|
||
*
|
||
* @param string $type The options type to get
|
||
* @param array $params Optional arguments, if they are supported by the options type.
|
||
*
|
||
* @since 3.3.0
|
||
*
|
||
* @return \stdClass[]
|
||
*/
|
||
public static function getOptions($type, array $params = [])
|
||
{
|
||
if ((substr($type, 0, 1) == '_') || !method_exists(__CLASS__, $type))
|
||
{
|
||
throw new \InvalidArgumentException(__CLASS__ . "does not support option type '$type'.");
|
||
}
|
||
|
||
$useCache = true;
|
||
|
||
if (isset($params['cache']))
|
||
{
|
||
$useCache = isset($params['cache']);
|
||
unset($params['cache']);
|
||
}
|
||
|
||
$cacheKey = sha1($type . '--' . print_r($params, true));
|
||
$fetchNew = !$useCache || ($useCache && !isset(self::$cache[$cacheKey]));
|
||
|
||
if ($fetchNew)
|
||
{
|
||
$ret = forward_static_call_array([__CLASS__, $type], [$params]);
|
||
}
|
||
|
||
if (!$useCache)
|
||
{
|
||
return $ret;
|
||
}
|
||
|
||
if ($fetchNew)
|
||
{
|
||
self::$cache[$cacheKey] = $ret;
|
||
}
|
||
|
||
return self::$cache[$cacheKey];
|
||
}
|
||
|
||
/**
|
||
* Joomla! Access Levels (previously: view access levels)
|
||
*
|
||
* Available params:
|
||
* - allLevels: Show an option for all levels (default: false)
|
||
*
|
||
* @param array $params Parameters
|
||
*
|
||
* @since 3.3.0
|
||
*
|
||
* @return \stdClass[]
|
||
*
|
||
* @see \JHtmlAccess::level()
|
||
*/
|
||
private static function access(array $params = [])
|
||
{
|
||
$db = JFactory::getDbo();
|
||
$query = $db->getQuery(true)
|
||
->select($db->quoteName('a.id', 'value') . ', ' . $db->quoteName('a.title', 'text'))
|
||
->from($db->quoteName('#__viewlevels', 'a'))
|
||
->group($db->quoteName(array('a.id', 'a.title', 'a.ordering')))
|
||
->order($db->quoteName('a.ordering') . ' ASC')
|
||
->order($db->quoteName('title') . ' ASC');
|
||
|
||
// Get the options.
|
||
$db->setQuery($query);
|
||
$options = $db->loadObjectList();
|
||
|
||
if (isset($params['allLevels']) && $params['allLevels'])
|
||
{
|
||
array_unshift($options, JHtml::_('select.option', '', JText::_('JOPTION_ACCESS_SHOW_ALL_LEVELS')));
|
||
}
|
||
|
||
return $options;
|
||
}
|
||
|
||
/**
|
||
* Joomla! User Groups
|
||
*
|
||
* Available params:
|
||
* - allGroups: Show an option for all groups (default: false)
|
||
*
|
||
* @param array $params Parameters
|
||
*
|
||
* @since 3.3.0
|
||
*
|
||
* @return \stdClass[]
|
||
*
|
||
* @see \JHtmlAccess::usergroup()
|
||
*/
|
||
private static function usergroups(array $params = [])
|
||
{
|
||
$options = array_values(\JHelperUsergroups::getInstance()->getAll());
|
||
|
||
for ($i = 0, $n = count($options); $i < $n; $i++)
|
||
{
|
||
$options[$i]->value = $options[$i]->id;
|
||
$options[$i]->text = str_repeat('- ', $options[$i]->level) . $options[$i]->title;
|
||
}
|
||
|
||
// If all usergroups is allowed, push it into the array.
|
||
if (isset($params['allGroups']) && $params['allGroups'])
|
||
{
|
||
array_unshift($options, JHtml::_('select.option', '', JText::_('JOPTION_ACCESS_SHOW_ALL_GROUPS')));
|
||
}
|
||
|
||
return $options;
|
||
}
|
||
|
||
/**
|
||
* Joomla cache handlers
|
||
*
|
||
* @since 3.3.0
|
||
*
|
||
* @return \stdClass[]
|
||
*/
|
||
private static function cachehandlers()
|
||
{
|
||
$options = array();
|
||
|
||
// Convert to name => name array.
|
||
foreach (JCache::getStores() as $store)
|
||
{
|
||
$options[] = JHtml::_('select.option', $store, JText::_('JLIB_FORM_VALUE_CACHE_' . $store), 'value', 'text');
|
||
}
|
||
|
||
return $options;
|
||
}
|
||
|
||
/**
|
||
* Get a list of all installed components and also translates them.
|
||
*
|
||
* Available params:
|
||
* - client_ids Array of Joomla application client IDs
|
||
*
|
||
* @param array $params
|
||
*
|
||
* @since 3.3.0
|
||
*
|
||
* @return \stdClass[]
|
||
*/
|
||
private static function components(array $params)
|
||
{
|
||
$db = JFactory::getDbo();
|
||
|
||
// Check for client_ids override
|
||
$client_ids = isset($params['client_ids']) ? $params['client_ids'] : [0, 1];
|
||
|
||
if (is_string($client_ids))
|
||
{
|
||
$client_ids = explode(',', $client_ids);
|
||
}
|
||
|
||
// Calculate client_ids where clause
|
||
$client_ids = array_map(function ($client_id) use ($db) {
|
||
return $db->q((int) trim($client_id));
|
||
}, $client_ids);
|
||
|
||
$query = $db->getQuery(true)
|
||
->select(
|
||
[
|
||
$db->qn('name'),
|
||
$db->qn('element'),
|
||
$db->qn('client_id'),
|
||
$db->qn('manifest_cache'),
|
||
]
|
||
)
|
||
->from($db->qn('#__extensions'))
|
||
->where($db->qn('type') . ' = ' . $db->q('component'))
|
||
->where($db->qn('client_id') . ' IN (' . implode(',', $client_ids) . ')');
|
||
$components = $db->setQuery($query)->loadObjectList('element');
|
||
|
||
// Convert to array of objects, so we can use sortObjects()
|
||
// Also translate component names with JText::_()
|
||
$aComponents = [];
|
||
$user = JFactory::getUser();
|
||
|
||
foreach ($components as $component)
|
||
{
|
||
// Don't show components in the list where the user doesn't have access for
|
||
// TODO: perhaps add an option for this
|
||
if (!$user->authorise('core.manage', $component->element))
|
||
{
|
||
continue;
|
||
}
|
||
|
||
$aComponents[$component->element] = (object) [
|
||
'value' => $component->element,
|
||
'text' => self::_translateComponentName($component),
|
||
];
|
||
}
|
||
|
||
// Reorder the components array, because the alphabetical
|
||
// ordering changed due to the JText::_() translation
|
||
uasort(
|
||
$aComponents,
|
||
function ($a, $b) {
|
||
return strcasecmp($a->text, $b->text);
|
||
}
|
||
);
|
||
|
||
return $aComponents;
|
||
}
|
||
|
||
/**
|
||
* Method to get the field options.
|
||
*
|
||
* Available params:
|
||
* - client 'site' (default) or 'administrator'
|
||
* - none Text to show for "all languages" option, use empty string to remove it
|
||
*
|
||
* @since 3.3.0
|
||
*
|
||
* @return \stdClass Languages for the specifed client
|
||
*/
|
||
private static function languages($params)
|
||
{
|
||
$db = JFactory::getDbo();
|
||
|
||
$client = isset($params['client']) ? $params['client'] : 'site';
|
||
|
||
if (!in_array($client, ['site', 'administrator']))
|
||
{
|
||
$client = 'site';
|
||
}
|
||
|
||
// Make sure the languages are sorted base on locale instead of random sorting
|
||
$options = \JLanguageHelper::createLanguageList(null, constant('JPATH_' . strtoupper($client)), true, true);
|
||
|
||
if (count($options) > 1)
|
||
{
|
||
usort(
|
||
$options,
|
||
function ($a, $b)
|
||
{
|
||
return strcmp($a['value'], $b['value']);
|
||
}
|
||
);
|
||
}
|
||
|
||
$none = isset($params['none']) ? $params['none'] : '*';
|
||
|
||
if (!empty($none))
|
||
{
|
||
array_unshift($options, JHtml::_('select.option', '*', JText::_($none)));
|
||
}
|
||
|
||
return $options;
|
||
}
|
||
|
||
/**
|
||
* Options for a Published field
|
||
*
|
||
* Params:
|
||
* - none Placeholder for no selection (empty key). Default: null.
|
||
* - published Show "Published"? Default: true
|
||
* - unpublished Show "Unpublished"? Default: true
|
||
* - archived Show "Archived"? Default: false
|
||
* - trash Show "Trashed"? Default: false
|
||
* - all Show "All" option? This is different than none, the key is '*'. Default: false
|
||
*
|
||
* @param $params
|
||
*
|
||
* @return array
|
||
*/
|
||
private static function published(array $params = [])
|
||
{
|
||
$config = array_merge([
|
||
'none' => '',
|
||
'published' => true,
|
||
'unpublished' => true,
|
||
'archived' => false,
|
||
'trash' => false,
|
||
'all' => false,
|
||
], $params);
|
||
|
||
$options = array();
|
||
|
||
if (!empty($config['none']))
|
||
{
|
||
$options[] = JHtml::_('select.option', '', JText::_($config['none']));
|
||
}
|
||
|
||
if ($config['published'])
|
||
{
|
||
$options[] = JHtml::_('select.option', '1', JText::_('JPUBLISHED'));
|
||
}
|
||
|
||
if ($config['unpublished'])
|
||
{
|
||
$options[] = JHtml::_('select.option', '0', JText::_('JUNPUBLISHED'));
|
||
}
|
||
|
||
if ($config['archived'])
|
||
{
|
||
$options[] = JHtml::_('select.option', '2', JText::_('JARCHIVED'));
|
||
}
|
||
|
||
if ($config['trash'])
|
||
{
|
||
$options[] = JHtml::_('select.option', '-2', JText::_('JTRASHED'));
|
||
}
|
||
|
||
if ($config['all'])
|
||
{
|
||
$options[] = JHtml::_('select.option', '*', JText::_('JALL'));
|
||
}
|
||
|
||
return $options;
|
||
}
|
||
|
||
/**
|
||
* Options for a Published field
|
||
*
|
||
* Params:
|
||
* - none Placeholder for no selection (empty key). Default: null.
|
||
*
|
||
* @param $params
|
||
*
|
||
* @return array
|
||
*/
|
||
private static function boolean(array $params = [])
|
||
{
|
||
$config = array_merge([
|
||
'none' => '',
|
||
], $params);
|
||
|
||
$options = array();
|
||
|
||
if (!empty($config['none']))
|
||
{
|
||
$options[] = JHtml::_('select.option', '', JText::_($config['none']));
|
||
}
|
||
|
||
$options[] = JHtml::_('select.option', '1', JText::_('JYES'));
|
||
$options[] = JHtml::_('select.option', '0', JText::_('JNO'));
|
||
|
||
return $options;
|
||
}
|
||
|
||
|
||
/**
|
||
* Translate a component name
|
||
*
|
||
* @param \stdClass $item The component object
|
||
*
|
||
* @since 3.3.0
|
||
*
|
||
* @return string $text The translated name of the extension
|
||
*
|
||
* @see administrator/com_installer/models/extension.php
|
||
*/
|
||
private static function _translateComponentName($item)
|
||
{
|
||
// Map the manifest cache to $item. This is needed to get the name from the
|
||
// manifest_cache and NOT from the name column, else some JText::_() translations fails.
|
||
$mData = json_decode($item->manifest_cache);
|
||
|
||
if ($mData)
|
||
{
|
||
foreach ($mData as $key => $value)
|
||
{
|
||
if ($key == 'type')
|
||
{
|
||
// Ignore the type field
|
||
continue;
|
||
}
|
||
|
||
$item->$key = $value;
|
||
}
|
||
}
|
||
|
||
$lang = JFactory::getLanguage();
|
||
$source = JPATH_ADMINISTRATOR . '/components/' . $item->element;
|
||
$lang->load("$item->element.sys", JPATH_ADMINISTRATOR, null, false, false)
|
||
|| $lang->load("$item->element.sys", $source, null, false, false)
|
||
|| $lang->load("$item->element.sys", JPATH_ADMINISTRATOR, $lang->getDefault(), false, false)
|
||
|| $lang->load("$item->element.sys", $source, $lang->getDefault(), false, false);
|
||
|
||
return JText::_($item->name);
|
||
}
|
||
}
|