FM / Helper

/var/www/vhosts/ihelp.ro/httpdocs/vendor/mirko-pagliai/me-tools/src/View/Helper/

/var/www/vhosts/ihelp.ro/httpdocs/vendor/mirko-pagliai/me-tools/src/View/Helper

Name	Size	Mode	Actions
AddButtonClassesTrait.php	2400	0644	edit dl rm
BreadcrumbsHelper.php	3978	0644	edit dl rm
DropdownHelper.php	4092	0644	edit dl rm
FormHelper.php	13440	0644	edit dl rm
HtmlHelper.php	10943	0644	edit dl rm
IconHelper.php	3218	0644	edit dl rm
LibraryHelper.php	5925	0644	edit dl rm
PaginatorHelper.php	3608	0644	edit dl rm

Edit: /var/www/vhosts/ihelp.ro/httpdocs/vendor/mirko-pagliai/me-tools/src/View/Helper/IconHelper.php (3218B)

<?php
declare(strict_types=1);

/**
 * This file is part of me-tools.
 *
 * Licensed under The MIT License
 * For full copyright and license information, please see the LICENSE.txt
 * Redistributions of files must retain the above copyright notice.
 *
 * @copyright   Copyright (c) Mirko Pagliai
 * @link        https://github.com/mirko-pagliai/me-tools
 * @license     https://opensource.org/licenses/mit-license.php MIT License
 * @since       2.18.12
 */
namespace MeTools\View\Helper;

use Cake\View\Helper\HtmlHelper as CakeHtmlHelper;

/**
 * Provides functionalities for creating HTML icons
 */
class IconHelper extends CakeHtmlHelper
{
    /**
     * Adds icons to text
     * @param string|null $text Text
     * @param array<string, mixed> $options Array options/attributes to add a class to
     * @return array Array with text with icons and the array of options
     * @since 2.16.2-beta
     */
    public function addIconToText(?string $text, array $options): array
    {
        $icon = $options['icon'] ?? null;
        $align = $options['icon-align'] ?? null;
        unset($options['icon'], $options['icon-align']);

if (!$icon) {
            return [$text, $options];
        }

$icon = $this->icon($icon);
        $result = $icon . ' ' . $text;
        if (!$text) {
            $result = $icon;
        } elseif ($align === 'right') {
            $result = $text . ' ' . $icon;
        }

return [$result, $options];
    }

/**
     * Internal method to build icon classes
     * @param string|string[] $icon Icons
     * @return string
     * @since 2.16.2-beta
     */
    protected function buildIconClasses($icon): string
    {
        //Prepends the string "fa-" to any other class
        /** @var string|string[] $icon */
        $icon = preg_replace('/(?<![^ ])(?=[^ ])(?!fa)/', 'fa-', $icon);
        $icon = is_array($icon) ? $icon : (preg_split('/\s+/', $icon ?: '', -1, PREG_SPLIT_NO_EMPTY) ?: []);

//Adds the "fa" class, if no other "basic" class is present
        if (!count(array_intersect(['fa', 'fab', 'fal', 'far', 'fas', 'fa-brands'], $icon))) {
            array_unshift($icon, 'fa');
        }

return implode(' ', array_unique($icon));
    }

/**
     * Returns icons tag.
     *
     * Example:
     * <code>
     * echo $this->Icon->icon('home');
     * </code>
     * Returns:
     * <code>
     * <i class="fas fa-home"> </i>
     * </code>
     *
     * Example:
     * <code>
     * echo $this->Icon->icon(['hand-o-right', '2x']);
     * </code>
     * Returns:
     * <code>
     * <i class="fas fa-hand-o-right fa-2x"> </i>
     * </code>
     * @param string|array<string> $icons Icons. You can also pass multiple arguments
     * @return string
     * @see http://fontawesome.com Font Awesome icons
     */
    public function icon(...$icons): string
    {
        $toString = fn($value): string => implode(' ', (array)$value);

$class = $this->buildIconClasses($toString(array_map($toString, $icons)));

return $this->formatTemplate('tag', [
            'attrs' => $this->templater()->formatAttributes(compact('class')),
            'content' => ' ',
            'tag' => 'i',
        ]);
    }
}

$options Array options/attributes to add a class to * @return array Array with text with icons and the array of options * @since 2.16.2-beta */ public function addIconToText(?string $text, array $options): array { $icon = $options['icon'] ?? null; $align = $options['icon-align'] ?? null; unset($options['icon'], $options['icon-align']); if (!$icon) { return [$text, $options]; } $icon = $this->icon($icon); $result = $icon . ' ' . $text; if (!$text) { $result = $icon; } elseif ($align === 'right') { $result = $text . ' ' . $icon; } return [$result, $options]; } /** * Internal method to build icon classes * @param string|string[] $icon Icons * @return string * @since 2.16.2-beta */ protected function buildIconClasses($icon): string { //Prepends the string "fa-" to any other class /** @var string|string[] $icon */ $icon = preg_replace('/(? * echo $this->Icon->icon('home'); * * Returns: *


     *  
     *

* * Example: *


     * echo $this->Icon->icon(['hand-o-right', '2x']);
     *

* Returns: *


     *  
     *

* @param string|array $icons Icons. You can also pass multiple arguments * @return string * @see http://fontawesome.com Font Awesome icons */ public function icon(...$icons): string { $toString = fn($value): string => implode(' ', (array)$value); $class = $this->buildIconClasses($toString(array_map($toString, $icons))); return $this->formatTemplate('tag', [ 'attrs' => $this->templater()->formatAttributes(compact('class')), 'content' => ' ', 'tag' => 'i', ]); } }