Can I customize the Web Transfer Client Web page?

Expand / Collapse
 

Can I customize the Web Transfer Client Web page?


THE INFORMATION IN THIS ARTICLE APPLIES TO:
  • EFT Server 6.x
  • EFT Server Enterprise 6.x
  • EFT Server 5.x
  • Secure FTP Server 3.x
  • For informationg about customizing the WTC in version 6.1, refer to Rebranding the Web Transfer Client in the EFT Server version 6.1 online help.
SYMPTOM

Can I customize the Web Transfer Client Web page?

 

RESOLUTION

If you are comfortable editing CSS and HTML pages, the Web Transfer Client (WTC) can be easily customized to suit your needs. For example, you can edit the colors and fonts in the style sheet, and you can replace the EFT Server logo (header.gif) with your own company's logo of the same size. The appearance of the Web Transfer Client is controlled by the style sheet, EFTStyles.css. The image files can be substituted with your custom images. Before you make any changes, make a backup copy of the style sheet. (For detailed instructions for editing CSS files, refer to http://www.w3.org/MarkUp/Guide/Style.) The Web Transfer Client Web page is hard coded in the EFT Server code; however, you can add a registry key that will use an edited version of the Web Transfer Client Web page called EFTWebClient.htm.

If you lack the resources to edit CSS and HTML pages yourself, GlobalSCAPE's Professional Services group can create a custom Web Transfer Client Web page for you.

The EFT Server code that creates EFTWebClient.htm differs between versions; therefore, if you copy EFTWebClient.htm from one version to the next, you might not get the same results. Be sure to keep track of the changes you have made to the files (i.e., comment your code) and merge your changes into the next version when you upgrade. Tools such as Beyond Compare (by Scooter Software) or WinMerge (Open Source) can come in handy for porting custom changes over to new versions.

The default location of the Web Transfer Client files is C:\Program Files\GlobalSCAPE\EFT\EFTClient in EFT Server 5 and prior; the path was changed in EFT Server v6 to C:\Program Files\GlobalSCAPE\EFT Server\Client.

The EFTWebClient.htm file is not installed when you install EFT Server; you must contact GlobalSCAPE Technical Support to get a copy of the file for your specific version. EFTWebClient.htm is not used by default; you have to create a registry key to "tell" EFT Server to use that file. (Otherwise, the hard-coded version is used.)

To use EFTWebClient.htm

  1. Get a copy of EFTWebClient.htm from GlobalSCAPE Technical Support.

  2. Make your changes to the file, then save a copy, then paste it into the EFT Server installation folder's Client or EFTClient subfolder.

  3. Create the "http-applet:/EFTClient/EFTWebClient.htm" registry entry for the customized WTC page and set the value to be the physical path to the new file. You can add the key to a .reg file in the following format:

    Windows Registry Editor Version 5.00

    [HKEY_LOCAL_MACHINE\SOFTWARE\GlobalSCAPE Inc.\EFT Server 4.0\EFTClient]

    "use_registry"=dword:00000001

    "http-applet:/EFTClient/EFTWebClient.htm"="C:\\Program Files\\GlobalSCAPE\\EFT\\EFTClient\\EFTWebClient.htm"

    --Be sure to provide the correct path to the EFTWebClient.htm file.--

     

    ****On a 64-bit OS, the path is:

    [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\GlobalSCAPE Inc.\EFT Server 4.0\EFTClient]

    (Refer to http://kb.globalscape.com/article.aspx?id=10505 for more WTC-specific keys.)

  4. Stop and start the EFT Server service for your changes to take effect.

  5. Open the WTC page in your browser to confirm that the changes you want are there.

EXAMPLE

 

To edit the logout text in EFTWebClient.htm

You can edit the text that appears after a user has logged out of the Web Transfer Client to add to or remove the existing text:

  1. In EFTWebClient.htm, find the following line that handles the "logout" button:

    <td>

    <img src="/EFTClient/btnLogout.gif" id="btnLogout" name="btnLogout" onclick="doLogout(); showLogoutPage();" value="Logout"/>

    </td>

  2. "showLogoutPage()" is a javascript function that writes the logout page to the browser window. The function is found in EFTWebClientLogic.js, but you can make your own function inside EFTWebClient.htm to call instead of the default one. Update the line mentioned in step 2 to point to a new function as shown below (change in red text):
    <td><img src="/EFTClient/btnLogout.gif" id="btnLogout" name="btnLogout" onclick="doLogout(); showLogoutPage_New();" value="Logout"/></td>

    Add a new function to the "javascript" portion at the top of the page (between the <head> tags), making a function that reads as follows (you can edit the displayed text as you please, shown in red text below):

  3.  

    <script language="javascript">

    function showLogoutPage_New()
    {

    document.write("<html xmlns=\"http://www.w3.org/1999/xhtml\">");
    document.write("<head>");
    document.write(" <title>WTC Logged out</title>");
    document.write(" <meta http-equiv=\"Content-Type\" content=\"text/html; charset=UTF-8\">");
    document.write(" <title>GlobalSCAPE&reg; EFT Web Transfer Client</title>");
    document.write(" <link href=\"/EFTClient/EFTStyles.css\" rel=\"stylesheet\" type=\"text/css\">");

    document.write("</head>");
    document.write("<body>");
    document.write("<br/><br/><br/><br/>");
    document.write("<hr color=\"#000000\" size=\"1\"></hr>");

    document.write("<table align=\"center\" border=\"0\" style=\"position:relative;top: left: 0px;\" >");
    document.write("<tr><br>");
    document.write("<td valign =\"middle\">");

    document.write("<strong>You are now logged out.</strong><br>");
    document.write("Directory listings and other screens may be retained by<br>");
    document.write("your browser's history. We recommend you delete<br>");
    document.write("temporary files if extremely sensitive data is involved.<br><br>");

    document.write("<strong>Security notice:</strong><br>");
    document.write("When logging on to this server, we will never<br>");
    document.write("ask for any personal information other than <br>");
    document.write("your account login name and password.<br><br>");

    document.write("If you are ever prompted for additional personal<br>");
    document.write("information upon attempting to log in, please<br>");
    document.write("contact the server administrator.<br>");

    document.write("</td>");
    document.write("</tr>");
    document.write("</table>");
    document.write("</body>");
    document.write("</html>");
    document.close();

    }

    </script>

  4. Save your changes and paste EFTWebClient.htm into the EFT Server installation folder's EFTClient subfolder.
  5. Stop and start the EFT Server service for your changes to take effect.
  6. Open the WTC page in your browser to confirm that the changes you want are there.
  7. Logout to ensure the logout text that you want appears correctly.


Rate this Article:
     

Add Your Comments


Name: *
Email Address:
Web Address:
   
  
 
 
   
Verification Code:
*
 

Details
Last Modified:Friday, March 12, 2010
Last Modified By: GlobalSCAPE 5
Type: HOWTO
Rated 2 stars based on 9 votes.
Article has been viewed 3,398 times.
Options