X-Payments:Updating your X-Payments connector for Magento

From X-Payments Help
Jump to: navigation, search

We recommend using the latest available version of the X-Payments connector extension at all times. As new versions of the X-Payments connector become available, you may want to update your installed connector. To update your X-Payments connector for Magento, use one of the methods below.

Manual updating

To update your X-Payments connector manually, complete the following steps:

  1. Unarchive the extension package and copy its contents to your Magento site's root directory (without the file package.xml, as you do not need this file for this type of installation).
  2. Make sure the files responsible for displaying the X-Payments Iframe have been copied to the correct design package folder.
    For example, you may be using a design package other than default.
    (To find out what design package you are currently using, go to System -> Configuration -> Design (General) and review the section titled Package.)
    If the Current Package Name field in the Package section shows anything other than "default", you need to copy the template folders from your unarchieved X-Payments connector package to the folder of the design package listed in this field.

Example:
The name in the Current Package Name field shows as ultimo.
In this case you need to copy the template folder and layout:
  • app/design/frontend/default/default/template/xpaymentsconnector
  • app/design/frontend/default/default/layout/xpaymentsconnector.xml
to:
  • app/design/frontend/ultimo/default/template/xpaymentsconnector
  • app/design/frontend/ultimo/default/layout/xpaymentsconnector.xml



Automated updating

This method requires that your Magento folders have sufficient write permissions so you can use the Magento Connect Manager in the Admin Panel. To update your X-Payments connector, complete the following steps:

  1. In the Magento Admin panel, go to System -> Magento Connect-> Magento Connect Manager.
  2. Re-enter your Magento Administration Credentials.
  3. Uninstall the currently installed version of the X-Payments connector:
    Mg connector uninstall.png

  4. If the uninstallation is completed successfully, you should see something like the following:
    Mg connector uninstall success.png

  5. Install the new version of the X-Payments connector using one of the following methods:
    Install mg ext methods.png

  6. If in the process of installing the connector you get an error like the following:
    Mg ext install fail.png

    it may mean that not all the files and folders that were supposed to be removed during the uninstallation process have been removed successfully, and you will need to remove them manually.
    In our example, as demonstrated by the snapshot above, the problem is caused by the file /app/code/community/Cdev/XPaymentsConnector/Block/Adminhtml/System/Config/Form/Subselect.php
    To resolve this problem, we need to remove this file. In this situation, it is probably better to remove the entire folder app/code/community/Cdev/XPaymentsConnector - this way we'll get through the installation process faster.
    After removing all the files and folders of your old X-Payments connector installation, click the Refresh button, then try to install the extension again. You may have to do so more than once before all the files hindering the installation are removed.
  7. In the end, you should get something like the following:
    Mg connector install completed.png

  8. If you are using a design package other than default, please remember to check that the X-Payments connector theme files and folders have been copied there. A detailed explanation of what needs to be done is provided in the section 'Manual updating' above (See Step 2).