Site Settings 

Icons are defined on a per-page basis and are specified in the site settings.

Configuration of icon sets 

A single icon set uses a provider (e.g. Icomoon) to make multiple icons available. These icons can then be used in both the backend and frontend.

Multiple icon sets from different providers can be used per site.

config/sites/<my_site>/settings.yaml|typo3conf/sites/<my_site>/settings.yaml 
icons:
  sets:
    -
      provider: icomoon
      group: icomoon
      options:
        json: 'EXT:my_ext/Resources/Private/Fonts/Icomoon/selection.json'
        fonts: 'EXT:my_ext/Resources/Public/Fonts/Icomoon/'
Copied!

The following settings are available for a single icon set.

provider

provider
Type
string
Path
icons.sets.<index>.provider

The name of the provider to be used.

Either a predefined abbreviation (e.g. “icomoon”) or the full class name.

config/sites/<my_site>/settings.yaml|typo3conf/sites/<my_site>/settings.yaml 
icons:
  sets:
    -
      provider: Vendor\MyExt\Imaging\IconSet\CustomIconSetProvider
Copied!

group

group
Type
string
Path
icons.sets.<index>.group

Assigns the icon set to a group in the backend select fields.

config/sites/<my_site>/settings.yaml|typo3conf/sites/<my_site>/settings.yaml 
icons:
  sets:
    -
      provider: Vendor\MyExt\Imaging\IconSet\CustomIconSetProvider
      group: web_icons
Copied!

options

options
Type
array
Path
icons.sets.<index>.options

Configures the respective icon set provider. (See Icon provider options)

Icon provider options 

Each icon set provider uses different options to make icons available.

The extension comes with a provider for integrating Icomoon icons, but can be expanded to include additional providers.

Icomoon 

json

json
Type
string
Path
icons.sets.<index>.options.json

The path to the selection.json file from Icomoon.

Can be specified as either a storage path (1:/fonts/icomoon/selection.json), an extension path (EXT:my_ext/Resources/Private/Fonts/Icomoon/selection.json), or an absolute path (/fonts/icomoon/selection.json).

config/sites/<my_site>/settings.yaml|typo3conf/sites/<my_site>/settings.yaml 
icons:
  sets:
    -
      provider: icomoon
      options:
        json: 'EXT:my_ext/Resources/Private/Fonts/Icomoon/selection.json'
Copied!

fonts

fonts
Type
string
Path
icons.sets.<index>.options.fonts

The path to the font files.

Can be specified as either a storage path (1:/fonts/icomoon/), an extension path (EXT:my_ext/Resources/Public/Fonts/Icomoon/), or an absolute path (/fonts/icomoon/).

config/sites/<my_site>/settings.yaml|typo3conf/sites/<my_site>/settings.yaml 
icons:
  sets:
    -
      provider: icomoon
      options:
        fonts: '/fonts/icomoon/'
Copied!