// ------------------------------------------------------------ // Functions for client-side management of cookie-based popups. // ------------------------------------------------------------ // // Usage: // 1. Include this script between the tags of the desired HTML page, like: // // 2. In the BODY begin tag add an "onload" event handler containing a call to "initializePopup". // 3. At the end of the page, before the ending tag, include: // - the DIV representing the pseudo-popup (its ID will be used wherever the "popupID" is required); // - inside the DIV: the actual IMG representing the popup, and referencing the MAP with clickable areas; // - the MAP element that describes the clickable areas of the popup; // - inside the MAP: AREA elements representing active parts of the popup; // - the AREA elements that are to hide and disable (temporarily or permanently) the popup need to have // the "onclick" attribute set with a call to the "disablePopup" function. // Note: If desired, the "onunload" event handler of the BODY tag can also be hooked in order to call // "disablePopup". This will then disable (for the specified duration) the popup as soon as the // user leaves the page or closes the window. // Details regarding the usage of the mentioned functions are available below with the function definitions. // // ----------------------------------------------------------- // ----------------------------------------------------------- // A. Functions for management of cookie-based pseudo-popups. // In order to conditionally display a cookie-based popup, call initializePopup. // In order to hide and disable (potentially just temporarily) the popup, call disablePopup. // ----------------------------------------------------------- // ----------------------------------------------------------- // Function for initializing a cookie-based popup: // - displays the popup if no cookie was set // - hides the popup if an associated cookie exists. // This function should be called upon completing the load of the popup's host page. // Supply the ID of the popup object of interest. // The second argument is optional, and represents the number of milliseconds to delay // the display of the popup. If not supplied, the default value is 1000 (i.e. 1 second). function initializePopup(popupId,delay) { var d=parseInt(delay); if (isNaN(d)||d<0) d=1000; window.setTimeout("showPopup(findPopup('"+popupId+"'),isPopupEnabled('"+popupId+"')?'show':'hide')",d); } // Set a cookie to signal that this popup object should no longer be displayed. // Supply the ID of the popup object of interest. // Optionally an integer can be supplied, representing the interval, in minutes, // during which the popup must remain disabled. function disablePopup(popupId, minutesDisabled) { // expiration time for the cookie - by default, Jan-01-2015 // if set too far in the future, some older browsers will not set it correctly, // i.e. will set instead a cookie that expires at the end of the browser's session var dExpiration=new Date(2015, 0, 1); // check if an interval has been specified var iMinutes=parseInt(minutesDisabled); if (!isNaN(iMinutes)) { // add the specified number of minutes to the current time - this will be the expiration time var d=new Date(); dExpiration=new Date(d.getFullYear(), d.getMonth(), d.getDate(), d.getHours(), d.getMinutes()+iMinutes, d.getSeconds()); } // set a cookie with a name based on the supplied ID, and marked to // expire after the supplied number of minutes (or else in year 2015) setCookie(buildPopupCookieName(popupId), 'disabled', dExpiration); // hide the popup anyway showPopup(findPopup(popupId),'hide'); } // Find out (by querying a cookie) whether or not to display the popup. // Supply the ID of the popup object of interest. function isPopupEnabled(popupId) { // if the cookie exists, the popup must not be displayed return (getCookie(buildPopupCookieName(popupId)) ? false : true); } // Build a cookie name based on the ID of a HTML element. // Supply the ID of the popup object of interest. function buildPopupCookieName(popupId) { return 'popup_cookie_' + popupId; } // Helper function for locating the popup object inside the hosting page. // Attempts various standard & browser-specific ways to reach the popup object. // Supply the ID of the popup object of interest, and optionally the document object. function findPopup(popupId, doc) { var i,obj; if (!doc) doc=document; if (doc.getElementById) obj=doc.getElementById(popupId); if (!obj&&!(obj=doc[popupId])&&doc.all) obj=doc.all[popupId]; for (i=0;!obj&&i