PHPackages                             guysartorelli/silverstripe-gridfield-preview - 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. [Utility & Helpers](/categories/utility)
4. /
5. guysartorelli/silverstripe-gridfield-preview

ActiveSilverstripe-vendormodule[Utility & Helpers](/categories/utility)

guysartorelli/silverstripe-gridfield-preview
============================================

Standalone silverstripe GridField component for previewing records directly from the GridField

3.0.0(1y ago)6701BSD-3-ClausePHPPHP ^8.1CI passing

Since Sep 5Pushed 9mo ago4 watchersCompare

[ Source](https://github.com/GuySartorelli/silverstripe-gridfield-preview)[ Packagist](https://packagist.org/packages/guysartorelli/silverstripe-gridfield-preview)[ RSS](/packages/guysartorelli-silverstripe-gridfield-preview/feed)WikiDiscussions 3 Synced 1mo ago

READMEChangelog (5)Dependencies (3)Versions (11)Used By (0)

Silverstripe GridField Preview
==============================

[](#silverstripe-gridfield-preview)

A stand-alone `GridField` component that enables previewing records directly from a GridField.

Install
-------

[](#install)

```
composer require guysartorelli/silverstripe-gridfield-preview
```

CMS User Usage
--------------

[](#cms-user-usage)

[![example of usage](docs/en/images/preview-example.png)](docs/en/images/preview-example.png)

Click the preview button in the gridfield. This will automatically open the preview panel (in split mode if your screen is wide enough, or in preview mode otherwise) with the preview set to the record you clicked.

[![preview button](docs/en/images/preview-button.png)](docs/en/images/preview-button.png)

Developer Usage
---------------

[](#developer-usage)

### Directly inn a `ModelAdmin`

[](#directly-inn-a-modeladmin)

The easiest way to use this module is to add `PreviewableModelAdminExtension` as an extension for your `ModelAdmin` subclass. By default this will add a preview button to the gridfield for all tabs that have `CMSPreviewable` models.

```
MyApp\Admin\MyModelAdmin:
  extensions:
    - GuySartorelli\GridFieldPreview\PreviewableModelAdminExtension
```

You can also configure this to only add the component for specific model classes:

```
MyApp\Admin\MyModelAdmin:
  extensions:
    - GuySartorelli\GridFieldPreview\PreviewableModelAdminExtension
  gridfield_previewable_classes:
    - MyApp\Model\MyPreviewableModel
```

### In literally any other `GridField`

[](#in-literally-any-other-gridfield)

You can add the `GridFieldPreviewButton` `GridField` component to literally *any* `GridField`, even one that belongs to a `DataObject` which has its own preview!

```
use GuySartorelli\GridFieldPreview\GridFieldPreviewButton;
use SilverStripe\Forms\GridField\GridField;
use SilverStripe\Forms\GridField\GridFieldConfig_RecordViewer;

//...

    public function getCMSFields()
    {
        $fields = parent::getCMSFields();

        $fields->addFieldToTab('Root.Main', GridField::create(
            'SomethingPreviewable',
            'Something Previewable',
            MyPreviewableDataObject::get(),
            $config = GridFieldConfig_RecordViewer::create()
        ));

        // Here's the important part - add the GridFieldPreviewButton component!
        $config->addComponent(GridFieldPreviewButton::create());

        return $fields;
    }
```

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance53

Moderate activity, may be stable

Popularity15

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 92% 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 ~95 days

Recently: every ~197 days

Total

11

Last Release

397d ago

Major Versions

0.1.2 → 1.0.02022-12-21

1.x-dev → 2.0.02023-02-14

2.x-dev → 3.0.02025-04-10

PHP version history (2 changes)0.1.0PHP ^7.4 || ^8.0

2.0.0PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/b0cba8b534e20e6ab4fff555a97b237a18436ebca1446fc0b29c8a8b504038b9?d=identicon)[GuySartorelli](/maintainers/GuySartorelli)

---

Top Contributors

[![GuySartorelli](https://avatars.githubusercontent.com/u/36352093?v=4)](https://github.com/GuySartorelli "GuySartorelli (23 commits)")[![purplespider](https://avatars.githubusercontent.com/u/329880?v=4)](https://github.com/purplespider "purplespider (2 commits)")

---

Tags

silverstripepreviewgridfield

###  Code Quality

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/guysartorelli-silverstripe-gridfield-preview/health.svg)

```
[![Health](https://phpackages.com/badges/guysartorelli-silverstripe-gridfield-preview/health.svg)](https://phpackages.com/packages/guysartorelli-silverstripe-gridfield-preview)
```

###  Alternatives

[symbiote/silverstripe-gridfieldextensions

A collection of useful grid field components

971.8M235](/packages/symbiote-silverstripe-gridfieldextensions)[undefinedoffset/sortablegridfield

Adds drag and drop functionality to Silverstripe's GridField

941.2M50](/packages/undefinedoffset-sortablegridfield)[unclecheese/betterbuttons

Adds new form actions and buttons to GridField detail form for usability enhancements.

85544.9k19](/packages/unclecheese-betterbuttons)[briceburg/silverstripe-pickerfield

GridField based management of has\_one , has\_many , and many\_many relationship selection

2541.2k1](/packages/briceburg-silverstripe-pickerfield)[webbuilders-group/silverstripe-frontendgridfield

Wraps gridfield adding support for using it on the front-end.

2029.8k1](/packages/webbuilders-group-silverstripe-frontendgridfield)[milkyway-multimedia/ss-gridfield-utils

A collection of GridField components that you can use with any GridField, including Editable Rows and amy more

207.3k2](/packages/milkyway-multimedia-ss-gridfield-utils)

PHPackages © 2026

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