CoreFiles by mySites.guru
Icons.php131 lines, 2,681 bytes, from Joomla_4.0.0-beta6-Beta-Full_Package.zip
Raw History Compare with 4.0.0-beta5
md5
67dc5d802d176d465b6f53da2eb56bd8
sha1
aa42b4ee4a724957168094d3214c462f3ec720c6
sha256
3e451678af71d78d81154cbffad3aa243e174c54d8b042420be5bcd0582de441
<?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.