File > Image

Overview

The purpose of this field is to let you upload an image file (e.g: png, jpeg, jpg, gif.).

You can limit the compatible file extensions.

Images will be stored by default in the folder pub/media/contentmanager/content/

You can set a subfolder dedicated to your field.

Screenshot

Settings

• Title: Label of the field

• Identifier: Unique ID, used for template redefinition and custom script. By default, the identifier is set by a concatenation of the Custom Type identifier (eg “all_fields”) and Title (eg. “area”).

• Input type: current definition of the field type. Note that after saving, you’ll be unable to change it.

• Required: define if the field is mandatory or not when user will complete the content form.

• Show in Grid: define if the field will be available to be shown in the content listing (under CMS → Your content type name). Take care because all values will be shown.

• Note: A note which will be displayed under the field to help the webmaster, or give information about this field.

Special settings:

• File Path: Sub-directory to store files. For example, if you set “documents/”, files will be stored in “pub/media/contentmanager/content/documents/”.

• Compatible File Extensions: list all available file format extensions supported. Each extension must be separated by a simple comma (e.g.: ”tiff,png,bmp,gif,jpg,jpeg”).

• Maximum image size: WIDTH x HEIGHT pixels

• Enable crop tool :

• Keep aspect Ratio

• Additional attributes :

• Alt: allow to add an Alt attribute from the back office, to provide a replacement text if the image can not be displayed

• URL: add the source’s URL

• Title: add a title to bring an additional information for navigation purposes