Added Readme

Added library subclass to permit dependency injection usage.

Author: Silentscripter

README.md

@@ -0,0 +1,92 @@
+Laravel Prestashop Web Service
+========
+
+Laravel 5 wrapper for Prestashop Web Service Library
+
+Installation
+------------
+
+Require this package with composer using the following command:
+
+```shell
+composer require protechstudio/laravel-prestashop-webservice
+```
+
+After updating composer, add the service provider to the `providers` array in `config/app.php`
+
+```php
+Protechstudio\PrestashopWebService\PrestashopWebServiceProvider::class,
+```
+
+You may also add the Facade in the `aliases` array in `config/app.php`
+
+```php
+'Prestashop' => Protechstudio\PrestashopWebService\PrestashopWebServiceFacade::class,
+```
+
+Finally publish the configuration file using the artisan command
+
+```shell
+php artisan vendor:publish --provider="Protechstudio\PrestashopWebService\PrestashopWebServiceProvider"
+```
+
+Configuration
+-------------
+
+Open the published configuration file at `config/prestashop-webservice.php`:
+
+```php
+return [
+    'url' => 'http://domain.com',
+    'token' => '',
+    'debug' => env('APP_DEBUG', false)
+];
+```
+
+Then populate the `url` field with the **root url** of the targeted Prestashop installation and `token` field with the API token obtained from Prestashop control panel in Web Service section. If `debug` is `true` Prestashop will return debug information when responding to API requests.
+
+Usage
+-----
+
+You may use the Prestashop Web Service wrapper in two ways:
+### Using the dependency or method injection
+
+```php
+...
+use Protechstudio\PrestashopWebService\PrestashopWebService;
+
+class FooController extends Controller
+{
+    private $prestashop;
+    
+    public function __construct(PrestashopWebService $prestashop)
+    {
+        $this->prestashop = $prestashop;
+    }
+    
+    public function bar()
+    {
+        $opt['resource'] = 'customers';
+        $xml=$this->prestashop->get($opt);
+    }
+}
+```
+### Using the Facade
+
+```php
+...
+use Prestashop;
+
+...
+
+public function bar()
+{   
+    $opt['resource'] = 'customers';
+    $xml=Prestashop::get($opt);
+}
+```
+
+PS Underlying library usage
+---------------------------
+
+You may find complete documentation and tutorials regarding Prestashop Web Service Library in the [Prestashop Documentation](http://doc.prestashop.com/display/PS16/Using+the+PrestaShop+Web+Service).

src/PrestashopWebService.php

@@ -0,0 +1,10 @@
+<?php
+
+namespace Protechstudio\PrestashopWebService;
+
+use PrestaShopWebservice as PSLibrary;
+
+class PrestashopWebService extends PSLibrary
+{
+
+}

src/PrestashopWebServiceFacade.php

@@ -4,14 +4,13 @@
 
 
 use Illuminate\Support\Facades\Facade;
-use PrestaShopWebservice;
 
 class PrestashopWebServiceFacade extends Facade
 {
 
     protected static function getFacadeAccessor()
     {
-        return PrestaShopWebservice::class;
+        return PrestashopWebService::class;
     }
 
 }

src/PrestashopWebServiceProvider.php

@@ -3,7 +3,7 @@
 namespace Protechstudio\PrestashopWebService;
 
 use Illuminate\Support\ServiceProvider;
-use PrestaShopWebservice;
+
 
 class PrestashopWebServiceProvider extends ServiceProvider
 {
@@ -27,8 +27,8 @@ public function register()
     {
         $this->registerConfig();
 
-        $this->app->singleton(PrestaShopWebservice::class, function () {
-            return new PrestaShopWebservice(config('prestashop-webservice.url'),
+        $this->app->singleton(PrestashopWebService::class, function () {
+            return new PrestashopWebService(config('prestashop-webservice.url'),
                 config('prestashop-webservice.token', config('prestashop-webservice.debug')));
         });
     }

tests/PrestashopWebServiceTest.php

@@ -3,6 +3,7 @@
 use Illuminate\Foundation\Testing\WithoutMiddleware;
 use Illuminate\Foundation\Testing\DatabaseMigrations;
 use Illuminate\Foundation\Testing\DatabaseTransactions;
+use Protechstudio\PrestashopWebService\PrestashopWebService;
 
 class PrestashopWebServiceTest extends TestCase
 {
@@ -12,6 +13,6 @@ class PrestashopWebServiceTest extends TestCase
      */
     public function it_is_correctly_installed()
     {
-        $this->assertInstanceOf(PrestaShopWebservice::class, Prestashop::getFacadeRoot());
+        $this->assertInstanceOf(PrestashopWebService::class, Prestashop::getFacadeRoot());
     }
 }