Download the PHP package tobimori/kirby-icon-field without Composer
On this page you can find all versions of the php package tobimori/kirby-icon-field. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download tobimori/kirby-icon-field
More information about tobimori/kirby-icon-field
Files in tobimori/kirby-icon-field
Package kirby-icon-field
Short Description A simple Icon field plugin for Kirby CMS
License MIT
Informations about the package kirby-icon-field
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
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:
[!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
Options
Option | Default | Description |
---|---|---|
cache |
true |
Enable cache for reading from icons directory |
folder |
assets/icons |
Default folder for icon field, can also be a function |
sprite |
null |
Default file for SVG sprite file, can also be a function |
Options allow you to fine tune the behaviour of the plugin. You can set them in your config.php
file:
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