/*****************************************************************************
*
* File: PlatformCheck.js
*
* Description:
* Javascript library containing methods to test client platform and
* browser types and versions. Function calls can be made in VSS
* templates, leaving the developer to provide feedback regarding
* supportability of the web-based application on the client
* configuration.
*
*****************************************************************************/
/*****************************************************************************
* Function: vi_getPlatformType
*
* Description:
* Method to return name of client platform.
*
* Arguments: None
*
* Return value:
* Windows, Macintosh or Unix, depending on platform type. Returns
* Unknown if the platform type is not recognized.
*
* Side Effects: None
*
*****************************************************************************/
function vi_getPlatformType()
{
var platform = 'Unknown';
if( navigator.userAgent )
{
var agent = navigator.userAgent.toLowerCase();
if( agent.indexOf( 'win' ) != -1 )
{
platform = 'Windows';
}
else if( agent.indexOf( 'mac' ) != -1 )
{
platform = 'Macintosh';
}
else if( agent.indexOf( 'unix' ) != -1 ||
agent.indexOf( 'solaris' ) != -1 ||
agent.indexOf( 'sun' ) != -1 ||
agent.indexOf( 'irix' ) != -1 ||
agent.indexOf( 'linux' ) != -1 ||
agent.indexOf( 'bsd' ) != -1 ||
agent.indexOf( 'aix' ) != -1 ||
agent.indexOf( 'hp' ) != -1 )
{
platform = 'Unix';
}
}
return platform;
}
/*****************************************************************************
* Function: vi_getPlatformOS
*
* Description:
* Method to return name of client operating system.
*
* Arguments: None
*
* Return value:
* For the Windows platform: NT/ME/XP/95/98/2000/Unknown
* For the Macintosh platform: Version Number or Unknown
* For the Unix platform: Flavor of Unix or Unknown
*
* Side Effects: None
*
*****************************************************************************/
function vi_getPlatformOS()
{
var OS = 'Unknown';
if( navigator.userAgent )
{
var agent = navigator.userAgent.toLowerCase();
if( vi_getPlatformType() == 'Windows' )
{
if( agent.indexOf( 'winnt' ) != -1 )
{
OS = 'NT';
}
else if( agent.indexOf( 'win 9x 4.90' ) != -1 )
{
OS = 'ME';
}
else if( agent.indexOf( 'windows xp' ) != -1 ||
agent.indexOf( 'winxp' ) != -1 )
{
OS = 'XP';
}
else if( agent.indexOf( 'windows 95' ) != -1 ||
agent.indexOf( 'win95' ) != -1 )
{
OS = '95';
}
else if( agent.indexOf( 'windows 98' ) != -1 ||
agent.indexOf( 'win98' ) != -1 )
{
OS = '98';
}
else if( agent.indexOf( 'windows nt' ) != -1 )
{
var start = agent.indexOf( 'windows nt' ) + 10;
if( parseInt( agent.substring( start ) ) == 4 ) {
OS = 'NT';
}
else if( parseFloat( agent.substr( start+1, 3 ) ) == 5.0 ) {
OS = '2000';
}
else if( parseFloat( agent.substr( start+1, 3 ) ) == 5.1 ) {
OS = 'XP';
}
else {
// We knew that we are windows nt already.
OS = 'NT';
}
}
else
{
OS = 'Unrecognized Windows';
}
}
else if( vi_getPlatformType() == 'Macintosh' )
{
if( agent.indexOf( 'os x' ) != -1 )
{
OS = 'Mac OS X';
}
// for Mac 5.2 is only for OS X
else if( agent.indexOf( 'msie' ) != -1 &&
agent.indexOf( '5.2' ) != -1)
{
OS = 'Mac OS X';
}
else
{
OS = 'Mac OS';
}
}
else if( vi_getPlatformType() == 'Unix' )
{
if( agent.indexOf( 'solaris' ) ||
agent.indexOf( 'sun' ) != -1 )
{
OS = 'Sun Microsystems';
}
else if( agent.indexOf( 'irix' ) != -1 )
{
OS = 'Silicon Graphics IRIX';
}
else if( agent.indexOf( 'linux' ) != -1 )
{
OS = 'Linux';
}
if( agent.indexOf( 'bsd' ) != -1 )
{
OS = 'Free BSD';
}
else if( agent.indexOf( 'aix' ) != -1 )
{
OS = 'IBM AIX';
}
else if( agent.indexOf( 'hp' ) != -1 )
{
OS = 'Hewlett Packard Unix';
}
else
{
OS = 'Unrecognized Unix';
}
}
}
return OS;
}
/*****************************************************************************
* Function: vi_getBrowserType
*
* Description:
* Method to return name of client browser.
*
* Arguments: None
*
* Return value:
* MSIE or Netscape, depending on client browser. Returns
* Unknown if the browser type is not recognized.
*
* Side Effects: None
*
*****************************************************************************/
function vi_getBrowserType()
{
var browser = 'Unknown';
if( navigator.appName )
{
var app = navigator.appName.toLowerCase();
if( app.indexOf( 'netscape' ) != -1 )
{
browser = 'Netscape';
}
}
if( navigator.userAgent )
{
var agent = navigator.userAgent.toLowerCase();
if( agent.indexOf( 'msie' ) != -1 )
{
browser = 'MSIE';
}
}
return browser;
}
/*****************************************************************************
* Function: vi_getBrowserVersion
*
* Description:
* Method to return version number of client browser.
*
* Arguments: None
*
* Return value:
* Version number of Netscape or IE depending on client browser.
* Returns -1 if the browser type is unrecognized or the version
* number cannot be determined.
*
* Side Effects: None
*
*****************************************************************************/
function vi_getBrowserVersion()
{
var version = -1;
if( navigator.appName )
{
var app = navigator.appName.toLowerCase();
if( app.indexOf( 'netscape' ) != -1 )
{
if( navigator.appVersion )
{
version = parseFloat( navigator.appVersion );
if (version >= 5.0)
{
if (navigator.userAgent)
{
var agent = navigator.userAgent.toLowerCase();
var len = agent.length;
// Look for the last '/'
var start = agent.lastIndexOf( '/');
var verstr = agent.substr(start+1);
if (parseInt(verstr) >= 6)
{
version = parseFloat(verstr);
}
}
}
}
}
}
if( navigator.userAgent && navigator.appVersion )
{
var agent = navigator.userAgent.toLowerCase();
if( agent.indexOf( 'msie' ) != -1 )
{
var start = agent.indexOf( 'msie' ) + 4;
version = parseFloat( agent.substring( start ) );
}
}
return version;
}
/*****************************************************************************
* Function: vi_checkWindowsPlayerPlugin
*
* Description:
* Method to return flag indicating whether the WindowsMedia player
* plug-in is installed and available. This method is originally
* based upon free Javascript available via www.javascriptkit.com
* and written by Frederic (fw4@tvd.be). This method invokes the
* appropriate underlying method based upon the client browser.
*
* Arguments: None
*
* Return value:
* Returns 1 if the WindowsMedia plugin is installed and available.
* Returns 0 if the WindowsMedia plugin is not available.
* Returns -1 if the WindowsMedia plugin status could not be determined.
*
* Side Effects: None
*
*****************************************************************************/
function vi_checkWindowsPlayerPlugin()
{
var platform = vi_getPlatformType();
var browser = vi_getBrowserType();
if( platform == 'Windows' && browser == 'MSIE' ) {
return vi_detectIEPlugin( 'MediaPlayer.MediaPlayer.1' );
}
else if( platform != 'Windows' || browser == 'Netscape' ) {
return vi_detectNSPlugin( 'application/x-mplayer2',
'Windows Media Player' );
}
else {
return -1;
}
}
/*****************************************************************************
* Function: vi_checkRealPlayerPlugin
*
* Description:
* Method to return flag indicating whether the RealMedia player
* plug-in is installed and available. This method is originally
* based upon free Javascript available via www.javascriptkit.com
* and written by Frederic (fw4@tvd.be). This method invokes the
* appropriate underlying method based upon the client browser.
*
* Arguments: None
*
* Return value:
* Returns 1 if the RealPlayer plugin is installed and available.
* Returns 0 if the RealPlayer plugin is not available.
* Returns -1 if the RealPlayer plugin status could not be determined.
*
* Side Effects: None
*
*****************************************************************************/
function vi_checkRealPlayerPlugin()
{
var platform = vi_getPlatformType();
var browser = vi_getBrowserType();
var realPluginAvailable = -1;
if( platform == 'Windows' && browser == 'MSIE' ) {
return vi_detectIEPlugin( 'rmocx.RealPlayer G2 Control.1' );
}
else if( platform != 'Windows' || browser == 'Netscape' ) {
realPluginAvailable = vi_detectNSPlugin( 'audio/x-pn-realaudio-plugin','RealPlayer' );
if (realPluginAvailable == -1)
{
// Test for the RealOne Player plugin.
realPluginAvailable = vi_detectNSPlugin( 'application/vnd.rn-realplayer-javascript','RealOne Player' );
}
return realPluginAvailable;
}
else {
return -1;
}
}
/*****************************************************************************
* Function: vi_checkSVGViewerPlugin
*
* Description:
* Method to return flag indicating whether the SVG viewer
* plug-in is installed and available. This method is originally
* based upon free Javascript available via www.javascriptkit.com
* and written by Frederic (fw4@tvd.be). This method invokes the
* appropriate underlying method based upon the client browser
* (Netscape or Internet Explorer, other browsers unsupported)
*
* Arguments: None
*
* Return value:
* Returns 1 if the SVG viewer plugin is installed and available.
* Returns 0 if the SVG viewer plugin is not available.
* Returns -1 if the SVG viewer plugin status could not be determined.
*
* Side Effects: None
*
*****************************************************************************/
function vi_checkSVGViewerPlugin()
{
var platform = vi_getPlatformType();
var browser = vi_getBrowserType();
if( platform == 'Windows' && browser == 'MSIE' ) {
return vi_detectIEPlugin( 'Adobe.SVGCtl' );
}
else if( platform != 'Windows' || browser == 'Netscape' ) {
return vi_detectNSPlugin( 'image/svg-xml', 'SVG Viewer' );
}
else {
return -1;
}
}
/*****************************************************************************
* Function: vi_checkShockwaveDirectorPlugin
*
* Description:
* Method to return flag indicating whether the Shockwave Director
* plug-in is installed and available. This method is originally
* based upon free Javascript available via www.javascriptkit.com
* and written by Frederic (fw4@tvd.be). This method invokes the
* appropriate underlying method based upon the client browser.
*
* Arguments: None
*
* Return value:
* Returns 1 if the Shockwave Director plugin is installed and available.
* Returns 0 if the Shockwave Director plugin is not available.
* Returns -1 if the Shockwave Director plugin status could not be
* determined.
*
* Side Effects: None
*
*****************************************************************************/
function vi_checkShockwaveDirectorPlugin()
{
var platform = vi_getPlatformType();
var browser = vi_getBrowserType();
if( platform == 'Windows' && browser == 'MSIE' ) {
return vi_detectIEPlugin( 'SWCtl.SWCtl.1' );
}
else if( platform != 'Windows' || browser == 'Netscape' ) {
return vi_detectNSPlugin( 'application/x-director',
'Shockwave Director' );
}
else {
return -1;
}
}
/*****************************************************************************
* Function: vi_checkShockwaveFlashPlugin
*
* Description:
* Method to return flag indicating whether the Shockwave Flash
* plug-in is installed and available. This method is originally
* based upon free Javascript available via www.javascriptkit.com
* and written by Frederic (fw4@tvd.be). This method invokes the
* appropriate underlying method based upon the client browser.
*
* Arguments: None
*
* Return value:
* Returns 1 if the Shockwave Flash plugin is installed and available.
* Returns 0 if the Shockwave Flash plugin is not available.
* Returns -1 if the Shockwave Flash plugin status could not be
* determined.
*
* Side Effects: None
*
*****************************************************************************/
function vi_checkShockwaveFlashPlugin()
{
var platform = vi_getPlatformType();
var browser = vi_getBrowserType();
if( platform == 'Windows' && browser == 'MSIE' ) {
return vi_detectIEPlugin( 'ShockwaveFlash.ShockwaveFlash.1' );
}
else if( platform != 'Windows' || browser == 'Netscape' ) {
return vi_detectNSPlugin( 'application/x-shockwave-flash',
'Shockwave Flash' );
}
else {
return -1;
}
}
/*****************************************************************************
* Function: vi_checkQuickTimePlugin
*
* Description:
* Method to return flag indicating whether the QuickTime plug-in
* is installed and available. This method is originally based upon
* free Javascript available via www.javascriptkit.com and written by
* Frederic (fw4@tvd.be). This method invokes the appropriate underlying
* method based upon the client browser.
*
* Arguments: None
*
* Return value:
* Returns 1 if the QuickTime plugin is installed and available.
* Returns 0 if the QuickTime plugin is not available.
* Returns -1 if the QuickTime plugin status could not be determined.
*
* Side Effects: None
*
*****************************************************************************/
function vi_checkQuickTimePlugin()
{
var platform = vi_getPlatformType();
var browser = vi_getBrowserType();
if( platform == 'Windows' && browser == 'MSIE' ) {
return vi_detectIEPlugin( 'QuickTimeCheckObject.QuickTimeCheck.1' );
}
else if( platform != 'Windows' || browser == 'Netscape' ) {
return vi_detectNSPlugin( 'video/quicktime', 'QuickTime' );
}
else {
return -1;
}
}
/*****************************************************************************
* Function: vi_checkAcrobatReaderPlugin
*
* Description:
* Method to return flag indicating whether the Adobe Acrobat Reader
* plug-in is installed and available. This method is originally
* based upon free Javascript available via www.javascriptkit.com
* and written by Frederic (fw4@tvd.be). This method invokes the
* appropriate underlying method based upon the client browser.
*
* Arguments: None
*
* Return value:
* Returns 1 if the Acrobat Reader plugin is installed and available.
* Returns 0 if the Acrobat Reader plugin is not available.
* Returns -1 if the Acrobat Reader plugin status could not be determined.
*
* Side Effects: None
*
*****************************************************************************/
function vi_checkAcrobatReaderPlugin()
{
var platform = vi_getPlatformType();
var browser = vi_getBrowserType();
if( platform == 'Windows' && browser == 'MSIE' ) {
return vi_detectIEPlugin( 'PDF.PdfCtrl.5' );
}
else if( platform != 'Windows' || browser == 'Netscape' ) {
return vi_detectNSPlugin( 'application/pdf', 'Acrobat Reader' );
}
else {
return -1;
}
}
/*****************************************************************************
* Function: vi_checkJavaEnabled()
*
* Description:
* Method to return flag indicating whether the browser is Java
* enabled. This method is originally based upon free Javascript
* available via www.javascriptkit.com and written by Frederic
* (fw4@tvd.be). This method invokes the appropriate underlying
* method based upon the client browser.
*
* Arguments: None
*
* Return value:
* Returns 1 if the browser is Java-enabled
* Returns 0 if the browser is not Java-enabled
*
* Side Effects: None
*
*****************************************************************************/
function vi_checkJavaEnabled()
{
return navigator.javaEnabled() ? 1 : 0;
}
/*****************************************************************************
* Function: vi_detectIEPlugin()
*
* Description:
* Internal method to return flag indicating whether the specified
* plugin is available. This method is only supported for the Internet
* Explorer browser on the Windows platform. This method is originally
* based upon free Javascript available via www.javascriptkit.com and
* written by Frederic (fw4@tvd.be).
*
* Arguments:
* pluginName the name of the plugin for which to check availability
*
* Return value:
* Returns 1 if the plug-in is installed and available
* Returns 0 if the plug-in is not installed and available
* Returns -1 if plug-in status could not be determined
*
* Side Effects: None
*
*****************************************************************************/
function vi_detectIEPlugin( ClassID )
{
res = 0;
var platform = vi_getPlatformType();
var browser = vi_getBrowserType();
if( platform != 'Windows' || browser != 'MSIE' )
{
res = -1;
}
else
{
document.write( '\n');
if( res ) {
res = 1;
}
}
return res;
}
/*****************************************************************************
* Function: vi_getNSPlugin()
*
* Description:
* Internal method to return the full name of the specified
* plugin. This method is only supported for the Netscape browser. This
* method is originally based upon free Javascript available via
* www.javascriptkit.com and written by Frederic (fw4@tvd.be).
*
* Arguments:
* pluginName the name of the plugin for which to check availability
*
* Return value:
* pluginName the name of the plugin for which to check availability
*
* Side Effects: None
*
*****************************************************************************/
function vi_getNSPlugin(pluginName )
{
var retVal = "";
if( navigator.plugins )
{
for( var count = 0; count < navigator.plugins.length; count++ )
{
var curName = navigator.plugins[count].name.toLowerCase();
if( curName.indexOf( pluginName.toLowerCase() ) != -1 )
{
retVal = navigator.plugins[count].name;
}
}
}
return retVal;
}
/*****************************************************************************
* Function: vi_detectNSPlugin()
*
* Description:
* Internal method to return flag indicating whether the specified
* plugin is available and configured to support the specified MIME
* type. This method is only supported for the Netscape browser. This
* method is originally based upon free Javascript available via
* www.javascriptkit.com and written by Frederic (fw4@tvd.be).
*
* Arguments:
* mimeType the MIME type the plug-in is required to support
* pluginName the name of the plugin for which to check availability
*
* Return value:
* Returns 1 if the plug-in/MIME type combination is supported
* Returns 0 if the plug-in/MIME type combination is not supported
* Returns -1 if plug-in or MIME type status could not be determined.
*
* Side Effects: None
*
*****************************************************************************/
function vi_detectNSPlugin( mimeType, pluginName )
{
var retVal = -1;
if( navigator.plugins )
{
retVal = 0;
for( var count = 0; count < navigator.plugins.length; count++ )
{
var curName = navigator.plugins[count].name.toLowerCase();
if( curName.indexOf( pluginName.toLowerCase() ) != -1 )
{
// The plug-in has been found, so see if it supports the
// specified MIME type.
var mimeArr = navigator.plugins[count];
if( mimeArr )
{
for( var mcount = 0; mcount < mimeArr.length; mcount++ )
{
var curMime = mimeArr[mcount].type.toLowerCase();
if( curMime.indexOf( mimeType.toLowerCase() ) != -1 )
{
// The plugin supports the specified MIME type
retVal = 1;
break;
}
}
}
else
{
// Unable to determine which MIME types are supported
retVal = -1;
}
break;
}
}
}
return retVal;
}
/*****************************************************************************
* Function: vi_getRealPlayerBuild
*
* Description:
* Method to return the version of the Real Player (or RealOne Player)
* plug-in installed for the current browser, or -1 if the Real Player
* is not installed and available.
*
* Arguments: None
*
* Return value:
* Version number of RealPlayer installed. Returns -1 if the
* RealPlayer plugin is not installed and available, or if its
* status cannot be determined. Build numbers map to RealPlayer
* releases as follows (from http://service.real.com/help/library/
* guides/realonescripting/browse/realscript.htm):
* Release Version Standalone Build Embedded Player Build
* --------------------- ---------------- ---------------------
* RealPlayer 8 Update 3 6.09.584 6.0.8.1024
* RealPlayer 8 Update 2 6.0.9.450 6.0.7.881
* RealPlayer 8 Gold 6.0.9.357 6.0.7.788
* RealPlayer 7 Update 1 6.0.8.122 6.0.7.529
* RealPlayer 7 Gold 6.0.7.380 6.0.7.407
* RealPlayer G2 Update 3 6.0.6.99 6.0.6.98
* RealPlayer G2 Update 2 6.0.6.33 6.0.6.33
* RealPlayer G2 Update 1 6.0.5.27 6.0.5.27
* RealPlayer G2 Gold 6.0.3.128 6.0.6.131
*
* Side Effects: None
*
*****************************************************************************/
function vi_getRealPlayerBuild()
{
if (vi_checkRealPlayerPlugin() <= 0)
{
return -1;
}
if (!( document.vid ))
{
var rp = '