OPENCART NATIVE Copyright 2017 TALENTHUT www.talenthut.io
1. Welcome The OpenCart Native Siberian CMS module will allow you to completely integrate an OpenCart store into your App. The App is managed completely from the OpenCart admin interface so, whatever changes on the OpenCart site, it will also be reflected on the App. This module supports payments via Paypal, Stripe and bank transfer. Please note that, in order to use this module, you need to purchase separately the OpenCart API extension. We will provide a discount code for 30% OFF upon the purchase of this module. Please note that the module is currently only compatible with OpenCart version 3.x and 1.5.6.4. Should you need another OpenCart version, please get in touch with our support team. 2. OPENCART setup Since this module requires the OpenCart API to work, the first setup step is actually to install the OpenCart API via the OpenCart Admin interface. Then, please follow the steps outlined below: 2.1. Upload rest_api.php file Into this location of opencart site upload/admin/controller/module/ 2.2. Get the rest_api.php file from below directory path in the provided API upload/admin/ admin/language/english/module/ 2.3. Upload rest_api.php file Into this location of opencart site upload/admin/controller/module/ 2.4. Get the rest_api.php file from below directory path in the provided API upload/admin/ admin/language/english/module/ 2.5. Upload rest_api file Into this location of opencart site upload/admin/controller/module/ 2.6. Get the rest_api.php file from below directory path in the provided API upload/admin/ view/template/module/ 2.7. Upload rest_api file into this location of opencart site upload/admin/ view/template/module/ 2.8. Get the rest_api.php file from below directory path in the provided API upload /catalog/controller/feed/ 2.9. Upload the rest_api.php file into this location of opencart site upload /catalog/controller/feed/ 2
2.10. Get the rest folder from below directory path in the provided API upload /catalog/controller/ 2.11. Upload the rest folder into this location of opencart site upload /catalog/controller/ 2.12. Get the restapi_pay.php file from below directory path in the provided API upload /catalog/view/theme/default/template/checkout/ 2.13. Upload the restapi_pay file into this location of opencart site upload /catalog/view/theme/default/template/checkout/ 2.14. Get the restcontroller file from below directory path in the provided API upload /system/engine/ 2.15. Upload the restcontroller file into this location of opencart site upload /system/engine/ Note : Remove code from function returndeprecated() which is written in upload /system/engine/restcontroller.php and only return true inside this function. 2.16. Get the folder vqmod folder from below directory path in the provided API upload / 2.17. Upload folder vqmod into this location of opencart site upload/ Now that you ve installed the OpenCart API extension, you ll be able to see it on your OpenCart Admin interface (figure 2.1). You ll need to create a secret key (it can be a combination of letters and numbers) and insert the order id you obtain when purchasing the OpenCart API extension (figure 2.2). Please note down the secret key as you will need it in order to setup the OpenCart Native module. For any support related to the OpenCart API, please contact the developer directly through info@opencartapi.com. Figure 2.1 OpenCart Admin > Extensions 3
Figure 2.2. Rest API interface 3. MODULE setup By now you should have setup the OpenCart API. If you have not done so please refer to the OPENCART API setup instructions. Setting up the OpenCart Native module is quite straightforward and is divided into 2 steps. a. Connecting to the OPencart site The URL of your OpenCart site and the Secret Key you created on the OpenCart API extension will be needed at this point. You ll need to add them to the module as shown below (figure 3.A.1). Figure 3.A.1 Connecting to the OpenCart API 4
You ll also have the possibility of uploading a logo for your store (it should be transparent) and a footer that will appear at the end of the App s main page after the products. b. Configuring payment methods The OpenCart Native module support payments via Paypal, Stripe and bank transfer - should you need a specific payment method, please contact our support team. You ll need to add the API details for each of the payment methods that you d like to activate. By filling out the information on the module, you ll make the payment method active on the App. c. colors You can set the color on the OpenCart Native module by changing the Homepage (Border), List, List Item and Button colors on the Siberian Colors tab. 4. LAYOUTs The the OpenCart Native module was optimized to be used with Siberian Layout 9 same as seen below. It does, however, work with any other layouts. 5. Additional modules When adding additional modules to this App, you should be aware that the login needs to be made first using the OpenCart user account icon (figure 5.1). When the user logs-in using the OpenCart account, the user will be automatically logged into the Siberian account. Figure 5.1 OpenCart user account icon OpenCart User Account icon 5
In case you need to add modules that require login, please follow the following steps (figure 5.2): 1-Add the modules that require login to your App; 2-Add the Padlock feature to the App and select the modules that require login; 3-Make sure that the Padlock feature is not activated so that the Padlock icon will not show on the App. Figure 5.2 Padlock setup 6
Following the steps outlined above, the modules that require login will only appear after the user has logged in using the OpenCart user account icon. If you do not follow the steps outlined above, the user will be able to login directly into Siberian and won t be logged into OpenCart. 6. User Frontend Interface Below you can find the user frontend interface screens. 7
7. TIPS The OpenCart Native module only requires one icon but you should add additional icons for, e.g., About Us, Terms & Conditions, Privacy Policy and Delivery & Returns. These additional pages will make the App fuller and will avoid the App from being rejected on the Apps stores. 8