The File Manager interface, like all Manager dialogs, consists of two parts, the File Browser section, where files are uploaded, manipulated and selected, and a Properties section where various file options can be set.

The Properties section is contains three tabbed areas - File, Advanced and Popups

File Tab

URL

The URL field represents the file link's href attribute, and is the relative path to the file on the server, or the full URL to an external file.

Title

The link title attribute. Used as a description of the link and will be shown as a tooltip when the mouse is placed over the link.

Format

The format of the file insert - Link inserts the file as a link and Embed embeds the file into content using an iframe.

Open With

An optional method for displaying the link using either Google™ Docs Viewer or Office Apps Viewer

The options area in the grey box will change depending on the Format selected - 

Link Format Options

Text

If a text selection was made before opening the plugin this field will be filled by the selection. If the selction was any other element (an image for example), the Options section (including the Text, Layout and Class fields) will not be available. If no selection was made prior to opening the plugin, a text description of the link is required for this field.

Target

Where the link should be opened when clicked. When this option is set to Download, the file will downloaded when clicked (modern browsers only)

Layout

This field contains optional elements that will be included in the link's description and include the file icon, text (required), file size and file modification date. The Size and Date fields are filled when a file is selcted in the File Browser. These values can be edited and the original values restored by clicking the corresponding reload icons 

Each of these elements can be re-ordered, thereby affecting the order that they are displayed in the link, by dragging their boxes from left to right / right to left.

Include each element in the link by checking the corresponding checkbox.

Date Class and Size Class

Apply additional classes to the Date and Size span element descriptions in the file link.

The HTML created when inserting a link typically consists of the link/anchor element, the file Icon img element, the file Text, and two span elements each containg the Date and Size values eg:

<a href="/images/files/2017_Joomla_Brand_Manual.pdf">
 <img src="/media/jce/icons/pdf.png" alt="pdf" class="wf_file_icon" />
 <span class="wf_file_text">2017_Joomla_Brand_Manual.pdf</span>
 <span class="wf_file_size" style="margin-left: 5px;">3 MB</span>
 <span class="wf_file_date" style="margin-left: 5px;">12/08/2017, 11:38</span>
</a>

Embed Format Options

The embed options are similar to those available when inserting an image with the Image Manager, or inserting an iframe with IFrames.

Dimensions

The width and height of the iframe, in pixels. If the proportional checkbox is checked, changes to one value will automatically be affected on the other. When inserting a file using the Embed option, Dimensions values must be set.

Alignment

The position of the iframe relative to surrounding text.

Margin

Represents the amount of space (in pixels) between the iframe and surrounding items. If the Equalize box is checked, all margin positions will use the same value.

Advanced Tab

The Advanced tab contains fields for setting standard attributes for the file link or iframe.

ID

Unique identifier that distinguishes the element from others in the document.

Style

Represents the style attribute. Will be populated with styles set in the File tab (margin, align etc). Additional styles can be added using the style element syntax, eg: text-align:right;vertical-align:middle;

Classes

A list of classes from your Joomla! template that can be applied to the link. Classes can be selected by clicking the drop-down icon, or typed into the field seperated by a space.

Language Direction

Text direction of the element

Target Language Code

Language code of the target url

Language Code

Language code of the element, eg: en-GB

Target Character Encoding

Character encoding of the target url, eg: utf-8

Target MimeType

MIME (Multipurpose Internet Mail Extensions) Type of the target url eg: text/html

Relationship Page to Target

Relationship between the current page and the target url

Relationship Target to Page

Relationship target url and the current page

Tab Index

Tab order of the element

Access Key

Keyboard shortcut to access the element