osCommerce

Integração com osCommerce

Um programa de loja online gratuito com histórico de pedidos, carrinho de compras, busca completa, avaliações de produtos, transações seguras, listas de mais vendidos e itens relacionados.

A integração com o osCommerce é feita ao inserir o script de rastreamento de vendas na página de confirmação. Para obter os valores de OrderID e TotalSale, o snippet se conecta ao banco de dados do osCommerce e recupera os valores de lá.

Como integrar o PostAffiliatePro ao osCommerce

Encontre o arquivo checkout_success.php

Localize e abra o arquivo checkout_success.php nos arquivos-fonte do osCommerce.

Encontre o local correto para integração

Dentro do arquivo, procure esta linha:

if ($global['global\_product\_notifications'] != '1') {...

Ela deve estar em algum ponto após esta linha:

<! DOCTYPE ........>

Adicione o código de integração

Insira o seguinte código logo acima dessa linha:

      //--------------------------------------------------------------------------
       // integration code
       //--------------------------------------------------------------------------
       // get order id
       $sql = "select orders_id from ".TABLE_ORDERS.
              " where customers_id='".(int)$customer_id.
              "' order by date_purchased desc limit 1";
       $pap_orders_query = tep_db_query($sql);
       $pap_orders = tep_db_fetch_array($pap_orders_query);
       $pap_order_id = $pap_orders['orders_id'];
    
       // get total amount of order
       $sql = "select value from ".TABLE_ORDERS_TOTAL.
              " where orders_id='".(int)$pap_order_id.
              "' and class='ot_subtotal'";
       $pap_orders_total_query = tep_db_query($sql);
       $pap_orders_total = tep_db_fetch_array($pap_orders_total_query);
       $pap_total_value = $pap_orders_total['value'];
    
       //get product ids
        $sql = "select products_id from " .TABLE_ORDERS_PRODUCTS.
              " where orders_id=".(int)$pap_order_id;
        $pap_orders_products_query = tep_db_query($sql);
        $pap_orders_products = '';
        while ($row = tep_db_fetch_array($pap_orders_products_query)) {
            $pap_orders_products .= $row['products_id'] . ',';
        }
        $pap_orders_products = substr($pap_orders_products, 0, -1);
    
       // draw invisible image to register sale
       if($pap_total_value != "" && $pap_order_id != "")
       {
          print '<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('$pap_total_value');
    sale.setOrderID('$pap_order_id');
    sale.setProductID('$pap_orders_products');
    
    PostAffTracker.register();
    </script>";
       }
       //--------------------------------------------------------------------------
       // END of integration code
       //--------------------------------------------------------------------------

Integração concluída

Agora está integrado. Sempre que um cliente acessar a página de confirmação do pedido, o código de rastreamento será acionado e registrará uma venda para o afiliado .

Outra integração

Se você pretende dividir produtos em mais campanhas, provavelmente precisará de outra integração, que dividirá a venda total em vendas individuais por produto.

    //--------------------------------------------------------------------------
       // integration code
       //--------------------------------------------------------------------------
       // get order id
       $sql = "select orders_id from ".TABLE_ORDERS.
              " where customers_id='".(int)$customer_id.
              "' order by date_purchased desc limit 1";
       $pap_orders_query = tep_db_query($sql);
       $pap_orders = tep_db_fetch_array($pap_orders_query);
       $pap_order_id = $pap_orders['orders_id'];
    
        //get variables for script
        $sql = "select products_id,products_price,products_quantity from " .TABLE_ORDERS_PRODUCTS.
              " where orders_id=".(int)$pap_order_id;
        $pap_products_total_query = tep_db_query($sql);
        $k = 0;
        while ($row = tep_db_fetch_array($pap_products_total_query)) {
            $pap_products_total[$k+1] = $row['products_price'] * $row['products_quantity'];
            $pap_products[$k+1] = $row['products_id'];
            $k++;
        }
    
        // draw invisible image to register sale
        if($pap_order_id != "")
        {
    
        ?>
        <script id="pap_x2s6df8d" src="https://URL_TO_PostAffiliatePro/scripts/trackjs.js" type="text/javascript"></script>
        <script type="text/javascript">
     PostAffTracker.setAccountId('Account_ID');    <?php
         for ($j=1; $j<=$k; $j++){
          echo "var sale".$j." = PostAffTracker.createSale();\n".
               "sale".$j.".setTotalCost('". $pap_products_total[$j]."');\n".
               "sale".$j.".setOrderID('".$pap_order_id."');\n".
               "sale".$j.".setProductID('".$pap_products[$j]."');\n\n";
         }
        ?>
        
        PostAffTracker.register();
        </script>;
        <?php
        }
       //--------------------------------------------------------------------------
       // END of integration code
       //--------------------------------------------------------------------------

Integração direta com PayPal no osCommerce

Se você deseja confiar no IPN do PayPal (pois é seguro e garante que a transação será registrada), pode editar diretamente o template do botão PayPal no osCommerce. Acesse seu FTP e navegue até catalog/includes/modules/payment/ e edite o arquivo paypal_standard.php .

Encontre a função process_button e role até o final dela. Você deve encontrar este bloco de código:

    } else {
        reset($parameters);
        while (list($key, $value) = each($parameters)) {
          $process_button_string .= tep_draw_hidden_field($key, $value);
        }
     }
    
      return $process_button_string;

// ——————————————– // substitua todo esse bloco por este:

    } else {
            reset($parameters);
            while (list($key, $value) = each($parameters)) {
              if ($key == "custom") {
                $tofix = tep_draw_hidden_field($key, $value);
                $process_button_string .= substr($tofix,0,-1) .' id="pap_ab78y5t4a" >';
              }
              else {
                $process_button_string .= tep_draw_hidden_field($key, $value);
              }
            }
          }
    
          $process_button_string .= '<script type="text/javascript">';
          $process_button_string .= 'document.write(unescape("%3Cscript id=%27pap_x2s6df8d%27 src=%27" + (("https:" == document.location.protocol) ? "https://" : "http://") + "URL_TO_PostAffiliatePro/scripts/trackjs.js%27 type=%27text/javascript%27%3E%3C/script%3E"));';
          $process_button_string .= '</script><script type="text/javascript">PostAffTracker.setAccountId(\'default1\');';
          $process_button_string .= 'PostAffTracker.setAppendValuesToField(\'||\');';
          $process_button_string .= 'PostAffTracker.writeCookieToCustomField(\'pap_ab78y5t4a\');</script>';
    
          return $process_button_string;

Isso adicionará o script de rastreamento diretamente ao botão PayPal e inserirá o valor correto no parâmetro custom.

Agora, você também precisa reenviar o IPN do osCommerce para o PAP. Veja o próximo passo.

Redirecionamento do PayPal para o PAP

Quando ocorre uma venda, o PayPal envia o IPN para seu osCommerce. Você precisa reenviá-lo para o PAP para salvar a transação. Navegue até catalog/ext/modules/payment/paypal/ no seu FTP e modifique o arquivo standard_ipn.php . Insira o seguinte código no início do arquivo:

     $ch = curl_init();
     curl_setopt($ch, CURLOPT_URL, "https://URL_TO_PostAffiliatePro/plugins/PayPal/paypal.php");
     curl_setopt($ch, CURLOPT_POST, 1);
     curl_setopt($ch, CURLOPT_POSTFIELDS, $_POST);
     curl_exec($ch);

O último passo é modificar o ID do cliente salvo no campo custom, para que fique sem o ID do visitante PAP. Encontre a linha:

if ($result == 'VERIFIED') {

e adicione o seguinte código acima dela:

    $separator = '||';
        if ($_POST['custom'] != '') {
          $explodedCustomValue = explode($separator, $_POST['custom'], 2);
              if (count($explodedCustomValue) == 2) {
                $_REQUEST['custom'] = $_POST['custom'] = $explodedCustomValue[0];
                $HTTP_POST_VARS['custom'] = $explodedCustomValue[0];
          }
        }

Não se esqueça de integrar seu site com o código de rastreamento de cliques.

O que é o osCommerce?

O osCommerce é uma plataforma de eCommerce gratuita e open-source, além de uma solução de carrinho de compras desenvolvida para ajudar empresas a gerenciar e vender produtos online de forma eficiente. Fundado em março de 2000 como The Exchange Project, é construído com tecnologias PHP e MySQL. O osCommerce oferece diversos recursos, incluindo zero taxas de processamento da plataforma, otimização para mecanismos de busca (SEO), design responsivo, conformidade com GDPR e integração total com gateways de pagamento como PayPal e Stripe. Atende tanto clientes B2C quanto B2B, sendo uma escolha versátil para vários tipos de lojistas online.

O osCommerce começou como um projeto informal de Harald Ponce de Leon e evoluiu para uma solução de eCommerce amplamente utilizada, atingindo o auge da popularidade em 2009. Apesar do sucesso inicial, a plataforma sofreu um declínio devido à falta de estratégia comercial, chegando quase à obsolescência em 2020. Em 2021, o Holbi Group adquiriu o osCommerce e lançou o osCommerce 4, trazendo atualizações significativas e modernizando a plataforma para atender às demandas atuais do mercado.

O osCommerce tem como público-alvo pequenas e médias empresas, especialmente aquelas com conhecimento técnico ou acesso a suporte de desenvolvimento acessível. É ideal para empreendedores que preferem software open-source para minimizar investimentos iniciais e evitar custos recorrentes. A flexibilidade da plataforma permite a criação de lojas online altamente customizáveis, adaptando a experiência de compra às necessidades específicas do negócio sem o peso de licenças caras.

Principais Recursos do osCommerce

• Gerenciamento Avançado de Catálogo de Produtos: Organize, gerencie e exiba produtos com facilidade.
• Suporte Multilíngue e Multimoeda: Alcance um público global oferecendo múltiplos idiomas e moedas.
• Integração com Marketplaces: Conecte-se a marketplaces populares como Amazon e eBay para expandir canais de vendas.
• Biblioteca Extensa de Add-Ons: Personalize e melhore sua loja com uma ampla variedade de plugins e extensões.
• Flexibilidade Open-Source: Acesse e modifique o código-fonte para desenvolvimento personalizado.
• Solução Econômica: Gratuito para uso em hospedagem própria, com custos opcionais para hospedagem e add-ons premium.

Opções de Preço do osCommerce

Embora o osCommerce seja gratuito para baixar e usar, há custos associados a considerar. As despesas podem incluir registro de domínio, hospedagem web e eventuais extensões pagas ou serviços profissionais de suporte. Planos de hospedagem adequados para o osCommerce normalmente variam de US$ 4,99/mês a US$ 19,99/mês, dependendo do provedor de hospedagem e dos recursos necessários.

Opiniões de Usuários sobre o osCommerce

• Vantagens:
  • Desempenho rápido e eficiente devido ao design leve.
  • Alto grau de personalização graças ao seu código aberto.
  • Requisitos mínimos de hospedagem, tornando-o uma opção econômica.
• Desvantagens:
  • Requer conhecimento de programação para aproveitar e personalizar ao máximo.
  • A interface e alguns recursos podem parecer desatualizados em comparação com plataformas mais novas.

No geral, o osCommerce é mais indicado para usuários tecnicamente experientes ou empresas com acesso a recursos de desenvolvimento. Sua flexibilidade e baixo custo tornam a plataforma atraente para quem está disposto a investir tempo e esforço na personalização da loja. Porém, iniciantes ou quem não tem habilidades técnicas pode encontrar dificuldades devido à sua complexidade e abordagem prática exigida.

Avaliações do osCommerce no YouTube

Para quem deseja demonstrações visuais e opiniões, seguem alguns vídeos úteis no YouTube:

• osCommerce Review 2023 – Prós e Contras
• osCommerce Features and Installation Guide

Alternativas ao osCommerce

Se você está considerando outras opções além do osCommerce, veja algumas alternativas populares:

• WooCommerce – woocommerce.com
• Magento – magento.com
• PrestaShop – prestashop.com
• OpenCart – opencart.com
• Drupal Commerce – drupalcommerce.org
• Joomla! com VirtueMart – virtuemart.net
• Zen Cart – zencart.com
• Sylius – sylius.com
• Spree Commerce – spreecommerce.org
• Shopify – shopify.com