/** * @license Copyright (c) 2003-2013, CKSource - Frederico Knabben. All rights reserved. * For licensing, see LICENSE.html or http://ckeditor.com/license */ /** * @fileOverview The "filebrowser" plugin that adds support for file uploads and * browsing. * * When a file is uploaded or selected inside the file browser, its URL is * inserted automatically into a field defined in the filebrowser * attribute. In order to specify a field that should be updated, pass the tab ID and * the element ID, separated with a colon.

* * Example 1: (Browse) * *
 * {
 * 	type : 'button',
 * 	id : 'browse',
 * 	filebrowser : 'tabId:elementId',
 * 	label : editor.lang.common.browseServer
 * }
 * 
* * If you set the filebrowser attribute for an element other than * the fileButton, the Browse action will be triggered.

* * Example 2: (Quick Upload) * *
 * {
 * 	type : 'fileButton',
 * 	id : 'uploadButton',
 * 	filebrowser : 'tabId:elementId',
 * 	label : editor.lang.common.uploadSubmit,
 * 	'for' : [ 'upload', 'upload' ]
 * }
 * 
* * If you set the filebrowser attribute for a fileButton * element, the QuickUpload action will be executed.

* * The filebrowser plugin also supports more advanced configuration performed through * a JavaScript object. * * The following settings are supported: * * * * Example 3: (Quick Upload) * *
 * {
 * 	type : 'fileButton',
 * 	label : editor.lang.common.uploadSubmit,
 * 	id : 'buttonId',
 * 	filebrowser :
 * 	{
 * 		action : 'QuickUpload', // required
 * 		target : 'tab1:elementId', // required
 * 		params : // optional
 * 		{
 * 			type : 'Files',
 * 			currentFolder : '/folder/'
 * 		},
 * 		onSelect : function( fileUrl, errorMessage ) // optional
 * 		{
 * 			// Do not call the built-in selectFuntion.
 * 			// return false;
 * 		}
 * 	},
 * 	'for' : [ 'tab1', 'myFile' ]
 * }
 * 
* * Suppose you have a file element with an ID of myFile, a text * field with an ID of elementId and a fileButton. * If the filebowser.url attribute is not specified explicitly, * the form action will be set to filebrowser[DialogWindowName]UploadUrl * or, if not specified, to filebrowserUploadUrl. Additional parameters * from the params object will be added to the query string. It is * possible to create your own uploadHandler and cancel the built-in * updateTargetElement command.

* * Example 4: (Browse) * *
 * {
 * 	type : 'button',
 * 	id : 'buttonId',
 * 	label : editor.lang.common.browseServer,
 * 	filebrowser :
 * 	{
 * 		action : 'Browse',
 * 		url : '/ckfinder/ckfinder.html&type=Images',
 * 		target : 'tab1:elementId'
 * 	}
 * }
 * 
* * In this example, when the button is pressed, the file browser will be opened in a * popup window. If you do not specify the filebrowser.url attribute, * filebrowser[DialogName]BrowseUrl or * filebrowserBrowseUrl will be used. After selecting a file in the file * browser, an element with an ID of elementId will be updated. Just * like in the third example, a custom onSelect function may be defined. */ (function() { // Adds (additional) arguments to given url. // // @param {String} // url The url. // @param {Object} // params Additional parameters. function addQueryString( url, params ) { var queryString = []; if ( !params ) return url; else { for ( var i in params ) queryString.push( i + "=" + encodeURIComponent( params[ i ] ) ); } return url + ( ( url.indexOf( "?" ) != -1 ) ? "&" : "?" ) + queryString.join( "&" ); } // Make a string's first character uppercase. // // @param {String} // str String. function ucFirst( str ) { str += ''; var f = str.charAt( 0 ).toUpperCase(); return f + str.substr( 1 ); } // The onlick function assigned to the 'Browse Server' button. Opens the // file browser and updates target field when file is selected. // // @param {CKEDITOR.event} // evt The event object. function browseServer( evt ) { var dialog = this.getDialog(); var editor = dialog.getParentEditor(); editor._.filebrowserSe = this; var width = editor.config[ 'filebrowser' + ucFirst( dialog.getName() ) + 'WindowWidth' ] || editor.config.filebrowserWindowWidth || '80%'; var height = editor.config[ 'filebrowser' + ucFirst( dialog.getName() ) + 'WindowHeight' ] || editor.config.filebrowserWindowHeight || '70%'; var params = this.filebrowser.params || {}; params.CKEditor = editor.name; params.CKEditorFuncNum = editor._.filebrowserFn; if ( !params.langCode ) params.langCode = editor.langCode; var url = addQueryString( this.filebrowser.url, params ); // TODO: V4: Remove backward compatibility (#8163). editor.popup( url, width, height, editor.config.filebrowserWindowFeatures || editor.config.fileBrowserWindowFeatures ); } // The onlick function assigned to the 'Upload' button. Makes the final // decision whether form is really submitted and updates target field when // file is uploaded. // // @param {CKEDITOR.event} // evt The event object. function uploadFile( evt ) { var dialog = this.getDialog(); var editor = dialog.getParentEditor(); editor._.filebrowserSe = this; // If user didn't select the file, stop the upload. if ( !dialog.getContentElement( this[ 'for' ][ 0 ], this[ 'for' ][ 1 ] ).getInputElement().$.value ) return false; if ( !dialog.getContentElement( this[ 'for' ][ 0 ], this[ 'for' ][ 1 ] ).getAction() ) return false; return true; } // Setups the file element. // // @param {CKEDITOR.ui.dialog.file} // fileInput The file element used during file upload. // @param {Object} // filebrowser Object containing filebrowser settings assigned to // the fileButton associated with this file element. function setupFileElement( editor, fileInput, filebrowser ) { var params = filebrowser.params || {}; params.CKEditor = editor.name; params.CKEditorFuncNum = editor._.filebrowserFn; if ( !params.langCode ) params.langCode = editor.langCode; fileInput.action = addQueryString( filebrowser.url, params ); fileInput.filebrowser = filebrowser; } // Traverse through the content definition and attach filebrowser to // elements with 'filebrowser' attribute. // // @param String // dialogName Dialog name. // @param {CKEDITOR.dialog.definitionObject} // definition Dialog definition. // @param {Array} // elements Array of {@link CKEDITOR.dialog.definition.content} // objects. function attachFileBrowser( editor, dialogName, definition, elements ) { if ( !elements || !elements.length ) return; var element, fileInput; for ( var i = elements.length; i--; ) { element = elements[ i ]; if ( element.type == 'hbox' || element.type == 'vbox' || element.type == 'fieldset' ) attachFileBrowser( editor, dialogName, definition, element.children ); if ( !element.filebrowser ) continue; if ( typeof element.filebrowser == 'string' ) { var fb = { action: ( element.type == 'fileButton' ) ? 'QuickUpload' : 'Browse', target: element.filebrowser }; element.filebrowser = fb; } if ( element.filebrowser.action == 'Browse' ) { var url = element.filebrowser.url; if ( url === undefined ) { url = editor.config[ 'filebrowser' + ucFirst( dialogName ) + 'BrowseUrl' ]; if ( url === undefined ) url = editor.config.filebrowserBrowseUrl; } if ( url ) { element.onClick = browseServer; element.filebrowser.url = url; element.hidden = false; } } else if ( element.filebrowser.action == 'QuickUpload' && element[ 'for' ] ) { url = element.filebrowser.url; if ( url === undefined ) { url = editor.config[ 'filebrowser' + ucFirst( dialogName ) + 'UploadUrl' ]; if ( url === undefined ) url = editor.config.filebrowserUploadUrl; } if ( url ) { var onClick = element.onClick; element.onClick = function( evt ) { // "element" here means the definition object, so we need to find the correct // button to scope the event call var sender = evt.sender; if ( onClick && onClick.call( sender, evt ) === false ) return false; return uploadFile.call( sender, evt ); }; element.filebrowser.url = url; element.hidden = false; setupFileElement( editor, definition.getContents( element[ 'for' ][ 0 ] ).get( element[ 'for' ][ 1 ] ), element.filebrowser ); } } } } // Updates the target element with the url of uploaded/selected file. // // @param {String} // url The url of a file. function updateTargetElement( url, sourceElement ) { var dialog = sourceElement.getDialog(); var targetElement = sourceElement.filebrowser.target || null; // If there is a reference to targetElement, update it. if ( targetElement ) { var target = targetElement.split( ':' ); var element = dialog.getContentElement( target[ 0 ], target[ 1 ] ); if ( element ) { element.setValue( url ); dialog.selectPage( target[ 0 ] ); } } } // Returns true if filebrowser is configured in one of the elements. // // @param {CKEDITOR.dialog.definitionObject} // definition Dialog definition. // @param String // tabId The tab id where element(s) can be found. // @param String // elementId The element id (or ids, separated with a semicolon) to check. function isConfigured( definition, tabId, elementId ) { if ( elementId.indexOf( ";" ) !== -1 ) { var ids = elementId.split( ";" ); for ( var i = 0; i < ids.length; i++ ) { if ( isConfigured( definition, tabId, ids[ i ] ) ) return true; } return false; } var elementFileBrowser = definition.getContents( tabId ).get( elementId ).filebrowser; return ( elementFileBrowser && elementFileBrowser.url ); } function setUrl( fileUrl, data ) { var dialog = this._.filebrowserSe.getDialog(), targetInput = this._.filebrowserSe[ 'for' ], onSelect = this._.filebrowserSe.filebrowser.onSelect; if ( targetInput ) dialog.getContentElement( targetInput[ 0 ], targetInput[ 1 ] ).reset(); if ( typeof data == 'function' && data.call( this._.filebrowserSe ) === false ) return; if ( onSelect && onSelect.call( this._.filebrowserSe, fileUrl, data ) === false ) return; // The "data" argument may be used to pass the error message to the editor. if ( typeof data == 'string' && data ) alert( data ); if ( fileUrl ) updateTargetElement( fileUrl, this._.filebrowserSe ); } CKEDITOR.plugins.add( 'filebrowser', { requires: 'popup', init: function( editor, pluginPath ) { editor._.filebrowserFn = CKEDITOR.tools.addFunction( setUrl, editor ); editor.on( 'destroy', function() { CKEDITOR.tools.removeFunction( this._.filebrowserFn ); }); } }); CKEDITOR.on( 'dialogDefinition', function( evt ) { var definition = evt.data.definition, element; // Associate filebrowser to elements with 'filebrowser' attribute. for ( var i = 0; i < definition.contents.length; ++i ) { if ( ( element = definition.contents[ i ] ) ) { attachFileBrowser( evt.editor, evt.data.name, definition, element.elements ); if ( element.hidden && element.filebrowser ) { element.hidden = !isConfigured( definition, element[ 'id' ], element.filebrowser ); } } } }); })(); /** * The location of an external file browser that should be launched when the **Browse Server** * button is pressed. If configured, the **Browse Server** button will appear in the * **Link**, **Image**, and **Flash** dialog windows. * * See the [File Browser/Uploader](http://docs.cksource.com/CKEditor_3.x/Developers_Guide/File_Browser_(Uploader\)) documentation. * * config.filebrowserBrowseUrl = '/browser/browse.php'; * * @since 3.0 * @cfg {String} [filebrowserBrowseUrl='' (empty string = disabled)] * @member CKEDITOR.config */ /** * The location of the script that handles file uploads. * If set, the **Upload** tab will appear in the **Link**, **Image**, * and **Flash** dialog windows. * * See the [File Browser/Uploader](http://docs.cksource.com/CKEditor_3.x/Developers_Guide/File_Browser_(Uploader\)) documentation. * * config.filebrowserUploadUrl = '/uploader/upload.php'; * * @since 3.0 * @cfg {String} [filebrowserUploadUrl='' (empty string = disabled)] * @member CKEDITOR.config */ /** * The location of an external file browser that should be launched when the **Browse Server** * button is pressed in the **Image** dialog window. * * If not set, CKEditor will use {@link CKEDITOR.config#filebrowserBrowseUrl}. * * config.filebrowserImageBrowseUrl = '/browser/browse.php?type=Images'; * * @since 3.0 * @cfg {String} [filebrowserImageBrowseUrl='' (empty string = disabled)] * @member CKEDITOR.config */ /** * The location of an external file browser that should be launched when the **Browse Server** * button is pressed in the **Flash** dialog window. * * If not set, CKEditor will use {@link CKEDITOR.config#filebrowserBrowseUrl}. * * config.filebrowserFlashBrowseUrl = '/browser/browse.php?type=Flash'; * * @since 3.0 * @cfg {String} [filebrowserFlashBrowseUrl='' (empty string = disabled)] * @member CKEDITOR.config */ /** * The location of the script that handles file uploads in the **Image** dialog window. * * If not set, CKEditor will use {@link CKEDITOR.config#filebrowserUploadUrl}. * * config.filebrowserImageUploadUrl = '/uploader/upload.php?type=Images'; * * @since 3.0 * @cfg {String} [filebrowserImageUploadUrl='' (empty string = disabled)] * @member CKEDITOR.config */ /** * The location of the script that handles file uploads in the **Flash** dialog window. * * If not set, CKEditor will use {@link CKEDITOR.config#filebrowserUploadUrl}. * * config.filebrowserFlashUploadUrl = '/uploader/upload.php?type=Flash'; * * @since 3.0 * @cfg {String} filebrowserFlashUploadUrl='' (empty string = disabled)] * @member CKEDITOR.config */ /** * The location of an external file browser that should be launched when the **Browse Server** * button is pressed in the **Link** tab of the **Image** dialog window. * * If not set, CKEditor will use {@link CKEDITOR.config#filebrowserBrowseUrl}. * * config.filebrowserImageBrowseLinkUrl = '/browser/browse.php'; * * @since 3.2 * @cfg {String} [filebrowserImageBrowseLinkUrl='' (empty string = disabled)] * @member CKEDITOR.config */ /** * The features to use in the file browser popup window. * * config.filebrowserWindowFeatures = 'resizable=yes,scrollbars=no'; * * @since 3.4.1 * @cfg {String} [filebrowserWindowFeatures='location=no,menubar=no,toolbar=no,dependent=yes,minimizable=no,modal=yes,alwaysRaised=yes,resizable=yes,scrollbars=yes'] * @member CKEDITOR.config */ /** * The width of the file browser popup window. It can be a number denoting a value in * pixels or a percent string. * * config.filebrowserWindowWidth = 750; * * config.filebrowserWindowWidth = '50%'; * * @cfg {Number/String} [filebrowserWindowWidth='80%'] * @member CKEDITOR.config */ /** * The height of the file browser popup window. It can be a number denoting a value in * pixels or a percent string. * * config.filebrowserWindowHeight = 580; * * config.filebrowserWindowHeight = '50%'; * * @cfg {Number/String} [filebrowserWindowHeight='70%'] * @member CKEDITOR.config */