Virtue Mart 3

Virtue Mart 3 integration

VirtueMart 3 is a free, open-source e-commerce extension for Joomla, allowing you to sell products online with a flexible store system. Post Affiliate Pro can be integrated with VirtueMart 3 to track affiliate sales, whether orders are paid online or offline.

This integration method is for Virtue Mart version 3. If you have a lower version, please navigate to the integration method named “Virtue Mart 2”.

Required Information

Before you begin, you need:

• Post Affiliate Pro Account ID – used in the tracking snippet.

• URL to PAP tracking script – usually something like: https://YOUR_POSTAFFILIATE_DOMAIN/scripts/trackjs.js

• Access to your Joomla / VirtueMart 3 installation – you will need to edit PHP files. Always backup files before making changes.

Step-by-step integration

Below are the steps you should follow, based on the official VirtueMart 3 integration guide by Post Affiliate Pro. All code snippets come with their file locations.

Integrate offline payments (cash)

For offline payment methods, the tracking code should be added to the VirtueMart plugin that handles “standard” (offline) payments. Locate the file:

Open file plugins/vmpayment/standard/standard.php and find function plgVmConfirmedOrder.

At the end of it, there is a line $cart- >emptyCart – place the following code above it:

/* [Post Affiliate Pro](/ "Post Affiliate Pro offers a comprehensive affiliate software platform to manage multiple affiliate programs with ease. Enjoy no setup fees, 24/7 customer support, and a free 1-month trial. Ideal for small and large businesses, it features precise tracking, automated workflows, and customizable tools to boost your affiliate marketing success. Try it now and streamline your affiliate operations effortlessly!") integration snippet */
$html .= '<script id="pap_x2s6df8d" src="https://URL_TO_PostAffiliatePro/scripts/trackjs.js" type="text/javascript"></script>
<script type="text/javascript">'."{$SetAccountJs}
{$CreateSaleJs}
sale.setTotalCost('".$order['details']['BT']->order_subtotal."');
sale.setOrderID('".$order['details']['BT']->order_number."');
sale.setData1('".$order['details']['BT']->email."');
PostAffTracker.register();
</script>";
/* [Post Affiliate](/ "Post Affiliate Pro offers a comprehensive affiliate software platform to manage multiple affiliate programs with ease. Enjoy no setup fees, 24/7 customer support, and a free 1-month trial. Ideal for small and large businesses, it features precise tracking, automated workflows, and customizable tools to boost your affiliate marketing success. Try it now and streamline your affiliate operations effortlessly!") Pro integration snippet */

Save your changes.

Integrate online payments

Online payments are handled differently, particularly in the VirtueMart plugin responsible for confirmed order payment responses.

Open file administrator/components/com_virtuemart/plugins/vmpsplugin.php and find function processConfirmedOrderPaymentResponse.

Add the following code to its beginning:

/* Post [Affiliate](/ "Post Affiliate Pro offers a comprehensive affiliate software platform to manage multiple affiliate programs with ease. Enjoy no setup fees, 24/7 customer support, and a free 1-month trial. Ideal for small and large businesses, it features precise tracking, automated workflows, and customizable tools to boost your affiliate marketing success. Try it now and streamline your affiliate operations effortlessly!") Pro integration snippet */
$html .= '<script id="pap_x2s6df8d" src="https://URL_TO_PostAffiliatePro/scripts/trackjs.js" type="text/javascript"></script>
<script type="text/javascript">'."{$SetAccountJs}
{$CreateSaleJs}
sale.setTotalCost('".$order['details']['BT']->order_subtotal."');
sale.setOrderID('".$order['details']['BT']->order_number."');
sale.setData1('".$order['details']['BT']->email."');
PostAffTracker.register();
</script>";
/* Post Affiliate Pro integration snippet */

Save the file and test with a real online payment method to ensure the tracking fires correctly after payment is confirmed.

Additional step: Click tracking

After implementing sale tracking (via the snippets above), you must also integrate click tracking, so that when an affiliate link is clicked, the click is recorded. Without click tracking, sales may not be properly attributed to affiliates.

• Usually this involves placing a click tracking script in a place that’s common to all pages (often in the header or via a site-wide template).
• This captures all affiliate clicks before an order is placed.

Testing & Verification Once you’ve added the snippets:

1. Place a test offline order: verify the tracking script appears in the HTML before the cart is emptied.
2. Place a test online order: ensure after payment that the tracking code runs and sends data to your Post Affiliate Pro account.
3. Test an affiliate referral link: click the link, complete a purchase, and verify the sale is attributed to the affiliate in PAP reports.

Troubleshooting

• If no tracking shows up, double-check that you used the correct file paths (in your Joomla / VirtueMart installation) and correct virtuemart plugin names.
• Ensure that URL_TO_PostAffiliatePro and Account_ID are replaced with your real Post Affiliate Pro script URL and your real account ID.
• Be sure that caching (on server / CDN) is cleared after changes.
• Check for syntax errors (especially quotes, concatenation) in PHP when adding the snippet.

Example code combined

Here’s a simplified combined snippet (offline payments example):

// in plugins/vmpayment/standard/standard.php, inside plgVmConfirmedOrder function
// … prior code

/* Post Affiliate Pro integration snippet */
$html .= '<script id="pap_x2s6df8d" src="https://YOUR_POSTAFFILIATE_DOMAIN/scripts/trackjs.js" type="text/javascript"></script>
<script type="text/javascript">' . "PostAffTracker.setAccountId('YOUR_ACCOUNT_ID');
var sale = PostAffTracker.createSale();
sale.setTotalCost('" . $order['details']['BT']->order_subtotal . "');
sale.setOrderID('" . $order['details']['BT']->order_number . "');
sale.setData1('" . $order['details']['BT']->email . "');
PostAffTracker.register();
</script>";
/* End of snippet */

// Proceed to empty the cart
$cart->emptyCart();

Alternatives to VirtueMart 3 that integrate with Post Affiliate Pro

If you are considering alternatives to VirtueMart 3, these platforms are also compatible with Post Affiliate Pro: