nGen File Field is a field type for the FieldFrame framework by Brandon Kelly. It adds a custom field type allowing you to upload files from the Publish/Edit interface, and also functions as part of the FF Matrix. This extension is useful for creating galleries, download libraries, and much more.

Download ngen-file-field-1.0.2.zip v1.0.2 (29k)

By downloading this software you assume all responsibility for its use and absolve nGen Works of any liability and/or responsibility of any kind.

Requirements

Installation

  • Upload the ngen_file_field folder to /system/extensions/fieldtypes/
  • Upload lang.ngen_file_field.php to /system/language/english/
  • Enable the field type in FieldFrame's settings.

Configuration

  • When setting up a new nGen File Field simply select the appropriate upload location from the provided drop-down.
    • Each nGen File Field can upload to it's own location
    • Setup upload preferences as you normally would in Admin » Section Administration » Upload Preferences
  • Site wide settings ( Admin » Utilities » Fieldtypes Manager )
    • Create high quality thumnails (yes/no) - If set to no will generate low quality thumbnails to help save on memory usage.
    • Create thumbnails (yes/no) - Disable the generation of thumbnails.

Parameters

show='filename'

The show parameter is used in situations where you only need the file name to be displayed and not the full path to the file.

{custom_field show='filename'}

If our custom_field had a value of /images/photo1.jpg, the above code sample would only output photo1.jpg.

Screenshots

Screen example 1 Screen example 2

Change Log

  • 1.0.2 - 8/16/2010
    • New feature: disable thumbnail generation setting
    • Bug fix: caching issue for existing files list
    • Bug fix: file extension upper/lower
    • Other small bug fixes
  • 1.0.1 - 4/6/2010
    • Bug fix: avoid reaching max_file_uploads limit
    • Bug fix: SAEF issues
    • Bug fix: thumbnail issues
    • Bug fix: Wygwam compatibility issue
    • Other general bug squashing
  • 1.0 - 2/25/2010
    • New feature: Hide existing file option
    • New feature: Use/create low resolution thumbnails (lower memory usage). Found in FieldType Manager/FieldFrame settings.
    • New feature: Respects upload location maximum image dimensions
    • Improved: Error reporting
    • Improved: File list caching
    • Feedback during upload (simple upload animation)
    • Bug fix: Errors due to small file size
    • Bug fix: PHP_URL_PATH usage now has better compatibility across PHP versions
    • General speed/performance improvements
  • 0.9.10 - 6/16/2009
    • Bug fix: PHP notice message from line 310
    • Bug fix: Upload issue + path
  • 0.9.9 - 6/15/2009
    • New param: show="filename" will output only the file name without path
    • New feature: Existing file image preview
    • Bug fix: Javascript fix for SAEF IE7/8 compatibility
    • Bug fix: Duplicating path when operating in sub-directory
    • Bug fix: Compatibility w/ TinyMCE + improved existing file save robustness
  • 0.9.8 - 5/27/2009
    • LG Addon Updater support
    • Enhancement: if directory for upload does not exist it will create it and set permissions on it
    • SAEF compatibility
    • Bug fix: MSM compatibility
  • 0.9.7 - 5/6/2009
    • Moved text into language file
    • Improved thumbnail creation/detection
    • Removed accidental dependency on PHP v5.2+
    • Trash dialog now uses file/image wording based on filetype
    • Allow for uppercase file extensions when creating thumbnails
    • Only show current site's upload locations
    • Exclude files that start with "." for the existing files list
    • Improve MH File compatibility
    • Backup, if EXIF is not enabled, for exif_imagetype function
  • 0.9.5 - 5/1/2009
    • New feature: Select an existing file
    • Delete or de-associate: Now that you can use an existing file, you can either remove a file from the server (even if other entries use it) or just remove it from use with a particular entry via a new delete interface
    • MH File compatability: can now be a drop in replacement for single file uploads. NOTE! This will not work with fields that have multiple files uploaded. You will need to migrate those fields to an FF Matrix
    • File data is no longer stored as an array
    • Thumbnails in CP
      • Thumbnails are automatically create for use in the CP
      • "thumbs" directory under the upload directory for the field will be created to store the thumbnails
      • Image detection has been improved for thumbnail display - only GIF/JPG/PNG will show thumbnails
  • 0.9 - 3/29/2009: Initial release

Restrictions

Unless you have been granted prior, written consent from nGen Works, you may not:

  • Reproduce, distribute, or transfer the Software, or portions thereof, to any third party
  • Sell, rent, lease, assign, or sublet the Software or portions thereof
  • Grant rights to any other person