Summer Cart

Een eenvoudig te gebruiken PHP-winkelwagentje met alle functies.

Summer Cart heeft alle tools en functies waarmee online verkopers eenvoudig een werkende winkel van boven naar beneden kunnen bouwen. Of u nu een dozijn nichespecialiteiten verkoopt of honderden massaproducten opsomt, u krijgt een hoge zichtbaarheid en populariteit van uw bedrijf via een meesterlijk vervaardigde winkel.

Integratie van Post Affiliate Pro met Summer Cart vereist niet alleen het wijzigen van de voettekst van uw winkel (om kliktrackingcode toe te voegen), maar ook 2 winkelwagenklassen. Bekijk hieronder de details van deze integratie.

Klikintegratie

Als u dit bestand niet in uw skin hebt, kopieer het dan gewoon van de skeleton-directory naar uw thema-directory en voeg klik-trackingcode toe, die voor u is voorbereid in Post Affiliate Pro (menu Tools-> Integratie -> Kliktracking)

Voeg deze code toe vóór de

Verkoopsintegratie

Verkoopintegratie werkt in 2 stappen en integratie wordt gedaan door PAP API-verzoeken rechtstreeks vanuit de php-code van uw winkelwagen naar Post Affiliate Pro te bellen.

In de eerste stap wordt een transactie aangemaakt in Post Affiliate Pro (status In behandeling) en later, wanneer de bestelling bij uw klant wordt afgeleverd, verandert de transactie in Post Affiliate Pro de status in Goedgekeurd.

Transactiestap toevoegen

Uw winkelwagen zal op tijd een bestelling plaatsen, wanneer wordt de bezoeker doorgestuurd naar de betalingsverwerker (bijv. Paypal). Tegelijkertijd wordt een transactie aangemaakt in Post Affiliate Pro (status In behandeling)

zodat we de verkoop-trackingcode direct aan het einde van de les scOrdersInProgress kunnen plaatsen.

Om de hele bestelling als 1 transactie (commissie) in Post Affiliate Pro te volgen (zelfs als er meerdere items worden gekocht tijdens de specifieke bestelling), gebruikt u de volgende 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');

    $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();
}

Als u wilt dat elk item dat tijdens de bestelling is gekocht, wordt gevolgd als een afzonderlijke transactie (commissie) in Post Affiliate Pro, gebruik dan de volgende 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();
    }

Kopieer het naar uw server, waar uw winkel is geïnstalleerd en stel het juiste pad in op plaats van .

Transactiestap toevoegen

Voeg de volgende regel code toe aan de methode createOrder vlak voor de laatste regel

return $this->_lastOrderId;

$this->registerNewPostAffiliateProTransaction($order);

Status van transactie wijzigen

De status van bestaande transacties in Post Affiliate Pro kan worden gecontroleerd door de status in uw winkelwagen te wijzigen.

De volgende code verandert de status van de PAP-transactie in Goedgekeurd, als u uw winkelwagenbestelling instelt op de status Afgeleverd.

En het zet de PAP-transactie op de status Geweigerd, als u uw winkelwagenbestelling instelt op de status Geannuleerd, Mislukt of Geretourneerd.

    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;
                  }
                  // changing the status of a transaction
                  if (strlen($newStatus) && $transaction->getStatus() != $newStatus) {
                    $transaction->setStatus($newStatus);
                    $transaction->save();
                  }
               }
        	  }
          } catch (Exception $e) {
            return false;
          }
        }
        } catch (Exception $e) {
          return false;
        }
        return true;
    }

BELANGRIJK: vergeet niet te vervangen door het juiste pad naar het bestand PapApi.class.php. Het PapApi.class.php-bestand kan worden gedownload van uw Post Affiliate Pro-installatie in het menu Tools-> Integratie -> Api-integratie.

Kopieer het naar uw server, waar uw winkel is geïnstalleerd en stel het juiste pad in op plaats van .

Status van transactie wijzigen

Nu moeten we de methode gebruiken die we hebben toegevoegd aan de klasse Order.

$this->updatePostAffiliateProTransaction();

Aangepaste bestelstatussen

in de schakelfunctie moet u nieuwe case-statements toevoegen, waarbij de waarde de ID van uw aangepaste status is.