Download the PHP package blueways/bw-icons without Composer
On this page you can find all versions of the php package blueways/bw-icons. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package bw-icons
Icon picker for TCA and RTE. Generates a browsable gallery of your icon fonts and SVGs - just link your stylesheet or image directory. Works with FontAwesome, Bootstrap, Icomoon.. Optionally adds icon field to pages, tt_content or sys_category.
Demo
Features
- icon picker form element
- icon field for tt_content, pages and sys_category
- RTE plugin
- icon gallery with filter function
- displays icons from image files or font (css)
- extracts and caches font styles (css)
- works with remote css files
- can include generated stylesheet in the frontend
Pro tip: Use your Icomoon development file. Your Icon Picker is always up to date, and you can serve the font files from your own remote without manually downloading and adjusting paths!
Installation
-
Install via composer
-
Update database schema
-
Include PageTS
Enable the extension in the Extension Manager and include the static PageTS for TYPO3 core icons or set up your own icons. See Configuration section.
-
Enable icons for tt_content, pages and/or sys_category
In the extension settings (
Admin Tools → Extension Configuration → bw_icons
), you can enable the icon fields. If you want to use it for other tables, see For developers section. - Include RTE configuration (optional)
Configuration
The displayed icons are set up via PageTS. Choose a unique identifier and
select FileIconProvider
if you want to add
image files from a directory or CssIconProvider
if you want to display font
icons from a stylesheet.
After changing the settings, make sure to clear the cache.
RTE Configuration
After importing the yaml configuration, you can add the new button anywhere you want to your RTE present. Read more about RTE configuration.
Usage
The icons are saved as filename (
e.g. EXT:myext/Resources/Public/Images/icon.svg
or fileadmin/icons/foo.png
)
if you use the FileIconProvider
or as css class names (
e.g. fas fa-arrow-right
) by using CssIconProvider
.
If you have configured only the selection of SVGs, you can safely use
the <f:image src="{data.tx_bwicons_icon}" />
viewHelper in your fluid
template.
By only using font icons, you can output
like <i class="{data.tx_bwicons_icon}"></i>
.
If you have a mixture, you can use my ViewHelper that determines the type by checking for a dot in the icon name:
Output:
or
CSS Frontend Include
If you want to include the extracted styles in the frontend, you can use
the CssUtility
to generate the style-tags in the head of your page. Include
this in your TypoScript setup:
For developers
Usage in other tables
-
Create database field for the icon:
-
Edit TCA: Add the renderType
iconSelection
in the config array:Optional: you may restrict which icon providers are available:
New icon sources
If you want to add other icon sources (e.g. from API), you can create your own
IconProvider. Just make sure to extend
from Blueways\BwIcons\Provider\AbstractIconProvider
.
Contribute
This extension was made by Maik Schneider: Feel free to contribute!
All versions of bw-icons with dependencies
ext-dom Version *
ext-json Version *
ext-libxml Version *
ext-simplexml Version *
phenx/php-font-lib Version 0.5.4 || 0.5.6
sabberworm/php-css-parser Version 8.4.0
typo3/cms-core Version ^12.4