PHPackages                             ctessier/nova-advanced-image-field - 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 & Media](/categories/media)
4. /
5. ctessier/nova-advanced-image-field

ActiveLibrary[Image & Media](/categories/media)

ctessier/nova-advanced-image-field
==================================

An advanced image field for Nova with cropping and resizing.

v2.1.0(2y ago)103548.4k↑76.4%30[6 issues](https://github.com/ctessier/nova-advanced-image-field/issues)[1 PRs](https://github.com/ctessier/nova-advanced-image-field/pulls)1MITVuePHP ^7.3|^8.0

Since Nov 26Pushed 1y ago4 watchersCompare

[ Source](https://github.com/ctessier/nova-advanced-image-field)[ Packagist](https://packagist.org/packages/ctessier/nova-advanced-image-field)[ GitHub Sponsors](https://github.com/sponsors/ctessier)[ RSS](/packages/ctessier-nova-advanced-image-field/feed)WikiDiscussions 2.x Synced 1mo ago

READMEChangelog (10)Dependencies (2)Versions (23)Used By (1)

Nova Advanced Image Field
=========================

[](#nova-advanced-image-field)

 [![StyleCI](https://camo.githubusercontent.com/2c9eeeb84b0b2e93093739b0edfb4fe9046f350410db249d79ed93d5b1e9771c/68747470733a2f2f6769746875622e7374796c6563692e696f2f7265706f732f3135363039313137352f736869656c643f6272616e63683d322e78)](https://github.styleci.io/repos/156091175?branch=2.x) [![Latest Version on Packagist](https://camo.githubusercontent.com/fc854f776e1360df301a3ac02658cbcd3f319acd17bb25d7b3a50e416a1d5105/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f63746573736965722f6e6f76612d616476616e6365642d696d6167652d6669656c642e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ctessier/nova-advanced-image-field) [![Total Downloads](https://camo.githubusercontent.com/9f91129313d676f84eea05da296ffbbd77f64d109e872159179f99259f16ba57/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f63746573736965722f6e6f76612d616476616e6365642d696d6167652d6669656c642e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ctessier/nova-advanced-image-field) [![License](https://camo.githubusercontent.com/09855724cf1d5a04473a7a51498f616aa3efc6f82273a702edc3e7c1f5fbbfc3/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f63746573736965722f6e6f76612d616476616e6365642d696d6167652d6669656c643f636f6c6f723d253233423238373842267374796c653d666c61742d737175617265)](https://packagist.org/packages/ctessier/nova-advanced-image-field)

*An advanced image field for Nova allowing you to upload, crop and resize images*

This package is built on top of the native Nova image field. It uses [Advanced Cropper](https://advanced-cropper.github.io/vue-advanced-cropper/) to show a cropper on the frontend, and [Intervention Image](http://image.intervention.io) to process the image on the backend.

[![screenshot of the advanced image field](screenshot.png)](screenshot.png)

Requirements
------------

[](#requirements)

   Version PHP Nova GD (default) Imagick     1.x >=7.1 2 or 3 >=2.0 >=6.5.7   2.x >=7.3 4 See [Intervention requirements](https://image.intervention.io/v2/introduction/installation) for more details.

Getting started
---------------

[](#getting-started)

Install the package into a Laravel application with Nova using Composer:

```
composer require ctessier/nova-advanced-image-field
```

If you want to use Imagick as the default image processing library, follow the [Intervention documentation for Laravel](https://image.intervention.io/v2/introduction/installation#laravel). This will provide you with a new configuration file where you can specify the driver you want.

Code examples
-------------

[](#code-examples)

`AdvancedImage` extends from `Image` so you can use any methods that `Image` implements. See the documentation [here](https://nova.laravel.com/docs/3.0/resources/file-fields.html).

```
// Show a cropbox with a fixed ratio
AdvancedImage::make('Photo')->croppable(16/9),

// Resize the image to a max width
AdvancedImage::make('Photo')->resize(1920),

// Override the image processing driver for this field only
AdvancedImage::make('Photo')->driver('imagick'),
```

To display the image as a rounded avatar, use the `AdvancedAvatar` class or the `rounded` method:

```
AdvancedAvatar::make('Avatar')->croppable(),
AdvancedImage::make('Avatar')->croppable()->rounded(),
```

API
---

[](#api)

### `driver(string $driver)`

[](#driverstring-driver)

Override the default driver to be used by Intervention for the image manipulation.

```
AdvancedImage::make('Photo')->driver('imagick'),
```

### `croppable([float $ratio])`

[](#croppablefloat-ratio)

Specify if the underlying image should be croppable.

If a numeric value is given as a first parameter, it will be used to define a fixed aspect ratio for the crop box.

```
AdvancedImage::make('Photo')->croppable(),
AdvancedImage::make('Photo')->croppable(16/9),
```

### `resize(int $width = null[, int $height = null])`

[](#resizeint-width--null-int-height--null)

Specify the size (width and height) the image should be resized to.

```
AdvancedImage::make('Photo')->resize(1920),
AdvancedImage::make('Photo')->resize(600, 400),
AdvancedImage::make('Photo')->resize(null, 300),
```

*Note: this method uses [Intervention Image `resize()`](https://image.intervention.io/v2/api/resize) with the upsize and aspect ratio constraints.*

### `autoOrientate()`

[](#autoorientate)

Specify if the underlying image should be orientated. It will rotate the image to the orientation specified in Exif data, if any.

This can be mandatory in some cases for the cropper to work properly.

```
AdvancedImage::make('Photo')->autoOrientate(),
```

*Note: PHP must be compiled in with `--enable-exif` to use this method. Windows users must also have the mbstring extension enabled. See [the Intervention Image documentation](https://image.intervention.io/v2/api/orientate) for more details.*

### `quality(int $quality)`

[](#qualityint-quality)

Specify the resulting quality of the transformed image.

This only applies to JPG format as PNG compression is lossless. The value must range from 0 (poor quality, small file) to 100 (best quality, big file).

```
AdvancedImage::make('Photo')->resize(600, 400)->quality(95),
```

*Note: the quality will be passed to the [Intervention Image `save()`](https://image.intervention.io/v2/api/save) method.*

### `convert(string $format)`

[](#convertstring-format)

Specify the desired output format.

```
AdvancedImage::make('Photo')->convert('webp'),
```

*Note: See [Intervention Image `encode()`](https://image.intervention.io/v2/api/encode) for more details, including the list of allowed formats.*

###  Health Score

49

—

FairBetter than 95% of packages

Maintenance29

Infrequent updates — may be unmaintained

Popularity53

Moderate usage in the ecosystem

Community25

Small or concentrated contributor base

Maturity75

Established project with proven stability

 Bus Factor1

Top contributor holds 79.4% 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 ~98 days

Recently: every ~107 days

Total

21

Last Release

759d ago

Major Versions

v0.2.0 → v1.0.02019-02-15

v1.3.3 → v2.0.02022-12-12

2.x-dev → 3.x-dev2024-04-19

PHP version history (2 changes)v0.1.0PHP >=7.1.0

v2.0.0PHP ^7.3|^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/2bab6804907f1159829dfdee9dab8c14a31c4d0b1463932a635ad5a959af10be?d=identicon)[ctessier](/maintainers/ctessier)

---

Top Contributors

[![ctessier](https://avatars.githubusercontent.com/u/4518186?v=4)](https://github.com/ctessier "ctessier (127 commits)")[![Ruitjes](https://avatars.githubusercontent.com/u/26769441?v=4)](https://github.com/Ruitjes "Ruitjes (16 commits)")[![mathd](https://avatars.githubusercontent.com/u/860894?v=4)](https://github.com/mathd "mathd (3 commits)")[![Woeler](https://avatars.githubusercontent.com/u/18422096?v=4)](https://github.com/Woeler "Woeler (3 commits)")[![Grafikart](https://avatars.githubusercontent.com/u/395137?v=4)](https://github.com/Grafikart "Grafikart (3 commits)")[![mziraki](https://avatars.githubusercontent.com/u/6510195?v=4)](https://github.com/mziraki "mziraki (2 commits)")[![nilsvannoort](https://avatars.githubusercontent.com/u/106384897?v=4)](https://github.com/nilsvannoort "nilsvannoort (2 commits)")[![puzzledmonkey](https://avatars.githubusercontent.com/u/3913622?v=4)](https://github.com/puzzledmonkey "puzzledmonkey (2 commits)")[![Jaspur](https://avatars.githubusercontent.com/u/4254854?v=4)](https://github.com/Jaspur "Jaspur (1 commits)")[![james-staffs](https://avatars.githubusercontent.com/u/65457974?v=4)](https://github.com/james-staffs "james-staffs (1 commits)")

---

Tags

advancedcropfieldimageinterventionlaravelnovaresizelaravelimageresizeadvancedimage resizecropnovaimage-cropadvanced imageadvanced image field

### Embed Badge

![Health badge](/badges/ctessier-nova-advanced-image-field/health.svg)

```
[![Health](https://phpackages.com/badges/ctessier-nova-advanced-image-field/health.svg)](https://phpackages.com/packages/ctessier-nova-advanced-image-field)
```

###  Alternatives

[ayvazyan10/nova-imagic

Imagic is a Laravel Nova field package that allows for image manipulation capabilities, such as cropping, resizing, quality adjustment, and WebP conversion. It utilizes the powerful Intervention Image class for image manipulation.

144.3k1](/packages/ayvazyan10-nova-imagic)[intervention/image-laravel

Laravel Integration of Intervention Image

1536.5M102](/packages/intervention-image-laravel)[bkwld/croppa

Image thumbnail creation through specially formatted URLs for Laravel

510496.0k23](/packages/bkwld-croppa)[stefangabos/zebra_image

A single-file, lightweight PHP library designed for efficient image manipulation featuring methods for modifying images and applying filters

141110.4k6](/packages/stefangabos-zebra-image)[reliqarts/laravel-guided-image

Simplified and ready image manipulation for Laravel via intervention image.

351.4k](/packages/reliqarts-laravel-guided-image)[bodom78/kohana-imagefly

Create resized / cropped images directly through url parameters.

5517.0k](/packages/bodom78-kohana-imagefly)

PHPackages © 2026

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