lukasbableck / contao-svg-icon-picker-bundle

This bundle adds a svg icon picker widget to Contao.

Maintainers

Details

github.com/lukasbableck/contao-svg-icon-picker-bundle

Fund package maintenance!
lukasbableck

Type:contao-bundle

pkg:composer/lukasbableck/contao-svg-icon-picker-bundle

1.0.3 2025-10-12 13:24 UTC

Requires

php: ^8.1
contao/core-bundle: ^5.3
enshrined/svg-sanitize: ^0.22
symfony/asset: ^6.4 || ^7.0
symfony/dependency-injection: ^6.4 || ^7.0
symfony/http-kernel: ^6.4 || ^7.0
twig/cache-extra: ^3.10
twig/twig: ^3.10

Requires (Dev)

Suggests

None

Provides

None

Conflicts

contao/manager-plugin: <2.0 || >=3.0

Replaces

None

LGPL-3.0-or-later 9bf7f6c8f7b418f3d89aa395876755c31a60e7e0

Lukas Bableck <lukas.woop@bableck.dev>

svg FontAwesome icon picker

dev-main
1.0.3
1.0.2
1.0.1
1.0.0

This package is auto-updated.

Last update: 2025-10-12 13:25:01 UTC

README

This bundle adds a svg icon picker widget to Contao.

Configuration

Create a field in your DCA/RSCE/...

'icon' => [
	'inputType' => 'svgIconPicker',
	'eval' => [
		'sourceDirectory' => 'files/icons',
		'metadataDirectory' => 'files/icons/metadata',
		'tl_class' => 'clr'
	],
	'sql' => 'blob NULL',
],

Put your SVG icons in the specified sourceDirectory.
Icon metadata like search terms and labels can be provided via an icons.json, which has to be placed in the metadataDirectory. Providing metadata is completely optional.
Currently only an icons.json file in the scheme of the FontAwesome icons.json is supported.
Glyphs are not supported yet.

Usage

This extension provides a Twig function to render the SVG icon in your templates.

{{ svg_icon(icon) }}