Virtue Mart 3

Integración de Virtue Mart 3

VirtueMart 3 es una extensión gratuita y de código abierto para Joomla, que te permite vender productos en línea con un sistema de tienda flexible. Post Affiliate Pro se puede integrar con VirtueMart 3 para rastrear las ventas de afiliados, ya sea que los pedidos se paguen en línea o fuera de línea.

Este método de integración es para la versión 3 de Virtue Mart. Si tienes una versión inferior, por favor dirígete al método de integración llamado “Virtue Mart 2”.

Información requerida

Antes de comenzar, necesitas:

• ID de cuenta de Post Affiliate Pro – se utiliza en el fragmento de seguimiento.

• URL del script de seguimiento de PAP – normalmente algo como: https://TU_DOMINIO_POSTAFFILIATE/scripts/trackjs.js

• Acceso a tu instalación de Joomla / VirtueMart 3 – necesitarás editar archivos PHP. Siempre haz una copia de seguridad antes de realizar cambios.

Integración paso a paso

A continuación se presentan los pasos que debes seguir, basados en la guía oficial de integración de VirtueMart 3 por Post Affiliate Pro. Todos los fragmentos de código incluyen sus ubicaciones de archivo.

Integrar pagos offline (efectivo)

Para los métodos de pago offline, el código de seguimiento debe agregarse al plugin de VirtueMart que gestiona los pagos “estándar” (offline). Ubica el archivo:

Abre el archivo plugins/vmpayment/standard/standard.php y busca la función plgVmConfirmedOrder.

Al final de esta función, hay una línea $cart- >emptyCart – coloca el siguiente código encima de ella:

/* [Post Affiliate Pro](/ "Post Affiliate Pro ofrece una plataforma integral de software de afiliados para gestionar múltiples programas de afiliados fácilmente. Sin tarifas de instalación, soporte 24/7 y prueba gratuita de 1 mes. Ideal para negocios pequeños y grandes, ofrece seguimiento preciso, flujos de trabajo automatizados y herramientas personalizables para impulsar el éxito de tu marketing de afiliados. ¡Pruébalo ahora y optimiza tus operaciones de afiliados sin esfuerzo!") fragmento de integración */
$html .= '<script id="pap_x2s6df8d" src="https://URL_TO_PostAffiliatePro/scripts/trackjs.js" type="text/javascript"></script>
<script type="text/javascript">'."PostAffTracker.setAccountId('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>";
/* [Post Affiliate](/ "Post Affiliate Pro ofrece una plataforma integral de software de afiliados para gestionar múltiples programas de afiliados fácilmente. Sin tarifas de instalación, soporte 24/7 y prueba gratuita de 1 mes. Ideal para negocios pequeños y grandes, ofrece seguimiento preciso, flujos de trabajo automatizados y herramientas personalizables para impulsar el éxito de tu marketing de afiliados. ¡Pruébalo ahora y optimiza tus operaciones de afiliados sin esfuerzo!") fragmento de integración Pro */

Guarda los cambios.

Integrar pagos online

Los pagos online se gestionan de forma diferente, especialmente en el plugin de VirtueMart responsable de las respuestas de pago de pedidos confirmados.

Abre el archivo administrator/components/com_virtuemart/plugins/vmpsplugin.php y busca la función processConfirmedOrderPaymentResponse.

Agrega el siguiente código al inicio de la función:

/* Post [Affiliate](/ "Post Affiliate Pro ofrece una plataforma integral de software de afiliados para gestionar múltiples programas de afiliados fácilmente. Sin tarifas de instalación, soporte 24/7 y prueba gratuita de 1 mes. Ideal para negocios pequeños y grandes, ofrece seguimiento preciso, flujos de trabajo automatizados y herramientas personalizables para impulsar el éxito de tu marketing de afiliados. ¡Pruébalo ahora y optimiza tus operaciones de afiliados sin esfuerzo!") fragmento de integración Pro */
$html .= '<script id="pap_x2s6df8d" src="https://URL_TO_PostAffiliatePro/scripts/trackjs.js" type="text/javascript"></script>
<script type="text/javascript">'."PostAffTracker.setAccountId('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>";
/* Post Affiliate Pro fragmento de integración */

Guarda el archivo y haz una prueba con un método de pago online real para asegurarte de que el seguimiento se ejecute correctamente después de la confirmación de pago.

Paso adicional: Seguimiento de clics

Después de implementar el seguimiento de ventas (con los fragmentos anteriores), también debes integrar el seguimiento de clics, para que cuando se haga clic en un enlace de afiliado, el clic quede registrado. Sin el seguimiento de clics, las ventas pueden no atribuirse correctamente a los afiliados.

• Normalmente esto implica colocar un script de seguimiento de clics en un lugar común para todas las páginas (a menudo en el encabezado o mediante una plantilla global).
• Esto captura todos los clics de afiliados antes de que se realice un pedido.

Pruebas y verificación Una vez añadidos los fragmentos:

1. Haz un pedido de prueba offline: verifica que el script de seguimiento aparece en el HTML antes de vaciar el carrito.
2. Haz un pedido de prueba online: asegúrate de que, tras el pago, el código de seguimiento se ejecuta y envía los datos a tu cuenta de Post Affiliate Pro.
3. Prueba un enlace de referido de afiliado: haz clic en el enlace, finaliza una compra y verifica que la venta se atribuye al afiliado en los informes de PAP.

Solución de problemas

• Si no aparece el seguimiento, revisa que hayas utilizado las rutas de archivo correctas (en tu instalación de Joomla/VirtueMart) y los nombres correctos de los plugins de VirtueMart.
• Asegúrate de que URL_TO_PostAffiliatePro y Account_ID se reemplacen por tu URL real del script de Post Affiliate Pro y tu ID de cuenta real.
• Verifica que el caché (en el servidor/CDN) esté limpio tras los cambios.
• Revisa errores de sintaxis (especialmente comillas y concatenaciones) en PHP al agregar el fragmento.

Ejemplo de código combinado

Aquí tienes un fragmento combinado simplificado (ejemplo para pagos offline):

// en plugins/vmpayment/standard/standard.php, dentro de la función plgVmConfirmedOrder
// … código previo

/* Fragmento de integración Post Affiliate Pro */
$html .= '<script id="pap_x2s6df8d" src="https://TU_DOMINIO_POSTAFFILIATE/scripts/trackjs.js" type="text/javascript"></script>
<script type="text/javascript">' . "PostAffTracker.setAccountId('TU_ID_DE_CUENTA');
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>";
/* Fin del fragmento */

// Procede a vaciar el carrito
$cart->emptyCart();

Alternativas a VirtueMart 3 que se integran con Post Affiliate Pro

Si estás considerando alternativas a VirtueMart 3, estas plataformas también son compatibles con Post Affiliate Pro: