DisplayAnything is a gallery tool for SilverStripe CMS. It's primary goal is to replace the ImageGallery module as a file management tool for pages and dataobjects. It can also be used to manage galleries of other files such as PDF document lists.

• Handles file uploads via XHR or standard uploads.
• Security: uses a configurable mimetype map, not file extensions, to determine an uploaded file type
• Integration: uses PHP system settings for upload file size
• Multiple file uploading in supported browsers (Note: not yet supported by Internet Explorer)
• Drag and Drop in supported browsers (Chrome, Firefox, Safari and possibly Opera)
• XHR file uploading
• Has Zero Dependencies on the third-party Silverstripe modules ImageGallery, DataObjectManager and Uploadify
• 100% Flash Free - no plugin crashes, HTTP errors, I/O errors or other futzing with incomprehensible Flash errors!
• Import ImageGallery album items to a gallery
• Uses jQuery bundled with SilverStripe
• Well documented & clean code with extendable classes and overrideable methods
• $_REQUEST not used
• Uses Valum's Ajax Uploader (hat tip)
• Drag and drop sorting of images & files in the gallery
• File upload progress with cancel option

Source and Download

Source is located on Github, please review the readme.md file there for up-to-date instructions and changes. The module is currently considered beta quality and we are aiming to tag an initial 0.1 release by February 2012.

Use Cases

• Image gallery - allows asynchronous multiple uploads (if the browser supports it)
• File gallery - providing a document list associated with a given page or DataObject
• Single file or image - in a has_one scenario, DisplayAnything defers to it's underlying library UploadAnything to provide a single file upload field. Note that Silverstripe's core FileField and FileIframeField provide much the same functionality
• Video gallery - a sample extension of DisplayAnything is bundled to provide an example of a YouTube gallery. Each gallery item contains an image and an optional YouTube video URL and configuration area.

DisplayAnything is extensible using core SilverStripe programming techniques and does not rely on third party modules such as DataObjectManager or Uploadify.

Simple Gallery Example

To create a gallery associated with your Page model, you'll first need to add a gallery to the database schema. It's worth noting that this code is an example only so don't copy and paste it.

class SimpleGalleryPage extends Page {
	
	// this page has one gallery
	
	public static $has_one = array(
		'SimpleImageGallery' => 'DisplayAnythingGallery',
	);
	
}

You will then need to associate this field with the CMS interface for that page:

class SimpleGalleryPage extends Page {
	
	// this page has one gallery
	
	public static $has_one = array(
		'SimpleImageGallery' => 'DisplayAnythingGallery',
	);
	
	public function getCmsFields() {
		
		$fields = parent::getCmsFields();
		
		$gallery = new DisplayAnythingGalleryField(
			$this,
			'SimpleImageGallery',
			'DisplayAnythingGallery'
		);
		
		//where your files will be uploaded (e.g assets/gallery in this case)
		$gallery->SetTargetLocation('gallery');
		
		//add the field to a tab called 'Gallery', you can change the name if you want
		$fields->addFieldsToTab('Root.Content.Gallery', array($gallery));
	
		// other field declarations you may have
		
		return $fields;
	}
}

Once that is done, /dev/build your database (you must be logged in as an admin). Browsing to the page in the CMS you should see a 'Gallery' tab containing sub-tabs allowing you to configure each gallery. By default the gallery is set up to handle image uploads of GIF, PNG and JPG types.

Troubleshooting

If you run into trouble, try the following

• Ensure you are using the latest code from the source repo (either bleeding edge or a tagged branch)
• Put Silverstripe into dev mode ( Director::set_environment_type('dev'); ) in order to get verbose errors
• Read the Issues list at Github, it may contain discussion of a similar bug
• For upload errors, read the alert messages provided and ensure the assets directory is writable by the applicable system user and/or group
• Ensure the module is in a directory called "display_anything" in your SilverStripe install

If you are still having trouble with setup, please log an issue describing the problem. Provide code examples and links to pages if possible. Be descriptive of the issue and include what you were trying to do during setup. The more information, the faster the issue resolution.

Frontend templates

Inumerable gallery plugins with varying licenses exist for image & file lists and viewing of images in a lightbox (Fancybox is good and open source). DisplayAnything stays light and does not bundle any of these galleries. It's up to you to implement the gallery the way you want it (this saves you having to undo & override any defaults DisplayAnything may set).

The readme.md file contains a simple example you can expand on for your frontend templates.

Gallery Usage

Display Anything allows you to configure galleries for different usages. 2 usages are bundled with the code "Image" and "Document". To edit or add these usages as instructed on the "Usage" tab of the gallery.
DisplayAnything uses mimetypes rather than file extensions to determine if a file can be uploaded. If you are unsure about the correct mimetypes, a good start is Google.

Management

The gallery tab allows you to manage:

• Uploading of new files, either in batches (Chrome, Firefox, Safari) or in single file mode (Internet Explorer <= 9)
• Reloading of the current file list
• The sort order of each item (drag and drop each item)
• Image deletion - hit the delete button
• Editing - click an image/file to open the editable fields in popup
• File replacement - in edit mode, choose File Preview and the standard file button to replace the file