README

Пакет jevo/evo-gms-o додає Google Material Symbols у Blade-шаблони Evolution CMS.

Іконки використовуються через Blade Icons і викликаються за єдиним форматом:

{!! svg('GMS_o-settings')->toHtml() !!}

Повний каталог іконок доступний на сайті Google Material Symbols.

Можливості

Google Material Symbols у стилі Outlined;
великий набір готових SVG-іконок;
виклик через svg() у Blade-шаблонах;
підтримка CSS-класів, стилів та HTML-атрибутів;
автоматична реєстрація пакета через package:discover Evolution CMS;
сумісність із адаптером Blade Icons Evolution CMS;
стабільний виклик іконок через helper svg().

Вимоги

PHP 8.3 або новіший;
Evolution CMS 3.5.x;
встановлений Blade Icons у складі Evolution CMS.

Пакет не додає власну копію blade-ui-kit/blade-icons, оскільки базовий Blade Icons уже надається Evolution CMS.

Встановлення

Встановлення через Artisan Evolution CMS

Це рекомендований спосіб встановлення пакета з Packagist.

Перейдіть до каталогу core:

cd core

Встановіть пакет через стандартний інсталятор Evolution CMS:

php artisan package:installrequire jevo/evo-gms-o "^1.0"

Після встановлення пакет буде доданий до core/custom/composer.json, а Evolution CMS автоматично зареєструє його Service Provider.

Для публікації конфігурації виконайте:

php artisan vendor:publish --provider="JEvoGMS\\GmsServiceProvider"

Публікація конфігурації не є обов'язковою для використання іконок. SVG-файли використовуються безпосередньо з пакета.

Після встановлення перевірте роботу іконки у Blade-шаблоні:

{!! svg('GMS_o-settings')->toHtml() !!}

Використання

{!! svg('GMS_o-settings')->toHtml() !!}
{!! svg('GMS_o-home')->toHtml() !!}
{!! svg('GMS_o-search')->toHtml() !!}
{!! svg('GMS_o-star')->toHtml() !!}

Назва іконки складається з префікса GMS_o та назви іконки:

GMS_o-ім'я_іконки

Наприклад:

{!! svg('GMS_o-medical_services')->toHtml() !!}
{!! svg('GMS_o-shopping_cart')->toHtml() !!}
{!! svg('GMS_o-calendar_today')->toHtml() !!}

Назви іконок можна переглянути на сторінці Google Material Symbols. Пробіли в назві потрібно замінити на символ _.

Розмір іконки

Рекомендовано використовувати CSS-клас:

{!! svg('GMS_o-star', [
    'class' => 'material-icon',
    'aria-hidden' => 'true',
])->toHtml() !!}

.material-icon {
    width: 32px;
    height: 32px;
}

Або можна передати inline-стиль:

{!! svg('GMS_o-star', [
    'style' => 'width: 48px; height: 48px;',
])->toHtml() !!}

Колір

SVG-іконки використовують currentColor, тому колір можна задати через CSS:

{!! svg('GMS_o-star', [
    'class' => 'material-icon material-icon--warning',
])->toHtml() !!}

.material-icon--warning {
    color: #f5b301;
}

Виклик у Evolution CMS

Для шаблонів Evolution CMS використовуйте helper svg():

{!! svg('GMS_o-settings')->toHtml() !!}

Виклик у форматі <x-GMS_o-settings /> належить до стандартного Laravel Blade Icons. У Evolution CMS він може бути недоступним без попередньо створеного manifest-кешу іконок, тому для цього пакета рекомендовано використовувати саме svg().

Доступність

Для декоративних іконок використовуйте aria-hidden:

{!! svg('GMS_o-star', [
    'aria-hidden' => 'true',
])->toHtml() !!}

Якщо іконка має змістове значення, додайте заголовок:

{!! svg('GMS_o-warning', [
    'title' => 'Попередження',
])->toHtml() !!}

Оновлення

Для оновлення пакета:

cd core
composer update jevo/evo-gms-o

Для встановлення версій, зафіксованих у composer.lock, використовуйте:

composer install

Не редагуйте файли в core/vendor. Налаштування та залежності проєкту зберігайте через core/custom/composer.json.

Ліцензія

Пакет поширюється за ліцензією MIT.

Google Material Symbols належать Google і використовуються відповідно до умов їхньої ліцензії.

jevo / evo-gms-o

Package info

Security

Statistics