Virtue Mart 3

Intégration Virtue Mart 3

VirtueMart 3 est une extension e-commerce gratuite et open-source pour Joomla, vous permettant de vendre des produits en ligne avec un système de boutique flexible. Post Affiliate Pro peut être intégré à VirtueMart 3 pour suivre les ventes affiliées, que les commandes soient payées en ligne ou hors ligne.

Cette méthode d’intégration est destinée à la version 3 de Virtue Mart. Si vous disposez d’une version antérieure, veuillez consulter la méthode d’intégration nommée « Virtue Mart 2 ».

Informations requises

Avant de commencer, vous avez besoin de :

• ID de compte Post Affiliate Pro – utilisé dans le script de suivi.

• URL du script de suivi PAP – généralement sous la forme : https://VOTRE_DOMAINE_POSTAFFILIATE/scripts/trackjs.js

• Accès à votre installation Joomla / VirtueMart 3 – vous devrez éditer des fichiers PHP. Sauvegardez toujours vos fichiers avant toute modification.

Intégration étape par étape

Voici les étapes à suivre, selon le guide officiel d’intégration VirtueMart 3 par Post Affiliate Pro. Tous les extraits de code sont accompagnés de leurs emplacements de fichiers.

Intégrer les paiements hors ligne (espèces)

Pour les méthodes de paiement hors ligne, le code de suivi doit être ajouté au plugin VirtueMart qui gère les paiements « standard » (hors ligne). Localisez le fichier :

Ouvrez le fichier plugins/vmpayment/standard/standard.php et trouvez la fonction plgVmConfirmedOrder.

À la fin de celle-ci, il y a une ligne $cart- >emptyCart – placez le code suivant juste au-dessus :

/* [Post Affiliate Pro](/ "Post Affiliate Pro propose une plateforme complète de gestion de programmes d'affiliation. Profitez de l'absence de frais d'installation, d'un support client 24/7 et d'un essai gratuit d'un mois. Idéal pour les petites et grandes entreprises, il offre un suivi précis, des workflows automatisés et des outils personnalisables pour booster votre marketing d'affiliation. Essayez-le maintenant et simplifiez vos opérations d'affiliation !") integration snippet */
$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 propose une plateforme complète de gestion de programmes d'affiliation. Profitez de l'absence de frais d'installation, d'un support client 24/7 et d'un essai gratuit d'un mois. Idéal pour les petites et grandes entreprises, il offre un suivi précis, des workflows automatisés et des outils personnalisables pour booster votre marketing d'affiliation. Essayez-le maintenant et simplifiez vos opérations d'affiliation !") Pro integration snippet */

Enregistrez vos modifications.

Intégrer les paiements en ligne

Les paiements en ligne sont gérés différemment, notamment dans le plugin VirtueMart responsable des réponses de paiement de commande confirmées.

Ouvrez le fichier administrator/components/com_virtuemart/plugins/vmpsplugin.php et trouvez la fonction processConfirmedOrderPaymentResponse.

Ajoutez le code suivant au début :

/* Post [Affiliate](/ "Post Affiliate Pro propose une plateforme complète de gestion de programmes d'affiliation. Profitez de l'absence de frais d'installation, d'un support client 24/7 et d'un essai gratuit d'un mois. Idéal pour les petites et grandes entreprises, il offre un suivi précis, des workflows automatisés et des outils personnalisables pour booster votre marketing d'affiliation. Essayez-le maintenant et simplifiez vos opérations d'affiliation !") Pro integration snippet */
$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 integration snippet */

Enregistrez le fichier et testez avec une véritable méthode de paiement en ligne pour vous assurer que le suivi s’active correctement après confirmation du paiement.

Étape supplémentaire : suivi des clics

Après avoir mis en place le suivi des ventes (via les extraits ci-dessus), vous devez également intégrer le suivi des clics, afin que lorsqu’un lien d’affilié est cliqué, le clic soit enregistré. Sans suivi des clics, les ventes risquent de ne pas être correctement attribuées aux affiliés.

• Cela implique généralement de placer un script de suivi des clics dans un emplacement commun à toutes les pages (souvent dans l’en-tête ou via un template global).
• Cela permet de capturer tous les clics d’affiliés avant qu’une commande ne soit passée.

Tests & Vérification Une fois les extraits ajoutés :

1. Passez une commande hors ligne de test : vérifiez que le script de suivi apparaît dans le HTML avant la vidange du panier.
2. Passez une commande en ligne de test : assurez-vous qu’après le paiement, le code de suivi s’exécute et envoie les données à votre compte Post Affiliate Pro.
3. Testez un lien de parrainage affilié : cliquez sur le lien, finalisez un achat et vérifiez que la vente est attribuée à l’affilié dans les rapports PAP.

Dépannage

• Si aucun suivi n’apparaît, vérifiez que vous avez utilisé les bons chemins de fichiers (dans votre installation Joomla / VirtueMart) et les bons noms de plugins VirtueMart.
• Assurez-vous que URL_TO_PostAffiliatePro et Account_ID sont remplacés par votre véritable URL de script Post Affiliate Pro et votre véritable identifiant de compte.
• Veillez à vider le cache (serveur / CDN) après les modifications.
• Vérifiez qu’il n’y a pas d’erreurs de syntaxe (notamment les guillemets, la concaténation) dans le PHP lors de l’ajout de l’extrait.

Exemple de code combiné

Voici un extrait combiné simplifié (exemple pour paiements hors ligne) :

// dans plugins/vmpayment/standard/standard.php, à l'intérieur de la fonction plgVmConfirmedOrder
// … code précédent

/* Post Affiliate Pro integration snippet */
$html .= '<script id="pap_x2s6df8d" src="https://VOTRE_DOMAINE_POSTAFFILIATE/scripts/trackjs.js" type="text/javascript"></script>
<script type="text/javascript">' . "PostAffTracker.setAccountId('VOTRE_ID_COMPTE');
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 de l'extrait */

// Procédez à la vidange du panier
$cart->emptyCart();

Alternatives à VirtueMart 3 compatibles avec Post Affiliate Pro

Si vous envisagez des alternatives à VirtueMart 3, ces plateformes sont également compatibles avec Post Affiliate Pro :