| AJS 4.x
Manual | Note! This Manual is for the "Windows authentication" version, which is designed to work with existing Windows server or Active Directory accounts and Windows authentication. If you want to create accounts by yourself and store their credentials in your own HTTP Commander XML database, you need to download the "Forms authentication" version! This Manual is for the Windows authentication version only! | Web file manager Free Installation assistance Manual Home page

Branding of HTTP Commander

In this section we will describe all settings related to branding of HTTP Commander.

- Application name, title, loading text
- Put your logo
- Background image of login page
- Themes
- Welcome message
- Public link page
- MSOFBA login page
- Default.aspx and Logout.aspx
- Email templates

- ### Application name, title, loading text

  - Application title ("Web files access") configured in the localization settings.
    Open Admin panel, Localization tab, select needed language (English , for example) and search for "CommonMainTitle" setting. Set needed value.
  - Loading text ("Loading of web files access") configured in the localization settings.
    Open Admin panel, Localization tab, select needed language (English , for example) and search for "CommonApplicationLoading" setting. Set needed value.
  - Application name can be changed in the application settings. It used as basic auth realm (if it not specified explicitly with BasicAuthenticationRealm setting).
    Also can be used for the template of the letter with public links.
    Open Admin panel, Settings tab, and search for ApplicationName setting. Set needed value.

- ### Put your logo

  You can set your own logo on the login page, on the top of the main User Interface or on the top panel.
  1. To change logo on the top panel, modify the LogoHeaderHtml parameter at Application settings.
     Note. If you insert an image, in its' html style tag, make sure you specify the sizes in pixels: style="width:Wpx;height:Hpx;".

  2. To show the logo on the toolbar, add "Logo" to the ToolbarButtons1 or ToolbarButtons2 parameters at Application settings.

     To modify logo (set your own image):

     - Place the logo image in the HTCOMNET\Scripts\ folder.
     - Open the file HTCOMNET\Styles-min.css in Notepad and find the ".x-logo-icon" style. Set your image width and height at the width and height parameters (by default: .x-logo-icon{width:147px !important;height:25px !important}). Save the file.
     - Open the file HTCOMNET\Scripts\Main.js in Notepad. Find the "logoBtn=config.logoBtn||{url:"",tooltip:"Your logo or link",icon:"Scripts/logo.png",showInNewWindow:false}" string. Set the URL for the logo button (set empty value if it is not a link), tooltip and icon image file name. Save the file.

- ### Background image of login page

  You can change background image of the login page to your own image.
  To do that simply replace the file images/bg.jpg with your own image file.
  Or change the link to background image in styles-min.css file . Open this file in a editor and search for following line :

      .login-bg{background-image:url(images/bg.jpg);background-position:top center;background-size:cover;min-height:100%}

  Change images/bg.jpg to path to your custom image file.

- ### Themes

  HTTP Commander distributed with several predefined themes.
  In a distribution kit there are 9 additional themes gray, access, extbuilder.dynalias.com-example,
  azzurra-black, azzurra-blue, azzurra-gray, azzurra-green, azzurra-orange, azzurra-red.
  Open Admin panel, Settings tab, and search for StyleThemeName setting. Select needed value.

- ### Welcome message

  You can use welcome message to show some notices to users when they logs into applicaiton.
  Open Admin panel, Settings tab, and search for WelcomeWindowMessage setting. Set needed value.
  Additonally you can allow users to hide this message for next logon with setting WelcomeWindowAllowHideOnNextLogon.

- ### Branding of public links page

  In current version there is three settings to customize public link page.
  The first setting allow to set custom html code on the top of the public link page. You can use it to add your logo and brand name to public link page.
  Open Admin panel, Settings tab, and search for PublicLinkLogoHeaderHtml setting. Set needed value.
  The second setting ExpandUploadFormWhenOpenPublicFolder allows you to control whether the file upload panel is collapsed or expanded when the public folder is opened (if it is allowed to upload it). Default - collapsed.
  And finally, the third (additional) setting ShowExpirationDateForPublicLink, allows you to display or hide the expiration date of the link. The default is displayed.
  See also, how to branding of e-mail for sending public links.

- ### MSOFBA login page

  When MSOFBA support is enabled (true by default), then MS Office will display html login form when document is opened. There are several settings to configure this login page:
  1. MSOFBAloginPageBackgroundImage - configure background image.
     Open Admin panel, Settings tab, press on "Show advanced parameters" and search for MSOFBAloginPageBackgroundImage setting. Set needed value.
  2. MSOFBAloginPageCaption - login page caption
     Open Admin panel, Settings tab, press on "Show advanced parameters" button and search for MSOFBAloginPageCaption setting. Set needed value.

- ### Default.aspx and Logout.aspx

  These page are with open source code. You can edit them for your needs. Feel free to change layout of UI elements, style and action handlers.
  1. Default.aspx - This file is responsible for Forms and Windows authentication and loading of main/mobile interface.
     Also this file contain registration form, password/username remind form, second step auth form.
  2. Lougout.aspx - The file controls user logout process.

- ### Email templates

  HTTP Commander can send several types of the email notifications to users and administrators.
  You can change email subjects and messages. For example, you can include your company name to the subject and company logo to the message body. Here are settings (Admin Panel -> Settings tab) related to customization of email notifications:
  - EMailFromName - Common setting to set "From" name in the email (Used in "Send email", "Watch for modifications" and all other email notifications).
    Default value is "Web files manager".
  - TplForAddUserNameToDisplaySenderNameWhenSendEmail - Template string added to the "From" name of the email message when user send email from HTTP Commander using "Share" -> "Send mail" feature. Does not applies to notification emails.
    Default value is "Email from {0}".
  - MailSubjectOfWatchedChanges - Subject of mails with notification of changes observed for files, folders.
    Default value is "Information about the file, folders changes".
  - PublicEmailTemplate.html file in the folder App_Data from the root of the application (or localized with a two-letter language name, for example: PublicEmailTemplate-de.html file for German language) used to branding of e-mail when sending public links (if enabled AllowSendPublicLinks parameter).
    For branding e-mail with public links, edit the file PublicEmailTemplate.html (or create such a file if it does not exist; by default this file is exist). You can immediately create (or use an already existing) localized file by adding a suffix with a two-letter language name, for example "-fr", "-de", "-ja" (for English, the suffix "-en" is not necessary). By default, there are already such files for the German language (suffix "-de"), French ("-fr"), Italian ("-it"), Spanish ("-es") and Russian ("-ru").
    This file is a plain HTML document that you can edit in notepad or in another code editor with a syntax highlighting. In addition, you can use the following list of variables to substitute values:
    - {Owner} The name of the owner (display user name), the one who created the public link.
    - {OwnerEmail} The e-mail address of the owner, if it was specified in the Sender email field when sending the letter.
      Can be used if you want to insert a link of the form <a href="mailto:{OwnerEmail}">{Owner}<a> to reply.
    - {OwnerEmailInfo} Information about the sender's address, if his mail was specified.
      The text of this information is taken from the localized value ServerSendEmailInfo.
      By default, it is added at the end of the message.
    - {ApplicationTitle} The value is taken from the localized string CommonMainTitle.
      See Application name, title, loading text section.
    - {ApplicationName} The value is taken from the parameter ApplicationName.
      See Application name, title, loading text section.
      The default value is HTTP Commander.
    - {ApplicationUrl} Your HTTP Commander application URL address. See parameter DomainName. By default it is placed at the bottom of the e-mail message.
    - {RelativeLogoUrl} Relative URL to the icon with logo image - has a constant value Scripts/logo.png.
      When you send a message, these logo will be included as attachments and instead of this url, values ​​like "cid:logo.png" will be substituted.
    - {ResourceName} Shared file or folder name.
    - {RelativeTypeIconUrl} Relative URL to the icon with the type of shared resource. If this is a file, the value Images/24/file.png is substituted, otherwise - Images/24/folder.png.
      When you send a message, these icons will be included as attachments and instead of these links, values ​​like "cid:file.png" (or "cid:folder.png") will be substituted.
    - {Url} Url of anonymous link. In most cases, this is the full address (with AnonymousDownload.ashx), or a short address (like https://goo.gl/CijCgW), if you only use short links (PublicLinksViewType = OnlyShortUrl) and short address generated.
    - {ShortUrl} Short Url an anonymous link, like https://goo.gl/CijCgW.
      If short links are disabled (PublicLinksViewType = OnlyLongUrl) or when sending a message, there is no short link, then an empty string will be substituted and additionally for the variable {NoShortUrl} - the value of

           style="display:none!important;"

    - {ShortOrFullUrl} If there is a short URL, then it will be substituted, otherwise it will be full.
    - {ExpirationDate} The expiration date of the anonymous link in the format m/d/yyyy or d/m/yyyy.
    - {Notes} Notes specified in the Note for users field if the link to the folder.
      If an anonymous link to a file or a note was not specified, an empty value is substituted, and instead of the variable {NoNotes} the value is substituted:

           style="display:none!important;"

    - {ThemeBackColor}, {ThemeBorderColor}, {ThemeFontColor} The color of background, borders and font respectively, depending on the theme (specified in the setting StyleThemeName). By default, the following values ​​are used (from the blue theme):
      {ThemeBackColor} = #1566aa
      {ThemeBorderColor} = #1461a1
      {ThemeFontColor} = #ffffff
      In the default template, these colors are used for the "Open" button, which opens an anonymous url link in the variable {ShortOrFullUrl}.
    It is also possible to specify relative URLs to PNG images from the following folders in the root of the application:
    Images/, Images/24/, Images/48/, Images/ext/16, Images/ext/32, Images/ext/96. In this case, the file must exist and its name should contain only Latin characters, numbers, hyphens. For example, you can place an image in the email template:

        <img src="Images/hclogomin.png" />

    In this case, when sending a message, this picture will be added to the attachments and instead of src value - the value cid:hclogomin.png.
    The default template for English is as follows:

        <div style="width:100%;padding:24px 0 16px 0;background-color:#f5f5f5;text-align:center">
            <div style="display:inline-block;width:90%;max-width:680px;min-width:280px;text-align:left;font-family:Roboto,Arial,Helvetica,sans-serif">
                <div style="border-bottom:1px solid #f0f0f0;border-right:1px solid #f0f0f0">
                    <div style="padding:24px 32px 24px 32px;background:#fff;border-right:1px solid #eaeaea;border-bottom:1px solid #eaeaea" dir="ltr">
                        <div style="font-size:14px;line-height:18px;color:#444">
                            <a href="mailto:{OwnerEmail}" style="color:inherit;text-decoration:none" target="_blank">
                                {Owner} (via {ApplicationTitle})
                            </a> has invited you access to the following shared resource:
                        </div>
                        <div style="height:10px"></div>
                        <div style="font-size:18px;display:table">
                            <div style="height:16px"></div>
                            <div style="display:table-row;border-bottom:4px solid #fff">
                                <span style="display:table-cell;padding-left:12px">
                                    <img src="{RelativeTypeIconUrl}" alt="" style="vertical-align:middle;max-width:24px" />&nbsp;&nbsp;<a target="_blank" href="{Url}">
                                        {ResourceName}
                                    </a><br />
                                    <span style="font-size:0.6em">(<a target="_blank" href="{Url}">{Url}</a>)</span>
                                </span>
                            </div>
                            <div {NoShortUrl}>
                                <div style="height:16px"></div>
                                <div style="display:table-row;border-bottom:4px solid #fff">
                                    <span style="display:table-cell;padding-left:12px">
                                        <a target="_blank" href="{ShortUrl}">Alternate link</a>
                                        <br /><span style="font-size:0.6em">(<a target="_blank" href="{ShortUrl}">{ShortUrl}</a>)</span>
                                    </span>
                                </div>
                            </div>
                        </div>
                        <div style="height:16px"></div>
                        <div style="height:1px;background-color:#eee"></div>
                        <div style="height:24px"></div>
                        <div style="display:table-row">
                            <span style="display:table-cell;vertical-align:top;padding-left:16px;font-size:13px;line-height:18px;max-width:496px;color:#262626">
                                Valid until <strong>{ExpirationDate}</strong>
                            </span>
                        </div>
                        <div {NoNotes}>
                            <div style="height:16px"></div>
                            <div style="display:table-row">
                                <span style="display:table-cell;vertical-align:top;padding-left:16px;font-size:13px;line-height:18px;max-width:496px;color:#262626">
                                    {Notes}
                                </span>
                            </div>
                        </div>
                        <div style="height:24px"></div>
                        <div style="height:1px;background-color:#eee"></div>
                        <div style="height:16px"></div>
                        <div>
                            <a href="{ShortOrFullUrl}" style="background-color:{ThemeBackColor};border:1px solid {ThemeBorderColor};border-radius:2px;color:{ThemeFontColor};display:inline-block;font-family:Roboto,Arial,Helvetica,sans-serif;font-size:11px;font-weight:bold;height:29px;line-height:29px;min-width:54px;outline:0px;padding:0 8px;text-align:center;text-decoration:none" target="_blank">
                                Open
                            </a>
                        </div>
                    </div>
                </div>
                <table style="padding:14px 10px 0 10px" role="presentation" dir="ltr">
                    <tr>
                        <td style="width:100%;font-size:11px;font-family:Roboto,Arial,Helvetica,sans-serif;color:#646464;line-height:20px;min-height:40px;vertical-align:middle">
                            You have received this email because someone shared a resource with you from {ApplicationName}.
                            {OwnerEmailInfo}
                        </td>
                        <td style="padding-left:20px;vertical-align:middle">
                            <a href="{ApplicationUrl}" target="_blank">
                                <img src="{RelativeLogoUrl}" alt="{ApplicationName}" border="0" style="max-height:20px;min-width:96px;" />
                            </a>
                        </td>
                    </tr>
                </table>
            </div>
        </div>

    Screenshots

  Here are localization parameters (Admin Panel -> Localization tab) related to customization of email notifications.
  To change value of localization parameter: login under admin account, open AdminPanel, Localization tab, select needed language from dropdown box and search (Ctrl+F) for needed parameter.
  Here we list parameters with default values for English localization.
  - AnonymousSendEmailSubject - Subject of email with information about public link visitor activity.
    Default value is "Visitors activity of public folder".
  - AnonymousSendEmailUploadBody - Body of email with information about public link visitor activity.. Default value is "The following files were uploaded to your public folder {0}:{1}.".
  - AnonymousSendEmailDownloadBody - Body of email with information about public link visitor activity.
    Default value is "The file {0} was downloaded from your public folder {1}.".
  - AnonymousSendEmailZipDownloadBody - Body of email with information about public link visitor activity.
    Default value is "The whole content of public folder {0} was downloaded in a ZIP archive.".
  - ServerEmailMsgProcessedFilesSubject - Subject of email with information about users activity.
    Default value is "Uploaded/Modified/Downloaded/Created/Deleted/Shared files/folders".
  - ServerEmailMsgUploadFilesTitle - String template for action.
    Default value is "uploaded".
  - ServerEmailMsgModifyFilesTitle - String template for action.
    Default value is "modified".
  - ServerEmailMsgDownloadFilesTitle - String template for action.
    Default value is "downloaded".
  - ServerEmailMsgCreateFilesTitle - String template for action.
    Default value is "created".
  - ServerEmailMsgDeleteFilesTitle - String template for action.
    Default value is "deleted".
  - ServerEmailMsgCreatePublicFilesTitle - String template for action.
    Default value is "shared".
  - ServerEmailMsgProcessedFilesBody - Body of email with information about users activity.
    Default value is "The following files/folders were {0} by {1}:{2}.".
  - ServerEmailMsgPasswordRecoverSubject - Subject of email for password recovery.
    Default value is "Password recovery".
  - ServerEmailMsgPasswordRecoverBody - Body of email for password recovery.
    Default value is "You requested to recover your password in Web File Manager. Your password was reset. If you believe this is an error, simply ignore this letter, but be aware that your password has been changed. User name: {0} New password: {1}".
  - ServerEmailMsgUserNameRecoverSubject - Subject of email for username recovery.
    Default value is "Username recovery".
  - ServerEmailMsgUserNameRecoverBody - Body of email for username recovery.
    Default value is "You requested to recover your name in Web File Manager. User name: {0}".
  - ServerEmailMsgUserActivationSubject - Subject of email for user activation.
    Default value is "Account activation".
  - ServerEmailMsgUserActivationBody - Body of email for user activation.
    Default value is "Account ({0}) activation is required. To activate your account, please click on the following link: {1}".
  - ServerEmailMsgUserRegisteredSubject - Subject of email for user registration.
    Default value is "User registered".
  - ServerEmailMsgUserRegisteredBody - Body of email for user registration.
    Default value is "You are successfully registered in Web File Manager. User name: {0}".
  - ServerEmailMsgUserRegisteredForAdminsBody - Body of email sent to administrator about user registration .
    Default value is "<h4>New user has been registered</h4> <strong>User name</strong>: {0}<br /> <strong>Email</strong>: {1}<br /> <strong>Date</strong>: {2}<br /> <strong>Extra info</strong>: {3}<br />".
  - ServerSendEmailInfo - String added to the message body of email sent by the user from the application (Share->Send Emmail).
    Default value is "Author specified their email as {0}. Use ONLY this email address to reply.".