É comum um cliente entrar em uma loja virtual, encher o carrinho de produtos, e abandonar em algum passo do checkout, ou antes mesmo dele. Os motivos para abandono são diversos: muitas vezes o cliente faz isso simplesmente pra deixar o sistema mesmo calcular quanto ele vai ter de gastar para comprar os produtos que ele tem em vista, por falta de tempo, por dificuldades em um checkout longo e que se extende por várias páginas, etc.

Apesar de eu achar o termo “carrinho abandonado” engraçado (sempre imagino alguém fugindo correndo de um supermercado), ao que tudo indica, o Magento lida com isso da maneira mais adequada possível. Conforme um post de Cezar Taurion (MBA em Marketing de Serviços), na revista TI Master:

“Se houver abandono, o site deve salvar o conteúdo do cesto de compras, pois nem sempre a interrupção da transação acontece por vontade do cliente. Assim, quando ele voltar, ele poderá continuar do ponto em que a operação foi interrompida. E mesmo que ele tenha desistido por vontade própria, ficará satisfeito em saber que a loja lembra dele e de sua última tentativa de compra.”

O Magento salva carrinhos abandonados, tanto para usuários logados, como para os visitantes. Para os visitantes isso é feito através de um cookie e, para os logados, tudo fica no banco de dados e é restaurado quando o usuário se loga novamente. Acontece que durante a homologação de um novo site em Magento, bem naquele momento em que o cliente (que geralmente nunca teve um e-commerce antes) está fazendo diversas compras teste para entender os métodos de pagamento e envio, entende que salvar carrinhos abandonados é um erro.

Vamos entender o procedimento do teste:

1. Cliente entra no site;
2. Cliente adiciona 2 produtos no carrinho;
3. Cliente tenta o checkout;
4. Magento grava carrinho atual no banco;
5. Cliente abandona o carrinho (desloga ou sai do site).

Cliente volta ao site:

1. Cliente entra no site;
2. Cliente adiciona 2 produtos no carrinho;
3. Cliente tenta o checkout;
4. Cliente se loga no site;
5. Magento UNE o carrinho anterior ao atual.

Assim o cliente testando seu e-commerce pensa: “Opa, peraí…”. Nesse ponto 5 o cliente passa a ter 4 produtos no carrinho! Ele pensa que o seus futuros clientes da loja vão se confundir, e talvez a quantidade de reembolsos por compras erradas possam ser significativos… E o Magento realmente não avisa que salva o carrinho, nem avisa que restaura e une os carrinhos. Muito dificilmente uma pessoa tem como primeira atitute ao entrar no site se logar, o que faria com que ela percebesse o crescimento do número de itens no carrinho.

Solução 1: Fazer o Magento mostrar uma mensagem quando carrinhos são unidos. Você precisará alterar 3 arquivos:

1. Em app/code/core/Mage/Checkout/Model/Session.php altere o método loadCustomerQuote() para este:

    public function loadCustomerQuote()
    {
    	// reseta controle
    	Mage::getSingleton("core/session")->setIsLoadedCart("0");

        $customerQuote = Mage::getModel('sales/quote')
            ->setStoreId(Mage::app()->getStore()->getId())
            ->loadByCustomer(Mage::getSingleton('customer/session')->getCustomerId());

        if ($this->getQuoteId() != $customerQuote->getId()) {
            if ($this->getQuoteId()) {
                $customerQuote->merge($this->getQuote())
                    ->collectTotals()
                    ->save();

                //carrinho unido
                Mage::getSingleton("core/session")->setIsLoadedCart("1");
            }

            $this->setQuoteId($customerQuote->getId());

            if ($this->_quote) {
                $this->_quote->delete();
            }
            $this->_quote = $customerQuote;
        }
        return $this;
    }

2. Em app/code/core/Mage/Checkout/Model/Observer.php altere o método loadCustomerQuote() para este:

    public function loadCustomerQuote()
    {
   	    try {
            Mage::getSingleton('checkout/session')->loadCustomerQuote();
        }
        catch (Mage_Core_Exception $e) {
            Mage::getSingleton('checkout/session')->addError($e->getMessage());
            return;
        }
        catch (Exception $e) {
            Mage::getSingleton('checkout/session')->addException(
                $e,
                Mage::helper('checkout')->__('Load customer quote error')
            );
            return;
        }

        //adiciona a mensagem
        if (Mage::getSingleton("core/session")->getIsLoadedCart() == "1")
        {
			Mage::getSingleton('customer/session')->addNotice(
				Mage::helper('checkout')->__("Você já havia adicionado produtos ao carrinho em outra visita ao site e nós os restauramos para você. Por favor, revise seu carrinho antes de finalizar o pedido. Obrigado!")
			);
        }
    }

Isso fará com que a mensagem apareça nas telas gerais do sistema:


3. E em app/design/frontend/default/default/template/checkout/onepage/billing.phtml adicione o seguinte trecho de código, antes de tudo:

<div target="_blank" id="messages_product_view">
<?php
	if (Mage::getSingleton("core/session")->getIsLoadedCart() == "1" && $this->isCustomerLoggedIn())
	{
		$nome = Mage::getSingleton('customer/session')->getCustomer()->getName();

		Mage::getSingleton("core/session")->setIsLoadedCart("0");
		Mage::getSingleton('customer/session')->addNotice(
			Mage::helper('checkout')->__("Bem vindo, $nome. Você já havia adicionado produtos ao carrinho em outra visita ao site e nós os restauramos para você. Por favor, revise seu carrinho antes de finalizar o pedido. Obrigado!")
		);
		$this->getMessagesBlock()->setMessages(Mage::getSingleton('customer/session')->getMessages(true));
		echo $this->getMessagesBlock()->getGroupedHtml();
	}
?>
</div>

Esse é o passo mais importante, fará com que a mensagem apareça especificadamente quando os carrinhos são unidos já no processo de checkout, o que realmente pode ser confuso:

Mais defesas para salvar os carrinhos:
- É incomum o cliente de verdade do site ficar enchendo o carrinho diversas vezes, como em um procedimento de teste.
- O cliente sempre revê o que vai comprar, antes de fazer a compra, e dificilmente comprará por acidente. Quando estamos fazendo testes, passamos batido por essa parte clicando em “Finalizar Compra”.

Solução 2: Quero desativar o salvamento de carrinhos mesmo assim!

• Para usuários visitantes: Basta ir em Sistema->Configuração->Web e colocar o Tempo-de-vida do cookie (Cookie Lifetime) para 0. Isso vai fazer com que, assim que o usuário fechar a janela do browser, todos os dados sejam perdidos. Isso força também uma limpeza do carrinho.
• Para usuários logados: É aqui que o bicho pega. A princípio vamos em Sistema->Configuração->Finalizar Compra->Carrinho de Compras->”Validade da cotação (dias)”. Ali, colocando o valor “0″, teoricamente o carrinho não deveria ser salvo… Mas não é o que ocorre. Ainda não testei se até amanhã o carrinho vai se esvaziar (o que já seria errado pois de hoje até amanhã se passa 1 dia, e 0 é menor que 1), mas tudo bem. Ou na marra: vá até o arquivo app/code/core/Mage/Checkout/etc/config.xml e remova o seguinte trecho de código:

            <customer_login>
                <observers>
                    <loadCustomerQuote>
                        <type>singleton</type>
                        <class>checkout/observer</class>
                        <method>loadCustomerQuote</method>
                    </loadCustomerQuote>
                </observers>
            </customer_login>

Note que, assim, carrinhos anteriores nunca são submetidos a operação de união com um carrinho novo, porém, caso não haja nada no carrinho, alguns produtos da última quote acabam sim voltando.

Mais informações:

• http://imasters.uol.com.br/artigo/15001/ecommerce/o_primeiro_passo_para_ganhar_dinheiro_com_e-commerce_conhecer_o_seu_consumidor_online/
• http://www.timaster.com.br/revista/artigos/main_artigo.asp?codigo=371&pag=1
• Os códigos deste post foram testados na versão 1.3.2.4.
• Não altere arquivos do core, crie módulos.

Abraço!

Já vamos começar este post (agora heterodoxo) com 1 link de referência: http://www.magentocommerce.com/wiki/custom_account/registration_fields. Neste link temos toda a informação necessária para se criar um campo adicional na hora do cadastro do cliente pelo frontend, sendo que todos que seguem este artigo acabam conseguindo adicionar os campos com sucesso, portanto não vou descrever os passos que já estão ali.

O problema: em geral, para a criação de um novo campo no cadastro do usuário, este tutorial sempre foi o suficiente, mas quando tenta-se lidar pelo backend (admin) com estes campos criados surge um problema que exige uma mini-explicação superficial do fluxo de informações do cadastro no Magento. Vamos supor que criamos o campo “CPF”:

Fluxo de informações de dados do cliente no Magento.

Ao ver esta imagem concluímos algo: se os dados do cliente são copiados da tabela customer pra tabela sales isso significa que, ao visualizarmos os dados desta compra, sempre veremos os dados que o cliente tinha na época da compra. Isso é vantajoso: se ele trocou de endereço 1 ano depois dessa compra, podemos saber o endereço que ele tinha na época; se ele resolver entregar seu cadastro para outra pessoa, trocando os dados, continuaremos com todos os dados que ele utilizou nas compras anteriores.

O fluxo de informações fica então assim: Na tabela eav_attribute temos o campo “cpf”. Este campo tem o entity_type_id = 1. Olhando na tabela eav_entity_type percebemos que o entity_type_id = 1 tem o entity_type_code = “customer”, ou seja, campos com este id servem para o cadastro do usuário (isso no Magento 1.3.2.4, essa relação entity_type_id/entity_type_code pode variar de versão pra versão). Beleza, isso faz com que na hora que o cliente se cadastre, o campo CPF seja gravado no banco. Mas na hora da compra, isso não faz com que o campo seja gravado junto da compra, como no fluxo acima. Esse segundo passo (o “addendum” a que me refiro nesse post) é feito da seguinte forma:

Passo 1: Vá até a tabela eav_entity_type no banco e ache o entity_type_id aonde o entity_type_code = “order”. No meu caso o valor é 11.

Passo 2: Rode o seguinte código apenas uma vez (colocando no index.php):

$idOrder = '11';
$installer = new Mage_Eav_Model_Entity_Setup('core_setup');
$installer->addAttribute($idOrder, 'customer_cpf', $attrList);

Pronto. Você tem o campo (eav_entity, na verdade) que receberá os dados do cliente a cada compra na tabela sales.

Passo 3: agora, no arquivo Mage/Customer/etc/config.xml ou, idealmente, do módulo que adiciona campos ao cadastro que você estiver desenvolvendo, identifique esta tag e adicione a linha marcada:

<config>
    <global>
        <fieldsets>
           <sales_convert_quote> <!-- achar esta tag -->
                <customer_cpf><to_order>*</to_order></customer_cpf> <!-- adicionar esta linha -->
           </sales_convert_quote>
        </fieldsets>
    </global>
</config>

Isso vai fazer com que o campo “cpf” que você havia criado pro cliente seja gravado também na compra, trazendo as vantagens acima citadas. Agora, como ver esta informação na tela do pedido? O cliente se cadastrou, usou meu campo novo, os dados estão na tabela sales_* mas a cada pedido que ele faz eu tenho que voltar no cadastro dele pra verificar essa informação…

Passo 4 e final: o que podemos fazer é adicionar um pouco de código ao arquivo app/design/adminhtml/default/default/template/sales/order/view/info.phtml. Este arquivo é chamado quando estamos vendo um pedido, sua fatura, ou seu envio.

Dentro deste arquivo, dentro de um div chamado “box-right”, temos uma tabela com uma listagem de dados trazidas das tabelas sales_*. Como agora, depois das mudanças acima, nosso campo “cpf” também é gravado nesta tabela, basta adicionarmos esta linha a tabela:

                <tr>
                    <td class="label"><label><?php echo Mage::helper('sales')->__('CPF') ?></label></label></td>
                    <td>
                    <strong><?php echo $this->htmlEscape($_order->getCustomerCpf())?></strong>
                    </td>
                </tr>

Resultado:


Claro que o ideal é sempre fazer um módulo a parte e nunca sobrescrever arquivos do sistema. OFF-TOPIC: O uso do termo “addendum” fica pra quem é familiarizado com o Zeitgeist.

Abraço, espero ter ajudado.

O fato deste módulo necessitar do CPF do comprador nos fez adaptar o Magento a realidade brasileira sem perder a compatibilidade para vendas internacionais. Um dos famosos “work-arounds” da comunidade brasileira para este cenário aonde o CPF é necessário era o de forçar a tradução do campo “TAX/VAT”, o que é longe de ser o recomendado. O módulo, porém, funciona em ambas as situações.

Este módulo permite, já na tela do pedido, ter informações sobre o nível de segurança da transação, ou seja, nenhum click além do procedimento normal é necessário para um resumo das informações vindas do MClearSale. Para um detalhamento maior (compras anteriores, consulta completa do cpf, possibilidade de consulta por um analista, entre outras funcionalidades) basta um click e você já é levado para o ambiente da MClearSale.







Para maiores informações de como o MClearSale funciona vá para http://loja.clearsale.com.br/ComoFunciona.aspx.

Abraço!

O Magento tem algumas funções que te ajudam a se localizar em desafios deste tipo, a maioria criadas estaticamente dentro da classe Mage, estando assim disponíveis em qualquer arquivo dentro do Magento sem a necessidade de se instanciar um objeto para tal. Aqui vão algumas:

echo "<BR />".Mage::getBaseUrl();
// http://www.meusitemagento.com/ - O mesmo que passando URL_TYPE_LINK

echo "<BR />".Mage::getBaseUrl(Mage_Core_Model_Store::URL_TYPE_WEB);
// http://www.meusitemagento.com/ - A url (porção com o nome do servidor) atualmente sendo utilizada para acessar o Magento (leva em conta se está usando https)

echo "<BR />".Mage::getBaseUrl(Mage_Core_Model_Store::URL_TYPE_LINK);
// http://www.meusitemagento.com/ - A url base do Magento (não leva em conta se está usando https)

echo "<BR />".Mage::getBaseUrl(Mage_Core_Model_Store::URL_TYPE_MEDIA);
// http://www.meusitemagento.com/media - A url da pasta "media"

echo "<BR />".Mage::getBaseUrl(Mage_Core_Model_Store::URL_TYPE_SKIN);
// http://www.meusitemagento.com/skin - A url da pasta "skin"

echo "<BR />".Mage::getBaseUrl(Mage_Core_Model_Store::URL_TYPE_JS);
// http://www.meusitemagento.com/js - A url da pasta "js"

echo "<BR />".Mage::getBaseUrl(Mage_Core_Model_Store::URL_TYPE_DIRECT_LINK);
// http://www.meusitemagento.com/ - A url base do Magento sem levar em conta a Loja atual

echo "<BR />".Mage::getRoot();
// /home/domains/meusitemagento.com/public_html/app - O caminho físico da pasta "app" da instalação atual do Magento

Note que a função Mage::getBaseUrl() retorna por padrão o mesmo que retornaria se passássemos Mage_Core_Model_Store::URL_TYPE_LINK como parâmetro, que é a URL base http, independente se no momento o site estiver em modo seguro (https) ou inseguro (http).

Dicas:

• Um jeito rápido de descobrir qual o seu diretório de trabalho no servidor (um nível acima da pasta app do seu magento):

echo "<BR />".substr(Mage::getRoot(),0,strlen(Mage::getRoot())-4);
// /home/domains/meusitemagento.com/public_html/

• Para descobrir URLs e subdiretórios:

echo "<BR />".Mage::getUrl('');
// http://www.meusitemagento.com/ - A url do seu site

echo "<BR />".Mage::getUrl('customer/account');
// http://www.meusitemagento.com/customer/account/ - A url para o painel da conta do usuário

echo "<BR />".Mage::getUrl('', array('_secure'=>true));
// https://www.meusitemagentoseguro.com/ - Força a recuperação da URL configurada para ser utilizada quando em modo seguro (HTTPS)

A função Mage::getUrl() aceita um segundo parâmetro, que, como no último exemplo acima, é um array. Este array contém nas chaves uma ou mais das opções que desejarmos passar, e, em cada parâmetro, o valor pode ser false ou true. Sendo assim, além de “_secure” podemos ter:

1. _current : A URL atual
2. _use_rewrite : Força o uso de URL rewrite
3. _nosid : URL sem o ID da sessão do PHP (o SID sempre é passado quando se muda da url insegura para a url segura e vice-versa, ou em qualquer mudança de url aonde a sessão seria perdida caso o SID não fosse passado)
4. … Entre outros parâmteros encontrados em app/code/core/Mage/Core/Model/Url.php

• Descobrir facilmente arquivos da pasta “skin”:

echo "<BR />".$this->getSkinUrl();
// http://www.meusitemagento.com/skin/frontend/MEU-PACKAGE/MEU-TEMA/

echo "<BR />".$this->getSkinUrl("images/icon_rss.gif");
// http://www.meusitemagento.com/skin/frontend/MEU-PACKAGE/MEU-TEMA/images/icon_rss.gif - O Magento tenta achar esta imagem dentro do tema configurado, caso ele não ache ele tenta dentro de http://www.meusitemagento.com/skin/frontend/default/default, nesta ordem.

• Dentro do arquivo app/code/core/Mage/Core/Model/Url.php existe no cabeçalho um esquema (praticamente em ASCII-art, hehe) explicando a nomenclatura que o Magento usa para cada porção da estrutura de uma URL.

Abraço!

foreach( Mage::getSingleton('checkout/session')->getQuote()->getItemsCollection() as $item )
{
   if ($item->getStore()->getCode() != Mage::app()->getWebsite()->getCode())
   {
      Mage::getSingleton('checkout/cart')->removeItem( $item->getId() )->save();
   }
}

Eu acabei colocando esta função no arquivo app/code/core/Mage/Customer/Model/Session.php, dentro da função login. Pra mim isto foi o ideal, pois o meu maior problema era o de usuários antigos que vinham com produtos de outra loja no momento do login. Este código também pode ser colocado no app/design/frontend/default/SEUTEMA/template/page/html/header.phtml, por exemplo, que é carregado em toda página, fazendo essa limpeza a todo momento (e deixando o core intacto).

IMPORTANTE: Ele também pode ser usado sem o if que faz a verificação da loja, para limpar todos os produtos do carrinho.

Caso sua limpeza tenha de ser completa, e envolve toda a sessão do carrinho (métodos de envio, métodos de pagamento…), o código abaixo seria bem útil:

Mage::getSingleton('checkout/session')->clear();

Abraço!

* Por favor, façam download no Connect: Extensão Pagamento Digital para Magento.

Maiores informações no post no blog do Gabriel.

Caso você ache a extensão útil e queira nos ajudar a manter as atualizações, por favor crie agora a sua conta no Pagamento Digital pelo nosso link de parceiro: http://www.pagamentodigital.com.br/parceiros/indexa .

Aguardamos o feedback da comunidade!
Abraços e boas vendas!

Esta semana tive o seguinte desafio: customização do ambiente administrador (ou “admin”, ou “backend”) do Magento. Em uma primeira vista, tem-se a impressão de que o backend do Magento (cheio de campos obrigatórios as vezes não tão necessários, ou vazio de informações instrucionais para funcionalidades importantes, como preferir) não foi feito pra ser tão facilmente customizado como o frontend, principalmente pela falta da IMPORTANTE opção de se ligar os “Template Hints”, ou “Dicas de caminho de modelo”. O primeiro passo para se alterar alguma parte do layout/design do backend do Magento é descobrir em que arquivo cada parte está, porém sem a possibilidade das “template hints” a coisa complica um pouco mais.

* Esta opção fica dentro de Sistema->Configuração->Desenvolvedor. Alterando-se o Escopo para o website atual, tem-se opções para ligar as “Dicas de caminho de modelo”, porém isso só funciona para o frontend.

Eu recomendo que, antes de tudo, o cache do Magento seja desligado e devidamente limpo. Continuando, primeiro faça um backup dos arquivos do tema “default”. O método que utilizei é meio agressivo e pode danificar os arquivos do template. Enfim, para se conseguir um efeito parecido no backend, tive a seguinte abordagem (Magento 1.3.2.2):

1. Encontre um editor que faça substituição de texto em massa. Eu utilizei o já descontinuado, porém muito bom, Macromedia Homesite. Nele temos a opção “Extended Replace” que fará o trabalho.
2. Todos os arquivos do template default do backend (ao menos não encontrei um que não tenha até agora) tem um comentário logo no início, sobre a licença e etc., será esse texto que tuilizaremos como base da nossa mudança.
3. Você irá procurar por:

   <?php
   /**
   * Magento
   *
   * NOTICE OF LICENSE
   

   Em todos os arquivos (incluindo subdiretórios) do diretório /app/design/adminhtml/default/default/template/ e substituirá por:

   <?php
   
   echo "<div style='border: 1px solid red;'>".__FILE__."</div>";
   
   ?><?php
   /**
    * Magento
    *
    * NOTICE OF LICENSE
   

4. Se tudo der +ou- certo, você verá uma tela assim:
5. Devolta ao admin, temos o seguinte resultado:

Pronto, seu admin já tem todas as dicas necessárias para se começar a descobrir onde e o que alterar. Dicas:

• Se você colocar um if antes do echo, você pode controlar a impressão ou não das hints com uma simples variável de controle. Esta variável pode, por exemplo, estar dentro de index.php.
• Caso não queira inserir este “echo” dentro dos arquivos do template que terá seu layout modificado, trabalhe com 2 instalações ou 2 temas diferentes para o admin. No meu caso, eu trabalhei com uma instalação local diferente da que seria modificada. Assim você pode ter um tema ligado só para descobrir caminhos.

Edit: Acabei descobrindo um outro jeito muito bom neste link: http://classyllama.com/magento/development/enable-templateblock-hints-in-admin-panel/. Em resumo seria:
1) Conecte-se ao banco;
2) Execute esta query:

INSERT INTO core_config_data (scope, scope_id, path, value)
VALUES ('default', 0, 'dev/debug/template_hints', 1),
('default', 0, 'dev/debug/template_hints_blocks', 1);

Feito! Para desligar os hints abra a tabela core_config_data table e mude a coluna “value” da linha que você adicionou para o valor “0″.

T+!

Possuindo uma solução integrada pra lidar com esse problema, o Magento quase faz isso tudo passar despercebido, mas ela não trata todas as possibilidades como, por exemplo, alguns tipos de PNGs como background. Para resolver isso, instalei nele uma famosa correção que circula na web, o IEPNGFIX (já muito bem rankeado no google, diga-se de passagem). Seguem os passos de como fiz para instalá-lo no Magento:

• Ente em http://www.twinhelix.com/css/iepngfix/ e baixe a última versão da correção. No momento é a 2.0 alpha 3, que você pode obter clicando em “teste area”.
• Faça upload dos arquivos blank.gif, iepngfix.htc e iepngfix_tilebg.js (contidos no zip da correção) para o diretorio skin do seu template, algo como http://meumagento.com.br/skin/frontend/default/meutema.
• Abra o arquivo app/design/frontend/default/meutema/template/page/html/head.phtml – Transforme a tag script de seu original:

Original:

<script>
//<![CDATA[
var BLANK_URL = '<?php echo $this->helper('core/js')->getJsUrl('blank.html') ?>';
var BLANK_IMG = '<?php echo $this->helper('core/js')->getJsUrl('spacer.gif') ?>';
//]]>
</script>

Para:

<script>
//<![CDATA[
var BLANK_URL = '<?php echo $this->helper('core/js')->getJsUrl('blank.html') ?>';
var BASE_SKIN = '<?php echo $this->getSkinUrl('blank.gif') ?>';
//]]>
</script>

• No final desse mesmo arquivo, adicione as seguintes linhas:

<style type="text/css">
img, div, a, input { behavior: url(<?php echo $this->getSkinUrl('iepngfix.htc') ?>) }
</style>
<script type="text/javascript" src="<?php echo $this->getSkinUrl('iepngfix_tilebg.js') ?>"></script>

• Abra o arquivo iepngfix.htc e altere o caminho da imagem em branco para:

// This must be a path to a blank image, relative to the HTML document(s).
// In production use I suggest '/images/blank.gif' or similar. That's all!
IEPNGFix.blankImg = BASE_SKIN;

• Limpe todos os caches possíveis e dê um reload.

Lembre-se:

• Coloque width e height em todos os PNGs que existirem no seu site.
• Caso a correção comece a dar alerts dizendo que existem “unclickable links”, simplesmente comente a única linha que contém a palavra “alert” também no arquivo iepngfix.htc. Aparentemente, apesar de parar de incomodar o usuário, tudo continua funcionando como deveria.
• Quando puder, use GIF! É menos chance de dar algum problema…

Obrigado e até a próxima!

“País”,”Estado”,”CEP”,”Peso (e acima)”,”Valor do frete”
“BR”,”RJ”,”*”,”0.25″,”11.71″
“BR”,”RJ”,”*”,”0.5″,”12.39″
“BR”,”RJ”,”*”,”0.75″,”13.07″
…

Sendo assim, para qualquer CEP do estado RJ com produtos pesando até 250 gramas o preço de envio fica R$ 11,71,  de 251 gramas até 500 gramas custa R$ 12,39, e assim por diante, com uma regra pra cada estado. Porém, como problemática típica, pra cada estado existem 2 valores: um para capital, e outro para interior. Nesse caso, apesar de existirem extensões para tabelas múltiplas, como nos links a seguir:

http://www.magentocommerce.com/extension/306/pickup-at-event–multiple-flatrates
http://www.magentocommerce.com/extension/1357/product-matrix-shipping
http://www.magentocommerce.com/extension/728/multiple-tablerates

…acabei optando por cadastrar Regions diferentes (como “São Paulo – Interior” e “São Paulo – Capital”), o que agradou mais esse cliente em específico, por já facilitar a diferenciação da taxa a ser utilizada através de uma simples olhada no endereço do cliente.

Refiz então o CSV para essa nova situação, usando siglas como “RJI” para o interior do “Rio de Janeiro – Interior” e “RJC” para “Rio de Janeiro – Capital”, modificando isso tudo lá nas tabelas de Regions do MySQL do Magento… Mas, ao fazer o upload do CSV pela tela de configuração (ver imagem mais abaixo no post) um erro de “undefined index” me foi mostrado. Não sei se há um jeito melhor de resolver isso, porque todos os índices estavam corretos e etc, mas tive de fazer a seguinte alteração no core pro arquivo conseguir ser processado corretamente. Me pareceu um pequeno bugfix:

/www/app/code/core/Mage/Shipping/Model/Mysql4/Carrier/Tablerate.php

Certo, na linha 202 adicionei aquele if checando se o índice existe antes de indexá-lo e tudo pareceu correr bem a partir de então… Fiz mais 2 mudanças no core para o Tablerate funcionar corretamente pro meu caso:

/www/app/code/core/Mage/Shipping/Model/Mysql4/Carrier/Tablerate.php

As condições dessa query são bem importantes pra definir como o Magento traz os resultados da Tablerate e o relaciona com os produtos e o peso. No print acima está como as minhas condições acabaram ficando. Na próxima e última alteração, fiz com que a listagem de estados lá do frontend viesse em ordem alfabética. Para isso, criei uma função que ordena o array das regiões do Brasil, sem modificar seus índices:

/www/app/code/Mage/Directory/Helper/Data.php

Bom, partindo para a configuração final, logo abaixo segue a tela com as opções que selecionei lá nas configurações do admin e que deixou tudo funcionando no checkout… Pra chegar até esta tela clique em Sistema->Configurações e selecione Taxas de Tabela, e lembre-se de selecionar o website pra essas opções aparecerem!

E agora um print do resultado dessa brincadeira no frontend:

Valeu pessoal, espero ajudar aí e até a próxima!

O Magento não foge dessa regra e acaba contando com diversos colaboradores para sua tradução para o português. Meu co-worker aqui (ou “koleg labor”, em uma tentativa de esperanto) Gabriel Zamprogna ajudou bastante nesse sentido, sendo atualmente um dos moderadores da tradução do Magento para o nosso querido pt-BR. E, sem enrolar mais, aqui vai a minha pequena contribuição: clique aqui e baixe os botões do tema Modern do Magento traduzidos para português. Junto no pacote ainda vai o template em PSD para criação de novos botões!

E, bom, apesar da etimologia, acredito que não seja necessário traduzir o botão “OK”, não é? Obrigado, bom download, e até a próxima!