Kentico CMS 6.0 Developer's Guide

Files and folders management

Files and folders management

Previous topic Next topic Mail us feedback on this topic!  

Files and folders management

Previous topic Next topic JavaScript is required for the print function Mail us feedback on this topic!  

To manage files stored in a media library, you need to go to CMS Desk -> Tools -> Media libraries and click the Edit (Edit) icon next to the appropriate media library.

 

devguide_clip0300

 

The library editing interface will be displayed on the Files tab where the files can be managed.

 

Folder operations

 

The following actions can be performed with the folders in the media library:

 

NewFolder New folder - creates a new folder under the currently selected folder.

LibraryDelete Delete - deletes the currently selected folder.

LibraryCopy Copy - uploads the folder and its content to another location and keeps the original folder.

LibraryMove Move - uploads the folder into another location and deletes the original folder.

 

Single file operations

 

You can perform the following operations by clicking the icons next to particular files:

 

NewFile New file - uploads a file from the local or network file system to the currently selected folder.

Next Select - selects the file and opens its editing interface in the bottom section.

View View - downloads the file and opens it in your default application for the file type.

Edit Edit - if you click the icon next to an image, the image gets opened in the built-in image editor. If the icon is clicked next to a non-image file, the metadata editor is opened.

Delete Delete - deletes the file.

Update Update - replaces the file with another file. The original file gets deleted and replaced by the new one.

Warning Import - this icon is displayed only with files that have been uploaded to the library folder externally (e.g. via FTP) and have not yet been registered in the database. By clicking the icon, you register the file in the database as described here.

 

devguide_clip0301

 

Batch file operations

 

You can also perform the LibraryCopy Copy, LibraryMove Move, LibraryDelete Delete and Warning Import operations for multiple files at once. To perform a batch operation, take the following steps:

 

1. Use the first drop-down list (1. in the screenshot) to select if you want to perform the operation for:

 

All files - performs the operation for all files in the current folder.

Selected files - performs the operation only for files selected by the check-boxes (Enabled).

 

2. If you selected Selected files in the previous step, use the check-boxes (2. in the screenshot) to select the files with which to perform the operation.

 

3. Choose the operation to perform using the second drop-down list (3. in the screenshot) and click OK.

 

devguide_clip0303

 

4.a If you are performing the LibraryCopy Copy or LibraryMove Move operation, the following dialog is displayed. Choose the target folder (or create a new one using the NewFolder New folder button if needed) and click the LibraryCopy Copy/ LibraryMove Move button.

 

devguide_clip0305

 

4.b If you are performing the LibraryDelete Delete operation, you will be prompted to confirm the deletion. Click OK to delete the files.

 

devguide_clip0304

 

4.c If you are performing a batch Warning Import operation, the dialog as in the following screenshot will appear for each imported file. Please specify the following details for each imported file:

 

File name - the name of the file displayed in the administration interface.

Title - the name of the file displayed on the live site.

Description - the text describing the image. You can leave blank.

 

Click the Import file button to proceed to the following file.

 

You can also enable the Apply description to all files option, which imports all files in one click on the Import all files button. All files will have the entered Description and the File name and Title fields will contain the names of the physical files without extension.

 

devguide_clip0306

 

 

 

Important!

 

Because of ASP.NET architecture, site restart will occur when:

 

a media library is deleted

a group containing a media library is deleted

one of the following actions is performed when editing a library in CMS Desk -> Tools -> Media libaries -> Files or on the live site:

folder is deleted

folder is renamed

folder is moved

large number of files is deleted (100 by default, this can be set in the <system.web> section of your web.config by the following key: <compilation debug="true" numRecompilesBeforeAppRestart="100">)

 

Because of this, it is highly recommended to allow performing of these actions only to system administrators or to the least possible number of users. The recommended practice is for the site administrators to pre-define the folder structure of the libraries when they are created and not to allow users to further modify it.