JIM Control Usage Manual : Add Favorite, Set Homepage, Send To Friend, Get URL
[ To Table Of Contents ]

Some other functions of the JIM Control provide your visitors with some simple methods with which to remember your web site and tell other people about it. Some of the functions, because of security settings in some newer web browsers, may not automate such processes (for example, adding the web page to the visitor's Favorites menu). In these cases, the JIM Control will display a message to the user about the setting and offer an alternative. Before these functions are covered, an unrelated function "Get URL" will be discussed below.

An unrelated function, more for the web site owner's use, is a function called wgeturl(). If you use this function it will return the current URL of the web page the visitor is currently looking at. An example use of such a function could be to help troubleshoot web site problems.

Add Favorite, Set Homepage, Send To Friend
Below are the details for the functions that can be utilized for "Add Favorite", "Set Homepage", and "Send To Friend".

Add Favorite - wfavorites()
You could use this function in a hyperlink that can add the current web page to the user's "Favorites" list. This option is typically only available with Internet Explorer web browsers, but an alternative is presented to users of other web browsers.

Set Homepage - wsethome()
You could use this function in a hyperlink that can set the user's start page to the current web page they are viewing on your web site. This option is typically only available with Internet Explorer and Netscape web browsers, but an alternative is presented to users of other web browsers.

Send To Friend - wemail_friend()
You could use this function in a hyperlink that would compose an email message in the user's client email program. Because this function composes an email message, you have the opportunity to specify what will be in the email message as indicated below:

In the JIM Control is a variable named wef_msg_subject. Modify the value of this variable to reflect the text you want displayed in the subject line of the email message.

In the JIM Control is a variable named wef_msg_body. Modify the value of this variable to reflect the text you want displayed in the body of the email message.

It is important to note that the current web page URL is automatically added in the body of the email message for you with a brief introductory sentence that states:"When you get a chance, please check out the following web page:".