Download the PHP package silverware/font-icons without Composer
On this page you can find all versions of the php package silverware/font-icons. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download silverware/font-icons
More information about silverware/font-icons
Files in silverware/font-icons
Package font-icons
Short Description SilverWare Font Icons Module.
License BSD-3-Clause
Homepage https://github.com/praxisnetau/silverware-font-icons
Informations about the package font-icons
SilverWare Font Icons Module
Provides a new form field and database field type for referencing a font icon. Intended to be used with SilverWare, however this module can also be installed into a regular SilverStripe v4 project. A backend for Font Awesome is provided with the module.
Contents
- Background
- Requirements
- Installation
- Configuration
- Usage
- Issues
- To-Do
- Contribution
- Attribution
- Maintainers
- License
Background
Font icons are neat. They look great on all devices, and are really easy to reference via HTML and CSS. However, font icon libraries such as Font Awesome provide a staggering amount of icons, and we can't really expect users to remember the icon names, codes, or have to refer to a cheatsheet.
We could just provide a standard select field listing all of the icons on offer, but users need to know
what the icons look like. Enter FontIconField
provided by this module. An extension of the SilverWare
Select2AjaxField
class, it provides an Ajax-powered searchable list of icons provided by the configured
backend, along with a preview of each icon.
Requirements
Installation
Installation is via Composer:
Configuration
As with all SilverStripe modules, configuration is via YAML. The SilverStripe dependency injector is used to configure the font icon backend. Font Awesome is configured by default:
You can specify the version of Font Awesome in use by changing the version
property. Upon flush, the
backend will download a full list of icons from GitHub and cache the results until the next flush.
Usage
Field Type
To make use of font icons in your code, you can reference the field type in your $db
array:
You can also use
the field type within your class file, and reference the field type directly:
Form Field
Within your getCMSFields
method, create a FontIconField
to allow the user to select an icon:
Don't forget to first use
the field in the header of your class file:
Data Extension
The module also comes with a data extension class to easily add font icons to data objects within
SilverStripe. The extension adds a FontIcon
database field, and a new Icon tab within the CMS
containing a FontIconField
.
To apply the extension to your class, use YAML configuration:
Issues
Please use the GitHub issue tracker for bug reports and feature requests.
To-Do
- Tests
Contribution
Your contributions are gladly welcomed to help make this project better. Please see contributing for more information.
Attribution
- Makes use of Font Awesome by Dave Gandy.
- Special thanks to @hailwood for providing a sane example of how to parse the source icons from Font Awesome with his SilverStripe v3 module.
Maintainers
Colin Tucker | Praxis Interactive |
License
BSD-3-Clause © Praxis Interactive
All versions of font-icons with dependencies
silverstripe/framework Version ^4.0
silverware/colorpicker Version ^1.0
silverware/select2 Version ^1.0
symfony/yaml Version ~3.2