Added some sales channel resources

.gitignore

@@ -1,3 +1,4 @@
 vendor
 /nbproject/private/
-.idea/
+.idea/
+.DS_Store

README.md

@@ -14,12 +14,26 @@ composer require phpclassic/php-shopify
 PHPShopify uses curl extension for handling http calls. So you need to have the curl extension installed and enabled with PHP.
 >However if you prefer to use any other available package library for handling HTTP calls, you can easily do so by modifying 1 line in each of the `get()`, `post()`, `put()`, `delete()` methods in `PHPShopify\HttpRequestJson` class.
 
+You can pass additional curl configuration to `ShopifySDK`
+```php
+$config = array(
+    'ShopUrl' => 'yourshop.myshopify.com',
+    'ApiKey' => '***YOUR-PRIVATE-API-KEY***',
+    'Password' => '***YOUR-PRIVATE-API-PASSWORD***',   
+    'Curl' => array(
+        CURLOPT_TIMEOUT => 10,
+        CURLOPT_FOLLOWLOCATION => true
+    )
+);
+
+PHPShopify\ShopifySDK::config($config);
+```
 ## Usage
 
 You can use PHPShopify in a pretty simple object oriented way. 
 
 #### Configure ShopifySDK
-If you are using your own private API, provide the ApiKey and Password. 
+If you are using your own private API (except GraphQL), provide the ApiKey and Password. 
 
 ```php
 $config = array(
@@ -31,14 +45,26 @@ $config = array(
 PHPShopify\ShopifySDK::config($config);
 ```
 
-For Third party apps, use the permanent access token.
+For Third party apps, use the permanent access token. 
+> For GraphQL, AccessToken is required. If you are using private API for GraphQL, use your password as AccessToken here.
 
 ```php
 $config = array(
     'ShopUrl' => 'yourshop.myshopify.com',
     'AccessToken' => '***ACCESS-TOKEN-FOR-THIRD-PARTY-APP***',
 );
 
+PHPShopify\ShopifySDK::config($config);
+```
+You can use specific Shopify API Version by adding in the config array
+
+```php
+$config = array(
+    'ShopUrl' => 'yourshop.myshopify.com',
+    'AccessToken' => '***ACCESS-TOKEN-FOR-THIRD-PARTY-APP***',
+    'ApiVersion' => '2022-07',
+);
+
 PHPShopify\ShopifySDK::config($config);
 ```
 ##### How to get the permanent access token for a shop?
@@ -171,7 +197,7 @@ $shopify->Order($orderID)->put($updateInfo);
 ```php
 $webHookID = 453487303;
 
-$shopify->Webhook($webHookID)->delete());
+$shopify->Webhook($webHookID)->delete();
 ```
 
 
@@ -302,7 +328,8 @@ Some resources are available directly, some resources are only available through
 - Blog -> Article -> [Metafield](https://help.shopify.com/api/reference/metafield)
 - Blog -> [Event](https://help.shopify.com/api/reference/event/)
 - Blog -> [Metafield](https://help.shopify.com/api/reference/metafield)
-- [CarrierService](https://help.shopify.com/api/reference/carrierservice/)
+- [CarrierService](https://help.shopify.com/api/reference/carrierservice/)-
+- [Cart](https://shopify.dev/docs/themes/ajax-api/reference/cart) (read only)
 - [Collect](https://help.shopify.com/api/reference/collect/)
 - [Comment](https://help.shopify.com/api/reference/comment/)
 - Comment -> [Event](https://help.shopify.com/api/reference/event/)
@@ -359,6 +386,8 @@ Some resources are available directly, some resources are only available through
 - [Shop](https://help.shopify.com/api/reference/shop) _(read only)_
 - [SmartCollection](https://help.shopify.com/api/reference/smartcollection)
 - SmartCollection -> [Event](https://help.shopify.com/api/reference/event/)
+- [ShopifyPayment](https://shopify.dev/docs/admin-api/rest/reference/shopify_payments/)
+- ShopifyPayment -> [Dispute](https://shopify.dev/docs/admin-api/rest/reference/shopify_payments/dispute/) _(read only)_
 - [Theme](https://help.shopify.com/api/reference/theme)
 - Theme -> [Asset](https://help.shopify.com/api/reference/asset/)
 - [User](https://help.shopify.com/api/reference/user) _(read only, Shopify Plus Only)_
@@ -483,6 +512,15 @@ The custom methods are specific to some resources which may not be available for
     - [current()](https://help.shopify.com/api/reference/user#current)
     Get the current logged-in user
 
+### Shopify API features headers
+To send `X-Shopify-Api-Features` headers while using the SDK, you can use the following:
+
+```
+$config['ShopifyApiFeatures'] = ['include-presentment-prices'];
+$shopify = new PHPShopify\ShopifySDK($config);
+```
+
+
 ## Reference
 - [Shopify API Reference](https://help.shopify.com/api/reference/)
 

lib/AccessScope.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace PHPShopify;
+
+/**
+ * Class AccessScope
+ * @package PHPShopify
+ * @author Alexey Sinkevich
+ */
+class AccessScope extends ShopifyResource
+{
+    /**
+     * @inheritDoc
+     */
+    protected $resourceKey = 'access_scope';
+
+    /**
+     * @inheritDoc
+     */
+    public $countEnabled = true;
+
+    /**
+     * @inheritDoc
+     */
+    public $readOnly = true;
+
+    /**
+     * @param array $urlParams
+     * @param null $customAction
+     * @return string
+     */
+    public function generateUrl($urlParams = array(), $customAction = null)
+    {
+        return ShopifySDK::$config['AdminUrl'] . 'oauth/' . $this->getResourcePath() . '.json';
+    }
+}

lib/ApplicationCredit.php

@@ -0,0 +1,26 @@
+<?php
+/**
+ * Created by PhpStorm.
+ * @author Tareq Mahmood <tareqtms@yahoo.com>
+ * Created at 8/18/16 9:50 AM UTC+06:00
+ *
+ * @see https://help.shopify.com/api/reference/applicationcharge Shopify API Reference for ApplicationCharge
+ */
+
+namespace PHPShopify;
+
+
+class ApplicationCredit extends ShopifyResource
+{
+    /**
+     * @inheritDoc
+     */
+    protected $resourceKey = 'application_credit';
+
+    /**
+     * @inheritDoc
+     */
+    public $countEnabled = false;
+
+
+}

lib/AuthHelper.php

@@ -29,7 +29,10 @@ public static function getCurrentUrl()
             $protocol = 'http';
         }
 
-        return "$protocol://$_SERVER[HTTP_HOST]$_SERVER[REQUEST_URI]";
+        $url = $protocol . '://' . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'];
+        $url = false !== ($qsPos = strpos($url, '?')) ? substr($url, 0, $qsPos) : $url; // remove query params
+
+        return $url;
     }
 
     /**
@@ -170,6 +173,10 @@ public static function getAccessToken()
 
             $response = HttpRequestJson::post($config['AdminUrl'] . 'oauth/access_token', $data);
 
+            if (CurlRequest::$lastHttpCode >= 400) {
+                throw new SdkException("The shop is invalid or the authorization code has already been used.");
+            }
+
             return isset($response['access_token']) ? $response['access_token'] : null;
         } else {
             throw new SdkException("This request is not initiated from a valid shopify shop!");

lib/Balance.php

@@ -0,0 +1,51 @@
+<?php
+/**
+ * Created by PhpStorm.
+ * @author Robert Jacobson <rjacobson@thexroadz.com>
+ * @author Matthew Crigger <mcrigger@thexroadz.com>
+ *
+ * @see https://help.shopify.com/en/api/reference/shopify_payments/balance Shopify API Reference for Shopify Payment Balance
+ */
+
+namespace PHPShopify;
+
+/**
+ * --------------------------------------------------------------------------
+ * ShopifyPayment -> Child Resources
+ * --------------------------------------------------------------------------
+ *
+ *
+ */
+class Balance extends ShopifyResource
+{
+    /**
+     * @inheritDoc
+     */
+    protected $resourceKey = 'balance';
+
+    /**
+     * Get the pluralized version of the resource key
+     *
+     * Normally its the same as $resourceKey appended with 's', when it's different, the specific resource class will override this function
+     *
+     * @return string
+     */
+    protected function pluralizeKey()
+    {
+        return $this->resourceKey;
+    }
+
+    /**
+     * If the resource is read only. (No POST / PUT / DELETE actions)
+     *
+     * @var boolean
+     */
+    public $readOnly = true;
+
+    /**
+     * @inheritDoc
+     */
+    protected $childResource = array(
+        'Transactions'
+    );
+}

lib/Batch.php

@@ -0,0 +1,33 @@
+<?php
+/**
+ * @see https://help.shopify.com/api/reference/discounts/discountcode Shopify API Reference for PriceRule
+ */
+
+namespace PHPShopify;
+
+
+/**
+ * --------------------------------------------------------------------------
+ * DiscountCode -> Batch action
+ * --------------------------------------------------------------------------
+ *
+ */
+
+class Batch extends ShopifyResource
+{
+    /**
+     * @inheritDoc
+     */
+    protected $resourceKey = 'batch';
+
+    protected function getResourcePath()
+    {
+        return $this->resourceKey;
+    }
+
+    protected function wrapData($dataArray, $dataKey = null)
+    {
+        return ['discount_codes' => $dataArray];
+    }
+
+}

lib/Cart.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace PHPShopify;
+
+/* @see https://shopify.dev/docs/themes/ajax-api/reference/cart */
+use PHPShopify\ShopifyResource;
+
+class Cart extends ShopifyResource {
+
+     /**
+     * @inheritDoc
+     */
+    protected $resourceKey ='cart';
+
+     /**
+     * @inheritDoc
+     */
+    public $searchEnabled = false;
+
+     /**
+     * @inheritDoc
+     */
+    public $readOnly = true;
+}

lib/Checkout.php

@@ -0,0 +1,53 @@
+<?php
+/**
+ * Created by PhpStorm.
+ * @author Tareq Mahmood <tareqtms@yahoo.com>
+ * Created at 8/19/16 2:59 PM UTC+06:00
+ *
+ * @see https://help.shopify.com/api/reference/sales-channels/checkout Shopify API Reference for Checkout
+ */
+
+namespace PHPShopify;
+
+
+/**
+ * --------------------------------------------------------------------------
+ * Order -> Child Resources
+ * --------------------------------------------------------------------------
+ * @property-read ShippingRate $ShippingRate
+ *
+ * @method ShippingRate ShippingRate(integer $id = null)
+ *
+
+ * --------------------------------------------------------------------------
+ * Checkout -> Custom actions
+ * --------------------------------------------------------------------------
+ * @method array complete()         Completes Checkout without payment
+ *
+ */
+class Checkout extends ShopifyResource
+{
+    /**
+     * @inheritDoc
+     */
+    protected $resourceKey = 'checkout';
+
+    /**
+     * @inheritDoc
+     */
+    public $countEnabled = false;
+
+    /**
+     * @inheritDoc
+     */
+    protected $childResource = array (
+        'ShippingRate',
+    );
+    /**
+     * @inheritDoc
+     */
+    protected $customPostActions = array(
+        'complete',
+        'payments'
+    );
+}

lib/Collection.php

@@ -8,8 +8,10 @@
  * --------------------------------------------------------------------------
  *
  * @property-read Product $Product
+ * @property-read Metafield $Metafield
  *
  * @method Product Product(integer $id = null)
+ * @method Metafield Metafield(integer $id = null)
  *
  * @see https://shopify.dev/docs/admin-api/rest/reference/products/collection
  *
@@ -31,5 +33,6 @@ class Collection extends ShopifyResource
      */
     protected $childResource = array(
         'Product',
+        'Metafield',
     );
-}
+}