Changelog
v8.1.0 Updates - Released August 25th, 2010
===========================================
* New to the wpi_theme.js in each theme folder is
Installer_BackgroundRepeat to specify either a big background image or a
small pattern.
Note: In the theme folder in installer.css under .Background, you must
set the actual repeat style.
Options: repeat, stretch
Usage: Installer_BackgroundRepeat="stretch";
* Also new is Theme_BackgroundPosition is set the background image
position if using an image that is smaller than the screen and not using
stretch option.
Note: Must also set: Theme_BackgroundRepeat="no-repeat";
Options: top, left, center, right, bottom. and any combonation
Usage: Theme_BackgroundPosition="top right";
* In installer.css in each theme is a new entry: .WPI_Text.
This sets the text color for the title text in the installer window
near the bottom.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
There is a new theme type: Windows Framed. The first theme to use it is
WindowsFramed. Simply put, there is a frame around the main body, 7
pixels wide, 20 pixels in from the edge.
In the theme's folder in wpi_theme.js
Theme_FrameColor="#ffffff";
sets the frame color. If Frame.png exists, that image will be used.
There are no SmallBarT.png and SmallBarB.png images in this theme type.
All of the new features below are also in this new type.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
There are two new options in each theme folder in wpi_theme.js,
Theme_MainPanelBGColor="" and Theme_MainPanelBGImageRepeat="".
These set the main checkbox panel's background color or image. If
MainPanel.png exists, that image will be used.
You now have three independant background images:
Wallpaper.png (.jpg) as the main background.
SidePanel.png
MainPanel.png
You now have three independant background colors:
Theme_BGColor
Theme_SidePanelBGColor
Theme_MainPanelBGColor
Note: Only applies to Windows and WindowsFramed based themes.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* If the three png images for the main control links (Install.png,
InstallDown.png, InstallOver.png) do not exist, then just the text will
be displayed with no error image. Useful if tight on space or just
don't want any images.
Note: Only applies to Windows based themes.
* There is a new option in each theme folder in wpi_theme.js,
Theme_ShowButtonText, to show or not show the text for the control
links (Begin Install, Options, About WPI, etc). Setting this option to
false allows you to make full image text buttons. The drawback of this
is you lose locale support since images can't be translated. So use
this only if you don't need multi-language support.
Usage: Theme_ShowButtonText=false;
Note: Only applies to Windows based themes.
Note: Theme_ShowExitButtonText is still independant of this option.
* With the addition of the above feature, there are now seperate images
for Defaults, All, and None in all Windows and Accordion based themes.
* The large combobox on Options Wizard -> General tab has been removed
since many people seemed to not see it. It has been replaced by a new
Features tab with all the check boxes laid out in two columns.
* An oversite in the wpi_theme.js file has been remedied:
Theme_BackgroundRepeat="";
It was fine for large background images, but not small patterns that
needed to be repeated.
Options: repeat, no-repeat, repeat-x, repeat-y
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
New to the Config Wizard -> Details tab -> Return code requires reboot.
This function allows for a script, or program, to be run multiple times
with reboots in between. For example, you could have a script that
creates a new user, exit code for reboot, set user's network settings,
exit code for reboot, do some more stuff, exit code 0 for done.
If you have the "Repeat command until other code is returned" WPI will
restart at the same command. Else it will continue on to the next item.
The reboot code can not be 0 or 1.
There are now new warning image and sound files, and a css entry for it
with yellow text. The default ones have been copied to all themes.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* Added three new options in Options Wizard -> General tab:
- Abort installation process if failure occurs
- Script or program to execute if failure
- Continue next installation where failed
Very handy for testing a program or script.
* Fixed a bug dealing with stdout redirection and quotes in the path.
"d:\program.exe" "param1" >c:\app.txt
would fail, but with no quotes it always worked. Works all the time
now.
* WPI now reports success/fail properly in the installer. The return
code was not being processed properly. 999 is the "default" fail code,
which usually means the file does not exist. 0 is success. 1 usually
means a file doesn't exist in a CMD /C or cmd.exe call.
ex: cmd /c copy a b Return code 1
* Added function {JSCRIPT}=CreateRegKey().
Usage: {JSCRIPT}=CreateRegKey("HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\RunOnceEx\001")
Sometimes a key needs to be created first, then it's value set. If
{JSCRIPT}=WriteRegKey() fails to make and set the key, use this
function first, then write the value.
* Small update to tips.js which should make the tooltips display a
little faster and smoother.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
There is a new Theme Wizard to edit themes and a full GUI to edit the
tooltips. This interface has been much needed since none of the options
have been properly documented. Most of the options are self-
explanatory, so here are the obscure details:
* Appearance behavior: Controls how the tip message is displayed. Some
will stay open when mouse is moved. This allows for internet links to
be used in the message (ie, program's home page).
- Visible: Same as Sticky below but no X close button.
- Sticky: The tip message will not hide after your mouse goes off the
link and it will only be positioned once. A close link is automatically
generated and inserted at the top right of the tip message so if you
would like to hide the tip message just click it. The properties
(color, bgcolor, etc) of the close link are set from the title's
properties so the close link and title will have exactly the same style
and look as the title. This is designed specially for the need of
inserting links in the tip message or any thing that involves using the
mouse in tip message's content.
- Keep: The tip message will not hide after your mouse goes of the link
rather the tip message will move with your mouse around the page. This
will produce the same effect as if you didn't specify the mouse out
function in the link.
* Tip position type: Open the tip relative to the mouse pointer.
- Float: The tip message will not move with the mouse rather it will
popup at the coordinates of the X Pos and Y Pos entries. And if you
scroll down or left the scroll values are added to the X Pos and Y Pos
values so the tip message will always float in the same place no matter
how much you scroll left or right, in simple words "Static position".
- Fixed: The tip message will not move with the mouse rather it will
popup at the coordinates of the X Pos and Y Pos entries. And it will
not float with the scrollbars.
* Background image: Uses Graphics\ToolTipsBgs\ as base folder. Put all
your images in there. The image overrides the background color.
-OR- place ToolTipsTitleBg.png and/or ToolTipsBodyBg.png in the theme
folder to use that image to override the user specified one.
* X pos / Y pos:
- If the tip message's position is set as left or right it sets the
coordinate of the tip message relative to the position of the mouse.
- If the tip message's position is set as float or fixed it sets the
coordinate of the tip message relative to the window. You may set
positive or negative numbers.
* Shadow type: You may apply one of two shadow styles: simple or
complex, or none. You must also add a shadow color to enable it.
The ColorPicker does not like words for colors (white, red, etc) so use
the hex value whenever possible.
Keyboard shortcuts are either F6 or Alt+H.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* Updated WriteRegKey() to use the WMI version instead of the DOS-based
Reg. This speeds up the startup process by several seconds.
* Added to Options Wizard -> General -> combobox -> Disable hot keys.
Use this in conjunction with "Show extra buttons" and "Do not show if
started from CD" and/or "Do not show if started from USB". This will
block all access to Wizards. Enable when you make your final DVD.
Use with care.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Updated WPI and the Installer to handle custom audio files.
You can now place custom audio files in your theme's folder to override
the one's specified in Options Wizard -> Audio tab. WPI will check if
the files exist in the Theme folder and use those in place of the
specified ones.
The checkboxes in the Audio tab still must be checked for the audio to
play.
The audio files must be named:
SndWPIStart.wav
SndInstallStart.wav
SndInstallSuccess.wav
SndInstallWarning.wav
SndInstallFail.wav
SndInstallFinish.wav
SndWPIExit.wav
The audio files can either be wave (.wav) or midi (.mid) files.
Keep them as short as possible. The installer will not wait for the
sample to finish playing before moving on to the next item.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* Fixed a small issue with the audio player. If no files are specified
the Install.m3u file was not cleared.
* Alper Catak (ZEUS__) created some new themes: 7Fresh, 7Matrix, 7Pure,
7StarWars, and 7Transformers. He also created 7Matrix, Black, Pure,
LightGray, and CobaltSteel skin styles.
* Black_Kel skin style is gone. Use new Black style.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
It has come to my attention that it is difficult for people to specify
certain operations, like file copy, when building one config for both
32 and 64 bit systems. Here is a simple example on how to copy a file
based on your cpu bits and cpu type:
{JSCRIPT}=if (getBits()==32) RunCmd('%wpipath%\Install\CCleaner.exe /s',false,true)
{JSCRIPT}=if (getBits()==32) RunCmd('cmd /c copy /y
"C:\WPI\ChangeLog.txt" "C:\"',false,true)
{JSCRIPT}=if (getBits()==64) RunCmd('cmd /c copy /y "%wpipath%\Install\MyFile.txt"
"%ProgramFiles(x86)%\"',false,true)
{JSCRIPT}=if (getArch()=="AMD64") RunCmd('cmd /c copy /y "%wpipath%\Install\CCleaner\Password.ini"
"%ProgramFiles%\CCleaner\"',false,true)
Using RunCmd() is the key. There are 2 possible options:
RunCmd('your command',OutputWindow,Wait)
Use single quotes around your command so don't interfere with double
quotes in your paths.
OutputWindow: true or false. Show the cmd output window or not.
Wait: true or false. Wait until the command is finished or not.
All of the functions in the Dependecies can be used with {JSCRIPT}.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* Updated version extraction method.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
New to the Installer window is a combobox under the Pause/Abort buttons
to specify what to do when WPI is finished installing your programs.
There are 3 options: "none", Restart, and Shut Down.
If you have "Restart Computer" specified in Options Wizard -> Tools tab,
then that option will be reflected here. If you don't, then "none" is
selected. (no restart or shutdown)
With this combobox you can specify, or change, what to do on the fly.
Selecting "none" will cancel the restart or shut down.
The time delay and "Do not load desktop" options are still used.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* When hit Abort in the Installer window, any restart or shut down is
cancelled.
* Added new option to Options Wizard -> General tab -> Options combobox:
"Do not show extra buttons if started from USB drive". This has same
functionality as the original "...if started from CD Drive.". This is
needed because it is possible to still allow writing to a USB drive.
* Updated how drives are checked for how WPI was started.