JoelLipman.Com's AlertPay Payment Module for VirtueMart
 
This location is for Registered Users Only.
Please login or Register.

Description:

JoelLipman.Com's AlertPay Payment Module for VirtueMart TESTED ON:

- Virtuemart v1.1.3 & Virtuemart v1.1.4
- Joomla v1.5.14 & Joomla v1.5.15
- PHP v5.2.8 & MySQL v5.1.30

 

SCREENSHOT:

 

LICENSE:

These scripts are offered freely and in good faith. Please do not pass this off as your own work or try to sell it without due credit. Check back with us at joellipman.com for updates/fixes. If you want more support/work done to it, you could consider a donation :c)

 

BACKGROUND:

We've tried Googling the various AlertPay Payment Modules and trying to download them; to no avail though. Feed2post: Taken down and nothing there... CoderXO: where do i download it and why's it $35 dollars...? Well I ended up writing my own one and this one's free. As you can see I don't have an e-commerce site but I have friends who do and they're my guinea pigs...

This payment module will let you use Virtuemart with AlertPay. It takes your customer through the Virtuemart shopping process and then when they want to pay, they get redirected to the alertpay checkout/login page with a detailed order confirmation.

 

CHANGELOG:

 

Version 1.4

• Removed redirectional parameters after the return URL (these were hardcoded now it's up to you what you want there)
• Added GNU/GPL Copyright information as requested by Joomla Administrators

Version 1.3

• Fixed bug of items price being multiplied by quantity.
• Removed leading zeros on order id as "ap_itemname" cannot be more than 50 characters.

Version 1.2

• Uses AlertPay's new multiple-item checkout feature.
• Installation process simplified/automated (no coding/programming knowledge required)
• Includes shipping, tax and discount amounts as specified in your Virtuemart setup.
• Uses alertpay's parameter fields to specify item name, code, amount, description and quantity. Displays these as separate lines on the Alertpay checkout page along with subtotals, charges, and each total item price (see our screenshot below).
• Virtuemart Order Reference is included as a prefix to the first item in the checkout list.

Version 1.1

• Moved customizable parameters to fields.
• Available for global download on the www.joellipman.com website.

Version 1.0

• My first payment module for Virtuemart :c) !!!
• Hard-coded working version of AlertPay Payment Module.
• Order Reference is the item name and Order Description is text informing the customer that they've been emailed the details of the order.

 

 

IMPORTANT NOTE:

If you have any other AlertPay payment module(s) already installed on your Virtuemart setup, then make a copy, as a backup, of the following files:

/administrator 
     /components 
          /com_virtuemart 
               /classes 
                    /payment
                         /ps_alertpay.php
                         /ps_alertpay.cfg.php

 

INSTALLATION:

 

1. Download the alertpay_payment_module.zip from www.joellipman.com/features/downloads.html > downloads > Joomla 1.5 > AlertPay Payment Module (requires registration)
2. Unzip the two files (ps_alertpay.php and ps_alertpay.cfg.php) to a temporary drive on your local computer
3. Check that you don't already have someone else's alertpay payment module by looking in the folder as per my "Important Note" section above.
4. Upload the two PHP files to the directory (/administrator/components/com_virtuemart/classes/payment)
5. Login to your administration panel (back-end)
6. Go to Components > Virtuemart > Store > List Payment Methods > New
7. Ensure the "Active" checkbox is enabled (ticked)
8. "Payment Method Name" should be AlertPay (doesn't have to be but it's easier to remember)
9. "Code" is AP (again just easier to remember)
10. Next to "Payment class name", select ps_alertpay from the drop-down.
11. For "Payment method type", put a dot next to the HTML-form based (e.g. Paypal) option.
12. Click on the "SAVE" icon (top-right).
13. You should be returned to the "Payment Method List" page, click on the AlertPay entry you just made.
14. Click on the Configuration tab (next to Payment Method Form tab)
15. There should be a message saying that ps_alertpay.cfg.php is Writeable. If it isn't then check the permissions on the file using your FTP client.
16. Complete the fields just under this message as appropriate.
    • Purchase Type should be item-goods
    • Business email name should be the email address YOU registered with Alertpay as.
    • Return URL is the page that the user should be directed to when they click on "Return to Merchant"
    • Cancel URL is the page if the user starts signup to AlertPay but then cancels for whatever reason.
17. If you are using a javascript-enabled browser, the Payment Extra Info field should auto-complete itself with a load of programming code.
18. Click on the "SAVE" icon again (top-right).
19. Test as appropriate (Login to your AlertPay Account and Enable TEST mode)

 

FUTURE CONSIDERATIONS:

 

• Additional Charges field for AlertPay is not accounted for and set statically to 0.00
• Make price on each row not do for each but in total (or tell alertpay to indicate that price is for each item "@")
• Pass through AlertPay username and password for wholesalers which avoids the AlertPay pages and processes it without leaving the site.

 

 

TO RE-INSTALL/UPGRADE:

 

1. Upload just the ps_alertpay.php from the downloaded zip to the specified folder ("payment").
2. Go into your admin panel and clear the "Payment Extra Info" textbox (so that it's blank)
3. Click the SAVE icon
4. Go back to into the AlertPay entry and click the "Configuration" tab
5. The "Payment Extra Info" field should autocomplete itself (if it doesn't then enable javascript)

 

 

SCREENSHOT:

Submitted On:

July 2010

Submitted By:

Joel Lipman (webmaster)

File Date:

May 2010

File Version:

1.4

File Size:

14.79 Kb

File Type:

zip

Downloads:

246

Rating:

Total Votes:8

Comments:

source engineering 2010-02-18 18:41:54 Excellent, the word should be spread for your plugin. Thank you so much, appreciate it.

RV 2010-02-23 05:06:42 BRILLIANT!!!!!!!! I agree with source engineering that the word should be spread about this plugin - it is essential. Thanks a million times over - you've just spared me a huge headache.

tarek 2010-03-13 15:20:55 thanks so much

Angel 2010-04-22 12:03:41 Thanks a lot for your work... ;)

Austin Irabor 2010-05-12 15:16:27 Thank You!

mohamed 2010-06-20 14:27:19 Thanks a loot Joel awsome work keep it up

hasithaya 2010-08-16 07:04:15 Thanks very very much