Summer Cart

Intégration Summer Cart

Un panier d’achat PHP facile à utiliser et complet.

Summer Cart dispose de tous les outils et fonctionnalités permettant aux commerçants en ligne de créer facilement une boutique opérationnelle de A à Z. Que vous vendiez une douzaine de spécialités de niche ou que vous proposiez des centaines de produits grand public, vous bénéficierez d’une grande visibilité et popularité grâce à une boutique savamment conçue.

Comment intégrer PostAffiliatePro avec Summer Cart

L’intégration de Post Affiliate Pro avec Summer Cart nécessite de modifier non seulement le pied de page de votre boutique (pour ajouter le code de suivi des clics), mais aussi deux classes du panier d’achat. Retrouvez les détails de cette intégration ci-dessous.

Intégration des clics

Le code de suivi des clics doit être placé dans le fichier skins//customer/footer.tmpl.

Si vous ne disposez pas de ce fichier dans votre thème, copiez-le simplement depuis le répertoire skeleton vers votre dossier de thème et ajoutez le code de suivi des clics, disponible pour vous dans Post Affiliate Pro (menu Outils -> Intégration -> Suivi des clics)

Ajoutez ce code avant la balise </body> dans votre template footer.tmpl.

Intégration des ventes

L’intégration des ventes se déroule en deux étapes et s’effectue en appelant les requêtes API PAP vers Post Affiliate Pro directement depuis le code PHP de votre panier.

Dans la première étape, une transaction est créée dans Post Affiliate Pro (statut En attente) et, plus tard, lorsque la commande est livrée à votre client, la transaction dans Post Affiliate Pro passe au statut Approuvée.

Étape d’ajout de transaction

Votre panier crée une commande au moment où le visiteur est redirigé vers le processeur de paiement (par exemple Paypal). Au même moment, une transaction est créée dans Post Affiliate Pro (statut En attente).

Ouvrez le fichier du panier : /include/sc/util/order/OrdersInProgress.php

afin d’y placer le code de suivi des ventes à la fin de la classe scOrdersInProgress.

Pour suivre l’ensemble de la commande comme une seule transaction (commission) dans Post Affiliate Pro (même si plusieurs articles sont achetés lors de la commande), utilisez le code suivant :

private function registerNewPostAffiliateProTransaction($order) {
    include_once('<PATH_TO_PAP_API>/PapApi.class.php');
    $saleTracker = new Pap_Api_SaleTracker('https://URL_TO_PostAffiliatePro/scripts/sale.php');

    $productIDs = '';
    $items = $order->getOrderItems();
    foreach($items as $item) {
       $productIDs .= $item->get('OrderItemProductCode').',';
    }

    $sale = $saleTracker->createSale();
    $papOrderDetails = $order->getOrderTotalLines();
    $sale->setTotalCost($papOrderDetails[0]->get('OrderTotalLineCustomerCurrencyAmount'));
    $sale->setOrderID($order->getPK());
    $sale->setProductID($productIDs);
 
    $saleTracker->register();
}

Si vous souhaitez que chaque article acheté lors de la commande soit suivi comme une transaction distincte (commission) dans Post Affiliate Pro, utilisez alors ce code :

private function registerNewPostAffiliateProTransaction($order) {
    include_once('<PATH_TO_PAP_API>/PapApi.class.php');
    $saleTracker = new Pap_Api_SaleTracker('https://URL_TO_PostAffiliatePro/scripts/sale.php');
      $items = $order->getOrderItems();
      foreach($items as $item) {
          $sale = $saleTracker->createSale();
          $sale->setTotalCost($item->get('OrderItemTotal'));
          $sale->setOrderID($order->getPK());
          $sale->setProductID($item->get('OrderItemProductCode'));
      }
      $saleTracker->register();
    }

IMPORTANT : cette méthode doit être placée avant la fin de la classe, c’est-à-dire avant le dernier } dans le fichier /include/sc/util/order/OrdersInProgress.php

IMPORTANT : N’oubliez pas de remplacer <PATH_TO_PAP_API> par le chemin correct vers le fichier PapApi.class.php.

Le fichier PapApi.class.php peut être téléchargé depuis votre installation Post Affiliate Pro dans le menu Outils -> Intégration -> Intégration API.

Copiez-le sur votre serveur, là où votre boutique est installée, et indiquez le chemin correct à la place de <PATH_TO_PAP_API>.

Étape d’ajout de transaction

Nous devons maintenant utiliser la méthode registerNewPostAffiliateProTransaction ajoutée à l’étape précédente.

Veuillez ajouter la ligne de code suivante dans la méthode createOrder juste avant la dernière ligne :

return $this->_lastOrderId;


$this->registerNewPostAffiliateProTransaction($order);

Changement du statut de la transaction

Le statut des transactions existantes dans Post Affiliate Pro peut être contrôlé en modifiant le statut dans votre panier.

Le code suivant changera le statut de la transaction PAP en Approuvée si vous définissez la commande de votre panier sur le statut Livrée.

Et il définira la transaction PAP sur Refusée si vous définissez la commande sur Annulée, Échouée ou Retournée.

Modifiez votre fichier de panier /include/sc/domainobj/Order.php et ajoutez à la fin de la classe Order la méthode suivante :

private function updatePostAffiliateProTransaction() {
  try {
      include_once('<PATH_TO_PAP_API>/PapApi.class.php');
    $session = new Gpf_Api_Session("https://URL_TO_PostAffiliatePro/scripts/server.php");

    if(!$session->login("<MERCHANT_USERNAME>","<MERCHANT_PASSWORD>")) {
      return false;
    }


    $request = new Pap_Api_TransactionsGrid($session);
    $request->addFilter("orderid", Gpf_Data_Filter::LIKE, $this->getPK());
    $request->addFilter("rtype", Gpf_Data_Filter::EQUALS, 'S');
    try {
        $request->sendNow();
        $grid = $request->getGrid();
        $recordset = $grid->getRecordset();
    } catch (Exception $e) {
      return false;
    }

    foreach($recordset as $rec) {
      $transaction = new Pap_Api_Transaction($session);
      $transaction->setTransid($rec->get('transid'));
      try {
          if(!$transaction->load()) {
           return false;
          } else {
             if ($transaction->getStatus() != 'D') {
              $newStatus = '';
              switch($this->get('OrderStatus')) {
                case scOrderStatus::ORDER_STATUS_UNFINISHED:
                  case scOrderStatus::ORDER_STATUS_PAYMENT_PENDING:
                  case scOrderStatus::ORDER_STATUS_NEW:
                  case scOrderStatus::ORDER_STATUS_IN_PROGRESS:
                  case scOrderStatus::ORDER_STATUS_ON_HOLD:
                  case scOrderStatus::ORDER_STATUS_QUEUED:
                    $newStatus = 'P';
                    break;
                  case scOrderStatus::ORDER_STATUS_RETURNED:
                case scOrderStatus::ORDER_STATUS_PAYMENT_FAILED:
                  case scOrderStatus::ORDER_STATUS_CANCELLED:
                    $newStatus = 'D';
                    break;
                  case scOrderStatus::ORDER_STATUS_DELIVERED:
                    $newStatus = 'A';
                    break;
                  default:
                    return false;
              }
              // changement du statut de la transaction
              if (strlen($newStatus) && $transaction->getStatus() != $newStatus) {
                $transaction->setStatus($newStatus);
                $transaction->save();
              }
           }
          }
      } catch (Exception $e) {
        return false;
      }
    }
    } catch (Exception $e) {
      return false;
    }
    return true;
}

IMPORTANT : cette méthode doit être placée avant la fin de la classe, c’est-à-dire avant le dernier } dans le fichier /include/sc/domainobj/Order.php

Le fichier PapApi.class.php peut être téléchargé depuis votre installation Post Affiliate Pro dans le menu Outils-> Intégration -> Intégration API.

Copiez-le sur votre serveur, là où votre boutique est installée, et indiquez le chemin correct à la place de <PATH_TO_PAP_API>.

IMPORTANT : Remplacez <MERCHANT_USERNAME> par votre nom d’utilisateur marchand et <MERCHANT_PASSWORD> par votre mot de passe. La requête API utilisera vos identifiants pour accéder aux transactions dans votre installation Post Affiliate Pro.

Changement du statut de la transaction

Nous devons maintenant utiliser la méthode ajoutée à la classe Order.

Ajoutez la ligne de code suivante (trouvée dans le cadre ci-dessous) dans le fichier /include/sc/domainobj/Order.php à la toute fin des méthodes updateOrderStatus et setOrderStatus.

$this->updatePostAffiliateProTransaction();

Statuts de commande personnalisés

Si vous prévoyez d’utiliser des statuts de commande personnalisés dans votre Summer Cart, vous devrez adapter la méthode updatePostAffiliateProTransaction dans votre fichier panier /include/sc/domainobj/Order.php.

Dans la fonction switch, ajoutez de nouveaux cas où la valeur sera l’ID de votre statut personnalisé.

Qu’est-ce que Summer Cart ?

Summer Cart est une solution logicielle e-commerce complète conçue pour simplifier la création et la gestion de boutiques en ligne. Elle permet aux entreprises de toutes tailles de mettre en place une présence en ligne solide en toute simplicité. Offrant une large gamme de fonctionnalités telles que la gestion du catalogue produits, le traitement des commandes, la gestion de la relation client et des outils marketing intégrés, Summer Cart constitue une plateforme tout-en-un pour les projets e-commerce, qu’ils soient débutants ou établis.

Développé par Mirchev Ideas, une société bulgare fondée par Georgi Mirchev, Summer Cart a vu le jour en 2008. Pensé pour rendre le commerce en ligne accessible et abordable pour les entreprises bulgares, il a rapidement gagné en popularité. En 2014, Summer Cart était déjà la colonne vertébrale de plus de 2 700 boutiques en ligne, démontrant sa polyvalence et la valeur apportée au secteur du e-commerce.

Summer Cart s’adresse principalement aux petites et moyennes entreprises (PME) de divers secteurs, notamment la mode, l’électronique et la maison. Son interface conviviale et ses nombreuses fonctionnalités en font un choix idéal pour les entreprises recherchant une solution intégrée. Grâce à ses designs responsives, son support multilingue et multicurrency, ainsi que ses fonctionnalités B2B avancées, Summer Cart permet aux entreprises d’élargir leur portée et d’augmenter facilement leurs ventes en ligne.

Fonctionnalités clés de Summer Cart

• Outils d’optimisation SEO : Améliorez la visibilité de votre boutique sur les moteurs de recherche pour attirer plus de clients.
• Panneau d’administration avancé : Gérez votre boutique efficacement avec plus de 1 000 fonctionnalités à portée de main.
• Design responsive et personnalisable : Créez une vitrine en ligne unique et attrayante sur tous les appareils.
• Outils de vente et de marketing avancés : Stimulez vos ventes grâce à des fonctionnalités telles que la relance des paniers abandonnés.
• Support international : Touchez une audience mondiale avec les options multilingues et multicurrency.
• Sécurité renforcée : Protégez les données de vos clients avec des fonctionnalités de sécurité avancées.

Options tarifaires de Summer Cart

Summer Cart propose des formules tarifaires flexibles pour répondre aux besoins de chaque entreprise, allant de 222 $ à 829 $ par an. Chaque niveau offre différents niveaux de fonctionnalités et de support, permettant aux entreprises de choisir une offre adaptée à leurs besoins. Pour plus de détails, consultez la page officielle des tarifs Summer Cart .

Avis des utilisateurs sur Summer Cart

Bien que les avis utilisateurs spécifiques ne soient pas accessibles ici, les retours soulignent généralement la richesse fonctionnelle de Summer Cart et son interface conviviale. Certains utilisateurs notent une courbe d’apprentissage liée à la complexité de l’outil, et le prix peut être un facteur à considérer pour certaines entreprises. Pour des témoignages détaillés, il est conseillé de consulter des plateformes d’avis spécialisées comme G2.

Vidéo de présentation de Summer Cart

• Revue approfondie du logiciel e-commerce Summer Cart

Alternatives à Summer Cart

Si vous souhaitez explorer d’autres options que Summer Cart, pensez à ces plateformes e-commerce populaires :

• BigCommerce
• Spocket
• Payhip
• Rap Booster
• Weebly Ecommerce
• WooCommerce
• PrestaShop
• OpenCart
• Wix
• Squarespace

Ces alternatives offrent une variété de fonctionnalités et de modèles tarifaires qui pourraient correspondre à vos besoins spécifiques.