file_markup¶
Summary¶
- file_markup(File $files, array $props = Array, array $wrapperAttributes = Array)¶
Return HTML for a set of files.
Parameters: - $files (File) – A file record or an array of File records to display.
- $props (array) – Properties to customize display for different file types.
- $wrapperAttributes (array) – Attributes HTML attributes for the div that wraps each displayed file. If empty or null, this will not wrap the displayed file in a div.
Returns: string HTML
Usage¶
The second argument, $props, is an array of options to customize the display of files. Which options are valid depend on the particular file type and on whether a plugin has added a new method for displaying that file, but there are some fairly standard available options.
Options for many possible file types can be specified all together. Each file will only use the options that are valid for its type, and ignore the others.
- imageSize
Available for images. Default: square_thumbnail
A string naming the size of image to use. The possible sizes are thumbnail, square_thumbnail, and fullsize.
- linkToFile
Available for images and unknown-type files. Default: true
Whether the display should be wrapped in a direct link directly the file. true makes a link to the original file, false makes no link, and a string links to the specified image size (thumbnail, square_thumbnail, or fullsize).
- linkToMetadata
Available for images and unknown-type files. Default: false
If true, wrap the file in a link to the file’s “show” metadata page. This option overrides linkToFile when true.
- imgAttributes
Available for images. Default: none
An array of attributes to set on the HTML <img> tag. Keys of the array are attribute names, and values of the array are attribute values.
- linkText
Available for unknown-type files. Default: null
The text to display for the file (inside the link if one of the linking options is enabled). If null or omitted, the file’s Dublin Core Title (if available) or original filename are used as the text.
- width, height
Available for most audio and video types. Defaults vary.
The pixel height and width of the audio or video player.
Examples¶
file_markup can be passed just a file or array of files alone to produce the default display:
// Display one specific File
echo file_markup($file);
// Display all the given Files (here, the files for an Item)
echo file_markup($item->Files);
One of the simplest uses of file_markup‘s display options is to display a fullsize image instead of a small square thumbnail:
echo file_markup($file, array('imageSize' => 'fullsize'));