File Widget

The File widget enables you to upload a binary file and insert it onto a page as a text link. When you upload a file into the widget, the system creates a shared file asset in the Assets/uploads/files folder. If you open a file widget for editing and upload a new file, the new file replaces the original file in the file asset; this does not create a new asset.

If you are uploading a file for the first time, it is saved with its filename and extension, for example:
Assets/uploads/files/companypolicies.pdf.  Each time you upload additional files with the same filename, a number is appended to the end of the filename. For example, the second time you upload companypolicies.pdf, it is saved as companypolicies(1).pdf. The third time you upload companypolicies.pdf, it is saved as companypolicies(2).pdf. 

If you delete a file text link from a page or template, the file asset remains in library; however, when you delete a file asset from Asset's view, the file text link is removed from all pages and templates that contain it.

Widget Configuration Properties

In the Layout tab, you can check the box to open link in new window - If checked, indicates that file accessed by link is opened in a new window. 

File Widget Editor

In the Content tab, you can adjust the following settings:

Link Text - Text of the link that opens the file.

File - Click the Browse button to open a dialog that enables you to search for and select a file from your local hard drive. 

Once you upload the file, the asset meta-data (folder path, filename, file type) will be auto-populated.

file widget content config

Widget Style Properties

CSS Root Class - Text Box for entering the name of a CSS class that customizes the format of the file. Your site designer can supply you with the name of the class.

Leave a comment