PHPackages                             shel/neos-image-checker - 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. [Image &amp; Media](/categories/media)
4. /
5. shel/neos-image-checker

ActiveNeos-plugin[Image &amp; Media](/categories/media)

shel/neos-image-checker
=======================

Image editor with customisable checks for Neos CMS

1.2.0(1y ago)106.0k↓42.9%1MITTypeScriptCI passing

Since Oct 12Pushed 1y ago1 watchersCompare

[ Source](https://github.com/Sebobo/Shel.Neos.ImageChecker)[ Packagist](https://packagist.org/packages/shel/neos-image-checker)[ GitHub Sponsors](https://github.com/sebobo)[ Patreon](https://www.patreon.com/shelzle)[ RSS](/packages/shel-neos-image-checker/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (5)Dependencies (2)Versions (6)Used By (0)

Image editor plugin with additional checks for Neos CMS
=======================================================

[](#image-editor-plugin-with-additional-checks-for-neos-cms)

[![Tests](https://github.com/Sebobo/Shel.Neos.ColorPicker/actions/workflows/tests.yml/badge.svg)](https://github.com/Sebobo/Shel.Neos.ColorPicker/actions/workflows/tests.yml)

This package provides a Neos CMS plugin which extends the default Neos image editor with additional checks for the selected image. It supports global and individual configurations for each image type.

Installation
------------

[](#installation)

Add the plugin as dependency to your Neos CMS project:

```
composer require shel/neos-image-checker

```

Examples
--------

[](#examples)

### Example with all checks passing

[](#example-with-all-checks-passing)

[![Example with passed checks](Documentation/imagechecker-valid.png)](Documentation/imagechecker-valid.png)

Note: the details are not shown by default and can be toggled by clicking on the "i" button.

### Example with some checks failing

[](#example-with-some-checks-failing)

[![Example with failed checks](Documentation/imagechecker-invalid.png)](Documentation/imagechecker-invalid.png)

Note: the details are shown in this case by default and can be toggled by clicking on the "alert" button.

Configuration
-------------

[](#configuration)

After installation the default image editor in your Neos installation is replaced by the one from this package. The additional functionality only wraps the provided Neos image editor, so it doesn't contain the editors code and in most cases supports updating the Neos UI without needing updates for this plugin.

### Global settings

[](#global-settings)

Global defaults for each image editor

```
Neos:
  Neos:
    Ui:
     frontendConfiguration:
      'Shel.Neos.ImageChecker:ImageChecker':
        enabled: true # allows disabling the checks for all image properties
        defaults:
          fileSize:
            default: 2048
            svg: null
            png: null
            jpg: null
          fileDimensions:
            maxWidth: null
            maxHeight: null
            minWidth: null
            minHeight: null
          fileName:
            allowedPattern: '^[0-9a-zA-Z_\-.]+$'
```

### Individual settigns

[](#individual-settigns)

For each image property of a nodetype you can override single or all of the following settings:

```
My.Vendor:My.NodeType:
  properties:
    image:
      type: 'Neos\Media\Domain\Model\ImageInterface'
      ui:
        label: 'Some image'
        reloadIfChanged: true
        inspector:
          group: image
          editorOptions:
            features:
              imageCheck: # optional overrides
                fileSize: # in kb
                  default: 2048 # optional
                  svg: 100 # optional
                  jpg: 2048 # optional
                  png: 2048 # optional
                fileDimensions: # in px, only affects jpg and pngs
                  maxWidth: 500
                  maxHeight: 300
                fileName: # matches the filename without extension
                  allowedPattern: '^[a-z]+$'
```

License
-------

[](#license)

See [License](LICENSE.txt)

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance46

Moderate activity, may be stable

Popularity30

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 94.1% 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 ~226 days

Total

5

Last Release

411d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/5c9f106db319e8698dcb4aedfe8034f0442d379ebbd78fcd67b884999b2236f1?d=identicon)[Sebobo](/maintainers/Sebobo)

---

Top Contributors

[![Sebobo](https://avatars.githubusercontent.com/u/596967?v=4)](https://github.com/Sebobo "Sebobo (16 commits)")[![jonnitto](https://avatars.githubusercontent.com/u/4510166?v=4)](https://github.com/jonnitto "jonnitto (1 commits)")

---

Tags

hacktoberfestneoscms

### Embed Badge

![Health badge](/badges/shel-neos-image-checker/health.svg)

```
[![Health](https://phpackages.com/badges/shel-neos-image-checker/health.svg)](https://phpackages.com/packages/shel-neos-image-checker)
```

###  Alternatives

[neos/neos-base-distribution

Neos Base Distribution

4464.9k](/packages/neos-neos-base-distribution)[flowpack/media-ui

This module allows managing media assets including pictures, videos, audio and documents.

2184.5k2](/packages/flowpack-media-ui)[shel/neos-colorpicker

A plugin for Neos CMS which provides a colorpicker editor

1494.4k6](/packages/shel-neos-colorpicker)[shel/neos-terminal

Neos CMS Ui terminal for running Eel expressions and other commands

1441.3k](/packages/shel-neos-terminal)[jonnitto/plyr

Plyr.io for Neos.io

1236.2k2](/packages/jonnitto-plyr)[dl/gallery

Neos plugin to easily render image galleries

1416.8k2](/packages/dl-gallery)

PHPackages © 2026

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