markocupic / fontawesome-icon-picker-bundle

7.1.0 2026-10-10 08:33 UTC

Requires

• php: ^8.1
• contao/core-bundle: ^5.3 || ^6.0
• doctrine/dbal: ^3.6 || ^4.0
• symfony/asset: ^6.4 || ^7.0 || ^8.0
• symfony/config: ^6.4 || ^7.0 || ^8.0
• symfony/dependency-injection: ^6.4 || ^7.0 || ^8.0
• symfony/event-dispatcher: ^6.4 || ^7.0 || ^8.0
• symfony/filesystem: ^6.4 || ^7.0 || ^8.0
• symfony/http-kernel: ^6.4 || ^7.0 || ^8.0
• symfony/yaml: ^6.4 || ^7.0 || ^8.0
• twig/twig: ^3.8

Requires (Dev)

• contao/manager-plugin: ^2.12
• contao/test-case: ^5.3 || ^6.0

Conflicts

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

LGPL-3.0+

• Marko Cupic

• backend
• icon
• contao
• picker
• Font Awesome 5

Published on Packagist.org on 2026-10-10 08:34 UTC

README

Font Awesome Icon Picker form widget for Contao CMS

Requirements

• PHP 8.1 or higher (Contao 6 requires a more recent PHP version)
• Contao 5.3 or Contao 6

Contao 4.13 is no longer supported. Please use version 7.0.x of this extension for Contao 4.13.

DCA

Use the fontawesomeIconPicker input type to add the Font Awesome Icon Picker form widget to your tl_content table.

$GLOBALS['TL_DCA']['tl_content']['fields']['serviceLinkFaIcon'] = [
    'exclude'   => true,
    'search'    => true,
    'inputType' => 'fontawesomeIconPicker',
    'eval'      => ['doNotShow' => true],
    'sql'       => 'blob NULL',
];

Configuration

Out of the box, the bundle uses the free version of Font Awesome and does not require any configuration. But you can also use the Pro version by changing the configuration in your config/config.yaml file.

markocupic_fontawesome_icon_picker:
  # Use your custom Font Awesome (Pro) version here:
  fontawesome_source_path: 'files/fontawesome-pro/js/all.min.js' # You can even use the url to your kit 'https://kit.fontawesome.com/12345sdf65.js
  # Set the version of Font Awesome you want to use.
  fontawesome_version: '7.0.1'
  # Set the allowed styles
  fontawesome_allowed_styles:
    - fa-solid
    - fa-regular
    - fa-light
    - fa-brands
    - fa-duotone
    - fa-thin
  # Add the path to your custom fontawesome icons meta file.
  fontawesome_meta_file_path: 'files/fontawesome-pro/metadata/icons.yml'

Frontend usage

This extension will not add Font Awesome to your frontend. You have to add it yourself in your layout.