//<style type="text/css">
//.popupmessage, #popupmessage {
//  position: absolute; left: 100px; top: 10px; 
//  width: 200px;
//  color: black;
//  background-color: white;
//  font-weight: bold;
//  border: solid red 3px;
//  padding: 1em;
//}
//</style>

// *********************************************************************
// wfwiblib.js - A single library included as part of all pages with 
//               various utility functions
// *********************************************************************

// **********************************************************************
// Reusable, robust window opener
//   Credits: http://devedge.netscape.com/viewsource/2002/popup-control/
// **********************************************************************
// Notes:
//  The onLoad event handler is the target of most window suppression mechanisms.  
//  MSIE versions through 6.0 do not support this suppression, although add-ins may. 
//  Mozilla 1.1x+ provides a preference for "Advanced - Scripts &amp; Plugins", deselect,
//                Allow Scripts to: Open unrequested windows.
//         Furthermore, if you and edit prefs.js you can suppress a great deal.
// Other articles pertaining to browser preferencs/windows:
//    http://www.mozilla.org/unix/customizing.html
//    http://www.mozilla.org/projects/security/components/ConfigPolicy.html
//  Opera 7.x provides the greatest/easiest degree of control over scripting, windows, frames, etc.
// -----------------------------------------------------------------------

// -----------------------------------------------------------------------
// Usage:
//
// This example takes all the defaults, and takes the href object as the url.
//
// onClick event Handler
//   <p>Clicking a <a href="popped-child.html" 
//    onClick="wfOpenWin(this); return false;">demonstration</a> 
//    link will open a new browser</p>
//
// -----------------------------------------------------------------------

function wfOpenWin(url, wname, wfeatures) {
  //
  // where the parameters are:
  //   url = the url of the child window
  //   wname = window name 
  //   wfeatures = window features: browser chrome, window position [defaults to 300x300 chromeless window]
  //
  newwin = '';

   // add some parameter checking and reasonable defaults
   if (!wname) { 
     wname = 'Help';
   }
   if (!wfeatures) {
     // with the exception of height/width (<400) other chrome per WRD recommendations 
     wfeatures = 'height=300,width=300,toolbar=no,locationbar=no,personalbar=no,menubar=yes,status=yes,resizable=yes';
   }
   if (!url) {
     url = 'about:blank';
   }

   // attempt to open the popup
   if ( hasTryCatch() ){
     // any browser that can suppress window pop-ups, is modern enough to have JS 1.5/EcmaScript 3rd ed.
     // hide the try from NN4.x since it can not compile the script if it "sees" it
     eval("try { newwin = window.open(url, wname, wfeatures); } catch (e) { newwin = ''; }");
   } else {
     // older browsers that don't JS 1.5 also do not support window suppression
     newwin = window.open(url, wname, wfeatures);
   }

  // check results
  if (newwin !== '') {
    // popup succeeded
    // Notes: Opera was causing unknown errors on focusing. This will bypass the problem, but won't bring the child into focus.
    //        When Opera preferences set to: Pop-ups=Refuse pop-ups, will supress window.open calls altoghether and return true, 
    //          so that the link is followed.
    if (!window.opera) {newwin.focus();}
  } else {
    // popup failed
    showPopUpMsg(url);
  }
  return; 
}

//
// Used by: wfOpenWin
//
function showPopUpMsg(url) {
  // intialize some stuff
  var cname = 'popupmessage';
  var warningtext ='Your computer settings do not allow other browser windows to open, which prevents our site from working properly.';
  warningtext += '<a href="'+url+'" onclick="wfOpenWin( \''+url+'\');hidePopupMessage(); return true;">';
  warningtext += '<p>Open the page in this window' + '<\/a>.<\/p>';
  warningtext += '<p align="center">' + '<a href="#" onclick="hidePopupMessage(); return false;">Close this message<\/a><\/p>';
  warningtext += '<\/div>';
    
  // test for DOM support
  if (!document.createElement) {
    return;
  }
   // make us an element
   var elmDiv = document.createElement('div');
   
   // check on datatyping
   if (typeof(elmDiv.innerHTML) != 'string') {
     return;
   }
   
   // add properties to new element
   elmDiv.id='popupmessage';
   elmDiv.style.className=cname;
   
   // add the element to the page
   document.body.appendChild(elmDiv);
   elmDiv.innerHTML=warningtext;
}

//
// Used by: showPopUpMessage
//
function hidePopupMessage() {
  var elmDiv=document.getElementById('popupmessage');
  if (elmDiv) {
    elmDiv.parentNode.removeChild(elmDiv);
  }
}

//
// test language for try/catch ... JavaScript 1.5 functionality
// known not to be available in NN4.x, MSIE 4.x, who-knows-what-else
// 
function hasTryCatch () {
  // initialize try/catch boolean exit value
  var tc = false;
  
  // NN4 can't seem to handle the test for the language feature, so just bail
  if (document.layers) {
    return tc 
  }

  // suppress error report while we test for language feature
  window.onerror=function(){onerror=null;return true;};
  eval('try{} finally{tc=true;}');
  window.onerror=null;
  
  // test complete 
  return tc;
}