HTTP Commander AJS 1.5
Manual
  Home page
free Installation assistance

Web.config parameters

Note!
We offer free installation assistance for both trial and commercial licenses. You can get help via email, instant messenger or via remote access to your server. You need few minutes to get online help.

HTTP Commander is highly customizable application. All settings are stored in one Web.config XML file. You can edit it in any text editor, e.g. Notepad.

Web.config settings

Main settings

Key Description Default value
LicenseKey Put the license key here after purchase. If the key is not set the application will work in a trial mode. The trail mode allows not more than 10 sessions and shows a trial notification when a user logons. If a user is not active during 60 minutes, the sessions will be ended. To terminate an existing session manually, you need to restart the application. ""
Administrators List of administrators' names, comma-separated. Any user can be an administrator if its name is in this list. Administrators can login to Admin Panel ("adminpanel.aspx" page) and Diagnostics("diagnostics.aspx") functionality of the HTTP Commander. You can also type group by "group:" prefix (Each member of the group is Administrator) "Administrator,admin,group:Administrators,group:Domain admins,group:admins"
ShowDiagnosticsASPXOnly­ForAdmins The key defines if /diagnostics.aspx page is available to all authenticated users or only administrators (Defined by "administrators" parameter). You can disable the diagnostics page output from users if it shows info that you want to hide.
Note! By default it is available for all users!
"false"
allowedFoldersPaths The key defines allowed root paths which administrator can share at Admin Panel. Paths are comma separated. Empty value by default- administrator can share any folders. You can set this value for more security (to prevent sharing if somebody will got administrator's credentials) or if you want to allow administrator sharing only specifed folders.
You can also set parameter that defines how admin can select folder: <add key="listAllowedFoldersPaths" value="1" />
Value "0" means that admin should type path in text box, Value "1"- Administrator will see dropdown menu with root folders and subfolders, Value "2" - Administrator will see dropdown menu with root folders, their subfolders and all level subfolders.
""
DataFolderPath Path to the folder with XML users and folders settings. By default, it is stored in HTCOMNET\Data folder. To prevent file download:
  • You can disable "read" permissions in IIS for this folder.
    For Windows 2003:
    • Open IIS console: Control panel->Administrative tools->
      Internet Information Services->Expand "Default web site" and "HTCOMNET" folder.
    • Right-click the "Data" folder and select "Properties" in the context menu.
      In the Data properties dialog box, open "Directory" tab and uncheck Read permissions. Screenshot
    For Windows 2008:
    • In the IIS console select Data node inside "HTCOMNET" node and click "Handler mappings" in the right tab. Select StaticFile in the list and click "Edit Feature Permissions" link in the right tab. In the next dialog window, uncheck "Read" permissions.
      Screenshot
  • or move this folder outside of web site root. Copy "Data" folder to a new path, like c:\, and set "c:\Data" value. Check NTFS permissions for new Data folder location.
"~/Data"
HashPasswords When the parameter is set to false (default), the application stores users' passwords in plain text in the Data\Accounts.xml file. When it is set to true, the application stores password hashes
in the Data\Accounts.xml file.
Note: once you set this parameter to true, you cannot
change it back. All passwords will be hashed, it's not possible to recover the original password
by its hash.
"false"
EnableAnonymRegister Set "true" to allow users to sign-up (Self registration). After registration a user is automatically added to default groups defined by defaultGroups parameter. "false"
DefaultGroups List of groups where users will be added to after self registration (sign-up), comma-separated. "SelfRegisteredUsers"
CreateRootFoldersIfNotExists Set "true" to create root folders automatically if it does not exist. Applied only for paths with "%USERNAME%" patterns "true"
HideFilesWithAttributes The key defines if files with some attributes will be hidden for users. Example: value="hidden,system,readonly,encrypted" - files and folders with attributes Hidden, System, Read-only or Encrypted are hidden. "hidden,system"
ZipUnzipDefaultCodePage The key defines default code page for Zip archive. 850 is a code page for English-speaking and most European countries. If the files with names in your language are added to the ZIP with corrupted name, you need to modify this value. You can google for your region's code page. "850"
EnableChangePassword The key defines if users can change their own password. "false"
enablePasswordRecovery Set true if users can get their password via email. Password is changed while recovery "false"
EnableChangeEmail Set true if users can change their email "false"
sessionState timeout Inactive session life timeout. If a user is not active, the session will be ended after specified number of minutes. "60"
httpRuntime maxRequestLength Maximum file size (file upload limit), in Kbytes. By default, it is 2 GB. "2097151"
requestLimits maxAllowedContentLength The key is the same as httpRuntime maxRequestLength but for IIS 7 compatibility. The value is in bytes. By default, it is 2 GB. "2147483648"
mailSettings The mailSettings section defines your SMTP server settings. These settings are used to recover user password, email notifications and "send email" features. This is built-in .NET section. You can read about the settings at MSDN site or see the example below:
<smtp deliveryMethod="Network" from="noreply@yoursite.com">
<network host="mail.yoursite.com" port="25" userName="" password="" defaultCredentials="false" />
</smtp>
Leave userName and password parameters empty if server don't requires authentication.
 
UploadEmailNotification

The section defines settings for email notifications after upload feature.
Example:
<group>
<emails value="mike@mysite.com,jdoe@mysite.com"/>
<users value="admin,john"/>
<groups value="students,staff"/>
<paths>
<path value="Demo folder 1\"/>
<path value="path to folder2\commonproject.doc"/>
<path value="^Domain users demo folder\\folder1\\" type="Regex" />
</paths>
</group>
Emails value is the list of mail addresses that will get upload notification, comma separated.
Users and groups value is the list of users or groups that will get the notifications about the upload file.
Path is a parameter that determines the folder name where a file will be uploaded in order the notification will be sent. It is possible to specify the directory of the folder ("/" in the end is required) and a file name or a regular expression.
Description of the example described above: if the users admin and john or any another user of students and staff groups are downloading files into the Demo folder 1 or a path to folder2\commonproject.doc file or into the folder corresponding to the regular expression "^Domain users demo folder\\folder1\\", the notifications will be sent to the following e-mail addresses: mike@mysite.com and jdoe@mysite.com.
You need also to configure mailSettings section at web.config and type your mail server, port and user if authentication is nedded.

 

User interface settings

Key Description Default value
ToolbarButtons Visible buttons in the toolbar. You can hide some of the buttons by modifying this key. "Administration" button is visible only for administrators - see "administrators" key.
If you want to add or modify the logo button see FAQ.
"folders,view, search,filemenu, upload,administration, settings,help,logout"
DefaultLanguage Default language. The value is the name of file localization without extensions. See Localization section of the Documentation for more info. "English"
HideTree Set "true" to make the state of folder tree panel collapsed when a user logons. "false"
TreeView Key defines tree view. Value is integer from 0 to 2.
0 - tree is disabled and hidden, 1 - tree is enabled but no auto collapseble, 2 - tree is enabled and autocollabsible.
Tree with auto collapsing enabled makes work slower so you can disable it (if you have easy folders structure and tree is not required).
"2"
AutoOpenFirstFolder The key defines if the content of first root folder should be shown when a user logons. Applyed only if tree view is available. "true"
IsEmbeddedtoIFRAME Set "true" if HTTP Commander is placed to IFRAME (IFRAME mode). "false"
AvailableDetailsTitles The key defines the list of details(metadata) titles. Details is a good feature for users to make tags for files and folders. Users can set comment, description, authorship, locking info or any other metadata. Default value is empty string - details feature is prohibited.
Example: "Description,Comment,custom" (Details with titles "Description", "Comment" and user custom are available)
Note! Type "custom" title if users can insert their own details title.
Note2! Don't use spacers and special characters like "&" in the details titles.
""
DetailsFields

The key defines the columns for details table. You can modify this parameter only if availableDetailsTitles is defined. By default details table includes Details Title, Value, User last modified name and Last modified date columns. You can add extra columns.
Parameter format: value="columnname1#type,columnname2#type"
"columnname1" and "culumnname2" are titles for columns.
"type" is a value type. There are 5 available types: string, int, float, boolean, date.
Example: For file locking tags, you need to set:
value="locked#boolean"
This is not a real locking feature but users can set a tag that the file is locked.
Note! Don't use spacers and special characters like "&" in the column name.

"Description,custom"
DisplayedDefaultColumnsInList The key defines the columns of the list with files. By default file size, type and date modified columns are visible, date accessed and date created is missing. Also columns for details specified at availableDetailsTitles are available but they are not displayed while login.
Note! Here you can also type the titles of details to view details values in the list (example: "size:true,type:true,datemodified:true,comment:true"). See "availableDetailsTitles" parameter for more info.
Note! Don't use too much columns becouse each column make list loading slower.
Note! Don't use spacers and special characters like "&" in the column name.
"size:true,type:true, datemodified:true, datecreated:false, dateaccessed:false"
ShowLogoHeader Key defines if top header with logo and text will be shown or not.
If you want to change the logo or text you can edit HTML code of header at Scripts\Main.js file. See logoHeader object at the top of file.
"false"
ShowWelcomeWindow Key defines if window with text will be shown while first user logon. You can type any text for user.
If you want to change the text you can edit its HTML code at Scripts\Main.js file. See welcome object at the top of file.
"false"
DoubleClickAction Key defines default action for mouse double click event. Available values: "download", "showmenu", "nothing". "showmenu"
logEvents Key defines list of events that will be logged. Set empty value to disable logging. "login,logout,upload,modify, download,openfolder,delete, create,copy,move,officelock, officeunlock"
EnableSendEmail Defines if users can send email. Value is integer: 0-disable email feature, 1 -enable with link to file, 2-enable with both links and attachments.
Note!
Sending large attachments can busy your mail server. Set "0" or "1" value to prohibit attachments.
You need also to configure mailSettings section at web.config and type your mail server, port and user if authentication is nedded.
"0"
DefaultGridView Key defines default list view: "detailed" or "thumbnails". View mode state stored in users cookies after they changed mode. "detailed"
ShowImagesThumbnail Key defines if users can view images thumbnails. User can move mouse over image file name (jpg, jpeg, jpe, jfif, bmp, dib, gif, wmf, png, tif, tiff, ico, ief) and view thumbnail (maximum 160x160 pixels). "true"
EnableThumbnailView­ImagesLoading Key defines is emages thumbnails will be shown instead of icons at the thumbnail view mode. "true"
EnableEditAsTextFile Key defines if users can edit any file as text file. You can disable this feature for schoolchildren becouse they can damage non-text files like .doc, etc. "true"
EnableLinkToFile Key defines if users can make link to file (at menu). You can disable this feature if users have only personal folders and they don't need to share files for anybody else. "true"

File upload/download parameters

Key Description Default value
EnableDnDUploader The key defines if drag-n-drop uploader is available. It is HTML 5 based uploader supported by latest FireFox, Chrome browsers (70% of users. Internet Explorer users can't use drag-n-drop). Users can drop files to any place of main interface. It is strongly recommended to enable this uploader becouse it is most stable and don't needs extra plug-ins. "true"
EnableSilverlightUploader The key defines if Silverlight based multiple files uploader is enabled (Drag-n-drop, Resumable and very large files uploading). "true"
EnableFromUrlUploader The key defines if users can upload file from Internet URL (File servers or images sharing services like DropBox, Picasa, Flickr, Facebook, Photobucket). Users can use FTP or HTTP links. "true"
EnableDownloadToDropbox The key defines if users can download files to own DropBox account. DropBox.com is free very popular worldwide file sync, sharing and backup solution.
This feature don't needs any extra configuration at IIS. Users don't send their DropBox password to the application (Authentication is passed at DropBox.com website).
"true"
EnableFlashUploader The key defines if Flash multiple files uploader is enabled. "true"
EnableJavaUploader The key defines if Java applet multiple files and folders uploader is enabled. "true"
EnableJavaFoldersUpload The key defines if the folder upload is enabled in Java uploader. "true"
EnableJavaChunkedUpload The key defines if chunk upload mode is used for Java uploader. It allows resumable upload and the upload of very large files (greater than 2 GB). By default the key is disabled. "false"
EnableJavaDownloader The key defines if Java multiple files and folders downloader is enabled. "true"
EnableDownloadToGoogle The key defines if users can download files to their own Google accounts (Google Docs service).
This feature don't needs any extra configuration at IIS. Users don't send their Google password to the application (Authentication is passed at Google website).
Upload from Google Docs/Download to Google Docs - the possibility to share files with Google Docs storage. Google Docs allows to edit documents and convert them into different formats (doc, rtf, png, pdf, html, odt, xls, ods, ppt, swf and etc.). Users just need to have Google account (for example, gmail.com email box) or to register. Users can download the files from HTTP Commander folder to their Google Docs account or upload documents from Google Docs to HTTP Commander folder. To edit documents online, a user clicks a link in HTTP Commander or opens http://docs.google.com page in a browser. This is a free service with some limitations. If your users have Business account in Google Docs, they will have more possibilities. Although the free service includes a plenty of helpful functionalities.
"true"
EnableUploadFromGoogle The key defines if users can upload files from Google Docs to HTTP Commander folder. This feature allows users to upload documents from Google Docs account to the folder. "true"

MS Office/Openoffice.org support, Online Documents viewers and Image editor

HTTP Commander has a plenty of possibilities to view and edit documents and edit images. Users can create documents, edit them and make metadata. It supports lock/unlock functionallity designed for limitaion of simultaneous access to a document.
HTTP Commander allows to use Microsoft Office and free Openoffice.org for online editing of documents using desktop applications: Users do not need to download documents and upload them back to server after editing. It works automatically (owing to WebDAV technology). A user just need to click on Save or Save As buttons to save changed documents on server. Microsoft Office and free Openoffice.org allow to work with more than 100 document formats (text, tables, images, presentations). It is possible to convert one format to another and save new documents on server. This feature works in any browser and at both Windows and Mac OS. Office XP, 2003, 2007, 2010 are supported (Office 2000 not supported)

For work with documents via only browser, users can use more popular integrated online services:

Necessary settings for work with documents in online services:
Key Description Default value
EnableGoogleDocumentsViewer The key defines if Google Doc online viewer may view some kinds of files. Google docs supports the following types: pdf, doc, docx, ppt, pptx, tif, tiff. Users can save a document to their own Google Docs accounts and then edit it. If you set enableUploadFromGoogle option to true, a user can upload a modified file back to HTTP Commander folder.
You can get more info at the Google Docs Viewer web page
"true"
EnableZohoDocumentsViewer The key defines if Zoho online viewer may view some kinds of files: doc, docx, xls, xlsx, ppt, pptx, pps, odt, ods, odp, sxw, sxc, sxi, wpd, pdf, rtf, txt, html, csv, tsv. Maximum file size is 10 MB.

You can get more info at the Zoho Viewer web page
"true"
EnableZohoDocumentsEditor The key defines if Zoho online Editor may edit some kinds of files. Supported file types are the same as for Zoho Viewer (See enableZohoDocumentsViewer parameter)
Some functionalities of Zoho Editor are not free. You need to get free of charge or buy Zoho API key and to set its parameters in web.config:

<add key="zohoEditorAPIKey" value="PutZohoAPIKeyHere" />
If you use SSL, set this parameter as well: <add key="zohoEditorSecretKey" value="PutZohoSecretKeyHere" />
Optional. The Zoho Editor secret key value needs to be passed for the access to Zoho editor urls over https. The 'skey' is automatically generated at the moment of registering for 'api key' and is associated with it. Users can get their 'skey' details by logging into 'https://zapi.zoho.com' with their Zoho account (username/password).

If you use collaborative work with files, you can set the following parameter:
<add key="zohoEditingMode" value="collabedit " />
The parameter's values can be:
view -- A document opens in read-only mode.

normaledit -- A document opens only in edit mode for the user and no other collaborators are allowed. Default value.

collabview -- A document opens in a collaborative view mode. Multiple users can view the content of the document at the same time and can leave notes/comments using the integrated chat service. However, they cannot edit the document content.

collabedit -- A document opens in real-time collaborative edit mode. Multiple user can edit the document at the same time.


You can get more info at the Zoho API web page

"false"
EnablePixlrEditor The key defines if users can edit image files or create new via Pixlr.com service. "false"


Necessary settings for online work in desktop Microsoft office and OpenOffice : Except IIS settings, you need to configure in web.config file which functions for work with documents will be available for users.

EnableMSOfficeEdit The key defines if users can open some files to edit with desktop Microsoft office application. You can find a list of supported files types at the top of Scripts\Main.js file. To launch MS Office HTTP Commander using JavaScript (it works for IE and Mozilla and Mac browsers) or Java applet (for other browsers).
"false"
EnableOpenOfficeEdit The key defines if users can open some files to edit with free desktop OpenOffice.org application. You can find a list of supported files types at the top of Scripts\Main.js file. To launch OpenOffice HTTP Commander using Java applet.
"false"

Web folders mapping

Web folder mapping is the functionality for users that allows to map web folder to the file system on local computer (WebDav). Users may see on a local computer and work with the same folders that they see in HTTP Commander interface with the same rights. In fact the work with files takes place online in a remote folder on server, so Internet access is necessary. All the changes made by a user apply to the files on server at the very same moment.
Advantages of web folder: Disadvantages of web folder: Necessary settings in IIS for web folders mapping functionality.
Client-side setup: Necessary settings in the web.config file:

Key Description Default value
EnableWebFoldersLinks Set this parameter to "true" if you want to allow Web folders mapping support.
"false"