PocketWP/README.md

PocketWP
========

A helper class for apps wanting to create a Pocket client, or wanting to send stuff to a pocket client on Windows Phone. For apps wanting to send items to Pocket, this provides methods to ease launching any Pocket clients that the user has installed. For Pocket client developers, this allows you to easily tap into the shared URI scheme used by other apps. 

## Sending to Pocket Clients ##
Sending to a Pocket client in its simplest form is as easy as doing:

```c#
PocketHelper.AddItemToPocket("http://www.getpocket.com");
```

You can send multiple items to a Pocket client, but only a list of URLs and a comma separated list of tags. 

The helper also allows your app to send a callback URI to the Pocket client too, so that when it's finished adding the item(s), it can relaunch your app again, keeping the user's flow in tact.

## Use in Pocket Clients ##
This helper will allow you to easily check a url that is passed to your app and detect if it's a Pocket request, and if it is, it will give you an object that you can then use in your own app.

In your UriMapper, you will have code similar to this:

```c#
if (PocketHelper.HasPocketItem(uri))
{
    var item = PocketHelper.RetrievePocketItem(uri);
    
    // Save the item somewhere for use within your app

    if (item.Type == AddType.Single)
    {
        return new Uri("AddSinglePage.xaml", UriKind.Relative);
    }
    else
    {
        return new Uri("AddMultiplePage.xaml", UriKind.Relative);    
    }
}
```