1.4.0

.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,24 @@
+*Put a short and clear description of the bug or issue here, if needed*
+
+**This is for features**:
+
+TODO:
+
+* [ ] Some feature TODO
+* [ ] Another feature TODO
+
+**This is for bugs**
+
+**Steps to Reproduce**
+
+* Step 1
+* Step 2
+* Step 3, etc
+
+**Expected Results**
+
+**Actual Results**
+
+**Browser/Operating System**
+
+**Additional Comments**

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,22 @@
+* Description of changes 1
+* Description of changes 2
+* Description of changes 3, etc
+
+Fixes eMerchantPay/shopping_carts#number
+
+-----------------
+
+Before merging the PR make sure the following are checked:
+
+* [ ] [Good commit messages][1] are used.
+* [ ] Commit message starts with `{f|b}{year}{month}{day}{num}`, e.g. f2016071101
+* [ ] Necessary specs are added.
+* [ ] All specs are passing.
+* [ ] The code style complies with the [OpenCart][2] recommendation
+* [ ] Code irregularities are identified and removed using a set of rules and sniffs of [PHPMD][3]
+* [ ] All automated or manual PR comments are resolved or proper explanation is included for the given change
+* [ ] The PR relates to **only** one subject with a clear title
+
+[1]: http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html
+[2]: https://github.com/opencart/opencart/wiki/Coding-standards
+[3]: https://github.com/phpmd/phpmd

.phpcs.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0"?>
+<ruleset name="OpenCart EMP Plugin Coding Standards">
+    <description>Generally-applicable sniffs for OpenCart EMP Plugin</description>
+
+    <rule ref="OpenCart" />
+
+    <exclude-pattern>*/genesis/*</exclude-pattern>
+</ruleset>

.phpmd.xml

@@ -0,0 +1,61 @@
+<?xml version="1.0"?>
+<ruleset name="OpenCart EMP Plugin"
+         xmlns="http://pmd.sf.net/ruleset/1.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://pmd.sf.net/ruleset/1.0.0
+                     http://pmd.sf.net/ruleset_xml_schema.xsd"
+         xsi:noNamespaceSchemaLocation="
+                     http://pmd.sf.net/ruleset_xml_schema.xsd">
+    <description>
+        Rule Set for OpenCart eMerchantPay Plugin
+    </description>
+
+    <!--Start of CleanCode RuleSets-->
+    <rule ref="rulesets/cleancode.xml">
+        <exclude name="StaticAccess" />
+        <exclude name="BooleanArgumentFlag" />
+        <exclude name="ElseExpression" />
+    </rule>
+    <!--End of CleanCode RuleSets-->
+
+    <!--Start of CodeSize RuleSets-->
+    <rule ref="rulesets/codesize.xml">
+        <exclude name="TooManyPublicMethods"/>
+    </rule>
+    <!--End of CodeSize RuleSets-->
+
+    <!--Start of Controlversial RuleSets-->
+    <rule ref="rulesets/controversial.xml">
+        <exclude name="CamelCaseClassName" />
+        <exclude name="CamelCasePropertyName" />
+        <exclude name="CamelCaseMethodName" />
+        <exclude name="CamelCaseParameterName" />
+        <exclude name="CamelCaseVariableName" />
+    </rule>
+    <!--End of Controlversial RuleSets-->
+
+    <rule ref="rulesets/design.xml"/>
+
+    <!--Start of Naming RuleSets-->
+    <rule ref="rulesets/naming.xml">
+        <exclude name="LongVariable"/>
+        <exclude name="BooleanGetMethodName"/>
+    </rule>
+
+    <rule ref="rulesets/naming.xml/LongVariable">
+        <properties>
+            <property name="maximum" value="25" />
+        </properties>
+    </rule>
+
+    <rule ref="rulesets/naming.xml/BooleanGetMethodName">
+        <properties>
+            <property name="checkParameterizedMethods" value="true" />
+        </properties>
+    </rule>
+    <!--End of Naming RuleSets-->
+
+    <rule ref="rulesets/unusedcode.xml"/>
+
+    <exclude-pattern>*/genesis/*</exclude-pattern>
+</ruleset>

.pronto.yml

@@ -0,0 +1,6 @@
+github:
+  slug: ENV['GITHUB_SLUG']
+  access_token: ENV['GITHUB_ACCESS_TOKEN']
+  api_endpoint: ENV['GITHUB_API_ENDPOINT']
+  web_endpoint: ENV['GITHUB_WEB_ENDPOINT']
+verbose: false

Gemfile

@@ -0,0 +1,6 @@
+source 'http://rubygems.org'
+
+# code analysis
+gem 'pronto',       '~> 0.7.0'
+gem 'pronto-phpcs', '~> 0.1.1', require: false
+gem 'pronto-phpmd', '~> 0.1.0', require: false

Gemfile.lock

@@ -0,0 +1,50 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    addressable (2.5.0)
+      public_suffix (~> 2.0, >= 2.0.2)
+    faraday (0.11.0)
+      multipart-post (>= 1.2, < 3)
+    gitlab (3.7.0)
+      httparty (~> 0.13.0)
+      terminal-table
+    httparty (0.13.7)
+      json (~> 1.8)
+      multi_xml (>= 0.5.2)
+    json (1.8.6)
+    multi_xml (0.6.0)
+    multipart-post (2.0.0)
+    octokit (4.6.2)
+      sawyer (~> 0.8.0, >= 0.5.3)
+    pronto (0.7.1)
+      gitlab (~> 3.6, >= 3.4.0)
+      httparty (~> 0.13.7)
+      octokit (~> 4.3, >= 4.1.0)
+      rainbow (~> 2.1)
+      rugged (~> 0.24, >= 0.23.0)
+      thor (~> 0.19.0)
+    pronto-phpcs (0.1.1)
+      pronto (~> 0.7.0)
+    pronto-phpmd (0.1.0)
+      pronto (~> 0.7.0)
+    public_suffix (2.0.5)
+    rainbow (2.2.1)
+    rugged (0.25.1.1)
+    sawyer (0.8.1)
+      addressable (>= 2.3.5, < 2.6)
+      faraday (~> 0.8, < 1.0)
+    terminal-table (1.7.3)
+      unicode-display_width (~> 1.1.1)
+    thor (0.19.4)
+    unicode-display_width (1.1.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  pronto (~> 0.7.0)
+  pronto-phpcs (~> 0.1.1)
+  pronto-phpmd (~> 0.1.0)
+
+BUNDLED WITH
+   1.14.3

README.md

@@ -40,6 +40,34 @@ Installation (Manual)
 3.  Navigate to ```Extensions -> Payments``` and click install on ```eMerchantPay Direct``` and/or ```eMerchantPay Checkout```
 4.  Set the login credentials (```Username```, ```Password```, ```Token```) and adjust the configuration to your needs.
 
+Enable OpenCart SSL
+------------
+This steps should be followed if you wish to use the ```eMerchantPay Direct``` Method.
+
+* Ensure you have installed a valid __SSL Certificate__ on your __PCI-DSS Certified__ Web Server and you have configured your __Virtual Host__ properly.
+* Login to your OpenCart Admin Panel
+* Navigate to ```Settings``` -> ```your Store``` -> ```Server```
+* Set ```Use SSL``` to __Yes__ in ```Security``` tab and save your changes
+* Set the __HTTPS_SERVER__ and __HTTPS_CATALOG__ settings in your ```admin/config.php``` to use ```https``` protocol
+* Set the __HTTPS_SERVER__ setting in your ```config.php``` to use ```https``` protocol
+* Set the __site_ssl__ setting to ```true``` in your ```system/config/default.php``` file
+* It is recommended to add a __Rewrite Rule__ from ```http``` to ```https``` or to add a __Permanent Redirect__ to ```https``` in your virtual host
+
+Recurring Payments
+------------
+OpenCart has an integrated functionality for processing recurring transactions.
+In order to simplify the process of handling recurring payments, the recurring products cannot be ordered along with other products (recurring or non-recurring) and must be ordered separately, one per order.
+
+If you are interested in, you could read more about:
+
+* Total Order Calculation
+* Payment Method Configuration
+* Recurring Profile Creation
+* Setting up Scheduled Tasks & Cron Jobs Configurations
+* Cron Jobs IP Restrictions
+* Handling Recurring Payments with Payment Module
+
+in [wiki for Recurring Payments](https://github.com/eMerchantPay/opencart-emp-plugin/wiki/OpenCart-Recurring-Module-Configurations)
 
 _Note_: If you have trouble with your credentials or terminal configuration, get in touch with our [support] team