README

EN | RU

Versions

Installation

Install composer package

composer require jerabix/moonshine-iconify

Publish icon.blade.php file from package:

php artisan vendor:publish --tag="moonshine-iconify-blade"

This command put file icon.blade.php in resources/views/vendor/moonshine/components folder.

(Optional) You can also publish config file from package:

php artisan vendor:publish --tag="moonshine-iconify-config"

Usage

When you use ICONIFY_COMPONENT_MODE - you not need additional actions.

When you use DOWNLOAD_USAGE_ICONS_MODE - you need run command:

php artisan moonshine-iconify:icons:download

for download all usage icons in project.

Use moonshine default Icon component as before. Package work as fallback if icon is not found in moonshine - use iconify library.

Iconify icons can be found here.

Working mode

Package has 2 working mode:

ICONIFY_COMPONENT_MODE iconify doc

Used iconify component. Load icons from iconify API on demand, and cache to user localstorage, need load iconify JS script (package add it automatically).

DOWNLOAD_USAGE_ICONS_MODE

Use package command for download used iconify icons to project. Need re-run command for each new iconify icon in project.

Config

Detector N has error: X

When you has error: Detector {DetectorClass} has error: {Error}. Details in log file

Create issue here. And provide info from log file.

Icon not download with command

When you has own class with using icon, you need to create detector for class. Check IconComponentDetector class.

When class provide from Moonshine - you can create issue here.

TODO

• [Local icons mode] Detect WithIcon trait on classes
• [Local icons mode] Detect Url class
• [Local icons mode] Add Icon class detector
• [Local icons mode] Detect Icon attribute usage
• [Local icons mode] Remove not used icons
• [Local icons mode] Not download all icons every run command, only new
• [Local icons mode] Add mode to config to change dynamic/static icons mode
• Add button to ignition error page
• Refactor detect logic
• Update README file for new working mode
• Add tests for detect logic