J3.x

J3.x:Adding custom fields/Media Field

From Joomla! Documentation

< J3.x:Adding custom fields
Revision as of 12:28, 1 April 2020 by FuzzyBot (talk | contribs) (Updating to match new version of source page)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Other languages:


Media Field


Media

Provides modal access to the media manager for insertion of images with upload for users with appropriate permissions.

Options

Special options within this field are:

  • Directory
    The default image directory for this field. The Media field inherently defaults to the main /images folder, so anything entered into the Directory field is assumed to be inside the images folder. So if you wish your default folder to be /images/myimages you would simply enter myimages into the Directory field.
  • Preview
    Shows or hides the preview of the selected image.
  • image class
    The class which is added to the image.


Related Information

See Media form field type

Screenshots

Creating the field

Let's say you create a field with the options shown in the next figure.

Media field create-en.png

Using the field in the backend

In the backend while creating an article or a contact you see the field like in the following imageː

Media-en.png

And if you click on it, a modal window will open and you can select an image in here. Media 2-en.png


Using the field in the frontend

In the frontend, you can see the field as you see in the following image. The option Automatic display is responsible for the position of the field and your template is responsible for the design of the field.
Fields are only displayed in the frontend if you have filled them with data in the article. If it is not a required field, can you forget it?

Media field frontend-en.png