unclecheese/silverstripe-image-optionset

Provides a list of selectable items that use images as the primary label instead of text.

Image OptionsetField

Provides a list of selectable items that use images as the primary label instead of text., _(*1)

Screenshot

, _(*2)

Installation

composer require unclecheese/silverstripe-image-optionset, _(*3)

Configuration

You can configure the default width and height of the images., _(*4)

UncleCheese\Forms\ImageOptionsetField:
  default_image_width: 300
  default_image_height: 300

Usage

Simple example:, _(*5)

$field = ImageOptionsetField::create('Template', 'Select a template')
                ->setSource([
                    'sidebar' => [
                        'title' => 'Sidebar page',
                        'image' => '/path/to/sidebar.png'
                    ],
                    'block' => [
                        'title' => 'Block page',
                        'image' => '/path/to/block.png'
                    ]
                ]);

// Use a custom image width and height
$field->setImageWidth(100);
$field->setImageHeight(100);

If you're not using titles, you can use image paths as the values rather than nested arrays., _(*6)

$field = ImageOptionsetField::create('Template', 'Select a template')
                ->setSource([
                    'sidebar' => '/path/to/sidebar.png'
                    'block' => '/path/to/block.png'
                ]);

Tests

tests/ImageOptionsetFieldTest, _(*7)

Troubleshooting

Ring Uncle Cheese., _(*8)