Using the CCK display formatter with FileFields
- Create your content type if you haven't already (on your site at
- Add a FileField to your content type (at
- Configure the FileField to accept the file extension(s) for your media (e.g. swf, mp3, mp4, or flv). This is the field labeled Permitted upload file extensions on the field configuration page (at
- Both single and multiple-value FileFields are supported (Number of values on the same page).
- Set the field display formatter to a SWF Tools formatter (at
See explanation of the options below.
Once the FileField is set up, users can easily add content to the node by uploading a file to the FileField. SWF Tools will display it ready for playback.
SWF Tools provides a choice of formatters:
- SWF Tools - with download link
The uploaded file will be rendered according the SWF Tools settings, and a download link will also be shown. This is useful for podcasts where users might want to download the source file.
- SWF Tools - no download link
The uploaded file will be rendered according to the SWF Tools settings, but no direct download link is displayed.
- SWF Tools - playlist
The uploaded files will be turned in to a playlist and the selected SWF Tools handler for the mix of media will be used, perhaps SimpleViewer for a list of images, FlowPlayer3 for a series of audio files.
Alternate handlers for single files in a playlist
SWF Tools provides a settings page to allow for an alternate handler to be specified if a single file is passed to a field that has been configured to use a playlist formatter. This is primarily of use when uploading a images - a series of images makes sense as a slideshow, but a single image might be better presented as a simple image.
These settings are found at Administer > Site configuration > SWF Tools > CCK formatters. The page shows a simple list of all the FileFields that are using SWF Tools formatters. An alternate formatter can be selected from the dropdowns.