Client configuration options

Following settings are available in client configuration:

<script type="text/javascript">
	$(document).ready(function() {
		mollify.App.init({
			"service-path": "backend/",				// service path
			"service-param": false,				// service param
			"view-url": false,						// reflect view in url
			"file-view": {							// file view options
				"drop-type": ...,					// customize drag&drop operation
				"create-empty-file-action": false,	// create empty file
				"default-view-mode": "list",		// default view mode
				"icon-view-thumbnails": false,		// show icon thumbnails in icon view mode
				"list-view-columns": {
					...								// file list column setup
				},
				...
			}},
			[
				...									// client plugins
			]
		);
	});
</script>

General

Service path (service-path)

Location of the backend script relative to the index.html file.

Service param (service-param)

By default, REST API service is part of the request path, for example "http://host/mollify/backend/r.php/request/path/", where "request/path" would be the service requested.

Some servers don't support this format, and PHP application does not receive the service path at all. In this cases, enabling service-param, these requests are transformed into using URL parameter "http://host/mollify/backend/r.php?sp=request/path/"

Reflect view in URL (view-url)

Mollify can reflect the current view in the browser url (if browser supports history pushState). By default this is disabled.

File view options

Drag&drop operation (drop-type)

By default, drag&drop has following logic:

• if dragging single item, and it is from same root folder, item is moved
• if dragging single item, and it is from different root folder, item is copied
• if dragging multiple items, items are copied

With this setting it is possible to customize the operation.

Setting can have single constant value that is applied always, for example:

"file-view": {
	"drop-type": "copy"
}

Setting can also have different values for dragging&dropping single or multiple items:

"file-view": {
	"drop-type": {
		single: "move",
		multi: "copy"
	}
}

Also, value can be a function where custom logic can be defined, for example:

"file-view": {
	"drop-type": function(to, i) {
		// "to" is the target folder
		// "i" is dragged item/items

		if (window.isArray(i)) {
			//dragging multiple items
			return "copy";
		}
		// dragging single item
		var copy = (to.root_id != i.root_id);
		return copy ? "copy" : "move";
	}
}

In this example multiple items are always copied, and single item copied when dragged from different root folder.

Values can be "copy" or "move".

Create empty file (create-empty-file-action)

Action "create empty file" is not shown by default. With this setting, it can be enabled in folder action menu.

Icon view thumbnails (icon-view-thumbnails)

With this option, icon view can display supported images (gif, png, jpg, jpeg) with thumbnail. Requires thumbnail feature enabled in backend [https://code.google.com/p/mollify/wiki/BackendSettings#Enable_thumbnails_(enable_thumbnails)]

Default view mode (default-view-mode)

View mode selected when Mollify is launched, options are "list" (default), "small-icon" and "large-icon".

File list column customization

File list columns can be customized with setting 'list-view-columns'.

The setting accepts following format:

<script type="text/javascript">
	mollify.App.init({
		"file-view": {
			"list-view-columns": {
				"column-1-id": { column-1-settings: "" },
				"column-2-id": { column-2-settings: "" },
				...
			}
		}
	});
</script>

Column ID identifies the data shown, which can be either built-in predefined column or plugin provided.

Mollify provides following columns:

• 'name': File or folder name
• 'type': File or folder type description
• 'size': File size
• 'file-modified': Last modification time
• 'item-description': Item description

Following plugins provide more column data:

• [http://code.google.com/p/mollify/wiki/CommentsPlugin#File_list_columns Comments]

Column settings accepts following settings:

• 'title': Text key (in localization file) shown in the column title. If not provided, default title used
• 'sortable': Is column sortable
• 'width': Column width in pixels
• 'min-width': Column minimum width in pixels

Example configuration:

<script type="text/javascript">
	mollify.App.init({
		"list-view-columns": {
			"name": {width: 250},
			"type": {title:"myOwnColumnTitleKey"},
			"size": {}
		}
	});
</script>

Actions customizations

File list actions can be customized with following syntax:

mollify.App.init({
	"file-view": {	
		actions: {
			onClick: function(item, ctx) {
				return "open_menu";
			},
			onDblClick: function(item, ctx) {
				if (item.is_file) return "open_popup";
				return "go_into_folder";
			},
			onRightClick: function(item, ctx) {
				...
			}
		}
	},
	...

The object "actions" has can define following actions:

• onClick (for regular click in file list)
• onDblClick (for double click in file list)
• onRightClick (for right click in file list)

These action functions are called with following parameters:

• item: the file or folder
• ctx: context with following properties
  • viewtype: file list type "list" or "icon"
  • target: action target, in list view the column
  • element: jQuery object for the element representing the file or folder
  • viewport: jQuery object for the viewport (used when displaying UI popups etc)
  • container: jQuery object for the container (used when displaying UI popups etc)
  • folder: folder that is currently displayed
  • folder_permission: current user permission for the item

Possible return value for the action functions:

• "open_popup": opens the popup
• "open_menu": opens the action menu
• "go_into_folder": goes into the folder (if item is folder)
• false or no return value: default action
• true: default action is skipped (used for custom actions)

The options with string value are shortcuts for most common options, but by returning true you can define your own action handler.