CKSource

Latest revision as of 07:33, 2 December 2011

Upload Pane Versions

CKFinder Upload Pane comes in two flavors, depending on your environment. By default, the multiple upload solution (that lets you send more files to the server in one operation) is used for all environments that support Adobe Flash. If, however, your local system does not support Flash, you will still be able to upload individual files in separate operations thanks to the fallback solution.

The figure above presents the default Upload Pane with multiple upload solution enabled. For all systems that do not support Flash (including some mobile browsers) the following Upload Pane format will be used.

Single file Upload Panel in CKFinder

Multiple File Upload

By default CKFinder will allow you to upload multiple files at the same time. In order to send the files to the server, follow the steps described below.

Step 1: Click the Upload toolbar button to open the Upload Pane.

Step 2: When the Upload Pane expands, choose the Add Files button. A native file selection dialog window of your operating system that opens will let you choose the local file to be uploaded to the server.

You can choose as many files as you want by selecting them in the dialog window all at once.

Step 3: The local file(s) will now be added to the upload queue. If you want to add further files to this upload batch, click the Add Files button again and repeat the steps described above.

Upload queue in CKFinder

Step 4: If you change your mind about the files that should be sent to the server, you can always either remove individual files from the upload queue by clicking the Remove button next to the file, or decide to cancel the whole upload process by choosing the Cancel button of the Upload Pane.

Step 5: If you are ready with the file selection process, you can click the Upload button to start the upload. The progress of the whole process as well as individual files can be observed on the screen.

Multiple file upload progress

Step 6: Wait for the upload to terminate. Once it is completed, the folder content will refresh and the uploaded file will be selected in the Files Pane.

Single File Upload

When Adobe Flash is not available in your system, CKFinder upload will be fully functional, though limited to uploading one file at a time. In order to send the file to the server, follow the steps described below.

Step 1: Click the Upload toolbar button to open the Upload Pane.

Step 2: When the Upload Pane expands, choose the Browse button. A native file selection dialog window of your operating system that opens will let you choose the local file to be uploaded to the server.

The button caption may differ between browsers.

Step 3: The local file will now be selected. You can only upload one file at a time.

Step 4: If you are ready with the file selection process, you can click the Upload Selected File button to start the upload. The progress of the file upload process can be observed on the screen.

Single file upload in CKFinder

Step 5: Wait for the upload to terminate. Once it is completed, the Upload Pane will be closed, the folder content will refresh, and the uploaded file will be selected in the Files Pane.

Upload Errors

The following error messages may appear when uploading files.

A file with the same name is already available. The uploaded file was renamed to "filename(1).ext"

This message indicates that the uploaded file name is already in use by another file in the same folder. To avoid conflict, a consecutive number, the "(1)", was appended to the original name.

Invalid file

The file that you attempted to upload was not accepted.

The most common cause for this message is that CKFinder was configured to not accept the kind of file you are trying to upload based on its extension. This is a security restriction. It is also possible that the file size is too large for your system. If this is the case, the server must be configured to accept bigger files.

Upload cancelled for security reasons. The file contains HTML-like data.

The uploaded file contains HTML code. For security reasons, only files with selected extensions are allowed to contain HTML code.

Please contact your system administrator to get more information regarding the accepted file types and their size limits.

@@ Line 1: / Line 1: @@
 __TOC__
+{{#CUSTOMTITLE:Upload Button}}
-The upload* button, in the [[CKFinder_2.x/Users Guide/CKFinder Interface/Toolbar|Toolbar]] , opens the "Upload Pane", which can be used to add new files to the current folder. Here is a screenshot of it:
+The '''Upload''' button that is available in the CKFinder '''[[CKFinder_2.x/Users_Guide/CKFinder_Interface/Toolbar|Toolbar]]''' opens the '''Upload Pane''' which you can use to add new files to the current folder.
-''''[[Image:Ckfinder uploads pane.gif|Image:Ckfinder_uploads_pane.gif]]'''
+The figure below presents the default file browser '''Upload Pane''' that is expanded when you click the toolbar button.
-To close the Upload Pane, just click in the "'''Cancel'''" button, or click "'''Upload'''" again in the toolbar.
+[[Image:CKFinder_upload_01.png|frame|center|Flash Upload Panel in CKFinder]]
-<nowiki>*</nowiki> "'''Upload'''" is a technical term. It means the action of transferring a file from your local computer to a central computer (also known as server).
-== Upload Steps ==
+In order to close (collapse) the '''Upload Pane''', press the '''Cancel''' button or click the '''Upload''' toolbar button once again.
-# Select the file from your computer by using the "'''Browse..."'''button. The text in the button may vary from browsers, but it will always be right after the "Select the file to upload" field.
+<note>''Upload'' is a technical term that stands for the action of sending the files from your local computer to a central computer (also known as a ''server'').
-# Click the "'''Upload Selected File'''" button. A message will appear, indicating that the upload is in progress.
+</note>
-# Wait for the upload to terminate. Once completed, the Upload Pane will close automatically, and the uploaded file will be selected in the [[CKFinder_2.x/Users Guide/CKFinder Interface/Files Pane|Files Pane]].
-== Upload Messages ==
-The following are messages that may appear when uploading files:
+== Upload Pane Versions ==
+CKFinder '''Upload Pane''' comes in two flavors, depending on your environment. By default, the multiple upload solution (that lets you send more files to the server in one operation) is used for all environments that support Adobe Flash. If, however, your local system does not support Flash, you will still be able to upload individual files in separate operations thanks to the fallback solution.
-=== The uploaded file has been renamed ===
+The figure above presents the default '''Upload Pane''' with multiple upload solution enabled. For all systems that do not support Flash (including some mobile browsers) the following '''Upload Pane''' format will be used.
-A file with the same name is already available. The uploaded file has been renamed to "filename(1).ext"
+[[Image:CKFinder_upload_09.png|frame|center|Single file Upload Panel in CKFinder]]
-Indicates that the uploaded file name is already in use by another file in the same folder. To avoid conflict, a progressive number, the "(1)", has been appended to the original name.
-=== Invalid file ===
+== Multiple File Upload ==
+By default CKFinder will allow you to upload multiple files at the same time. In order to send the files to the server, follow the steps described below.
+''Step 1:'' Click the '''Upload''' toolbar button to open the '''Upload Pane'''.
+''Step 2:'' When the '''Upload Pane''' expands, choose the '''Add Files''' button. A native file selection dialog window of your operating system that opens will let you choose the local file to be uploaded to the server.
+<note>You can choose as many files as you want by selecting them in the dialog window all at once.
+</note>
+''Step 3:'' The local file(s) will now be added to the upload queue. If you want to add further files to this upload batch, click the '''Add Files''' button again and repeat the steps described above.
+[[Image:CKFinder_upload_03.png|frame|center|Upload queue in CKFinder]]
+''Step 4:'' If you change your mind about the files that should be sent to the server, you can always either remove individual files from the upload queue by clicking the '''Remove''' button next to the file, or decide to cancel the whole upload process by choosing the '''Cancel''' button of the ''' Upload Pane'''.
+''Step 5:'' If you are ready with the file selection process, you can click the '''Upload''' button to start the upload. The progress of the whole process as well as individual files can be observed on the screen.
+[[Image:CKFinder_upload_04.png|frame|center|Multiple file upload progress]]
+''Step 6:'' Wait for the upload to terminate. Once it is completed, the folder content will refresh and the uploaded file will be selected in the '''[[CKFinder_2.x/Users_Guide/CKFinder_Interface/Files_Pane|Files Pane]]'''.
+== Single File Upload ==
+When Adobe Flash is not available in your system, CKFinder upload will be fully functional, though limited to uploading one file at a time. In order to send the file to the server, follow the steps described below.
+''Step 1:'' Click the '''Upload''' toolbar button to open the '''Upload Pane'''.
+''Step 2:'' When the '''Upload Pane''' expands, choose the '''Browse''' button. A native file selection dialog window of your operating system that opens will let you choose the local file to be uploaded to the server.
+<note>The button caption may differ between browsers.
+</note>
+''Step 3:'' The local file will now be selected. You can only upload one file at a time.
+''Step 4:'' If you are ready with the file selection process, you can click the '''Upload Selected File''' button to start the upload. The progress of the file upload process can be observed on the screen.
+[[Image:CKFinder_upload_10.png|frame|center|Single file upload in CKFinder]]
+''Step 5:'' Wait for the upload to terminate. Once it is completed, the ''' Upload Pane''' will be closed, the folder content will refresh, and the uploaded file will be selected in the '''[[CKFinder_2.x/Users_Guide/CKFinder_Interface/Files_Pane|Files Pane]]'''.
-The uploaded file has not been accepted.
+== Upload Errors ==
+The following error messages may appear when uploading files.
-The most common cause for this messages is that CKFinder has been configured to not accept the kind of file you are trying to upload, based on its extension. This is a security restriction. Another cause of it may be that the file size is too big for your system. In this case the server must be configured to accept bigger files.
+=== A file with the same name is already available. The uploaded file was renamed to "''filename(1).ext''" ===
+This message indicates that the uploaded file name is already in use by another file in the same folder. To avoid conflict, a consecutive number, the "(1)", was appended to the original name.
-Please contact your system administrator to have more information regarding the accepted file types and their size limits.<br>
+=== Invalid file ===
+The file that you attempted to upload was not accepted.
-=== The file contains HTML like data ===
+The most common cause for this message is that CKFinder was configured to not accept the kind of file you are trying to upload based on its extension. This is a security restriction. It is also possible that the file size is too large for your system. If this is the case, the server must be configured to accept bigger files.
+=== Upload cancelled for security reasons. The file contains HTML-like data. ===
 The uploaded file contains HTML code. For security reasons, only files with selected extensions are allowed to contain HTML code.
+Please contact your system administrator to get more information regarding the accepted file types and their size limits.

CKSource

Login / Create Account

Page Tools

Upload Button