![Advanced-UI](https://img.shields.io/static/v1?label=UI&message=Advanced&color=lightgrey)
![NOVA-UI](https://img.shields.io/static/v1?label=UI&message=NOVA&color=blue)

The *Custom Preview Setter* plugin allows you to upload a custom preview image that replaces the one generated by the system.

The label for the key of the menu item is *customPreviewSetter.menuTitle* and can be customized via the *{home}/appserver/lang/customMessages_xx.properties* files.

[MINITOC]

## Properties

To be configured in *{home}/appserver/conf/custom.properties*.

##### customPreviewSetter.license

> type: String, **required: yes**, default: -

The license key for the plugin (product: customPreviewSetter), provided by *brix*.

##### customPreviewSetter.allowedUserGroups

> type: List of Long, required: no, default: - (Superadmins)

The plugin's menu entry is only visible for those user groups and Superadmins.

## Screenshots

before - during - after:

![screenshot](screenshot-marked.jpg)

## Compatibility Matrix

| Custom Previews | CELUM (min. version)      |
|:--------------- |:------------------------- |
| 1.0             | 5.13.4 (tested up to 6.6) |
| 1.1             | 5.13.4 (tested up to 6.7) |
| 1.2             | 5.13.4 (tested up to 6.7) |
| 1.3             | 6.8 (tested up to 6.14)   |

| Nova Plugin | CELUM (min. version) | Backend Plugin (min. version) |
| ----------- | -------------------- | ----------------------------- |
| 1.0.0       | 6.10.0               | 1.2.0                         |
| 1.0.1       | 6.11.0               | 1.2.0                         |

## Release Notes

#### 1.0

> Released 2020-09-18

Initial Version

#### 1.1

> Released 2020-10-15

Enabled setting (the same) preview on multiple assets at once

#### 1.2

> Released 2021-11-23

Nova compatibility

#### 1.3

> Released 2023-05-10

Compatibility update for 6.8+