Account Options

...

Code

Code

Sample Code

Using BrowserPlus™ is simpler than you might think. We've created some samples to demonstrate how simple. If BrowserPlus is installed, you'll be also be able to run the samples on this page.

Introduction

Check for and initialize BrowserPlus.

Detecting BrowserPlus

How to detect if BrowserPlus is installed.

Using Services

How to specify in your webpage what BrowserPlus services you require.

Errors & Return Values

How results are asynchronously returned.

Drag and Drop

Hooking up a drop target in a webpage.

Accessing Files

Previewing and getting contents of files that users select.

Uploading Modified Images

A demo showing how to use ImageAlter and Upload in a chain to upload images altered on the client.

File Zipper

A demo showing how to use Zipper and Upload in a chain to compress all files into one *.zip file before uploading.

All About Uploading

A demonstration of the various features of the uploader service.

Image Twiddler

A complete web application that demonstrates client side image manipulation, tying together the concepts thus far.

Publish Subscribe

Shows how two different browser windows (even from different browsers) can send messages back and forth.

Detecting BrowserPlus

<html>
<head><title>What If BrowserPlus Isn't installed?</title></head>
<body>
Let's see if BrowserPlus&trade; is installed...

$BP.init(function(r) {
  function bplusInitialized() {
    // this function will be called when BrowserPlus is ready,
    // either after the user goes and installs it, or immediately if
    // BrowserPlus was already installed.

// so... require some services!
  }

if (r.success) {
    // BrowserPlus is installed and ready to go!
    alert("Yahoo! BrowserPlus installed, v" + $BP.getPlatformInfo().version);
    bplusInitialized();
  } else if (r.error == "bp.notInstalled") {
    // BrowserPlus isn't installed, but the client browser/operating system
    // is supported!  we can render a link to let our users know that
    // more features are available if they install the thing.
    BrowserPlus.initWhenAvailable({}, bplusInitialized);
    alert("Get BrowserPlus! You can do it!");
  } else if (r.error == "bp.unsupportedClient") {
    // Uh oh, they're running a browser we don't yet support.  We should
    // probably disable features that require browserplus, and rendering
    // an installation link for BrowserPlus is useless.
  } else {
    // yikes!  Unexpected error!
    throw(r.error + ": " + r.verboseError);
  }
});
</script>
</body>
</html>

Run this Code

Description

This code sample demonstrates how you can detect whether BrowserPlus is installed. Inline comments describe the four possible cases when you call BrowserPlus.init():

BrowserPlus is installed and ready to use: r.success === true.
BrowserPlus is not installed and client platform is supported, r.error === 'bp.notInstalled'.
BrowserPlus is not installed and client platform is NOT supported, r.error === 'bp.unsupportedClient'.
Otherwise, BrowserPlus encountered an error during initialization.

The last two cases should be considered failure cases, and as a developer you should disable BrowserPlus functionality. In the second case you can render a link pointing to http://browserplus.yahoo.com/install, and describe to your user what features will become available to them if they install BrowserPlus. Further, if you would like to automatically detect when BrowserPlus is installed without a page reload you can use the BrowserPlus.initWhenAvailable() platform function which will set up a poller and once init() completes successfully, will invoke the callback you provide.

Using this handful of tools it should be possible to craft the precise experience you're looking for.