- All settings of Windows and Firefox described below need to be configured on each computer on which you want this feature to be enabled.
- All settings of XTRF described below need to be configured for each XTRF user who would like this feature.
Settings to be Pre-Configured in Windows
Your server's XTRF Home Directory, which is the location where XTRF stores your files, needs to be mapped via your local network to a local virtual drive. The path of the XTRF Home Directory on your server can be found in Advanced Configuration, referred to as the System Home Directory.
The instructions on how to map a network location to a local drive can be found here:
- Create a shortcut to (map) a network drive (Windows 7)
- Create a shortcut to (map) a network drive (Windows 8 and RT)
For the purpose of this article, let us assume that the XTRF Home Directory is E:\XTRF_data and that you mapped it to drive X:. As a result, the content of the E:\XTRF_data folder on your server is displayed whenever you open drive X: on your computer. Now you can map XTRF paths so that it always uses X: wherever E:\XTRF_data is used.
Settings to be Configured in XTRF
- Go to System > Preferences > Directories Mapping. These settings allow all system paths to be transformed from server-based into locally recognized ones.
- A table with two columns, Server Side Directory and Local Directory, displays all the current mappings.
- The Server Side Directory should be the same as what you entered for System Home Directory in Advanced Configuration.
- For Local Directory, enter the local path to the mapped directory from the server.
- Make any necessary modifications.
To add new mappings, enter them into the appropriate field and then click. For example, set E:\XTRF_data as the Server Side Directory and X: as the Local Directory.
Please note that both Server Side Directory and Local Directory should end with a slash (for Linux paths) or backslash (for Windows paths).
- To remove any unnecessary mappings, click next to the desired item.
- Click .
Settings to be Configured in Firefox
- Open about:config
- Right-click on the list.
- Select New / Boolean
- Enter the following string name: network.protocol-handler.expose.file
- Set the value to false.
- Close all Firefox windows.
- Open the prefs.js file. The location of the file is:
- for Windows Vista and 7: C:\Users\[YOUR_USER_NAME]\AppData\Roaming\Mozilla\Firefox\Profiles\[YOUR_PROFILE_NUMBER].default\
Add the following lines and save the file:
Replace YOUR_XTRF_ADDRESS with the proper URL address, e.g. http://xtrf.yourcompany.com/
Settings to be Configured in Windows
If you place the files in a different folder, you must edit the REG files and change the path leading to the BAT file. Remember to use double backslash in your path (like in the default path).
Check if xtrfdir.bat contains correct paths to the applications:
EXPLORER_PATH should point to Windows Explorer executable (explorer.exe)
TOTALCMD_PATH should point to Total Commander executable (TOTALCMD.EXE)
Setting the path to Total Commander is optional. Use it only if you have Total Commander installed on your system and you want to use it to handle XTRFDIR links.
If you want the links to be opened in Windows Explorer, run xtrfdir_explorer.reg. If you want the links to be opened in Total Commander, run xtrfdir_totalcmd.reg. You will then be asked to confirm the modifications to the Windows Registry.
- When you first open an xtrfdir:// link in your browser, you will be prompted to confirm the use of the new protocol. Click "Accept".
- To change application used by the XTRFDIR protocol afterwards, run a different REG file.