- md5
- 67dc5d802d176d465b6f53da2eb56bd8
- sha1
- aa42b4ee4a724957168094d3214c462f3ec720c6
- sha256
- 3e451678af71d78d81154cbffad3aa243e174c54d8b042420be5bcd0582de441
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131
<?php
/**
* Joomla! Content Management System
*
* @copyright (C) 2012 Open Source Matters, Inc. <https://www.joomla.org>
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
namespace Joomla\CMS\HTML\Helpers;
\defined('JPATH_PLATFORM') or die;
use Joomla\CMS\Factory;
use Joomla\CMS\HTML\HTMLHelper;
use Joomla\CMS\Layout\FileLayout;
use Joomla\CMS\Uri\Uri;
use Joomla\Filesystem\Path;
/**
* Utility class for icons.
*
* @since 2.5
*/
abstract class Icons
{
/**
* Method to generate html code for a list of buttons
*
* @param array $buttons Array of buttons
*
* @return string
*
* @since 2.5
*/
public static function buttons($buttons)
{
if (empty($buttons))
{
return '';
}
$html = array();
foreach ($buttons as $button)
{
$html[] = HTMLHelper::_('icons.button', $button);
}
return implode($html);
}
/**
* Method to generate html code for a list of buttons
*
* @param array $button Button properties
*
* @return string
*
* @since 2.5
*/
public static function button($button)
{
if (isset($button['access']))
{
if (is_bool($button['access']))
{
if ($button['access'] == false)
{
return '';
}
}
else
{
// Get the user object to verify permissions
$user = Factory::getUser();
// Take each pair of permission, context values.
for ($i = 0, $n = count($button['access']); $i < $n; $i += 2)
{
if (!$user->authorise($button['access'][$i], $button['access'][$i + 1]))
{
return '';
}
}
}
}
// Instantiate a new FileLayout instance and render the layout
$layout = new FileLayout('joomla.quickicons.icon');
return $layout->render($button);
}
/**
* Writes an inline '<svg>' element
*
* @param string $file The relative or absolute PATH to use for the src attribute.
* @param boolean $relative Flag if the path to the file is relative to the /media folder (and searches in template).
*
* @return string|null
*
* @since 4.0
*/
public static function svg(string $file, bool $relative = true): ?string
{
// Check extension for .svg
$extension = strtolower(substr($file, -4));
if ($extension !== '.svg')
{
return null;
}
// Get path to icon
$file = HTMLHelper::_('image', $file, '', '', $relative, true);
// Make sure path is local to Joomla
$file = Path::check(JPATH_ROOT . '/' . substr($file, \strlen(Uri::root(true))));
// If you can't find the icon or if it's unsafe then skip it
if (!$file)
{
return null;
}
// Get contents to display inline
$file = file_get_contents($file);
return $file;
}
}
No other release has this exact content. See every version of this file.