PHPackages                             iliain/silverstripe-visualfields - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Templating & Views](/categories/templating)
4. /
5. iliain/silverstripe-visualfields

ActiveSilverstripe-vendormodule[Templating & Views](/categories/templating)

iliain/silverstripe-visualfields
================================

Provides a number of CMS fields that display images

3.0.0(1w ago)1815↓81%1BSD-3-ClausePHPPHP ^7 || ^8

Since Jul 21Pushed 1w ago1 watchersCompare

[ Source](https://github.com/Iliain/silverstripe-visualfields)[ Packagist](https://packagist.org/packages/iliain/silverstripe-visualfields)[ Docs](http://github.com/Iliain/silverstripe-visualfields)[ RSS](/packages/iliain-silverstripe-visualfields/feed)WikiDiscussions main Synced today

READMEChangelog (7)Dependencies (2)Versions (8)Used By (0)

Silverstripe Visual Fields
==========================

[](#silverstripe-visual-fields)

[![Latest Stable Version](https://camo.githubusercontent.com/acdc073b87720e2f7a277aad8ea76460385740ffb0beef72287d5c23e297282d/68747470733a2f2f706f7365722e707567782e6f72672f696c6961696e2f73696c7665727374726970652d76697375616c6669656c64732f76)](https://packagist.org/packages/iliain/silverstripe-visualfields)[![Total Downloads](https://camo.githubusercontent.com/01e11a4a87adc70dc63288e56626f770f4976f52e32e28793098f639ed49c6e0/68747470733a2f2f706f7365722e707567782e6f72672f696c6961696e2f73696c7665727374726970652d76697375616c6669656c64732f646f776e6c6f616473)](https://packagist.org/packages/iliain/silverstripe-visualfields)[![Latest Unstable Version](https://camo.githubusercontent.com/254e70b867d09c73cb8ca8449242ec2328f20541872f0af28fc83c140c567774/68747470733a2f2f706f7365722e707567782e6f72672f696c6961696e2f73696c7665727374726970652d76697375616c6669656c64732f762f756e737461626c65)](https://packagist.org/packages/iliain/silverstripe-visualfields)[![License](https://camo.githubusercontent.com/372245f90cba4717656d9de5fef0126b45f05d83b8c5754d6f24bce7c427984e/68747470733a2f2f706f7365722e707567782e6f72672f696c6961696e2f73696c7665727374726970652d76697375616c6669656c64732f6c6963656e7365)](https://packagist.org/packages/iliain/silverstripe-visualfields)[![PHP Version Require](https://camo.githubusercontent.com/6ce3c9272685ebff986d7a971237b8f22874bd6f8c24a93bfffd44cdae9ed81d/68747470733a2f2f706f7365722e707567782e6f72672f696c6961696e2f73696c7665727374726970652d76697375616c6669656c64732f726571756972652f706870)](https://packagist.org/packages/iliain/silverstripe-visualfields)

Provides similar functionality to [heyday/silverstripe-colorpalette](https://github.com/WPP-Public/silverstripe-colorpalette), but uses images rather than colours.

Installation (with composer)
----------------------------

[](#installation-with-composer)

```
composer require iliain/silverstripe-visualfields

```

Usage
-----

[](#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',
]));
```

[![](docs/images/example-1.png)](docs/images/example-1.png)

Customising
-----------

[](#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');
```

[![](docs/images/example-2.png)](docs/images/example-2.png)

###  Health Score

47

↑

FairBetter than 93% of packages

Maintenance98

Actively maintained with recent releases

Popularity19

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~239 days

Recently: every ~323 days

Total

7

Last Release

11d ago

Major Versions

1.0.2 → 2.0.02024-10-16

2.1.0 → 3.0.02026-06-22

PHP version history (2 changes)1.0.0PHP ^7

1.0.2PHP ^7 || ^8

### Community

Maintainers

![](https://www.gravatar.com/avatar/95555999d61957aa18a23d42afe8bcf7aad3a5e6d9dcc8c7e41ba183f405e49e?d=identicon)[iliain](/maintainers/iliain)

---

Top Contributors

[![Iliain](https://avatars.githubusercontent.com/u/2579262?v=4)](https://github.com/Iliain "Iliain (14 commits)")

---

Tags

colorpalettefieldformfieldsimagesradioradio-buttonssilverstripevisualsilverstripecmsfieldsmodular

### Embed Badge

![Health badge](/badges/iliain-silverstripe-visualfields/health.svg)

```
[![Health](https://phpackages.com/badges/iliain-silverstripe-visualfields/health.svg)](https://phpackages.com/packages/iliain-silverstripe-visualfields)
```

###  Alternatives

[silverstripe/cms

The SilverStripe Content Management System

5253.6M1.4k](/packages/silverstripe-cms)[axllent/silverstripe-tiled-gridfield

Inline/tiled images in a Silverstripe GridField table

163.3k](/packages/axllent-silverstripe-tiled-gridfield)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)