tobimori / kirby-icon-field
A simple Icon field plugin for Kirby CMS
Fund package maintenance!
tobimori
Installs: 4 087
Dependents: 1
Suggesters: 0
Security: 0
Stars: 38
Watchers: 3
Forks: 4
Open Issues: 3
Language:Vue
Type:kirby-plugin
Requires
- php: >=8.2.0
- getkirby/composer-installer: ^1.2
Requires (Dev)
- getkirby/cms: ^4.0.1
This package is auto-updated.
Last update: 2024-10-30 19:38:29 UTC
README
Kirby Icon Field
A simple Icon field for Kirby 4+ - throw your Icon pack in a folder, add the field to your blueprints and you're good to go.
If you're using Kirby 3.9+, please try using v1.0.3.
Installation
Recommended: Composer
composer require tobimori/kirby-icon-field
Manual installation
Download and copy this repository to /site/plugins/kirby-icon-field
, or apply this repository as Git submodule.
Usage
This plugin relies on having your SVG icons as separate files in a folder for display in the panel - of course you're free to do whatever you want with the field's value in your templates.
Icons will always be displayed in single-color white or black.
Add the field to your blueprint:
fields: icon: label: Icon type: icon folder: assets/icons # path to your icon folder, relative to the `index` kirby root (you can use the Kirby query language) max: 1 # max number of icons to select - 1 will look like a 'select field', none or more like a 'multiselect' field sprite: svg-sprite.svg # optional, path to your svg sprite relative to folder option, if you want to use a sprite instead of individual files (you can use the Kirby query language) # [more settings...] - same as multi-select field, e.g. disabling search, limiting icons, etc.
Note
If you're using a sprite, make sure the file is available for the user to access at the set path. The plugin does not copy or move the file, it only references it. The #id
reference will be stored without a .svg
extension unlike the individual files mode.
Use the field value in your template
<?= svg('/assets/icons/' . $page->icon()) ?>
Options
Options allow you to fine tune the behaviour of the plugin. You can set them in your config.php
file:
return [ 'tobimori.icon-field' => [ 'cache' => true, 'folder' => 'assets/icons' ], ];
Support
Note
This plugin is provided free of charge & published under the permissive MIT License. If you use it in a commercial project, please consider to sponsor me on GitHub to support further development and continued maintenance of Kirby Icon Field.
License
MIT License Copyright © 2023-2024 Tobias Möritz
The icons in the preview image are part of Chunk Icons by Noah Jacobus. <3