More work on readme

Author: joshrps

readme.md

@@ -15,7 +15,7 @@ Add `"rocket-code/shopify": "~1.0"` in your "require" object. With a blank Larav
 	}
 ```
 ####Add the Service Provider
-In `app/config/app.php`, add `'RocketCode\Shopify\ShopifyServiceProvider'` to the end of the `'providers'` array.
+In `app/config/app.php`, add `RocketCode\Shopify\ShopifyServiceProvider` to the end of the `providers` array.
 
 ##Setting Up
 To begin, use `App::make()` to grab an instance of the `API` class.
@@ -60,7 +60,9 @@ Once the user accesses the Install URL and clicks the Install button, they will
 After setting up with at least `SHOP_DOMAIN`, `API_KEY`, & `API_SECRET`, call `getAccessToken()` with the code passed back in the URL. Laravel makes this easy:
 
 ```
+$code = Input::get('code');
 $sh = App::make('ShopifyAPI', ['API_KEY' => '', 'API_SECRET' => '', 'SHOP_DOMAIN' => '']);
+
 try
 {
 	$accessToken = $sh->getAccessToken($code);
@@ -82,7 +84,8 @@ try
 	$verify = $sh->verifyRequest(Input::all());
 	if ($verify)
 	{
-		// Make getAccessToken() request here
+		$code = Input::get('code');
+		$accessToken = $sh->getAccessToken($code);
 	}
 	else
 	{
@@ -99,5 +102,116 @@ catch (Exception $e)
 	
 ```
 
-`verifyRequest()` throws an Exception in two cases: If the timestamp generated by Shopify and your server are more than an hour apart, or if the argument passed is not an array or URL-encoded string of key/values.
+`verifyRequest()` returns `TRUE` when data is valid, otherwise `FALSE`. It throws an Exception in two cases: If the timestamp generated by Shopify and your server are more than an hour apart, or if the argument passed is not an array or URL-encoded string of key/values.
+
+If you would like to skip the timestamp check (not recommended unless you cannot correct your server's time), you can pass `TRUE` as a second argument to `verifyRequest()` and timestamps will be ignored:
+
+```
+$verify = $sh->verifyRequest(Input::all(), TRUE);
+```
+
+## Private Apps
+The API Wrapper does not distinguish between private and public apps. In order to utilize it with a private app, set up everything as you normally would, replacing the OAuth Access Token with the private app's Password.
+
+##Calling the API
+Once set up, simply pass the data you need to the `call()` method.
+
+```
+$result = $sh->call($args);
+```
+
+####`call()` Parameters
+The parameters listed below allow you to set required values for an API call as well as override additional default values.
+
+* `METHOD`: The HTTP method to use for your API call. Different endpoints require different methods.
+  * Default: `GET`
+* `URL`: The URL of the API Endpoint to call.
+  * Default: `/` (not an actual endpoint)
+* `HEADERS`: An array of additional Headers to be sent
+  * Default: Empty `array()`. Headers that are automatically sent include:
+    * Accept 
+    * Content-Type
+    * charset
+    * X-Shopify-Access-Token
+* `CHARSET`: Change the charset if necessary
+  * Default: `UTF-8`
+* `DATA`: An array of data being sent with the call. For example, `$args['DATA'] = array('product' => $product);` For an [`/admin/products.json`](http://docs.shopify.com/api/product#create) product creation `POST`.
+  * Default: Empty `array()`
+* `RETURNARRAY`: Set this to `TRUE` to return data in `array()` format. `FALSE` will return a `stdClass` object.
+  * Default: `FALSE`
+* `ALLDATA`: Set this to `TRUE` if you would like all error and cURL info returned along with your API data (good for debugging). Data will be available in `$result->_ERROR` and `$result->_INFO`, or `$result['_ERROR']` and `$result['_INFO']`, depending if you are having it returned as an object or array. Recommended to be set to `FALSE` in production.
+  * Default: `FALSE`
+* `FAILONERROR`: The value passed to cURL's [CURLOPT_FAILONERROR](http://php.net/manual/en/function.curl-setopt.php) setting. `TRUE` will cause the API Wrapper to throw an Exception if the HTTP code is >= `400`. `FALSE` in combination with `ALLDATA` set to `TRUE` will give you more debug information.
+  * Default: `TRUE`
+
+
+##Some Examples
+Assume that `$sh` has already been set up as documented above.
+
+####Listing Products
+```
+try
+{
+
+	$call = $sh->call(['URL' => 'products.json', 'METHOD' => 'GET', 'DATA' => ['limit' => 5, 'published_status' => 'any']]);
+}
+catch (Exception $e)
+{
+	$call = $e->getMessage();
+}
+
+echo '<pre>';
+var_dump($call);
+echo '</pre>';
+
+```
+
+`$call` will either contain a `stdClass` object with `products` or an Exception error message.
+
+####Creating a snippet from a Laravel View
+
+```
+$testData = ['name' => 'Foo', 'location' => 'Bar'];
+$view = (string) View::make('snippet', $testData);
+
+$themeID = 12345678;
+
+try
+{
+	$call = $sh->call(['URL' => '/admin/themes/' . $themeID . '/assets.json', 'METHOD' => 'PUT', 'DATA' => ['asset' => ['key' => 'snippets/test.liquid', 'value' => $view] ] ]);
+}
+catch (Exception $e)
+{
+	$call = $e->getMessage();
+}
+
+echo '<pre>';
+var_dump($call);
+echo '</pre>';
+```
+
+####Performing operations on multiple shops
+The `setup()` method makes changing the current shop simple.
+
+```
+$apiKey = '123';
+$apiSecret = '456';
+
+$sh = App::make('ShopifyAPI', ['API_KEY' => $apiKey, 'API_SECRET' => $apiSecret]);
+
+$shops = array(
+		'my-shop.myshopify.com'		=> 'abc',
+		'your-shop.myshopify.com'	=> 'def',
+		'another.myshopify.com'		=> 'ghi'
+		);
+		
+foreach($shops as $domain => $access)
+{
+	$sh->setup(['SHOP_DOMAIN' => $domain, 'ACCESS_TOKEN'' => $access]);
+	// $sh->call(), etc
+
+}
+
+```
+