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)6711BSD-3-ClausePHPPHP ^8.1CI passing

Since Sep 5Pushed 11mo 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 today

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

37

—

LowBetter than 81% of packages

Maintenance49

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

448d 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

[silverstripe/cms

The SilverStripe Content Management System

5253.6M1.4k](/packages/silverstripe-cms)[symbiote/silverstripe-advancedworkflow

Adds configurable workflow support to the CMS, with a GUI for creating custom workflow definitions.

46302.4k9](/packages/symbiote-silverstripe-advancedworkflow)[symbiote/silverstripe-gridfieldextensions

A collection of useful grid field components

951.9M271](/packages/symbiote-silverstripe-gridfieldextensions)[silverstripe/userforms

UserForms enables CMS users to create dynamic forms via a drag and drop interface and without getting involved in any PHP code

1371.1M85](/packages/silverstripe-userforms)[undefinedoffset/sortablegridfield

Adds drag and drop functionality to Silverstripe's GridField

911.3M52](/packages/undefinedoffset-sortablegridfield)[unclecheese/betterbuttons

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

79554.0k19](/packages/unclecheese-betterbuttons)

PHPackages © 2026

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