Merge pull request #1 from genuineq/master

Compatibility fixes for CE_Phoenix distribution

Author: ionutcalara

README.md

@@ -1,54 +1,64 @@
-# osCommerce plugin for Paylike 
+# osCommerce plugin for Paylike
 
 This plugin is *not* developed or maintained by Paylike but kindly made
 available by a user.
 
 Released under the GPL V3 license: https://opensource.org/licenses/GPL-3.0
 
 
-## Supported osCommerce versions 
-
-*The plugin has been tested with osCommerce v.2.3.4.1
+## Supported osCommerce versions
 
+*The plugin has been tested with osCommerce v.2.3.4.1 and osCommerce CE Phoenix
 
 ## Installation
 
  Once you have installed osCommerce, follow these simple steps:
-  1. Signup at [paylike.io](https://paylike.io) (it’s free) 
-  1. Create a live account
-  1. Create an app key for your osCommerce website
-  1. Upload the files in the `upload` folder to root of your osCommerce store.
-  1. In: `includes/template_top.php` add:
+  1. Signup at [paylike.io](https://paylike.io) (it’s free)
+  2. Create a live account
+  3. Create an app key for your osCommerce website
+  4. Upload the files in the `upload` folder to root of your osCommerce store.
+  5. In: `includes/template_top.php` add:
       ```
         <?php
             if ( basename( $PHP_SELF ) == 'checkout_confirmation.php' ) {
                 ?>
                 <script src="https://sdk.paylike.io/3.js"></script>
-                <script src="<?php echo DIR_WS_INCLUDES ?>javascript/paylike.js"></script>
+                <script src= "includes/javascript/paylike.js"></script>
                 <?php
     	        }
     	    ?>
         ```
      Anywhere betwen the `head` tags.
-  1. Install the Paylike module from modules -> payment in the admin  
-  1. Insert the app key and your public key in the settings and enable the plugin
-  
+  6. In: `includes/.htaccess` add:
+      ```
+      <FilesMatch "paylike\.php$">
+         <IfModule mod_authz_core.c>
+            Require all granted
+         </IfModule>
+         <IfModule !mod_authz_core.c>
+            Allow from all
+        </IfModule>
+      </FilesMatch>
+      ```
+      After the last line.
+  7. Install the Paylike module from modules -> payment in the admin  
+  8. Insert the app key and your public key in the settings and enable the plugin
+
 
 ## Updating settings
 
 Under the Paylike settings, you can:
- * Update the title that shows up in the payment popup 
+ * Update the title that shows up in the payment popup
  * Add test/live keys
  * Set payment mode (test/live)
  * Change the capture type (Instant/Delayed)
- 
+
  ## How to
- 
+
  1. Capture
  * In Instant mode, the orders are captured automatically
- * In delayed mode you can capture funds only from the paylike dashboard. 
+ * In delayed mode you can capture funds only from the paylike dashboard.
  2. Refund
    * To refund an order you can use the paylike dashboard.
  3. Void
-   * To void an order you can use the paylike dashboard. 
-
+   * To void an order you can use the paylike dashboard.

upload_ce_phoenix/images/modules/payment/paylike/maestro.svg

@@ -0,0 +1 @@
+* text=auto

upload_ce_phoenix/images/modules/payment/paylike/mastercard.svg

@@ -0,0 +1,78 @@
+# Created by .ignore support plugin (hsz.mobi)
+### macOS template
+*.DS_Store
+.AppleDouble
+.LSOverride
+
+# Icon must end with two \r
+Icon
+
+
+# Thumbnails
+._*
+
+# Files that might appear in the root of a volume
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+### Composer template
+composer.phar
+/vendor/
+
+# Commit your application's lock file http://getcomposer.org/doc/01-basic-usage.md#composer-lock-the-lock-file
+# You may choose to ignore a library lock file http://getcomposer.org/doc/02-libraries.md#lock-file
+composer.lock
+### Windows template
+# Windows thumbnail cache files
+Thumbs.db
+ehthumbs.db
+ehthumbs_vista.db
+
+# Folder config file
+Desktop.ini
+
+# Recycle Bin used on file shares
+$RECYCLE.BIN/
+
+# Windows Installer files
+*.cab
+*.msi
+*.msm
+*.msp
+
+# Windows shortcuts
+*.lnk
+### JetBrains template
+.idea/
+
+## File-based project format:
+*.iws
+
+## Plugin-specific files:
+
+# IntelliJ
+/out/
+
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+com_crashlytics_export_strings.xml
+crashlytics.properties
+crashlytics-build.properties
+fabric.properties
+.env

upload_ce_phoenix/images/modules/payment/paylike/paylike.png

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017 Ionut Calara
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

upload_ce_phoenix/images/modules/payment/paylike/visa.svg

@@ -0,0 +1,149 @@
+# Paylike client (PHP)
+
+You can sign up for a Paylike account at [https://paylike.io](https://paylike.io).
+
+## Getting an API key
+
+An API key can be obtained by creating a merchant and adding an app through
+Paylike [dashboard](https://app.paylike.io). 
+
+## Requirements
+
+PHP 5.3.3 and later.
+
+## Install
+
+You can install the package via [Composer](http://getcomposer.org/). Run the following command:
+
+```bash
+composer require paylike/php-api
+```
+
+If you don't use Composer, you can download the [latest release](https://github.com/paylike/php-api/releases) and include the `init.php` file.
+
+```php
+require_once('/path/to/php-api/init.php');
+```
+
+## Dependencies
+
+The bindings require the following extension in order to work properly:
+
+- [`curl`](https://secure.php.net/manual/en/book.curl.php)
+
+If you use Composer, these dependencies should be handled automatically. If you install manually, you'll want to make sure that these extensions are available.  
+If you don't want to use curl, you can create your own client to extend from `HttpClientInterface` and send that as a parameter when instantiating the `Paylike` class.
+
+## Example
+
+```php
+$paylike = new \Paylike\Paylike($private_api_key);
+ 
+// fetch a card
+$cards = $paylike->cards();
+$card  = $cards->fetch($card_id);
+ 
+// capture a transaction
+$transactions = $paylike->transactions();
+$transaction  = $transactions->capture($transaction_id, array(
+    'amount'   => 100,
+    'currency' => 'EUR'
+));
+``` 
+
+## Methods
+```php
+$paylike = new \Paylike\Paylike($private_api_key);
+ 
+$apps = $paylike->apps();
+$apps->create($args);
+$apps->fetch();
+ 
+$merchants = $paylike->merchants();
+$merchants->create($args);
+$merchants->fetch($merchant_id);
+$merchants->update($merchant_id, $args);
+$all_merchants = $merchants->find($app_id,$args);
+$some_merchants = $merchants->before($app_id,$before);
+$some_merchants = $merchants->after($app_id,$before);
+ 
+$cards = $paylike->cards();
+$cards->create($merchant_id, $args);
+$cards->fetch($card_id);
+ 
+$transactions = $paylike->transactions();
+$transactions->create($merchant_id, $args);
+$transactions->fetch($transaction_id);
+$transactions->capture($transaction_id, $args);
+$transactions->void($transaction_id, $args);
+$transactions->refund($transaction_id, $args);
+$all_transactions = $transactions->find($merchant_id,$args);
+$some_transactions = $transactions->before($merchant_id,$before);
+$some_transactions = $transactions->after($merchant_id,$before);
+
+// explicit args
+$limit = 10;
+$after = '5b8e839d7cc76f04ecd3f733';
+$before = '5b98deef882cf804f6108700';
+$api_transactions = $transactions->find($merchant_id, array(
+    'limit' => $limit,
+    'after' => $after,
+    'before' => $before,
+    'filter' => array(
+    	'successful' => true
+    )
+));
+``` 
+
+## Pagination
+The methods that return multiple merchants/transactions (find,after,before) use cursors, so you don't need to worry about pagination, you can access any index, or iterate all the items, this is handled in the background.
+
+## Error handling
+
+The api wrapper will throw errors when things do not fly. All errors inherit from
+`ApiException`. A very verbose example of catching all types of errors:
+
+```php
+$paylike = new \Paylike\Paylike($private_api_key);
+try {
+    $transactions = $paylike->transactions();
+    $transactions->capture($transaction_id, array(
+        'amount'   => 100,
+        'currency' => 'EUR'
+    ));
+} catch (\Paylike\Exception\NotFound $e) {
+    // The transaction was not found
+} catch (\Paylike\Exception\InvalidRequest $e) {
+    // Bad (invalid) request - see $e->getJsonBody() for the error
+} catch (\Paylike\Exception\Forbidden $e) {
+    // You are correctly authenticated but do not have access.
+} catch (\Paylike\Exception\Unauthorized $e) {
+    // You need to provide credentials (an app's API key)
+} catch (\Paylike\Exception\Conflict $e) {
+    // Everything you submitted was fine at the time of validation, but something changed in the meantime and came into conflict with this (e.g. double-capture).
+} catch (\Paylike\Exception\ApiConnection $e) {
+    // Network error on connecting via cURL
+} catch (\Paylike\Exception\ApiException $e) {
+    // Unknown api error
+}
+``` 
+
+In most cases catching `NotFound` and `InvalidRequest` as client errors
+and logging `ApiException` would suffice.
+
+## Development
+
+Install dependencies:
+
+``` bash
+composer install
+```
+
+## Tests
+
+Install dependencies as mentioned above (which will resolve [PHPUnit](http://packagist.org/packages/phpunit/phpunit)), then you can run the test suite:
+
+```bash
+./vendor/bin/phpunit
+```
+