getVersion(), "Pro") === false && strpos($BrowserHawk->getVersion(), "Ent") === false) { echo "Professional or Enterprise License Required. "; echo "You are using " . $BrowserHawk->getVersion() . ". "; echo "See http://www.cyscape.com/order/ for upgrade information."; return; } // Now we tell BrowserHawk which tests we want it to perform on the // browser. If there are other settings you want to check as well, you can // just add them to this list. See the ExtendedOptions class in the // BrowserHawk documentation for more information. $options->addProperties("PersistentCookies, SessionCookies, JavaScriptEnabled, Width, Height, WidthAvail, HeightAvail, Plugin_Flash, Broadband"); // Now we set various preferences and options for how we want // BrowserHawk to perform its test. See the ExtendedOptions class in // the documentation for details on options available such as // controlling the background color of the screen and page messages i.e. // "Checking your browser. Please wait...". // TIP: Set the BGCOLOR parameter below to your site's background color. // Otherwise you may notice a color flicker during the test. $options->setPageTitle("Please wait..."); $options->setPageMessage("Checking your system. Please wait..."); $options->setBodyTag("BGCOLOR=#FFFFFF"); // Now we tell BrowserHawk we want it to cache the results of the test // in the user's session. We do this simply by setting the // ExtendedOption CacheToken property. The token name used can be // any valid session variable name. NOTE: In order for this session // caching feature to work, you must have session tracking enabled. $options->setCacheToken("bhawk_results"); // Above we are using "bhawk_results" as the cache token. Whenver this // page runs again for this same user's session, or whenever any other // page using BrowserHawk runs again that also specifies this same cache // token, BrowserHawk will automaticall pull the results from the cache, // and NOT re-execute the test, even though the code below still calls // bhextended(). In this case bhextended() just retrives the cached // ExtendedBrowserInfo object from the user's session, instead of // retesting the browser. // Now call the bhextended() function which tells BrowserHawk that // we are finished setting our options and that it should perform the // browser test now. If this is the first time this page is executing // under this user's session, BrowserHawk will actually perform the test // and then cache the results in the user's session object. // If this is not the first time this page is executing for the user's // session, or if a previous page performed an extended property test // and specified the same CacheToken value for the ExtendedOptions class, // then Browserhawk will NOT perform the test again. Rather, the call to // bhextended() will simply retrieve the ExtendedBrowserInfo from the // session. // NOTE: You should not attempt to access the cached object directly from // the session object, but rather by calling bhextended(). BrowserHawk // will return the cached ExtendedBrowserInfo object for you automatically. // Note: There may be situations where you want to force BrowserHawk to // retest a browser even though the information is already in the cache. // For example, let's say you test a browser for a required screen size // and the user's screen size is too small. You then provide the user // with information on how to increase their screen size and provide a // link for them to retry the test to confirm their new settings are // correct so they can proceed with your site. If you do not force a // clear of the cached information, BrowserHawk will continue to return // their original screen size test result. Therefore in such situations, // you will want to call the options->setCacheForceRefresh() method and // pass in a value of true. This tells BrowserHawk to retest the // browser even if cached information is already available. The results // from the retest are then returned by BrowserHawk and stored in the // cache for reuse. $einfo = bhextended($options); ?> BrowserHawk Sample - Performing Popular BrowserHawk Tests (PHP)

Some Popular BrowserHawk Test Results (PHP)

This sample demonstrates how to perform some of the more popular browser tests.

It also demonstrates how BrowserHawk can automatically cache this information in the user's session. This way if the BrowserHawk test results are needed on the same or subsequent page later, BrowerHawk can just return the information to you from the session, rather than retesting the browser. See the source code for this sample for more information.

BrowserHawk results obtained from cache? isFromCache()) { ?> YES, results are from cached BrowserHawk information in user's session NO, results are NOT from the cache but will be on next retry

Session cookies enabled? getSessionCookies()) ?>

Persistent cookies enabled? getPersistentCookies()) ?>

JavaScript enabled? getJavaScriptEnabled()) ?>

Screen resolution: getWidth() ?> x getHeight() ?>

Available browser window size: getWidthAvail() ?> x getHeightAvail() ?>

Flash plug-in version installed: getPluginFlash() ?>

Broadband connection? getBroadband()) ?>

Retry this test, but clear the cached results to force a retest of the browser

Retry this test

Return to list of other PHP samples

BrowserHawk Pricing and Ordering

cyScape home page