yassinedoghri/codeigniter-iconify

This package is abandoned and no longer maintained. The author suggests using the yassinedoghri/codeigniter-icons package instead.

A CodeIgniter4 library with convenient helper functions to render svg icons using yassinedoghri/php-icons.

dev-develop 2024-04-09 22:06 UTC

Requires

• php: >=8.1
• yassinedoghri/php-icons: dev-develop

Requires (Dev)

• codeigniter/phpstan-codeigniter: ^v1.4.3
• codeigniter4/devkit: ^v1.2.2
• codeigniter4/framework: ^4.3.5
• phpstan/extension-installer: ^1.3.1
• phpstan/phpstan: ^1.10.66
• rector/rector: ^1.0.4
• symplify/coding-standard: ^12.1.4
• symplify/easy-coding-standard: ^12.1.14

MIT

• Yassine Doghri

• codeigniter
• icons
• codeigniter4
• iconify

README

A CodeIgniter4 library with convenient helper functions to render svg icons using php-icons.

🚀 Getting started

0. Prerequisites

Usage of CodeIgniter Icons requires the following:

• A CodeIgniter 4.3.5+ based project
• Composer for package management
• PHP 8.1+

1. Install via composer

composer require yassinedoghri/codeigniter-icons

2. Setup

1. init and configure PHPIcons, ie. create the PHPIcons config file.

2. add icons helper to your app/Config/Autoload.php file:

public $helpers = [/*...other helpers...*/, 'icons'];

3. Usage

Use the icon(string $iconKey) or phpicons(string $iconKey) helpers in your View files to render svg icons:

<?= icon('material-symbols:bolt') ?>
// <svg xmlns="http://www.w3.org/2000/svg" width="1em" height="1em" viewBox="0 0 24 24">
//      <path fill="currentColor" d="m8 22l1-7H4l9-13h2l-1 8h6L10 22z"/>
// </svg>

<?= icon('material-symbols:bolt', ['class' => 'text-2xl', "style" => "color: yellow;"]) ?>
// <svg class="text-2xl" style="color: yellow;" [...]>...</svg>

<?= phpicons('material-symbols:bolt')
        ->attr('class', 'text-2xl')
        ->attr('style', 'color: yellow;') ?>
// <svg class="text-2xl" style="color: yellow;" [...]>...</svg>

For more usage info, see php icons docs.

⚙️ Configuration

Checkout PHPIcons config reference to tweak things as you please.

// new file - app/Config/Iconify.php
<?php

declare(strict_types=1);

namespace Config;

// ...
use CodeIgniterIconify\Config\Iconify as CodeIgniterIconify;

class Iconify extends CodeIgniterIconify
{
    public string $phpIconsConfigPath = ROOTPATH . 'php-icons.php';
}

📜 License

Code released under the MIT License.

Copyright (c) 2024-present, Yassine Doghri (@yassinedoghri).