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