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
  • Enable mapping tool: adds an "Attribute Mapping Zone" to the field, letting the admin draw clickable areas (a mapping) directly over the uploaded image (e.g. to link zones of the image to a URL or another content). The mapping data is stored alongside the image and can be retrieved from your content template.

Use default value

On a multi-store setup, each image sub-value (image, alt, title, url and mapping zone) can be overridden per store view. In the content edit form, unchecking "Use default value" for a store view lets you set an image specific to that store; checking it back reverts the field to the value defined on the default (All Store Views) scope.

Loading...