MAGEJAM PLUGIN INSTALLATION GUIDE

Transcription

1 MAGEJAM PLUGIN INSTALLATION GUIDE BEFORE YOU BEGIN ANY INSTALL OR UPGRADE ** Always make sure to make a backup of your Magento installation before installing any extension especially on a live system.** PRE-REQUISITES A) The plugin is compatible with Magento Community Edition 1.7 and higher. B) SOAP is Required to allow MageJam to bridge the Magento store with the JMango360 App Management (J.A.M.) toolkit Make sure the SOAP module for PHP is installed and enabled. This is usually configured in a separate php configuration file within the php.d/ folder called soap.ini. C) Payment Method Integration Note: Payment methods compatible with MageJam extension: 1. All gateway methods 2. Hosted methods which meets the requirements below: a) hosted methods should redirect from Place Order page b) if success they should return to checkout/onepage/success page c) if fail they should return to checkout/cart page D) PRODUCT TYPES - Downloadable and virtual products are not supported. INSTALLATION First, please go to Magento admin panel, on the menu bar navigate to System >> Magento Connect >> Magento Connect Manager

2 - In Magento Connect Manager, please click on the link to go to Magento Connect website - Next step, you need to register an account and login to your account on Magento Connect. And then search for the JMango360 Magejam plugin. - Click to view the plugin in detail, then click on Install Now button

3 - Choose "I agree to the extension license argreement.\ - Click Get extension key button, then copy the key - Come back to Magento Connect Manager and paste the key to "Install new Extensions" field then click Install

4 - Next step, click Proceed and the plugin will be installed to your system - Please press Refresh button to continue - Then you can see Magejam plugin is now successfully installed. Let's turn back to the Magento admin panel to configure Magento site after installation of the plugin

5 Configure Magento site after installation of the plugin Enabled WS-I Compliance Go to the admin panel, from manu bar choose System >> Configuration >> Magento Core API Change WS-I Compliance to YES Change Enable WSDL Cache to YES Click Save Disable payment page login for Magejam module setup Go to the admin panel, from manu bar choose System >> Configuration >> under section Services >> Magejam set the parameter: "Use authorization on payment page" to false. Authentication is required to be set to No by default Testing of MageJam plugin After installing the plugin, you can run a test routine on Admin interface to validate that the plugin has been installed successfully. Step 1: Log into the Magento admin panel Step 2: from Menu bar, choose Settings >> Configuration. Step 3: go to MageJam settings and click on button "Test MageJam plugin"

6 Step 4: Complete the form with following information. - Select test store: please select the store which will be used for mobile app when integrate with JMango360 - Select test customer: please choose a customer with valid default shipping and billing address for testing shopping cart function. - Click "Test plugin cart operation" button, shipping method and payment method list will be displayed. The testing finished successfully. Create API role Go to System >> Web Services >> SOAP/XML-RPC Roles Click orange button 'Add new Role' in right corner on the tab Role Resource select Resource Access >> All. Create API user Go to System >> Web Services >> SOAP/XML-RPC - Users Click orange button 'Add new User' in right corner Fill User Info On the tab User Role don't forget to choose the role you have created on previous step Click orange button Save User Check that the wsdl is visible to external system open the URL as per following: <base site URL>/api/v2_soap?wsdl (this URL should return some XML data for the webservice definition.) You're now ready to integrate with the site via JMango SOAP.

7 REINSTALL / UPGRADE If you are having problems or need to upgrade your MageJam installation please follow these steps. Step 1: Uninstall Magejam plugin First, please go to Magento admin panel, on the menu bar navigate to System >> Magento Connect >> Magento Connect Manager Choose Uninstall then press Commit Changes button.

8 Step 2: Clear Magento and Storage Caches. a. Go to System -> Cache Management. b. Click Flush Magento Cache & Flush Cache Storage. Step 3: Install the newest plugin version by following the instruction above.