Customizing Dialog Boxes
Previous Top Next


Customizing the messages displayed

To customize the messages displayed in the Registration Dialog, add the following text files to your Thinstall project:

%InstallPath%\demo_nokey.rtf - Displayed if no default key and no license key has been set
%InstallPath%\demo_after.rtf - Displayed when the current license has expired
%InstallPath%\demo_before.rtf - Displayed when the current license is about expire
%InstallPath%\demo_register.rtf - Displayed when the user clicks on the 'Register' button


Adding hyperlinks to your website

You can specify hyperlinks to be displayed on the registration dialogs by editing the file default_config.txt located in your Thinstall Installation directory (i.e. c:\program files\thinstall\default_config.txt). Locate the section "Trial2" in this file for more information.


clip0286

1. A common URL is displayed at the top of each dialog no matter what screen the user is on (see url_top_link below). This URL is most likely to provide the user with general information about the product or information on purchasing.
2. For each message displayed to the user, you can also supply a URL (see table below) where the user will be directed if they click on that message. This allows you to provide additional in-depth instructions and explanations about each message.


License Configuration Entry Name
Default Value and description

trial2:url_top_name


trial2:url_top_link



"Edit default_config.txt to modify this hyperlink"
Displayed at the top of all License System 2 Dialogs


"http://thinstall.com/help/index.html?customizingdialogboxes.htm"
If this value is specified, url_top_name becomes a hyperlink
If this value is "", url_top_name is displayed as regular text



trial2:no_key


trial2:no_key_url



"Please enter your License Key"
Displayed if no key has been specified (default key has 0 days of initial use)

""
If this value is specified, no_key becomes a hyperlink
If this value is "", no_key is displayed as regular text




trial2:expired_msg


trial2:expired_msg_url



"Your current license has expired"
Displayed when the current key has expired.

""
If this value is specified, expired_msg becomes a hyperlink
If this value is "", expired_msg is displayed as regular text



trial2:will_expire_msg






trial2:will_expire_msg_url

"This license will expire in %d day%s"
Displayed when the current license key will expire in a number of days less than that specified in the settings tab. Note: The %d and %s will be replaced with the number of days remaining and the letter 's' if this is a plural value. For foriegn languages the %s can be ommitted. If the current license key does not have any time restrictions, this message is never displayed.

""
If this value is specified, will_expire_msg becomes a hyperlink
If this value is "", will_expire_msg is displayed as regular text




trial2:runs_expire_msg





trial2:runs_expire_msg_url

"%d more executions remaining before this license expires"
Displayed when the current license key will expire in a number of executions less than that specified in the settings tab. Note: The %d will be replaced with the number of executions remaining. If the current license key does not have any execution count restrictions this message is never displayed.

""
If this value is specified, runs_expire_msg becomes a hyperlink
If this value is "", runs_expire_msg is displayed as regular text




trial2:ver_max_hit




trial2:ver_max_hit_url

"Sorry, the current License Key must be used with older versions of this software"
Displayed when an entered license key is not permitted to be used with current version of the software. If a license key does not have any version restrictions this message is never displayed.

""
If this value is specified, ver_max_hit becomes a hyperlink
If this value is "", vet_max_hit is displayed as regular text




trial2:ver_min_hit




trial2:ver_min_hit_url

"Sorry, the current License Key must be used with newer versions of this software"
Displayed when an entered license key is not permitted to be used with current version of the software. If a license key does not have any version restrictions this message is never displayed.

""
If this value is specified, ver_min_hit becomes a hyperlink
If this value is "", ver_min_hit is displayed as regular text




trial2:bad_macid





trial2:bad_macid_url

"The current License Key cannot be used on this computer"
Displayed when an entered license key is has a machine-id restriction and the current machine ID does not match with the key's value. If a license key does not have any Machine ID restrictions this message is never displayed.


""
If this value is specified, bad_macid becomes a hyperlink
If this value is "", bad_mac_id is displayed as regular text



trial2:enter_reg




trial2:enter_reg_url



trial2:trial_window_title

"Please Enter your License Key"
This message is displayed to prompt the user to enter their license key on the dialog box that appears after clicking the "Enter License Key" button.


""
If this value is specified, enter_reg becomes a hyperlink
If this value is "", enter_reg is displayed as regular text


"Please Enter your License Key"
If this value is displayed for the dialog box which request the user to Enter a License Key



trial2:macid_show







trial2:macid_show_url

"Your Machine ID = %s"
This message is on the dialog which prompts the user to enter their License Key. The purpose of displaying this string is to inform the user of their current Machine ID in case they need to provide it to you (the vendor) so you can generate Machine-ID restricted license keys. This message is not displayed if the option "Display Machine ID on register dialog" is unchecked in the License System 2 Settings Tab.


""
If this value is specified, macid_show becomes a hyperlink
If this value is "", macid_show is displayed as regular text




trial2:bad_serial_msg





trial2:bad_serial_title

"Sorry, the License Key you entered is invalid\nPlease try again checking your input carefully"
This message is displayed if the user enters a License Key which is invalid. A license key will be invalid if it was entered incorrectly or was generated using a different password.

"Invalid License Key"
This is the text to display in the title of the dialog box for the above message.



trial2:duplicate_key






trial2:duplicate_key_title

"The License Key you entered:\n\n%s\n\nis already set as the current License Key\nNo changes to your License have been applied"
This message is displayed if the user enters the same License Key as is currently set. I.e. The user enters the same license key twice. This message will not be displayed in the event the user enters KeyA, then KeyB, and finally KeyA again. Note: The %s characters will be replaced by Thinstall with the user's current License Key.

"License Key already set"

This text will be displayed in the dialog title for the message above.


trial2:expired_key







trial2:expired_key_title

"The License Key you entered:\n\n%s\n\nhas expired or is not valid for this computer.\nPlease enter a different License Key"
This message is displayed when the user's license key is valid in terms of being generated by you, however the key has already expired and has no time or executions remaining. Note: The characters %s will be replaced with the license key the user entered. After this message is displayed Thinstall will revert back to the previous license key.

"License Key expired or invalid"
This text will be displayed in the dialog title for the message above.


trial2:trial_quit_button



"Quit"
This is the text to be displayed on the button associated with Quit.

trial2:trial_next_button

"Next"
This is the text to be displayed on the button associated with Next on the "Enter License Key" dialog box.


trial2:register_button

"Enter License Key"
This is the text to be displayed on the button that will bring the user to the "Enter License Key" dialog box.



trial2:register_later_button

"Enter License Key Later"
This is the text to be displayed on the button that will bring the user to the "Enter License Key" dialog box. This button is not displayed if the current license key has no time or execution restrictions.




All URLs may include 0, 1, or 2 "%s" symbol pairs. The first %s will be replaced with the user MachineID, the second with the user's current license key. For example the URL:

http://thinstall.com/purchase?machine_id= %s
becomes:
http://thinstall.com/purchase?machine_id= qgsu1ha79a2shwwp

and

http://thinstall.com/purchase?machine_id= %s
&current_key= %s
becomes:
http://thinstall.com/purchase?machine_id= qgsu1ha79a2shwwp
&current_key= 756k9thahu65t9usapajvk21dh2qax2

Note: When a message is displayed as a URL, the user is not able to Cut & Paste the contents.