Using the File List Manager

File List Manager is a tool for easy automation of common encryption tasks. If you need to encrypt periodically the same set of files, you can add them to an encryption file list. Then you can encrypt all files in the list with a few clicks!
You can specify a different set of individual protection options for each file in the list.
All options available in the main HTML Guardian window can be set from the File List Manager for each file individually (with a few exceptions listed below).

You can open the File List Manager from the 'Tools' menu, or by pressing the CTRL + L shortcut.
If you are creating a new list, select a Default Save Location first from the four available options. This is only for convenience, the folder and the filename for saving each file can be changed later.
Default Save Location options are:

- Same folder, same name - encrypted file will overwrite the original file. Please be careful, use this option only if you have backups of the original files.

- Same folder, add ... to the filename - will change the filename of the encrypted file. If for example you enter _E in the box, the encrypted version of index.htm will be saved as index_E.htm in the same folder.

- ... subfolder of the file folder - will create a subfolder with the specified name in the folder of the original file and will save the encrypted file there, with the same filename as the original. If for example you enter Encrypted in the box, the encrypted version of C:\Test\index.htm will be saved as C:\Test\Encrypted\index.htm

- Put all encrypted files from this list in one folder - checking this option will open a 'Select Folder' dialog. All encrypted files will be saved in the selected folder with the same filenames.

Click the Add File(s) button to add new files to the list.
Hold down Ctrl or Shift keys to add multiple files at once.
New files are added at the top of the list.
After adding one or more files, you can change the Default Save Location option - new files will be then added to the list using the new Default Save Location specified.
When you add all the files you want to the list, you can change the Save Location and the protection options for each file by double clicking the appropriate cell.
When ready, save the list. Lists are saved with .hgl extension.

If you can't see the whole text in some cell, just click it once - the full text will be displayed in the status bar at the bottom of the File List Manager window.

To open an existing file list for editing and/or encryption, click the Open List button.
To remove a file from the list, select it (click once inside any cell from the same row) and click the Remove File button.

Options not supported in File List Manager :

Only compress code and Disable Syntax check options are not supported (almost all HTML Guardian syntax checkers and code validation tools are disabled when a file list is encrypted).
Scramble Non-ASCII characters option can't be set for each file individually. It is possible to use it, but for all files in the list. To do this, minimize the File List Manager window and check the 'Scramble Non-ASCII characters' box in the main HTML Guardian window, then restore the File List Manager window and click the Encrypt List button. This setting is not stored in the file lists - you need to check this box each time before encrypting a file list if you want to use this option.

All other options are fully supported. You can also add files containing partial encryption tags to the file lists.

Some important notes :

- if the destination file (in the Save Encrypted File As column) already exists, it will be overwritten without prompt. Make sure you have a backup!

- almost all HTML Guardian syntax checkers and code validation tools are disabled when a file list is encrypted. If you have problems with some encrypted file, encrypt the original again individually, not from a file list.

- File List Manager does not validate the settings you enter, it will accept any setting for each file type. However all restrictions are valid when files from the list are encrypted, which means some protection options may not be applied for some files even if they are specified in the file list. For example no Password Protection will be added to encrypted .asp files, no 'Disable Right click' or 'Disable Text selection' protection will be added to frameset files etc, even if they are specified in the file list.

HTML Guardian command line reference

HTML Guardian command line syntax has the following structure :

htmlg.exe inputfile, outputfile, [switch1], [switch2], [switch3] ...... Note that comma ( , ) is used to separate the options.

htmlg.exe - required. The name of the main HTML Guardian executable.
inputfile - required. The full path to the file you want to encrypt, like C:\MySite\index.htm
outputfile - required. The path for saving the encrypted inputfile, including filename, like C:\MySite\Encrypted\index.htm

Important: outputfile parameter must be a valid path, it should point to an existing folder. In the example above, the folder C:\MySite\Encrypted\ must exist. If the outputfile parameter is invalid (points to a non-existing folder), the file will not be encrypted, it will be skipped.
If inputfile and outputfile parameters are the same, HTML Guardian will overwrite the original file with the encrypted file without prompting! Please be careful!


All switches are optional, and are described below:

IE5 - use alternative encryption method(for IE 5+ only). If omitted, the default method(for all browsers) will be used.
R - disable right click
L - don't show links in status bar
T - disable text selection
O - prohibit offline use
N - disable page printing
C - disable clipboard & print screen (this option will only work for IE 5+ browsers)
M - encrypt Meta tags.
P@password@redirection - set the password for the page and a redirection URL in case of incorrect password.
 password - the password that the visitor must enter to see the page.
possible values for the redirection part are:
 blank - will display a blank page.
 back - will turn the visitor back to the previous page visited.
 any valid URL, like http://www.protware.com - will redirect the visitor to this url in case of incorrect password.
F@referrer@redirection - set the scope of URL's allowed to link this page, and a redirection URL in case the page is linked from another place.
 referrer - a string that identifies the sites allowed to link this page. Normally that would be your domain name, like protware or protware.com - in this case the protected file can be linked only from within your domain. You may also include a filename here, like http://www.protware.com/features.htm, or just protware.com/features.htm - in this case, the protected file can be linked from the specified file only.
possible values for the redirection part are:
 blank - will display a blank page.
 any valid URL, like http://www.protware.com - will redirect the visitor to this url in case of incorrect password.

Batch file example:

htmlg.exe C:\Test\index.htm, C:\Test\Encrypted\index.htm, R, L, O, P@123@back
htmlg.exe C:\MySite\test.htm, C:\Test\test.htm, IE5, R, T, F@protware@blank

Copy the two lines above, paste them in any text editor, and save the file in HTML Guardian's installation folder with a .bat extension, like filelist1.bat. Then just double click this file to start encryption.

   © 1997-2023, ProtWare Inc. All rights reserved.