Interspire Shopping Cart (especialmente para o Google Checkout)

Um software de carrinho de compras rico em recursos que inclui tudo o que você precisa para iniciar, executar e promover sua loja online.

Este método de integração irá ajudá-lo a integrar o Post Affiliate Pro com o Interspire Shopping Cart 6.0+ caso os clientes não sejam devolvidos na página de agradecimento do Interspire após o pagamento com o Google Checkout.

Para que serve este roteiro?

Esta configuração foi criada para rastrear produtos encomendados no InterspireShopping Cart e pagos com o Google Checkout. O que esse script faz é postar cada produto diferente encomendado como uma venda separada no PAP4 ou no carrinho inteiro como uma venda única. Para rastreamento de venda, o rastreamento da API do PAP é usado.

Adicionando o campo visitorId no modelo ProductAddToCart

Editar arquivo /templates/__master/Snippets/ProductAddToCart.html (se você o alterou no próprio modelo, está no diretório: /templates/[modelo usado]/Snippets/)

Adicione esta linha no formulário:

<input value="" name="product-private-data" type="hidden" id="pap_dx8vc2s5">

após a linha:

<input type="hidden" name="currency_id" value="" />

e após o final da tag de formulário “” adicione:

<script id="pap_x2s6df8d" src="https://URL_TO_PostAffiliatePro/scripts/notifysale.php" type="text/javascript">
</script>

O código abaixo mostra todo o arquivo ProductAddToCart.html após as alterações:

%%GLOBAL_AddToCartButtonControlScript%%
<form method="post" action="%%GLOBAL_CartLink%%" onsubmit="return check_add_to_cart(this, %%GLOBAL_ProductOptionRequired%%)"  enctype="multipart/form-data">
	<input type="hidden" name="action" value="add" />
	<input type="hidden" name="product_id" value="%%GLOBAL_ProductId%%" />
	<input type="hidden" name="variation_id" class="CartVariationId" value="" />
	<input type="hidden" name="currency_id" value="" />
	<input value="" name="product-private-data" type="hidden" id="pap_dx8vc2s5">
	<div class="ProductDetailsGrid ProductAddToCart">
		%%SNIPPET_ProductFieldsList%%
		<div class="ProductOptionList">
			%%SNIPPET_VariationList%%
		</div>
		%%SNIPPET_EventDate%%
		<div class="DetailRow" style="display: %%GLOBAL_DisplayAdd%%">
			<div class="Label QuantityInput" style="display: %%GLOBAL_DisplayAddQty%%">%%LNG_QuantityFull%%:</div>
			<div class="Value AddCartButton">
				<span class="FloatLeft" style="display: %%GLOBAL_DisplayAddQty%%;">
					%%GLOBAL_AddToCartQty%%
				</span>
				<div class="BulkDiscount">
					%%GLOBAL_AddToCartButtonOptimizerScriptTag%%
						<input type="image" src="%%GLOBAL_IMG_PATH%%/%%GLOBAL_SiteColor%%/AddCartButton.gif" alt="Interspire Shopping Cart (especialmente para o Google Checkout)"/>
					%%GLOBAL_AddToCartButtonOptimizerNoScriptTag%%
					<div class="BulkDiscountLink" style="display: %%GLOBAL_HideBulkDiscountLink%%;">
						<a href="#" onclick="$.iModal({data: $('#ProductDetailsBulkDiscountThickBox').html(), width: 600}); return false;">
							%%LNG_BulkDiscountLink%%
						</a>
					</div>
				</div>
			</div>
		</div>
	</div>
</form>

<script id="pap_x2s6df8d" src="https://URL_TO_PostAffiliatePro/scripts/notifysale.php" type="text/javascript">
</script>

<div class="OutOfStockMessage">
	%%SNIPPET_SideAddItemSoldOut%%
</div>

%%GLOBAL_ProductBulkDiscountThickBox%%

<script type="text/javascript">
lang.OptionMessage = "%%GLOBAL_OptionMessage%%";
lang.VariationSoldOutMessage = "%%LNG_VariationSoldOutMessage%%";
lang.InvalidQuantity = "%%LNG_InvalidQuantity%%";
lang.EnterRequiredField = "%%LNG_EnterRequiredField%%";
lang.InvalidFileTypeJS = "%%LNG_InvalidFileTypeJS%%";
var ShowAddToCartQtyBox = "%%GLOBAL_ShowAddToCartQtyBox%%";
</script>
%%GLOBAL_EventDateJavascript%%

Adicionando o parâmetro visitorId nos links de Adicionar ao Carrinho

Edite todos os arquivos de modelo onde é usado o link adicionar ao carrinho. Adicione o atributo id=”affCookieLinkId” na tag <a> em <div class=”ProductActionAdd”>.

E no código de rastreamento de cliques, adicione:

PostAffTracker.writeCookieToLink('affCookieLinkId', 'product-private-data');

depois da linha:

PostAffTracker.track();

O código abaixo mostra este após as alterações:

<div class="ProductActionAdd" style="display:%%GLOBAL_HideActionAdd%%;">
		<a href="%%GLOBAL_ProductURL%%" id="affCookieLinkId">%%GLOBAL_ProductAddText%%</a>
</div>

Lista de arquivos, que você precisa editar no diretório /templates/__master/Snippets/:

• BrandProductsItem.html
• CategoryProductsItem.html
• HomeFeaturedProductsItem.html
• HomeNewProductsItem.html
• HomeSaleProductsItem.html
• ProductVendorsOtherProductsItem.html
• SearchResultProductGrid.html
• SideCategoryNewProducts.html
• SideCategoryPopularProducts.html
• SideCategoryTopSellers.html
• SideNewProducts.html
• SideRecentlyViewedProducts.html
• SideTopSellers.html
• SideTopSellersFirst.html
• TagProductsItem.html
• VendorFeaturedItemsItem.html
• VendorProductsItem.html

Edit file class.cart.api.php

Edite o arquivo /includes/classes/class.cart.api.php.

Encontrar linha:

public function AddItem

e adicione no final dos parâmetros o novo parâmetro $productPrivateData=null.

Será parecido com:

public function AddItem($productId, $quantity=1, $variationDetails=null, $configurableOptions=array(), $cartItemId=null, $options=array(), $parentId=null, $reorder=false, $productPrivateData=null)

Em seguida, encontre a matriz cartProduct (linha 1319):

    $cartProduct = array(
            'product_id' => $productId,
            'variation_id' => $variation,
            'options' => $variationOptions,
            'quantity' => $quantity,
            'product_name' => $product['prodname'],
            'product_code' => $productCode,
            'product_price' => $productPrice,
            'original_price' => $originalPrice,
            'default_currency' => $defaultCurrency['currencyid'],
            'customer_group' => $customerGroup,
        );

adicione lá:

product_private_data' => $productPrivateData

ficará parecido com isso:

$cartProduct = array(
            'product_id' => $productId,
            'variation_id' => $variation,
            'options' => $variationOptions,
            'quantity' => $quantity,
            'product_name' => $product['prodname'],
            'product_code' => $productCode,
            'product_price' => $productPrice,
            'original_price' => $originalPrice,
            'default_currency' => $defaultCurrency['currencyid'],
            'customer_group' => $customerGroup,
            'product_private_data' => $productPrivateData
        );

Edite o arquivo class.cart.php

Edite o arquivo /includes/classes/class.cart.php.

Encontrar linha:

$cartItemId = $this->api->AddItem($product_id, $qty, $variation, $configurableFields, null, $options, null, false);

altere como:

$cartItemId = $this->api->AddItem($product_id, $qty, $variation, $configurableFields, null, $options, null, false, $productPrivateData);

E adicione isso antes dela:

  $productPrivateData = '';
            if(isset($_REQUEST['product-private-data'])) {
                $productPrivateData = $_REQUEST['product-private-data'];
            }

Vai parecer assim depois das mudanças:

                        ...
                        ...
				$options['EventName'] = $eventName;
			}

			$productPrivateData = '';
			if(isset($_REQUEST['product-private-data'])) {
				$productPrivateData = $_REQUEST['product-private-data'];
			}

			// Actually add the product to the cart
			$cartItemId = $this->api->AddItem($product_id, $qty, $variation, $configurableFields, null, $options, null, false, $productPrivateData);
			$this->newCartItem = $cartItemId;

			if($cartItemId === false) {
                        ...
                        ...

Adicione o código de acompanhamento de vendas no arquivo class.handler.php no método googlecheckout

Edite o arquivo /modules/checkout/googlecheckout/class.handler.php.

Encontre este código na linha 925:

	if (!$completed) {
			$GLOBALS['ISC_CLASS_LOG']->LogSystemError($this->logtype, sprintf(GetLang('GoogleCheckoutCantCompleteOrder'), isc_html_escape($pendingToken), isc_html_escape(var_export($completed, true))));
			return;
		}

adicione o próximo código logo abaixo:

		include 'PapApi.class.php';
		$saleTracker = new Pap_Api_SaleTracker('URL_TO_PostAffiliatePro/scripts/sale.php');
		$prod_count = '1'; // Product Counter

		foreach($cartContent[$vendorId][0] as $cartItemId => $product) {
		    $productid = $product['data']['productid'];
		    $productPrivateData = $product['product_private_data'];

		    $price = $product['quantity'] * $product['product_price'];

		    if (strlen($productPrivateData) == 40) {
			  $accountId = substr($productPrivateData, 0, 8);
			  $visitorId = substr($productPrivateData, 8, 32);
		    } else {
			  $visitorId = $productPrivateData;
			  $accountId = 'default1';
		    }

		    $saleTracker->setAccountId($accountId);
		    $saleTracker->setCookieValue($visitorId);

		    $sale = $saleTracker->createSale();
		    $sale->setTotalCost($price);
		    $sale->setOrderID($order['orderid'] . "($prod_count)");
		    $sale->setProductID($productid);
		    $saleTracker->register();
		    $prod_count++;
		}

Este método de rastreamento está usando a API do PAP. Portanto, você precisa ter seu arquivo PapApi.class.php real no diretório /modules/checkout/googlecheckout/.

(Você pode baixá-lo em seu painel do comerciante > iniciar > ferramentas > integração > integração de API > Baixar API do PAP).