Alternate Toolbar and Animation Graphics

PWB can display alternate graphics for all the Toolbars, and the Working Animation.
Toolbars
To specify alternate graphics for the toolbars, PWB uses a naming convention in the “ToolBarIconFolder” to change the graphics. The graphics in the “ToolBarIconFolder” are single files that are either Bitmaps or Icons. The naming convention follows the [Buttons] section key names except for the “popup” button which needs to graphics, one for “popup-on” and one for “popup-off”, and does not include the separators. There are three states to the buttons and each button can any or all the state graphics created. The three states are “Enabled”, “Hot”, and “Disabled”. The only state graphic file that needs to be present to change the default button graphic is the enabled graphic which is a bitmap or icon file in the tool bar icon folder with the name of the button from the [Buttons] section of the INI file.
For example to change the “Forward” button graphic, create a bitmap or icon file called “forward” and place it in the toolbar icon folder.
This will change the PWB Forward button graphic to the file you created for all three states. To change the other state graphics of the button, create the graphic and append n “-d” for the disabled state, and a “-h” for the hot state, onto the file name.
For example if we are using icon type files and are changing the three states for the “Forward” button graphics, we would need to create three icons with the following names.
Forward.ico
Forward-d.ico
Forward-h.ico
These three files when placed in the PWB toolbar icon folder will change the forward button graphic.
You can use both bitmap and icon graphics, the icon type files, although more difficult to create, tend to yield better results.
Working Animation
To change the working animation file, create an un-compressed AVI file and specify the file in the PWB [Files] WorkingAnimation key. You should use the full path to the file to ensure PWB is able to find the file.
For example, if you created an AVI file called “working.avi”, and placed it in the C:\PWB\Grpahics folder; you would set the working animation key to the following.
[Files]
…
WorkingAnimation=C:\PWB\Graphics\working.avi
…
If the working animation is not specified PWB will use the default built in working animation.
PWB Advanced Configuration
It is possible to override the INI settings or to run PWB without an INI file by specifying the settings in the Windows Registry. This is accomplished by adding the corresponding INI setting as a String type to the following Windows Registry key. Each setting can be specified in any of the listed Locations. With settings in multiple locations, the last location will take precedence, see list below. The “Key” and “Value” below correspond to the Section and key information in the INI file.
Example:
[Browser] HomePage=
HKEY_CURRENT_USER\Software\TeamSoftware Solutions\Public Web Browser v2\Browser\HomePage
Configuration information will be read from the following location in this order.
1. Normal PWB INI file.
2. HKEY_LOCAL_MACHINE\Software\TeamSoftware Solutions\Public Web Browser v2\”Key”\”Value”
3. HKEY_CURRENT_USER\Software\TeamSoftware Solutions\Public Web Browser v2\”key”\”Value”
PWB INI file settings:
The INI is organized in a series of sections enclosed in brackets “[]”, followed by keys with values for the configuration options. There are two basic keys, ones that can be True or False, and ones that are string values. The True/False keys either turn the option on or off. For instance, setting the following will cause the WebMail button not to be displayed on the toolbar.
[Buttons]
…
WebMail=False
…
The string value keys rename or replace the PWB option. Here are some examples of string value keys.
Change title of browser:
[Browser]
…
Title=Our Library
…
Change Policy file location to UNC path:
[Files]
…
PolicyFile=\\Server\Share\Folder\Policy.txt
…
Other more advanced settings can be True, False, string value, or “NoText”. In this case the options have four states, on, off, rename, or have not text displayed.
For example, setting the following will cause the Help menu item “Policy”, to be “Our Policy”.
[MenuItems]
…
HelpPolicy=Our Policy
…
This setting will cause the search button to have not text. This is useful if you are using the Toolbars Button Text Right setting.
[Buttons]
…
Search=NoText
…
The different key states will be pointed out in the key explanations.
INI keys explanations.
[AutoRegister]
Auto register allows PWB to get your site license registration information from an online database and enter it into your INI file. You INI file will need to have write access for the currently logged on user for this to work.
The AutoRegister key is by request only.
· RegisterKey=
o Unique key used to allow PWB to auto register from on online database.
o Please request auto register key from support@teamsoftwaresolutions.com
· RegisterPassword=
o User supplied auto register password.
· RegisterDaysLeft=30
o Number of days left before current registration expires before PWB checks for a new registration number.
o After PWB receives the new registration number, it will wait until the new registration number has the number of days left before checking again.
· RegisterSeconds=15
o Number of seconds PWB will wait for the online database to answer request.
· RegisterShowWindow=False
o Show PWB registration window when requesting new registration number.
· UseWindowsRegistry=False
o Causes PWN to enter registration information into Windows registry instead of the PWB INI file.
o Can be used when you prefer to have the INI file read only.
· RegisterDelayClose=False
o Prevents the auto registration dialog from closing.
o Used mainly for debugging database problems.
[Browser]
General browser settings section
· RegisteredTo=Unregistered
o Name of company that PWB v2 was licensed to.
· RegistrationNumber=
o Registration number provided by TeamSoftware Solutions to license PWB.
o This number will need to be updated when your registration number expires.
o PWB uses this to track INI versions, normally should not be changed.
Title=Public Web Browser v2
o Change to set title of browser window, displayed after the URL in title bar.
o Change to true to open PWB in kiosk mode.
o Kiosk mode opens PWB full screen without command bar and covering Windows Start button and task bar.
o Change to true to open PWB in desktop mode.
o Desktop mode PWB opens full screen with out toolbar, status bar, or title bar to a web page, then opens a secondary window to home page.
o Opens to desktop file in the file section.
o All links click on desktop file are opened in new windows.
o Change to set home page of browser.
CommandLineHomePage=False
o Set to True to set the page specified in the command line to be the home page or set to false to use home page specified in the INI.
SearchPage=www.google.com
o Change to set search page of browser when search menu item or button is pressed.
WebMailPage=www.Hotmail.com
o Change to set Web Mail page of browser when Web Mail menu item or button is pressed.
o Change to set title of Address bar.
o Sets default font size.
o Sets send button to send link when clicked.
o Set to false to send file when clicked.
o Set to True to start PWB maximized or False to start PWB in a normal state.
o Sets parent browser to be always on top.
o If Secondary windows are always on top they will be on top of parent.
o Set initial height of browser parent window in pixels.
o Set initial width of browser parent window in pixels.
o Set initial top of browser parent window in pixels.
o Set initial left of browser parent window in pixels.
o Set to True to have menu bar or False to not have menu bar.
o Set to True to have tool bar or False to not have tool bar.
o Set to true to have shell bar or false to not have shell bar.
o Shell bar executes other programs via shortcuts in the shell bar folder.
o See shell bar file in the folders section.
o Set to True to have address bar or False to not have address bar.
o Set to True to have working animation or False to not have working animation.
o Set to True to have status bar or False to not have status bar.
o Set to True to have back button menu or False to not have back button menu.
o Set to True to show inactivity timer or False to not show inactivity timer on status bar.
o Set to True to show activity timer or False to not show activity timer on status bar.
o Set to True to show time of day on status bar or set to False to not show time of day on status bar.
ShowURLInBrowserCaption=True
o Set to True to show URL title in PWB caption or set to False to not show URL title in caption.
DisableMinimizeButton=False
o Set to True to disable title bar minimized button, set to False to enable minimize button.
o For parent window, see second window section for child windows.
DisableMaximizeButton=False
o Set to True to disable title bar maximized button, set to False to enable maximize button.
o For parent window, see second window section for child windows.
o Set to True to disable title bar close button, set to False to enable close button.
o For parent window, see second window section for child windows.
o Set to True to prevent parent window from moving, set to False to allow window to move.
o Set to True to disallow second windows, set to false to allow second windows.
DisableINIVersionCheck=False
o Set to true to disable PWB checking INI file version.
o PWB checks INI to make sure it is the same as the EXE.
o When PWB does not find a setting in the INI is uses a default setting.
o Set to True to disable the browser from exiting, set to False to allow exiting.
o This will not prevent the OS from killing the task via Task Manager.
o Confirms closing browser when exited.
· UseIEFavorties=False
o Use Favorites in IE Favorites folder
· ShowGoButton=True
o Show Go button.
· GoButtonText=Go
o Go button text.
· AlwaysOnBottom=False
o Sets browser to be bottom most window.
· ShellButtonIconWidth=
o Sets icon width of shell button icon.
· ShellButtonIconHeight=
o Sets icon height of shell button icon.
· DisableIESubClass=False
o Disables the IE subclassing to that prevents the IE window from blinking when resizing the window.
o This should be set to true only if you are using a custom control.
· ShowWindowRelation=False
o Displays the window indicator (Parent, Child) in the title bar.
· MainWindowIndicator=(Main)
o Indicator shown for parent window when show relation is true.
· ShowKioskBar=False
o Displays a kiosk bar on bottom of browser window.
· F1HelpPageURL=
o Navigates to this “Help” page when F1 is pressed.
· ShowSplashScreen=False
o Shows splash screen when PWB is starting.
· DisableAutoComplete=False
o Disables the Auto Complete for Forms and Passwords.
· ShellExecuteScripts=False
o Uses Windows Shell Execute to execute all scripts.
o Allows use of Shortcuts to script and executable files.
· OpenLinksInNewWindow=False
o Opens all links in main window in new windows.
· DisableCtrlEnter=False
o Disables Ctrl-Enter in the Address bar.
o When Ctrl-Enter is hit, “http://” and “.com” are added to text in address bar and the resulting URL is browsed to.
· SaveWindowPosition=True
o Saves PWB window location when PWB is closed, and opens PWB to this location.
· MinimizeMemoryUsage=False
o Minimizes the underlying Internet Explorer memory usage.
o Used primarily for terminal servers.
· StartTimersOnMouseKeyboard=False
o Starts PWB timers on Mouse or Keyboard movement as opposed to navigation in PWB.
· AddStationToUserAgent=False
o Adds the station environment variable prefixed with “PWB:” to the UserAgent String of Internet Explorer.
o Allows web servers to determine if PWB is being used.
o Can also be used to pass the station environment information to server.
· EnableAdvancedClose=False
o Enables advanced close.
o If you are having problems with PWB closing, enable this option.
· UpdateWindowOnTime=False
o Updates and redraws the PWB window once every second.
· RedrawWindowSeconds=
o Updates and redraws the PWB window every X seconds.
· ConfigRegLocation=
o Allows you to locate the PWB configuration anywhere in the Windows Registry.
o See the PWB Advanced Configuration above.
· DisableScrollBars=False
o Disables the scrollbars.
· MapContextPrintToButton=False
o Matches the context menu to the print button.
o Useful when preventing the Select Printer dialog.
· PreventHTMLClosingMainWindow=False
o Prevents HTML, JavaScript, from closing the main PWB window.
· AddressBarReadOnly=False
o Sets the address bar to read only.
· ShowAddressInBrowserCaption=False
o Shows URL address in browser title bar.
· MaximizeOnNonsizeable=False
o Maximizes window when window is set to non-resizable.
· SecureMode=False
o Start PWB in secure mode.
o Opens PWB alternate Windows Desktop.
o Prevents Task Manager from opening.
· HideCursor=False
o Hides Windows mouse cursor.
· ExitPage=
o Navigates PWB to URL indicated before exiting.
o Best used with Disable Exit.
· ShowSearchBar=False
o Shows Search bar edit box in Toolbar.
o Similar to Google search bar.
· SearchBarText=
o Search bar text label.
· SearchBarPage=
o Search bar search URL.
o Use %SEARCH% Marco in URL for text.
o Example: http://www.google.com/search?q=%SEARCH%
· StatusBarTimeFormat=
o Sets status bar time and date format.
o Example: %d-%b-%Y %I:%M %p
o See: http://msdn.microsoft.com/en-us/library/fe06s4ak.aspx
· StatusBarTimeWidth=
o Sets width of time slot in status bar.
· DefaultZoomLevel=
o Sets default zoom level.
[SecondWindow]
Secondary windows section
· AlwaysOnTop=False
o Set to True to cause all secondary windows to stay in front of parent window.
· LimitCount=
o Set to limit count of secondary windows to X number.
· DisableMinimizeButton=False
o Disables minimize button on secondary (child) windows.
· DisableMaximizeButton=False
o Disables maximize button on secondary (child) windows.
· DisableMoveWindow=False
o Disables moving of secondary (child) windows.
· DisableResizeWindow=False
o Disables resizing of secondary (child) windows.
· DisableTitleBar=False
o Disables title bar of secondary (child) windows.
· WindowHeight=
o Sets height of secondary (child) windows in pixels.
· WindowWidth=
o Sets width of secondary (child) windows in pixels.
· WindowTop=
o Sets top of secondary (child) windows in pixels.
· WindowLeft=
o Sets left corner of secondary (child) windows in pixels.
· NewPageAsHome=False
o Sets new page as home for secondary (child) windows.
· OpenInParentWindow=False
o Opens all pop-ups and new windows in the parent window.
o This may have undesirable results if used for general browsing.
· DisableUnrequested=False
o Disables un-requested pop-up windows.
o Only allows secondary windows opened with file open or new button.
· StartOnDesktopMode=False
o Start second window when using desktop mode
· OpenDesktopModeLink=True
o Opens new window on link click on Desktop mode page
· ShowTimers=False
o Show timers on secondary windows
· ShellBarURLNewWindow=False
o Links on shell bar will open in secondary windows
· DisableCloseButton=False
o Disable close on secondary windows
· ShowShellBar=True
o Show shell bar on secondary windows
· StartMaximized=False
o Starts all child windows maximized
· CloseChildrenOnClose=True
o Closes children windows of secondary windows when closed
· SecondWindowIndicator=(Secondary)
o Secondary (Child) window indicator.
o Displayed when [Browser] ShowWindowRelation is true.
· OpenInNewProcess=False
o Opens new PWB windows in separate process.
o Should only be used in special circumstances.
· ShowAddressBar=True
o Shows address bar in secondary windows
o Works independently of the [Browser] ShowAddressBar.
· ShowGoButton=True
o Shows go button in secondary windows
o Works independently of the [Browser] ShowGoButton.
· ShowKioskBar=False
o Shows kiosk bar in secondary windows
o Works independently of the [Browser] ShowKioskBar.
o See Kiosk bar section for button settings.
· ShowToolBar=True
o Shows Toolbar in secondary windows.
o Works independently of the [Browser] ShowToolBar.
· ShowMenuBar=True
o Shows Menu bar in secondary windows.
o Works independently of the [Browser] ShowMenuBar.
· ShowStatusBar=True
o Shows or hides status bar in secondary PWB windows.
· DisableShiftClick=False
o Disables Shift Click from opening secondary windows.
· OpenInFrame=
o Opens secondary in window is specified frame name.
o The current web page must contain a frame with the specified name for the secondary window to open in the named frame.
· ForceToFront
o Forces all child windows to front if main window has focus.
· ShowSearchBar
o Shows search bar on pop-up windows.
[ToolBars]
Tool bar options
· MenuBarGripper=True
o When true, menu bar has gripper and is moveable.
· ToolBarBreak=True
o When true, toolbar will be on new line.
· ToolBarGripper=True
o When true, menu bar has gripper and is moveable.
· ToolBarChevron=True
o When true, toolbar will have chevron drop down.
o ShellBarBreak=False
o When true, shell bar will be on new line.
· ShellBarGripper=True
o When true, shell bar has gripper and is moveable.
· ShellBarChevron=True
o When true, shell bar will have chevron drop down.
· AddressBarBreak=True
o When true, address bar will be on new line.
· AddressBarGripper=True
o When true, address bar has gripper and is moveable.
· MenuBarWidth=
o Sets minimum menu bar width in pixels.
· ToolBarWidth=
o Sets minimum toolbar width in pixels.
· ShellBarWidth=
o Sets minimum shell bar width in pixels.
· AddressBarWidth=
o Sets minimum address bar width in pixels.
· GoButtonGripper=True
o When true, Go bar has gripper and is moveable.
· GoButtonBreak=False
o When true, Go bar will be on new line.
· AlignBottom=False
o Aligns Toolbar on the bottom of PWB window.
o Can be used similar to the kiosk bar.
· KioskBarScrollBy=40
o Amount to scroll when kiosk bar scroll button is pressed.
· ButtonTextRight=False
o Display text on right of button.
o See Button “NoText” option.
· AutoSizeButtons=False
o Buttons are dynamically sized to button width.
o Effective when used with Button Text Right.
· ToolBarIconHeight=
o Toolbar icon height.
· ToolBarIconWidth=
o Toolbar icon width.
· ShellButtonIconHeight=
o Shellbar button icon height.
· ShellButtonIconWidth=
o Shellbar button icon width.
· KioskToolBarIconHeight=
o Kiosk Toolbar icon height.
· KioskToolBarIconWidth=
o Kiosk Toolbar icon width.
· KioskBarButtonColor=
o Kiosk button color.
o The color is specified in the BBGGRR.
§ Where BB is the Blue component in hex.
§ Where GG is the Green component in hex.
§ Where RR is the Red component in hex.
o Example:
§ Blue: FF0000
§ Red: 0000FF
· KioskBarBackGroundColor=
o Kiosk button background color.
o The color is specified in the BBGGRR.
§ Where BB is the Blue component in hex.
§ Where GG is the Green component in hex.
§ Where RR is the Red component in hex.
o Example:
§ Blue: FF0000
§ Red: 0000FF
· SearchBarWidth
o Sets search bar width.
· SearchBarBreak
o Show Searchbar on new line.
· SearchBarGripper
o Show gripper on search bar.
[Printer]
Print sections sets print functionality.
· ShowPrintButtonDialog=False
o Set to False to have print job sent to default printer when print button is pressed or set to True to show printer selection dialog when print button is pressed.
· ForcePrintPreview=False
o Set to false to print normal or set to True to force print preview when printing.
· UseLimitPrintJobs=False
o Set to true to enable print job limitations.
· LimitPrintJobs=0
o Set to 0 to disable limit print jobs.
o Set to number of print jobs to limit print jobs.
· PrintJobLimitTitle=Print Limit
o Title of dialog when print job limit reached.
· PrintJobLimitMessageFile=PrintLimit.txt
o Message of print limit dialog when displayed.
o This can be either a text file (.txt), or a rich text file (.RTF).
· ShowPrintingDialog=True
o Displays a dialog with message for information when printing.
· PrintingTitle=Page Printing
o Printing dialog message title.
· PrintingMessageFile=Printing.txt
o Printing dialog message file.
· CheckPrintAccess=False
o Check access of URL in print access file before printing
· PrintDialogShowCancel=True
o Show cancel button on printer information dialog
· ShowPrintMenuDialog=True
o Shows printer choosing dialog from File Print and Ctrl-P
· PrintTemplateFile=
o Specifies Print Template for PWB to use for Print Preview.
o See forums for Print Template Examples.
· ShowPrintIDDialog=False
o Shows dialog before printing.
· PrintIDDialogTitle=Print Identification
o Print dialog title.
· PrintIDDialogHeight=
o Print dialog height.
· PrintIDDialogWidth=
o Print dialog width.
· PrintIDDialogFile=
o HTML type file with before printing information displayed in dialog.
o This can be a local HTML file or a URL to a HTML file.
· AddSystemMenuPrint
o Adds Print to system menu (upper left hand corner).
[Dialogs]
General dialog settings
· DialogSeconds=10
o Sets the dialog count down timers in seconds.
· PolicyTitle=Policy
o Title of policy dialog.
· AccessTitle=Warning: Denied
o Title of access dialog.
· ConfirmCloseDefaultNo=True
o Default button on dialogs with yes and no buttons.
· ConfirmCloseTitle=Confirm Close
o Confirm close dialog title.
· PolicyWidth=
o Sets policy dialog width in pixels.
o Leave blank for default
· PolicyHeight=
o Sets policy dialog height in pixels.
o Leave blank for default
· ConfirmCloseSoundFile=
o Sound file played when confirm close dialog is displayed.
o Leave blank for no sound.
· AccessDeniedSoundFile=
o Sound file played when access denied dialog is displayed.
o Leave blank for no sound.
· AlwaysOnTop=True
o Sets PWB dialogs to be top level windows.
· SecondInstanceTitle=Second Instance
o Dialog title displayed when second instance is disabled.
· IncorrectPasswordMessage=Incorrect password entered?!
o Message when incorrect password is entered.
· AccessURLRedirect=
o Redirects to URL when access is denied
· PolicyShowDecline=True
o Show decline button on policy dialog
· PolicyShowClock=False
o Show clock on policy dialog
· MessageHeight=
o Set message box height
· MessageWidth=
o Set message box width
· OkButtonText=Ok
o Set message dialog Ok button text
· CancelButtonText=Cancel
o Set message dialog cancel button text
· DeclineButtonText=Decline
o Set message dialog Decline button text
· AcceptButtonText=Accept
o Set message dialog Accept button text
· YesButtonText=Yes
o Set message dialog Yes button text
· NoButtonText=No
o Set message dialog No button text
· ShowPopupMessage=True
o Shows pop-up message dialog when pop-up button is pressed.
o See [Files] PopupOnButtonFile and PopupOffButtonFile
· PopupOnMessageTitle=Pop-ups are on
o Pop-up On dialog title.
· PopupOffMessageTitle=Pop-ups are off
o Pop-up Off dialog title.
· UseHtmlDialogs=False
o Use HTML type dialog boxes.
o See sample HTML file Policy.htm for more information.
· MessageTop
o Message box top in pixels.
· MessageLeft
o Message box left in pixels.
· DisableCloseButton
o Disable close button (upper right corner) on message box dialog.
[Files]
File locations for PWB support files. To avoid file path problems, it is recommended you use full paths in the files section.
· WorkingAnimation=
o Working animation file, default if specified or file not found.
· PolicyFile=Policy.txt
o Policy file for policy dialog.
o This can be either a text file (.txt), or a rich text file (.RTF).
o If HTML dialogs is True should be a HTML type file.
· HistoryFile=History.txt
o History file written to when history log is enabled.
o File is created if not found.
· CheckURLFile=URL.txt
o URL file for URL filter.
o See sample URL file for details.
· CheckIPFile=IP.txt
o IP file for IP filter.
o See sample IP file for details.
· PopupAdFile=Popup.txt
o File for popup filter.
o See sample popup files for details.
· AccessMessageFile=Access.txt
o Message of denied access dialog.
o Dialog displayed when access is denied via URL and IP access.
o This can be either a text file (.txt), or a rich text file (.RTF).
o If HTML dialogs is True should be a HTML type file.
· ConfirmCloseMessageFile=ConfirmClose.txt
o Confirm close dialog message.
o This can be either a text file (.txt), or a rich text file (.RTF).
o If HTML dialogs is True should be a HTML type file.
· SaveAsErrorMessageFile=SaveAsError.txt
o Save as directory error message.
o This can be either a text file (.txt), or a rich text file (.RTF).
o If HTML dialogs is True should be a HTML type file.
· DownloadErrorMessageFile=DownloadError.txt
o Download directory error message
o This can be either a text file (.txt), or a rich text file (.RTF).
o If HTML dialogs is True should be a HTML type file.
· FavoritesFolder=Favorites
o Favorite’s folder for favorites.
o Copy Internet shortcuts and IE favorites to this folder for PWB favorites.
· ShellBarFolder=ShellBar
o ShellBar’s folder for shell bar shortcuts.
o Copy Windows shortcuts and/or IE favorites to this folder for shell buttons.
· StartupScript=
o Specifies a startup batch or command file to run before PWB starts.
· ShutdownScript=
o Specifies a shutdown batch or command file to run after PWB exits.
· PolicyDeclineScript=
o Specifies a batch or command file to run after PWB exits when the policy is declined.
· DesktopFile=
o HTML file for use with desktop mode, can be a URL.
· SendToAppLink=
o Specifies application PWB uses for send link function.
o We recommend TeamSoftware Solution’s TMail for this.
· SendToAppFile=
o Specifies application PWB uses for send file function.
o We recommend TeamSoftware Solution’s TMail for this.
· CheckPrintFile=PrintAccess.txt
o File for use with check print access
· PopupOnButtonFile=Popupon.txt
o Pop-up on message.
o This can be either a text file (.txt), or a rich text file (.RTF).
o If HTML dialogs is True should be a HTML type file.
· PopupOffButtonFile=Popupoff.txt
o Pop-up off message.
o This can be either a text file (.txt), or a rich text file (.RTF).
o If HTML dialogs is True should be a HTML type file.
· PasswordFile=
o Password HTML file for Password dialog box.
o If HTML dialogs is True should be a HTML type file.
· NewWindowProcessINI=
o INI file for new window process.
o See [SecondWindow] OpenInNewProcess.
· InactivityScript=
o Specifies a command or script to run after the Inactivity timer has run out.
· CheckPostDataFile=
o File for check post data filter.
· CheckACFile=
o File for Internet Explorer Auto Complete filter.
· ActivityScript=
o Specifies a command or script to run after the Activity timer has run out.
· TimeCheckScriptDay=
o Specifies a command or script to run at specified time of day.
o See [TimeCheck] section.
· TimeCheckScriptNight=
o Specifies a command or script to run at specified time of day.
o See [TimeCheck] section.
· ToolBarIconFolder=Graphics
o Specifies the folder where alternate Toolbar graphics as located.
o See Alternate Toolbar Graphics above for more information.
[WebFiles]
PWB can download configuration and informational files from a web server.
· EnableWebFiles=True
o Enables web files.
o If a web file URL is specified PWB will download to the location for the file specified in the [Files] section.
· CheckURLFile=http://www.teamsoftwaresolutions.com/WEBURL.txt
o URL filter file.
· CheckIPFile=
o IP filter file.
· CheckPrintFile=
o Printer filter file.
· PopupAdFile=
o Pop-up filter file.
[Directories]
Before starting, PWB sets the IE default save and download directory by setting the registry in the following key “HKEY_CURRENT_USER” “Software\Microsoft\Internet Explorer”. These settings do not restrict PWB to the directories only sets the opening default directory for the Internet Explorer Save and Download dialogs.
· SaveAsDirectory=
o Save as directory set in registry.
o If blank settings is ignored.
· SaveAsErrorTitle=Floppy required
o Title of save as error dialog when directory not found.
· DownloadDirectory=
o Download directory set in registry.
o If blank setting is ignored.
[Security]
General security section.
· StationEnvironmentVariable=COMPUTERNAME
o Environment variable to specify name written in history logs.
o For Windows 9x, use the SET command in the AutoExec.bat.
· UseUniqueHistoryFiles=False
o Appends station environment variable string to history file name.
· WriteHistoryFile=True
o Enable history log.
o Only writes URLs typed into address box.
o This must be true for any history logging.
· TrackURL=False
o WriteHistory must be True.
o Writes all URLs visited.
· CheckURLAccess=False
o Checks the URL file for access information prior to displaying web page.
o See sample URL file for more details.
· CheckIPAccess=False
o Checks the IP file for access information prior to displaying web page.
o See sample IP file for more details.
· ClosePopupAds=False
o Checks pop up file for access information on web page title.
o Closes browser based on access information.
o See sample pop up file for more details.
· ShowAccessDialog=True
o Shows access denied dialog box.
o This setting effects Check URL, Check IP, and Only Access HTTP.
· LogAccess=False
o Writes to history file when access is denied via URL and IP access.
· ShowPolicyDialog=False
o Shows policy dialog with accept decline before PWB starts.
o If declined PWB exits.
· OnlyAccessHTTP=False
o Tells PWB to only access HTTP servers.
o Prevents access to local drives, FTP, and other servers.
· AccessTitle=Warning: Denied
o Title of access denied dialog.
o Dialog displayed when access is denied via URL and IP access.
· ClearCacheOnHome=False
o Set to True to clear cache when home button is pressed.
· ClearCacheOnClose=False
o Set to True to clear cache when browser is closed.
· DisableAddressDropDown=False
o Set to True to disables address bar drop down menu.
· DisableContextMenu=False
o Set to True to disable context menu (right click menu).
· UseCustomContextMenu=True
o Set to True to use custom context menu.
o See [ContextMenu] section for settings.
· DisableSecondInstance=False
o Prevents two instances of PWB from running.
o Does not affect child windows.
· RestartOnClose=False
o Restarts PWB when parent window is closed.
· ShowPasswordDialog=False
o Shows password dialog when PWB is started.
· PasswordTitle=Public Web Browser
o Title for password dialog
· Password=password
o Password for password dialog
· CheckInitialURL=False
o Check initial URL for access
· DisableFileDownload=False
o Disable file downloads
· AllowSingleLinkLevel=False
o Allow one link level into denied sites from allow site
· AllowBrowseOnDeny=False
o Shows denied dialog box but allows browse to continue
· LogoffOnExit=False
o Log off computer when PWB exits
· ShowFilterStatus=False
o Shows filter status in title bar.
· FilterOnText=
o Filter status on text.
· FilterOffText=
o Filter status off text.
· ShowProxyStatus=False
o Show proxy status in title bar.
· ProxyOnText=
o Proxy status on text.
· ProxyOffText=
o Proxy status off text.
· ShowDenyDialogOncePerSession=False
o Only show deny dialog once per PWB session.
· OnlyAccessInternet=False
o Tells PWB to only access Internet Servers.
o Prevents access to local drives, and File servers.
· DebugAccessString=False
o When True, displays a dialog with the string that has been denied.
o Should only be used for debugging the URL filter file.
· AllowLinkLevelDepth=3
o Used in conjunction with AllowSingleLinkLevel.
o AllowSingleLinkLevel must be set to True.
o Adjusts the number of links past the filter PWB will allow.
· CheckPostDataAccess=False
o Checks the URL file for access information prior to displaying web page.
o Works in similar fashion to the URL and IP filter.
· DisableFileUploads=False
o Disables any “TYPE=FILE” elements in web pages.
o This effectively blocks 90% of upload pages on the web.
· TrackLogon=False
o Writes to history file time and date when PWB is started.
· CacheFilterFiles=False
o Caches PWB filter files for faster filter file parsing.
o May slow initial PWB load times.
· CheckACAccess=False
o Filter that enables or disables the Internet Explorer Auto Complete functionality on a per page basis.
o Works in similar fashion to the URL and IP filter.
· SecondInstanceNavigateCurrent=False
o If set to true, attempting to open a second instance of PWB will cause navigation in the current instance.
· RebootOnExit=False
o Reboots computer is PWB exits.
· PreventFileDownload
o Prevents non-active files from downloading.
· EnableFileDownload
o Enables file download in Control Panel applet Internet Options.
· EnableAlternateOverrideKeys
o Enables Ctrl+F4 to open override dialog.
· LogDeniedAccess
o Logs denied access URL.
· EnableFilterOrLogic
o Enables OR logic for URL and IP Filters.
o If URL or IP filter denies access URL is denied.
[Overrides]
Override command section. Dialog displayed when Ctrl-Alt-Shift + Insert keys are pressed. It is usually good practice to change these keywords to prevent unwanted actions.
· ExitBrowser=
o When keyword is entered, browser is closed.
o Useful when disable exit is enabled.
· Logoff=
o When keyword is entered, user is logged off computer.
· Shutdown=
o When keyword is entered, computer is shut down.
· ResetActvityTime=
o Resets activity time.
o If modifier is entered in dialog, sets activity time to modifier.
· ResetPrintLimit=
o Resets print job limit.
o If modifier is entered in dialog, sets new print job limit.
· RestrictedSave=
o Allows unrestricted save via IE save dialog
o Modifier allows multiples (default is one).
· ReReadINIFile=
o Override to re-read INI file into PWB if changes to INI have been made.
· OpenSysedit=
o Override that opens Sysedit.
· OpenRegedit=
o Override that opens Regedit.
· OpenExplorer=
o Override that opens Windows Explorer.
· DisableProxy=
o Override to disable/enable proxy
o Each override toggles proxy on or off.
· DisableFilters=
o Disables PWB URL and/or IP filters.
· ShowAddressBar=
o Toggles address bar for window.
· OverrideURLKeyword=
o Keyword typed into address bar to display overrides dialog.
o Leave blank to disable.
o Useful if you have the Ctrl-Alt keys disabled.
[HTMLError]
List or Navigation error status codes for PWB navigation error redirection. See the following web site for more information in navigation error numbers.
http://msdn.microsoft.com/library/default.asp?url=/workshop/browser/webbrowser/reference/constants/statuscodescpp.asp
· EnableRedirect=False
o Enables navigation error redirection.
· DebugErrorNumber=False
o Displays a dialog box with the URL and error number.
o Should be set to false unless debugging the error status codes.
· [Error Number]=URL
o Examples:
§ 2148270085=www.teamsoftwaresolutions.com
§ 404=www.google.com
[Java]
Dynamic External Java Commands and keywords section. These commands can be placed on a web page to do the indicated actions. A blank keyword will result in the command being disabled. The keywords should be unique to your implementation in order to provide protection against unauthorized use.
· EnableExternalJava=True
o Enables the Dynamic External Java Commands.
· JavaExit=PWBExit
o Dynamic External Java Command to exit PWB.
o Takes no parameters.
o Example:
§ window.external.PWBExit();
· JavaActivity=PWBActivity
o Dynamic External Java Command to set activity timer.
o Takes one parameter.
§ Number of seconds to set activity timer to.
o Example:
§ window.external.PWBActivity( ‘100’ );
· JavaRegister=PWBRegister
o Dynamic External Java Command to change registration number.
o PWB INI must not be read only.
o Takes one parameter.
§ New registration number.
o Example:
§ window.external.PWBRegister( ‘your new number’ );
· JavaHideToolbar=PWBHideToolbar
o Dynamic External Java Command to hide toolbar.
o Takes one parameter.
§ TRUE to hide toolbar, FALSE to show toolbar.
o Example:
§ window.external.PWBHideToolbar( ‘TRUE’ );
· JavaExecute=PWBExecute
o Dynamic External Java Command to execute local applications.
o Takes two parameters.
§ First parameter path to file to execute.
§ Optional second parameter command line arguments for file to execute.
o Example:
§ window.external.PWBExecute( ‘C:\Windows\NotePad.exe’ );
· JavaReadINIFile=PWBReadINI
o Dynamic External Java Command to re-read PWB INI file.
o Takes no parameters.
o Example:
§ window.external.PWBReadINI();
· JavaPrint=PWBJavaPrint
o Prints web page using Print Button settings.
§ Simulates pressing Print Button.
o Takes no parameters.
o Example:
§ window.external.PWBJavaPrint();
· JavaHideAddressBar=PWBHideAddressBar
o Dynamic External Java Command to hides or show address bar.
o Takes one parameter.
§ TRUE to hide address bar, FALSE to show address bar.
o Example:
§ window.external.PWBHideAddressBar( ‘TRUE’ );
· JavaPrintFrame=PWBPrintFrame
o Prints frame name specified.
o The current web page must have the specified frame name to print.
o Takes two parameters.
§ First parameter, specified name of frame to print.
§ Optional second parameter when set to true, all frames are printed except the named frame in first parameter.
o Example:
§ window.external.PWBPrintFrame( ‘InfoFrame’ );
§ window.external.PWBPrintFrame( ‘InfoFrame’, ‘TRUE’ );
· JavaFillElement=PWBFillElement
o Fills the name specified element with data.
o Takes two parameters.
§ First parameter specifies the element name.
§ Second parameter specified the data to be entered.
o Example:
§ window.external.PWBFillElement( ‘nameID’, ‘John Smith’ );
· JavaStartApp
o Starts application in new process.
· JavaSetActivity
o Sets activity time.
· JavaGetActivity
o Gets activity time.
[RestrictedSave]
Restricted save dialog when File Save as is selected.
· EnableRestrictedSave=False
o Enables the restricted save application for Save As.
o You can use MMC or Windows policies to restrict IE save dialog for general browsing, see TeamSoftware Solutions forums for more info.
· RestrictedSaveApp=
o Restricted save application to run to save web page.
o Application available on the TSS web site.
[ScreenSaver]
When PWB is used as the shell for windows the screen saver will not become active because the normal Windows shell normally activates the screen save. This allows PWB to activate the screen save. If you are not using PWB as the Windows shell it is usually better to set the normal Windows screen saver functionality.
· EnableScreenSaver=False
o Enable screen saver.
· ScreenSaverSeconds=1200
o Time in seconds when screen save is activated.
o The ShowStatusBarTime must be True for this to work.
· EnablePolicyScreenSaver=False
o Enables the policy dialog screen saver timer.
· PolicyScreenSaverSeconds=10
o Time is seconds when the screen saver is activated.
· DisableScreenSaverOnPolicyClose=False
o Disables Windows screen saver when policy dialog is closed.
· DisableScreenSaverOnClose=False
o Disables Windows screen saver when PWB is closed.
· WindowsScreenSaverExe=
o Sets Windows screen saver.
o Must be set to a path to a valid Windows screen saver file.
· WindowsScreenSaverMinutes=0
o Sets Windows screen saver time in minutes.
[Inactivity]
Inactivity timer section. When browser is idle for indicated time, the indicated action is taken.
· InactivityTimer=False
o Set to True to enable inactivity timer.
· InactivitySeconds=1200
o Sets inactivity time in seconds.
· InactivityMessageTitle=Warning
o Title of inactivity message dialog when displayed.
· InactivityMessageFile=Inactivty.txt
o Message if inactivity dialog when displayed.
o This can be either a text file (.txt), or a rich text file (.RTF).
· InactivityAction=Home
o Action to take when idle time is reached.
§ Home = browser to home page.
§ Exit = Browser exits.
§ Logoff = user is logged off computer.
§ Warn = The dialog was just a warning, PWB will continue
§ Restart = Restarts PWB.
§ Reboot = Computer will be rebooted.
§ Execute = Executes file specified in [Files] InactivityScript.
§ Executehome = Executes file and browses home.
§ Lock = Locks Workstation. (Windows NT/2K/XP only)
§ Lockhome = Locks Workstation, and browses home.
· InactivitySoundFile=
o Wave file played when inactivity dialog is displayed.
o Does not play sound on confirm action, see dialog section confirm close sound file.
o Leave blank for no sound.
· InactivityStartOnOpen=False
o When set to False, inactivity timer starts on navigate.
o When set to True, inactivity timer starts when browser is opened.
· InactivityShowDialog=True
o Show or hide inactivity dialog box when the inactivity timer runs out.
o If set to False, PWB assumes time is out and does inactivity action.
· ResetOnMouseMove=True
o Resets inactivity timer when mouse is moved.
o Set to false when using MicroTrends Office Scan.
· ResetOnMouseButton=True
o Resets inactivity timer when mouse button is pressed.
o Normally ok to leave set to true.
· ResetOnKeyboard=True
o Resets inactivity timer when keyboard button is pressed.
o Normally ok to leave set to true.
[Activity]
Activity timer section. The activity timer limits browser to activity time in seconds. Can be overridden using reset activity time override key word.
· ActivityTimer=False
o Set to True to enable activity timer.
· ActivitySeconds=1200
o Sets activity time in seconds.
· ActivityMessageTitle=Warning
o Title of activity message dialog when displayed.
· ActivityMessageFile=Activity.txt
o Message if activity dialog when displayed.
o This can be either a text file (.txt), or a rich text file (.RTF).
· ActivityWarnAt=120
o Time is seconds to warn user the time is about to expire.
· ActivityWarnTitle=Warning
o Title of activity warning dialog when displayed.
· ActivityWarnMessageFile=ActivityWarn.txt
o Message of activity warning dialog when displayed.
o This can be either a text file (.txt), or a rich text file (.RTF).
· ActivityAction=Exit
o Action to take when idle time is reached.
§ Home = browser to home page.
§ Exit = Browser exits.
§ Logoff = user is logged off computer.
§ Warn = The dialog was just a warning, PWB will continue.
§ Restart = Restarts PWB.
§ Reboot = Computer will be rebooted.
· ActivitySoundFile=
o Wave file played when activity dialog is displayed.
o Leave blank for no sound.
· ActivityStartOnOpen=False
o When set to False, activity timer starts on navigate.
o When set to True, activity timer starts when browser is opened.
· ActivityShowInTitleBar=False
o Shows activity time is title bar of window.
· ActivitySecondWarnAt=5
o Shows a secondary warn dialog that the activity timer is going to expire.
o Just in case they did not believe the first one.
· ActivitySecondWarnMessageFile=ActivityWarn.txt
o Message of activity timer second warn dialog.
o This can be either a text file (.txt), or a rich text file (.RTF).
· DisableDialogTimer=False
o Allows activity timer to continue to run while warning and informational dialogs are showing.
[TimeCheck]
Enables a dialog to be shown at a specific time of day with action and optionally runs a script file. See [Files] section for script files to run.
· EnableTimeCheck=False
o Enables time check dialogs.
· TimeToActionDay=10:14:00
o Time to show dialog (day).
o Time is 24 hour format with HH:MM:SS format.
§ Where HH = hour in 24 hour format.
§ Where MM = minutes.
§ Where SS = seconds.
o Examples:
§ 10:14:00 = 10:14 AM
§ 14:30:30 = 2:30 PM and 30 seconds.
· TimeToActionNight=
o Time to show dialog (night).
o Time is 24 hour format with HH:MM:SS format.
§ Where HH = hour in 24 hour format.
§ Where MM = minutes.
§ Where SS = seconds.
o Examples:
§ 18:15:00 = 6:15 PM
§ 23:30:30 = 11:30 PM and 30 seconds.
· TimeToWarnSeconds=300
o Number of seconds to warn before script is run.
· MessageTitleDay=Day Action
o Dialog title of day dialog.
· MessageFileDay=Day.html
o Message to be shown in day dialog.
o Can be TXT or HTML type file.
· MessageTitleNight=
o Dialog title of night dialog.
· MessageFileDNight=
o Message to be shown in night dialog.
o Can be TXT or HTML type file.
· MessageTitleWarnDay=Day Warning
o Dialog title of warning day dialog.
· MessageFileWarnDay=DayWarn.html
o Message to be shown in day warn dialog.
o Can be TXT or HTML type file.
· MessageTitleWarnNight=
o Dialog title of warning night dialog.
· MessageFileWarnNight=
o Message to be shown in night warn dialog.
o Can be TXT or HTML type file.
· ActionDay=Exit
o Action to take when dialog is dismissed.
§ Exit = Browser exits.
§ Logoff = user is logged off computer.
§ Restart = Restarts PWB.
§ Reboot = Computer will be rebooted.
§ Shutdown = Shutdown computer.
§ Execute = Executes script specified in [Files] section.
· ActionNight=
o Action to take when dialog is dismissed.
§ Exit = Browser exits.
§ Logoff = user is logged off computer.
§ Restart = Restarts PWB.
§ Reboot = Computer will be rebooted.
§ Shutdown = Shutdown computer.
§ Execute = Executes script specified in [Files] section.
[Proxy]
Proxy set up section. If use custom is set to True, the following proxy settings are set in the registry in the key: “HKEY_CURRENT_USER” “Software\Microsoft\Windows\CurrentVersion\Internet Settings”
· UseCustom=False
o Enables custom proxy settings when PWB is started.
· ProxyEnable=
o Sets Proxy enabled
o Here for consistency, should be set to True if custom proxy is used.
· ProxyServer=
o Proxy server to be used.
· ProxyOverride=
o Proxy overrides.
o Proxy does not use proxy for addresses beginning with.
· AutoConfigURL=
o URL for proxy auto configuration.
o If UseCustom=True and this field is blank, the AutoConfigURL will be removed.
[PageSetup]
Page setup section sets the printer properties when PWB is started to a predefined set.
· UseCustom=False
o Enables the use of custom printer settings.
· Footer=&u&b&d
o Printed page footer.
o See the IE page setup for macro details.
· Header=&w&bPage &p of &P
o Printed page header.
o See the IE page setup for macro details.
· MarginBottom=0.75000
o Printed page bottom margin in inches.
· MarginLeft=0.75000
o Printed page left margin in inches.
· MarginRight=0.75000
o Printed page right margin in inches.
· MarginTop=0.75000
o Printed page top margin in inches.
· Duplex=1
o Duplex option: 1=None, 2=Flip on long side, 3=Flip on short side
· Orientation=1
o Orientation option: 1=Portrait, 2=Landscape
[KioskButtons]
Buttons used on the kiosk bar.
· Back=True
o Show back button.
· Separator1=True
o Show separator.
· Forward=True
o Show forward button.
· Separator2=True
o Show separator.
· Stop=True
o Show stop button.
· Separator3=True
o Show separator.
· Refresh=True
o Show refresh button.
· Separator4=True
o Show separator.
· Home=True
o Show Home button.
· Separator5=True
o Show separator.
· Print=True
o Show Print button.
· Separator6=True
o Show separator.
· ScrollUp=True
o Show Scroll up button.
· Separator7=True
o Show separator.
· ScrollDown=True
o Show Scroll down button.
· Separator8=True
o Show separator.
· Close=True
o Show Close button.
[Buttons]
Please see the Menu and button relationships in the beginning of this file.
All button keys have a True/False, String, or “NoText” setting. If the button key has a “True” setting then the button is displayed. If the key has a “False” setting then the button is not displayed. If the key has a string value then the button is renamed to the string specified. For instance if the Forward key is changed to “Next” then the Forward button will have the text “Next” instead of “Forward”. If the button has the “NoText” setting the button will be displayed without the text.
…
Forward=Next
…
[MenuItems]
Please see the Menu and button relationships in the beginning of this file.
All menu item keys have a True/False or String setting. If the menu item key has a True setting then the menu item is displayed. If the key has a False setting then the menu item is not displayed. If the key has a string value then the menu item is renamed to the string specified. For instance if the Policy key is changed to “Our Policy” then the Policy menu item will have the text “Our Policy” instead of “Policy”.
…
Policy=Our Policy
…
[ContextMenu]
If the Security section Use Custom Context Menu is set to True then the context menu can be customized by setting the following keys to True or False. If the key is True, then the context menu item is displayed, if the key is false, then the context menu item is not displayed. For instance if the Save Picture key is set to False, the Save Picture context menu item will not be displayed. . If the key has a string value then the menu item is renamed to the string specified. For instance if the Print key is changed to “Print Page” then the Print menu item will have the text “Print Page” instead of “Print”.
…
SavePicture=False
…
[URLKeys]
URL keys act as hot keys for URLs to take the browser to specific web sites. When URL keys are enabled holding down a letter key and hitting a number key will activate the URL listed in the letter number combination. As an example with A1=www.TeamSoftwareSolutions.com in the URL keys section, holding “A” and hitting “1” will open the TeamSoftware Solutions web site in the browser. This is true for any letter number combination entered in the URL key section, A1 – Z9.
EnableURLKeys=False
A1=www.TeamSoftwareSolutions.com
A2=www.Google.com
…
B1=www.Yahoo.com
…
Z9=www.Excite.com
…
EnableURLfKeys=False
Similar to URL Keys but correspond to the function keys F2-F24 excluding F10.
As always, if you have any questions, please feel free to email us at Support@TeamSoftwareSolutions.com
Thank you,
Michelle Vermeersch
President and CEO
TeamSoftware Solutions
Document version 2.11
|