black-lamp/yii2-file-icons

Widget for getting the font-icon for file extension

File icons widget for Yii2

Widget for getting the font-icon for file extension, _(*1)

, _(*2)

Installation

Run command, _(*3)

composer require black-lamp/yii2-file-icons

or add, _(*4)

"black-lamp/yii2-file-icons": "^1.0.0"

to the require section of your composer.json., _(*5)

Using

Example of using, _(*6)

$widget = \bl\files\icons\FileIconWidget::begin([
    'icons' => [
        'txt' => [
            'icon' => \yii\helpers\Html::tag('i', '', ['class' => 'icon-file-txt'])
        ],
        'groups' => [
            [
                'extensions' => ['jpg', 'png', 'gif'],
                'icon' => \yii\helpers\Html::tag('i', '', ['class' => 'icon-picture'])
            ],
        ]
    ]
]);
echo $widget->getIcon('image.jpg');
$widget->end();

Method FileIconWidget::getIcon() takes file extension, file name or full path to file and returns icon for file extension. Icon - method gets from configuration array. If icon not found in configuration array method returns empty icon. Empty icon value gets from emptyIcon widget option., _(*7)

Widget configuration properties

Default icon set

If you set widget option useDefaultIcons in true - method FileIconWidget::getIcon() will be returns default icons for file extensions. Also you can override default icons if you dont't wont to use default icon for curren file extension. , _(*8)

<i class="file-text"></i>
<i class="file-pdf"></i>
<i class="file-power-point"></i>
<i class="file-archive"></i>
<i class="file-word"></i>
<i class="file-excel"></i>
<i class="file-picture"></i>
<i class="file-video"></i>
<i class="file-code"></i>

or using \bl\files\icons\helpers\IconHelper, _(*9)

IconHelper::icon('text');
IconHelper::icon('pdf');
IconHelper::icon('power-point');
IconHelper::icon('archive');
IconHelper::icon('word');
IconHelper::icon('excel');
IconHelper::icon('picture');
IconHelper::icon('video');
IconHelper::icon('code');