File Publishing

With the File Publishing module, you can publish the contents of any folder on your solution on your website.

For instance, you could:

  • Publish a list of training pdf’s on your intranet
  • Create a file-exchange where users can upload and download files from one central location

To visitors, a list of published files could look like (Figure 1.1) – although I hope you’ll style it nicer than I’ve done here.

In this article, you will learn how to set up and configure a File Publishing module on your solution.

Figure 1.1 A list of published pdf's

To use the File Publishing app add it to a paragraph on a page - you then have access to the app settings.

The display settings (Figure 3.1) let you control what to publish using the module.

Figure 3.1 The display settings

You can:

  • Select the folder containing the files you want to publish
  • Check force download to for the file to download, rather than open in a browser
  • Check show subfolders to allow users to access subfolders - you can use permissions to show/hide folders for selected user groups.
  • Select an icon folder containing alternative icons for the files in the list. Files must be in .gif format (16x16 recommended), and named [extension].gif – e.g. pdf.gif – and you should have a filed called na.gif to be used as a fallback icon.

The sorting settings (Figure 4.1) allow you to control how the list is, well, sorted.

Figure 4.1 The sorting settings

You can:

  • Sort the list by name, date or file size
  • Choose between descending or ascending sort order

The upload settings (Figure 5.1) allow you to provide a folder to upload files to, and to set up notifications for key people when a file is uploaded. Please note that this functionality has been removed in 9.10.15+ due to security concerns.

Figure 5.1 The upload settings

You can:

  • Specify an upload folder – if identical to the display folder, files uploaded will be immediately published. If not, you must manually move uploaded files to the relevant folders.
  • Check notify to enable email notifications when a file is uploaded. You must then:
    • Specify a subject
    • Enter a recipient, and optionally CC and BCC recipients
    • Enter a text – the email content. The email will also contain a path to the uploaded file.
    • Select a page to redirect users to after uploading a file

If a user is allowed to navigate to subfolders, you can localize how to render the link back up to the parent folder using the custom texts settings (Figure 6.1).

Figure 6.1 Custom text settings

Finally, the templates section (Figure 7.1) lets you select and edit the templates which control the styling and output of the file publishing module.

Figure 7.1 The templates section

The templates you can work with are:

  • List controls the styling and content of the list for displaying file list elements in
  • List element controls how each file is displayed in the list
  • Publish controls the styling and content of the upload function

There is no database specific information for this subject.