iliain/silverstripe-visualfields

Provides a number of CMS fields that display images

2.1.0 2025-05-09 05:22 UTC

Requires

• php: ^7 || ^8
• silverstripe/framework: ^4 || ^5

BSD-3-Clause

• cms
• modular
• silverstripe
• fields

README

Provides similar functionality to heyday/silverstripe-colorpalette, but uses images rather than colours.

Installation (with composer)

composer require iliain/silverstripe-visualfields

Usage

$fields->addFieldToTab('Root.Main', $typeField = VisualOptionField::create('IconType', 'Type', [
    'icon-1' => $iconFolderPath . '/icon-1.png',
    'icon-2' => $iconFolderPath . '/icon-2.png',
    'icon-3' => $iconFolderPath . '/icon-3.png',
    'icon-4' => $iconFolderPath . '/icon-4.png',
]));

Customising

You can customise the size and background colour of the images with the following options:

$typeField
    ->optionWidth('125px')
    ->optionHeight('125px')
    ->backgroundColour('#efe6da') // Only visible if the image has transparency
    ->imageSize('cover');