Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add supported OpenCart 2.0.x #19

Merged
merged 33 commits into from
Jan 30, 2016
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
33 commits
Select commit Hold shift + click to select a range
9e5741f
initial commit
duzydook Jul 11, 2015
fe111ee
fixed dashboard
duzydook Jul 13, 2015
32f2dff
fix admin model
duzydook Jul 14, 2015
541fddc
change br to css margin
duzydook Jul 14, 2015
b898b1b
fix opencart 2.0 bug
duzydook Jul 28, 2015
f47d5ef
update readme.md
duzydook Jul 28, 2015
455bc65
update readme images
duzydook Jul 28, 2015
2dc7887
fix readme images
duzydook Jul 28, 2015
4003b2f
change installation4%20&%20uninstall2.png to installation4-uninstall2…
duzydook Jul 28, 2015
406e991
inital change log
duzydook Jul 28, 2015
76b153e
change images url to https
duzydook Jul 29, 2015
1e4a31a
initial commit
duzydook Jul 11, 2015
06d2e0a
fixed dashboard
duzydook Jul 13, 2015
29d08cd
fix admin model
duzydook Jul 14, 2015
417aae6
change br to css margin
duzydook Jul 14, 2015
5c7675c
update readme.md
duzydook Jul 28, 2015
38c1923
update readme images
duzydook Jul 28, 2015
2f0c2a9
fix readme images
duzydook Jul 28, 2015
5feefd0
change installation4%20&%20uninstall2.png to installation4-uninstall2…
duzydook Jul 28, 2015
f6c035d
inital change log
duzydook Jul 28, 2015
66c669c
change images url to https
duzydook Jul 29, 2015
f799116
add javascript file to omise dashboard
duzydook Aug 4, 2015
bca40ba
move load omise library to constructor
duzydook Aug 4, 2015
ad3db67
Update CHANGELOG, change omise-cdn links in README.md file
guzzilar Nov 16, 2015
da0acc5
Move module configuration section up to the top of the omise module c…
guzzilar Nov 16, 2015
22a8d74
Bunch update code structure for support OpenCart 2.0.x
guzzilar Nov 29, 2015
23b6221
Add field to set the payment method name in a checkout page. Add vers…
guzzilar Dec 2, 2015
2d5569f
Add Omise logo to the payment extension list page
guzzilar Dec 4, 2015
6549e55
Give some warning message when stores use a currency that Omise does …
guzzilar Dec 8, 2015
050fdbf
Handle error case when cannot connect to Github server for get latest…
guzzilar Dec 21, 2015
e0b9c4e
Enhance the Omise dashboard in admin page, enhance the checkout form …
guzzilar Dec 24, 2015
622c2bf
Support 3D-Secure feature.
guzzilar Dec 25, 2015
b76ae14
Enhance Omise dashboard, redirect user to the failure page if 3ds pay…
guzzilar Jan 30, 2016
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,16 @@
Change Log
==========

An [unreleased] version is not available on `master` branch and is subject to changes and must not be considered final. Elements of unreleased list may be edited or removed at any time.

[unreleased]
------------
- *`Updated`* Updated README.md file
- *`Updated`* Changed compatible version number from `1.5.x` to `2.0.x`
- *`Updated`* Updated Opencart2.0 interface images
- *`Updated`* Updated interface to use bootstrap 3
- *`Fixed`* Fixed vQmod overwrited files becasue Opencart 2.0 change main interface

[1.5.0.2] 2015-11-16
----------------------
#### Updates
Expand Down
43 changes: 22 additions & 21 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
![Omise-OpenCart](https://omise-cdn.s3.amazonaws.com/artwork/opencart_omise_bodered.png)
![Omise-OpenCart](https://cdn.omise.co/artwork/opencart_omise_bodered.png)

## OpenCart Version Compatibility
- OpenCart 1.5.x
- OpenCart 2.0.x

## Dependencies (Already included in Omise-OpenCart)
- [omise-php](https://github.com/omise/omise-php) (v2.4.0)
Expand All @@ -17,27 +17,28 @@ Follow these steps to install **omise-opencart**:
[omise-opencart-v1.5.0.2.zip](https://github.com/omise/omise-opencart/archive/v1.5.0.2.zip) or
[omise-opencart-v1.5.0.2.tar.gz](https://github.com/omise/omise-opencart/archive/v1.5.0.2.tar.gz)

![omise-opencart Folder Structure](https://omise-cdn.s3.amazonaws.com/assets/omise-opencart/omise-opencart-install-01.png)
![omise-opencart Folder Structure](https://cdn.omise.co/assets/omise-opencart/omise-opencart-install-01.png)


2. Go to `/omise-opencart/src` and copy **all files** into your **OpenCart Project**

3. Open your **OpenCart website**, then go to `/admin` page

4. Go to `Extensions` > `Payments` (from the top menu), in the payment extension list page
![Payments Menu](https://omise-cdn.s3.amazonaws.com/assets/omise-opencart/omise-opencart-install-02.png)
4. Go to `Extensions` > `Payments` (from the left menu), in the payment extension list page
![Payments Menu](https://cdn.omise.co/assets/omise-opencart/v2.x/installation4-uninstall2.png)

5. Look for `Omise Payment Gateway` and click **Install**
![Install Omise Payment Gateway extension menu](https://omise-cdn.s3.amazonaws.com/assets/omise-opencart/omise-opencart-install-03.png)
![Install Omise Payment Gateway extension menu](https://cdn.omise.co/assets/omise-opencart/v2.x/installation5.png)

If the everything went fine, the `Omise` menu will appear on the right side of your admin page.
![Omise Menu](https://omise-cdn.s3.amazonaws.com/assets/omise-opencart/omise-opencart-install-04.png)
If the everything went fine, the `Omise` menu will appear on the right side of your admin page. Otherwise, please check **Frequent Problems**
![Omise Menu](https://cdn.omise.co/assets/omise-opencart/v2.x/installation6.png)

#### Frequent Problems

Permissions must be set so that **omise-opencart** can overwrite the following files:
- `your-opencart(root)/index.php`
- `your-opencart(root)/admin/index.php`
- `your-opencart(root)/omise-opencart`

It also creates new folders and files on your `your-opencart(root)/` directory for the first installation.
Ensure these 2 files and folder have appropriate `write` permissions (usually `755`).
Expand All @@ -46,35 +47,35 @@ Ensure these 2 files and folder have appropriate `write` permissions (usually `7
In order to use **omise-opencart** you have to link it to your *Omise account* using your credentials:

1. Go to `Omise` > `Settings` (from Omise menu on the top right of the page)
![Omise Menu](https://omise-cdn.s3.amazonaws.com/assets/omise-opencart/omise-opencart-install-05.png)
![Omise Menu](https://cdn.omise.co/assets/omise-opencart/v2.x/setup1.png)

2. The page that opens allows you to save your `Omise Keys`. If you want to test Omise service integration, you can enable *test mode* by clicking `Enable test mode`. Your OpenCart will then process orders with your test keys.
![Omise Payment Gateway Form](https://omise-cdn.s3.amazonaws.com/assets/omise-opencart/omise-opencart-install-06.png)
![Omise Payment Gateway Form](https://cdn.omise.co/assets/omise-opencart/v2.x/setup2.png)

3. The **Module config** allows you to enable or disable Omise Payment on your OpenCart site.
![Module Config Section](https://omise-cdn.s3.amazonaws.com/assets/omise-opencart/omise-opencart-install-07.png)
![Module Config Section](https://cdn.omise.co/assets/omise-opencart/v2.x/setup3.png)

## Checkout with Omise Payment Gateway
After setting up your *Omise keys*, you can checkout with *Omise Payment Gateway*. In order to test it, make sure you set up your test keys and enabled test mode.

1. Visit your website and add something to your cart.

2. Go to your cart and checkout (regular OpenCart process until now. Let's focus on step 5 **Payment Method**)
![Checkout Steps](https://omise-cdn.s3.amazonaws.com/assets/omise-opencart/omise-opencart-install-08.png)
![Checkout Steps](https://cdn.omise.co/assets/omise-opencart/v2.x/checkout2.png)

3. In this step (step #5 in opencart) the **Credit Card (Powered by Omise)** choice will be available. Select it and accept the terms & conditions.
![Payment Method](https://omise-cdn.s3.amazonaws.com/assets/omise-opencart/omise-opencart-install-09.png)
![Payment Method](https://cdn.omise.co/assets/omise-opencart/v2.x/checkout3.png)

4. The form allows you to fill in your credit card details. You can use a test credit card number from [our documentation](https://docs.omise.co/api/tests/).)
![Collect a Customer Card](https://omise-cdn.s3.amazonaws.com/assets/omise-opencart/omise-opencart-install-10.png)
![Collect a Customer Card](https://cdn.omise.co/assets/omise-opencart/v2.x/checkout4.png)

5. Once done, submit your order with the `Confirm Order` button. If you want to know how we collect and process your card, please check our documentation: [Collecting Cards](https://docs.omise.co/collecting-card-information/) and [Charging Cards](https://docs.omise.co/charging-cards/))

6. Once completed, you get redirected your website `processed page`.
![Checkout processed done](https://omise-cdn.s3.amazonaws.com/assets/omise-opencart/omise-opencart-install-11.png)
![Checkout processed done](https://cdn.omise.co/assets/omise-opencart/v2.x/checkout5.png)

7. If you go back to your **admin dashboard** you will see your order with `Processed` status.
![Admin Dashboard](https://omise-cdn.s3.amazonaws.com/assets/omise-opencart/omise-opencart-install-12.png)
![Admin Dashboard](https://cdn.omise.co/assets/omise-opencart/v2.x/opencart-dashboard.png)
Note: During the short period of authorization, the status will be marked as `Processing`

## Uninstalling Omise
Expand All @@ -87,22 +88,22 @@ Because we can not automatically check that `vQmod` library is used by other ext
#### 1. Uninstall Omise Payment Gateway extension
1. Open your **OpenCart website**, then go to `/admin` page

2. Go to `Extensions` > `Payments` (from the top menu)
![Payments menu](https://omise-cdn.s3.amazonaws.com/assets/omise-opencart/omise-opencart-install-02.png)
2. Go to `Extensions` > `Payments` (from the left menu)
![Payments menu](https://cdn.omise.co/assets/omise-opencart/v2.x/installation4-uninstall2.png )

3. Look for `Omise Payment Gateway` row and click **Uninstall**
![Uninstall Omise Payment Gateway extension menu](https://omise-cdn.s3.amazonaws.com/assets/omise-opencart/omise-opencart-install-13.png)
![Uninstall Omise Payment Gateway extension menu](https://cdn.omise.co/assets/omise-opencart/v2.x/uninstall3.png)

Once uninstalled, `Omise` will not appear in the top right menu of your admin page anymore.

#### 2. Removed vQmod library
*For this step, please make sure you are not using `vQmod` library in other extensions. If you are unsure, you can leave it there. It will not have any effect on your site.

1. In your OpenCart directory you will see the `vqmod` folder. Remove it
![vQmod folder](https://omise-cdn.s3.amazonaws.com/assets/omise-opencart/omise-opencart-install-14.png)
![vQmod folder](https://cdn.omise.co/assets/omise-opencart/omise-opencart-install-14.png)

2. Go to `omise-opencart/backup`, restore the backup files. You will see them here:
![Backup folder](https://omise-cdn.s3.amazonaws.com/assets/omise-opencart/omise-opencart-install-15.png)
![Backup folder](https://cdn.omise.co/assets/omise-opencart/omise-opencart-install-15.png)
Copy and past them into your OpenCart site
- `omise-opencart/backup/index.php` to `your-opencart(root)/index.php`
- `omise-opencart/backup/admin/index.php` to `your-opencart(root)/admin/index.php`
Loading