File Asset Types

Last Updated: 25 Jun 2018

In addition to the generic File asset, there are other specific file type assets with very similar functionality.

These are useful to use instead of the generic File asset as it controls which type of file can be uploaded against the asset. They are also useful for when you want to implement Search Pages or Asset Listings that specifically target certain file types. Some of these asset types also have additional functionality that supports their specific file type.

The documentation on this page will only refer to the additional functionality that is available for each file asset type.

To read about the generic functionality of file type assets, refer to the File asset chapter.

Bookmarks

Audio File

An Audio File asset is used to upload web compatible audio files and supports the following file extensions:

  • mp3
  • mka
  • m4a
  • aac
  • ogg
  • webm
  • wav
  • flac

ID3 Tag Information

The Details screen of this asset includes a section for adding additional information against the file. The top of this section has 2 fields for extracting and writing ID3 metadata:

  • Extract ID3 Metadata: Enable this to extract any metadata from the audio file to apply to the asset.
  • Write ID3 Metadata to file: Enable this field to write any metadata from the audio  asset to apply to the audio file.

CSS File

A CSS File asset is used to upload and edit CSS files and supports the following file extensions:

  • css
  • scss

FLV File

flv_file|asset|5.4.4.0

An FLV File asset is used to upload flash video files and supports the following file extensions:

  • flv

FLV Basic Information

The Details screen of this asset includes a section for adding additional information against the file.

The top of this section includes an option called Extract Basic FLV Metadata. Enable this to extract any metadata from the file to apply to the asset.

JS File

A JS File asset is used to upload and edit JavaScript files and supports the following file extensions:

  • js

MP3 File

mp3_file|asset|5.4.5.0

An MP3 File asset is used to upload MP3 files and supports the following file extensions:

  • mp3

ID3 Tag Information

The Details screen of this asset includes a section for adding additional information against the file. The top of this section has 2 fields for extracting and writing ID3 metadata:

  • Extract ID3 Metadata?: Enable this to extract any metadata from the mp3 file to apply to the asset.
  • Write ID3 Metadata to file?: Enable this field to write any metadata from the MP3 File asset to apply to the mp3 file.

MS Excel Document

A MS Excel Document asset is used to upload Microsoft Excel documents and supports the following file extensions:

  • xls
  • xlt
  • xlsx
  • xlsm
  • xltx
  • xltm

MS PowerPoint Document

A MS PowerPoint Document asset is used to upload Microsoft Power Point documents and supports the following file extensions:

  • ppt
  • pot
  • pps
  • pptx
  • potx
  • ppsx
  • pptm
  • potm
  • ppsm

MS Word Document

A MS Word Document asset is used to upload Microsoft Word documents and supports the following file extensions:

  • doc
  • dot
  • docx
  • docm
  • dotx
  • dotm

PDF File

A PDF File asset is used to upload PDF documents and supports the following file extensions:

  • pdf

RTF File

A RTF File asset is used to upload RTF files  and supports the following file extensions:

  • rtf

Text File

A Text File asset is used to upload text files and supports the following file extensions:

  • txt

Video File

A Video File asset is used to upload video based files and supports the following file extensions:

  • mov
  • avi
  • wmv
  • asf
  • flv
  • mp4
  • m4v
  • mpg
  • mpeg
  • ogv
  • ogg
  • webm

Video Metadata

The Details screen of this asset includes a section for adding additional information against the file.

The top of this section includes an option called Extract Video Metadata. Enable this to extract any metadata from the file to apply to the asset.

XML File

An XMLFile asset is used to upload XML (Extensible Markup Language) files and supports the following file extensions:

  • xml

Transformations Screen

This screen allows you to specify an XSL File to use for extensible style sheet language styling of the XML File when previewing the asset. Please note that this option requires PHP to have XSL support supplied in your system. If your system is running on Debian, you will be required to install the php5-xsl package on your system.

The Transformations section allows you to select the XSL File to use for XSL transformation. The following fields are available:

  • XSL Transformation: Select an XSL File to use and click Commit. This XSL File will be used to stylise the content of the XML File. This style will be reflected when previewing the asset on the frontend.
  • Replace Global Keywords: If set to Yes, global keywords in the XSL File will be replaced when applying to the XML data.

XSL File

xsl_file|asset|5.4.4.0

An XSL File asset is used to upload XSL (extensible style sheet language) files and supports the following file extensions:

  • xml

XSL Transformation

An XSL File can be used on the Transformations screen of an XML File asset to stylise the content of the XML. The Transformations screen is shown in the figure below.

In the example above, an XSL File has been selected in the XML Transformations section and will be used to style the XML File.

Text Based File Asset Types

The text based file asset types include:

  • CSS File
  • JS File
  • Text File
  • XML File
  • XSL File

Creating Without Uploading a File

Text based file asset types allow you to create them without needing to upload an existing file first. Simply just enter a Title for the file and click Save. This will create an empty text file of that type.

Edit File Screen

Text based files allow you to edit them directly within Squiz Matrix. You can edit the contents of these files on their Edit File screen.

Uploading a new file from the Details screen will off course overwrite and custom edits you have made on the Edit File screen.

getID3 Metadata Extraction

Some file types allow for automatic metadata extraction of the physical file when it is uploaded against the asset. This is used via the getID3 external tool that must be enabled for automatic metadata extraction to work.

If the tool was enabled when a file asset with getID3 metadata extraction support was first created, any metadata will have been automatically extracted and applied to the additional fields. If it was not enabled, an error message will be shown, as seen in the example below.

For more information on the getID3 tool, refer to the System Configuration manual.


Previous Chapter Next Chapter