Webgp :: Empresa Especializada em Magento

Magento: Módulo free para Itaushopline

luciene.silva — Mon, 11 Apr 2011 10:14:49 +0000

Olá Pessoal, tudo bem??

Tenhos um módulo itaushopline que foi desenvolvido ha um bom tempo (versão 1.2 do Magento se não me engano!).
Bem, foi feita uma atualização do módulo mas precisamos de usuários que possam nos ajudar a testar.

Interessados em ajudar, por favor enviar adicionar o skype portalwebgp ou mandar um email para contato@webgp.com.br.

Futuramente serão solicitados usuários para o Bradesco Fácil tambem!

Magento: Módulo free para inclusão de CPF, RG, CNPJ e etc.

luciene.silva — Tue, 05 Apr 2011 12:32:38 +0000

Olá Pessoal,

Depois de um longo tempo sem atualizações, voltaremos com força total.

Começarei disponibilizando para a comunidade um módulo para as versões 1.4.2 e 1.5.x.

Antes, gostaria de comer sobre algumas alterações do Magento. Alterações essas relacionadas ao cadastro de clientes.

Nas versões anteriores, era bem chato incluir um campo novo no cadastro de um cliente. Não era simplesmente chegar lá no “HTML”, cinluir o campo e pronto, acabou.
Além de alterar os arquivos relacionados ao cliente, também tínhamos que alterar arquivos de checkout, criar um novo módulo para sobrescrever configurações xml.

Bem, lá nos “primórdios”, havia a necessidade alterarmos 3 módulos: Customer, Checkout e Sales. Sem contar é claro, da criação de atributos no banco que eram meio “gambiarras”.

Era dificil aceitar como uma plataforma tão bacana como o Magento fosse tão falha nesse aspecto.

Esse pequeno problema as vezes impedia que um outro módulo tivesse uma distriuição masis bacana, pois havia a dependência da crianção “chata” de campos adicionais.

Parece que ouviram finalmente as nossas preces e desde a versão 1.4.2 está super tranquilo incluir atributos customizados no cadastro de usuário.

Quem estiver apenas atrás do módulo e não quiser acompanhar o tutorial que seguirá abaixo, pode fazer o download clicando AQUI.

Este módulo vem com um “brinde”: O módulo para busca do endereço via ajax.
LEIAM o manual de instalação antes de utilizarem e qualquer problema, por favor envie seu comentário.

Vamos voltar então ao nosso tutorial…
Vou tentar usar uma linguagem menos técnica possível!

Hoje, basicamente o Magento estruturou o cadastro de cliente da seguinte maneira:

O cliente possui seus atributos básicos configurados em xml (para ser mais específica em uma tag fieldset – customer_account ).

Arquivo app/code/core/Mage/Catalog/etc/config.xml

Vocês podem verificar, que existem outros fieldsets nesse mesmo xml, como o customer dataflow.
Se vocês olharem o config.xml do Sales, também irão encontrar vários outros fieldsets.

Esse é o ponto inicial para a criação de novos atributos. Mas como sobrescrever então esses xmls??
Na verdade você não irá “sobrescrever” nada, pois ao criar um novo módulo e adicionar o fieldset customer_account, você estará apenas “incluindo”/”apendando” os itens no fieldset original, vamos assim dizer.

Partindo desse ponto, o que faz o Magento então?
Ao gerar um formulário ele verifica quais atributos do cliente devem ser utilizados naquele form ou não. Exemplo: você pode criar um atributo no cliente que deseja apenas que apareça no seu frontend, mas que quando você for cadastrar alguém no seu backend não deseja que ele sequer apareça.
Acho dificil acontecer esse tipo de situação, mas é assim que foi criada a nova estrutura.

Ou seja, não adianta criar os atributos e não dizer para o Magento onde eles irão aparecer.

Acho que de forma bem resumida, é assim que funciona.

Vamos criar o nosso módulo, para que fique mais claro.

PASSO 1) Criar a seguinte estrutura de arquivos:

+app/code/community/
+++++++++++Webgp
+++++++++++++Customer
+++++++++++++++etc
+++++++++++++++Model
+++++++++++++++sql

PASSO 2) Dentro da pasta etc vamos criar o arquivo config.xml com o seguinte conteúdo:


    
        
            2.0.0
        
    


            
                11
                11
                11
                11
                11
                11
            
        
    
   
        
            
                
                    Webgp_Customer
                    Webgp_Customer_Model_Entity_Setup
                
                
                    core_setup
                
            
            
                
                    core_write
                
            
            
                
                    core_read
                
            
        

            
                *
                *
                *
                *
                *
                *
            
            
                *
                *
                *
                *
                *
                *
            
            
                *
                *
                *
                *
                *
                *
            
            
                ***
                ***
                ***
                ***
                ***
                ***
            
            
                *
                *
                *
                *
                *
                *
            
            
                *
                *
                *
                *
                *
                *
            
            
                11
                11
                11
                11
                11
                11
            
            
                cpf
                cnpj
                ie
                rg
                razaosocial
                tipopessoa
            
             
                
                    1
                    cpf
                
                
                    1
                    cnpj
                
                
                    1
                    ie
                
                
                    1
                    razaosocial
                
                
                    1
                    rg
                
                
                    1
                    tipopessoa

Grande o arquivo certo? Bem, nele compilamos todos os fieldsets que utilizam os atributos do cliente. Interessante notar o fieldset checkout_onepage_billing. Se você deseja que seu atributo seja incluído durante o cadastro direto na página de checkout, bem, você precisa indicar ali os atributos.
Lembre-se que durante a página de cadastro simples, o magento simplesmente pega os dados do formulário e salva no banco como cliente. Mas, quando o cadastro é feito na página de checkout, estamos trabalhando com objetos do tipo Order e Quote. Dessa forma, precisamos fazer um “de -> para” entre Order/Quote e Customer.
Acho que olhando o código acima dá para ver isso facilmente.

PASSO 3)Este passo eu realmente não parei para ver se é necessário, mas por via das dúvidas é melhor fazê-lo.
Dentro da pasta Model, crie uma pasta chamada Entity e por fim um arquivo chamado Setup.php (app/code/community/Webgp/Model/Entity/Setup.php):

class Webgp_Customer_Model_Entity_Setup extends Mage_Customer_Model_Entity_Setup
{
    public function getDefaultEntities()
    {
        return array(
            'customer' => array(
                'entity_model'          =>'customer/customer',
                'table'                 => 'customer/entity',
                'increment_model'       => 'eav/entity_increment_numeric',
                'increment_per_store'   => false,
                'additional_attribute_table' => 'customer/eav_attribute',
                'entity_attribute_collection' => 'customer/attribute_collection',
                'attributes' => array(
//                    'entity_id'         => array('type'=>'static'),
//                    'entity_type_id'    => array('type'=>'static'),
//                    'attribute_set_id'  => array('type'=>'static'),
//                    'increment_id'      => array('type'=>'static'),
//                    'created_at'        => array('type'=>'static'),
//                    'updated_at'        => array('type'=>'static'),
//                    'is_active'         => array('type'=>'static'),
                  'website_id' => array(
                        'type'          => 'static',
                        'label'         => 'Associate to Website',
                        'input'         => 'select',
                        'source'        => 'customer/customer_attribute_source_website',
                        'backend'       => 'customer/customer_attribute_backend_website',
                        'sort_order'    => 10,
                    ),
                    'store_id' => array(
                        'type'          => 'static',
                        'label'         => 'Create In',
                        'input'         => 'select',
                        'source'        => 'customer/customer_attribute_source_store',
                        'backend'       => 'customer/customer_attribute_backend_store',
                        'visible'       => false,
                        'sort_order'    => 20,
                    ),
                    'created_in' => array(
                        'type'          => 'varchar',
                        'label'         => 'Created From',
                        'sort_order'    => 30,
                    ),
                    'prefix' => array(
                        'label'         => 'Prefix',
                        'required'      => false,
                        'sort_order'    => 37,
                    ),
                    'firstname' => array(
                        'label'         => 'First Name',
                        'sort_order'    => 40,
                    ),
                    'middlename' => array(
                        'label'         => 'Middle Name/Initial',
                        'required'      => false,
                        'sort_order'    => 43,
                    ),
                    'lastname' => array(
                        'label'         => 'Last Name',
                        'sort_order'    => 50,
                    ),
                    'suffix' => array(
                        'label'         => 'Suffix',
                        'required'      => false,
                        'sort_order'    => 53,
                    ),
                    'email' => array(
                        'type'          => 'static',
                        'label'         => 'Email',
                        'class'         => 'validate-email',
                        'sort_order'    => 60,
                    ),
                    'group_id' => array(
                        'type'          => 'static',
                        'input'         => 'select',
                        'label'         => 'Group',
                        'source'        => 'customer/customer_attribute_source_group',
                        'sort_order'    => 70,
                    ),
                    'dob' => array(
                        'type'          => 'datetime',
                        'input'         => 'date',
                        'backend'       => 'eav/entity_attribute_backend_datetime',
                        'required'      => false,
                        'label'         => 'Date Of Birth',
                        'sort_order'    => 80,
                    ),
                    'password_hash' => array(
                        'input'         => 'hidden',
                        'backend'       => 'customer/customer_attribute_backend_password',
                        'required'      => false,
                    ),
                    'default_billing' => array(
                        'type'          => 'int',
                        'visible'       => false,
                        'required'      => false,
                        'backend'       => 'customer/customer_attribute_backend_billing',
                    ),
                    'default_shipping' => array(
                        'type'          => 'int',
                        'visible'       => false,
                        'required'      => false,
                        'backend'       => 'customer/customer_attribute_backend_shipping',
                    ),
                    'taxvat' => array(
                        'label'         => 'Tax/VAT Number',
                        'visible'       => true,
                        'required'      => false,
                    ),
                    'confirmation' => array(
                        'label'         => 'Is Confirmed',
                        'visible'       => false,
                        'required'      => false,
                    ),
                    'created_at' => array(
                        'type'          => 'static',
                        'label'         => 'Created At',
                        'visible'       => false,
                        'required'      => false,
                        'input'         => 'date',
                    ),
                    'rg' => array(
                        'label'         => 'Rg',
                        'visible'       => true,
                        'required'      => false,
                        'sort_order'    => 70,
                    ),
                    'cpf' => array(
                        'label'         => 'Cpf',
                        'visible'       => true,
                        'required'      => false,
                        'class'         => 'validate-cpf',
                        'sort_order'    => 80,
                    ),
                    'cnpj' => array(
                        'label'         => 'Cnpj',
                        'visible'       => true,
                        'required'      => false,
                        'class'         => 'validate-cnpj',
                        'sort_order'    => 70,
                    ),
                    'ie' => array(
                        'label'         => 'ie',
                        'visible'       => false,
                        'required'      => false,
                        'sort_order'    => 80,
                    ),
                    'tipopessoa' => array(
                        'label'         => 'Tipo Pessoa',
                        'input'                => 'select',
                        'source'            => 'customer/customer_attribute_source_tipopessoa',
                        'visible'       => true,
                        'required'      => true,
                        'sort_order'    => 80,
                    ),
                    'razaosocial' => array(
                        'label'         => 'Razao Social',
                        'visible'       => true,
                        'required'      => false,
                        'sort_order'    => 80,
                    ),
                ),
            ),
            'customer_address'=>array(
                'entity_model'  =>'customer/customer_address',
                'table' => 'customer/address_entity',
                'additional_attribute_table' => 'customer/eav_attribute',
                'entity_attribute_collection' => 'customer/address_attribute_collection',
                'attributes' => array(
//                    'entity_id'         => array('type'=>'static'),
//                    'entity_type_id'    => array('type'=>'static'),
//                    'attribute_set_id'  => array('type'=>'static'),
//                    'increment_id'      => array('type'=>'static'),
//                    'parent_id'         => array('type'=>'static'),
//                    'created_at'        => array('type'=>'static'),
//                    'updated_at'        => array('type'=>'static'),
//                    'is_active'         => array('type'=>'static'),
                    'prefix' => array(
                        'label'         => 'Prefix',
                        'required'      => false,
                        'sort_order'    => 7,
                    ),
                    'firstname' => array(
                        'label'         => 'First Name',
                        'sort_order'    => 10,
                    ),
                    'middlename' => array(
                        'label'         => 'Middle Name/Initial',
                        'required'      => false,
                        'sort_order'    => 13,
                    ),
                    'lastname' => array(
                        'label'         => 'Last Name',
                        'sort_order'    => 20,
                    ),
                    'suffix' => array(
                        'label'         => 'Suffix',
                        'required'      => false,
                        'sort_order'    => 23,
                    ),
                    'company' => array(
                        'label'         => 'Company',
                        'required'      => false,
                        'sort_order'    => 30,
                    ),
                    'street' => array(
                        'type'          => 'text',
                        'backend'       => 'customer_entity/address_attribute_backend_street',
                        'input'         => 'multiline',
                        'label'         => 'Street Address',
                        'sort_order'    => 40,
                    ),
                    'city' => array(
                        'label'         => 'City',
                        'sort_order'    => 50,
                    ),
                    'country_id' => array(
                        'type'          => 'varchar',
                        'input'         => 'select',
                        'label'         => 'Country',
                        'class'         => 'countries',
                        'source'        => 'customer_entity/address_attribute_source_country',
                        'sort_order'    => 60,
                    ),
                    'region' => array(
                        'backend'       => 'customer_entity/address_attribute_backend_region',
                        'label'         => 'State/Province',
                        'class'         => 'regions',
                        'sort_order'    => 70,
                    ),
                    'region_id' => array(
                        'type'          => 'int',
                        'input'         => 'hidden',
                        'source'        => 'customer_entity/address_attribute_source_region',
                        'required'      => 'false',
                        'sort_order'    => 80,
                        'label'         => 'State/Province'
                    ),
                    'postcode' => array(
                        'label'         => 'Zip/Postal Code',
                        'sort_order'    => 90,
                    ),
                    'telephone' => array(
                        'label'         => 'Telephone',
                        'sort_order'    => 100,
                    ),
                    'fax' => array(
                        'label'         => 'Fax',
                        'required'      => false,
                        'sort_order'    => 110,
                    ),
                ),
            ),
        );
    }
}

Na verdade apenas incluímos os campos em customer.

Passo 4) Dentro da pasta sql crie um pasta chamada webgp_customer_setup. Dentro desta pasta crie um arquivo chamado mysql4-install-1.0.0.php, com o seguinte conteúdo:

startSetup();
$installer->addAttribute( 'customer', 'cpf', array(
      'label'   => 'Cpf',
      'type'    => 'varchar',
      'input'   => 'text',
      'visible' => true,
      'required'  => false,
      'position'  => 1,
    )
);
Mage::getSingleton( 'eav/config' )
    ->getAttribute( 'customer', 'cpf' )
    ->setData('used_in_forms', array('customer_account_edit','customer_account_create','adminhtml_customer', 'checkout_register', 'adminhtml_checkout' ))
    ->save();
$installer->addAttribute( 'customer', 'rg', array(
      'label'   => 'Rg',
      'type'    => 'varchar',
      'input'   => 'text',
      'visible' => true,
      'required'  => false,
      'position'  => 1,
    )
);
Mage::getSingleton( 'eav/config' )
    ->getAttribute( 'customer', 'rg' )
    ->setData('used_in_forms', array('customer_account_edit','customer_account_create','adminhtml_customer', 'checkout_register', 'adminhtml_checkout' ))
    ->save();
$installer->addAttribute( 'customer', 'tipopessoa', array(
      'label'   => 'Tipo Pessoa',
      'type'    => 'varchar',
      'input'   => 'text',
      'visible' => true,
      'required'  => true,
      'position'  => 1,
    )
);
Mage::getSingleton( 'eav/config' )
    ->getAttribute( 'customer', 'tipopessoa' )
    ->setData('used_in_forms', array('customer_account_edit','customer_account_create','adminhtml_customer', 'checkout_register', 'adminhtml_checkout' ))
    ->save();
$installer->addAttribute( 'customer', 'cnpj', array(
      'label'   => 'Cnpj',
      'type'    => 'varchar',
      'input'   => 'text',
      'visible' => true,
      'required'  => false,
      'position'  => 1,
    )
);
Mage::getSingleton( 'eav/config' )
    ->getAttribute( 'customer', 'cnpj' )
    ->setData('used_in_forms', array('customer_account_edit','customer_account_create','adminhtml_customer', 'checkout_register', 'adminhtml_checkout' ))
    ->save();
$installer->addAttribute( 'customer', 'ie', array(
      'label'   => 'Inscr Estadual',
      'type'    => 'varchar',
      'input'   => 'text',
      'visible' => true,
      'required'  => false,
      'position'  => 1,
    )
);
Mage::getSingleton( 'eav/config' )
    ->getAttribute( 'customer', 'ie' )
    ->setData('used_in_forms', array('customer_account_edit','customer_account_create','adminhtml_customer', 'checkout_register', 'adminhtml_checkout' ))
    ->save();
$installer->addAttribute( 'customer', 'razaosocial', array(
      'label'   => 'Razao Social',
      'type'    => 'varchar',
      'input'   => 'text',
      'visible' => true,
      'required'  => false,
      'position'  => 1,
    )
);
Mage::getSingleton( 'eav/config' )
    ->getAttribute( 'customer', 'razaosocial' )
    ->setData('used_in_forms', array('customer_account_edit','customer_account_create','adminhtml_customer', 'checkout_register', 'adminhtml_checkout' ))
    ->save();
try {
    $installer->run("ALTER TABLE {$this->getTable('sales_flat_quote')} ADD COLUMN `customer_cpf` VARCHAR(20) CHARACTER SET utf8 DEFAULT NULL AFTER `customer_dob`;");
    $installer->run("ALTER TABLE {$this->getTable('sales_flat_quote')} ADD COLUMN `customer_cnpj` VARCHAR(20) CHARACTER SET utf8 DEFAULT NULL AFTER `customer_cpf`;");
    $installer->run("ALTER TABLE {$this->getTable('sales_flat_quote')} ADD COLUMN `customer_tipopessoa` VARCHAR(2) CHARACTER SET utf8 DEFAULT NULL AFTER `customer_cnpj`;");
    $installer->run("ALTER TABLE {$this->getTable('sales_flat_quote')} ADD COLUMN `customer_ie` VARCHAR(20) CHARACTER SET utf8 DEFAULT NULL AFTER `customer_tipopessoa`;");
    $installer->run("ALTER TABLE {$this->getTable('sales_flat_quote')} ADD COLUMN `customer_razaosocial` VARCHAR(255) CHARACTER SET utf8 DEFAULT NULL AFTER `customer_ie`;");
    $installer->run("ALTER TABLE {$this->getTable('sales_flat_quote')} ADD COLUMN `customer_rg` VARCHAR(20) CHARACTER SET utf8 DEFAULT NULL AFTER `customer_razaosocial`;");
}
catch (Exception $e) {
}
$installer->endSetup();
?>

O que esse arquivo faz??
Quando o seu módulo for instalado este arquivo de setup será executado. Ele irá adicionar no seu banco de dados os atributos cpf, cnpj, ie, razaosocial, rg e tipopessoa. Além de adicionar os atributos, ele irá dizer para o Magento em quais formulários esses atributos irão aparecer:

array('customer_account_edit','customer_account_create','adminhtml_customer', 'checkout_register', 'adminhtml_checkout')

Ou seja, irão aparecer na criação e edição do cadastro (frontend), na criação e edição via painel Administrativo, durante o processo de checkout (tanto frontend como backend).

Mas aí você pode perguntar: Mas na página de cadastro e edição, não é o magento que gera os html. Para que então a necessidade de fazer a configuração explicada acima?
Ele não gera o html, mas durante o processo onde é criado o objeto Customer, só são incluídos os campos relacionados na tabela customer_form_attribute, com o valor de customer_account_create ou qualquer outro tipo.
O mesmo acontece durante a criação do objeto Customer a partir de um objeto Order/Quote.
Não adianta ter configurado o config.xml corretamente se não estiver na tabela customer_form_attribute.

Pronto! A parte de codificação está pronta.
Ahh, falta agora criarmos o arquivo de “ativação” do nosso módulo, que fará com que o magento o reconheça.

Passo 5) Em app/etc/modules crie um arquivo chamado Webgp_Customer.xml, com o seguinte conteúdo:



    
        
            true
            community

Passo 6) O último passo é a configuração do seu template, para que os campos apareçam certo?

****app/design/frontend/seutemlate/seutema/template/customer/form/edit.phtml



htmlEscape($this->getCustomer()->getTipopessoa()) =="pf"): ?> checked="checked"  title="Pessoa Física" onclick="$('dados01').style.display='none';$('cnpj').removeClassName('validar_cnpj');$('razaosocial').removeClassName('required-entry');$('dados02').style.display='block';$('cpf').addClassName('required-entry');$('cnpj').addClassName('required-entry');" class="radio" />  Pessoa Física
htmlEscape($this->getCustomer()->getTipopessoa()) =="pj"): ?> checked="checked"  title="Pessoa Jurídica" onclick="$('dados01').style.display='block';$('dados02').style.display='none';$('cpf').removeClassName('required-entry');$('rg').removeClassName('required-entry');$('cnpj').addClassName('validar_cnpj');$('empresa').addClassName('required-entry');$('razaosocial').addClassName('required-entry');" class="radio">  Pessoa Jurídica


htmlEscape($this->getCustomer()->getTipopessoa()) =="pf"): ?> style="display:none;"  id="dados01">
Dados da Empresa - Cliente de Atacado
Preencha os dados da empresa somente para compras como cliente corporativo




Razão Social* 










CNPJ* 






IE 










htmlEscape($this->getCustomer()->getTipopessoa()) =="pj"): ?> style="display:none;" >
Dados da Pessoa Física




Rg* 






Cpf*

****app/design/frontend/seutemlate/seutema/template/customer/form/register.phtml





  Pessoa Física
  Pessoa Jurídica






Dados da Empresa - Cliente de Atacado
Preencha os dados da empresa somente para compras como cliente corporativo




Razão Social* 










CNPJ* 






IE 











Dados da Pessoa Física




Rg* 






Cpf*

Acho que os dois exemplos acima são suficientes. Não esqueça de alterar o arquivo relacionado ao checkout:

app/design/frontend/seutemplate/seutema/template/checkout/onepage/billing.phtml

AVISO: No pacote disponibilizado, os arquivos de template estão já configurados para utilizar o módulo ajax para endereço chamado Webgp_AjaxEnd. Além disso, tb já acompanha as configurações para a máscara e um arquivo js para validação do CPF e do CNPJ.
Os templates foram colocados em um nome tema chamado webgp. Ou seja, será criado no seu magento a estrutura app/design/frontend/default/webgp e dentro dela estarão os templates. Não esqueça de substituir os arquivos do SEU template/tema pelos enviados.

Comentários são bem vindos!

Magento: Erro ao adicionar produto no carrinho – Regra de Preço

luciene.silva — Wed, 01 Dec 2010 03:48:53 +0000

Pessoal,

Há algum tempo atrás fiz um post sobre um erro bobo, aparentemente um bug do magento: Após criar uma regra de desconto para uma forma de pagamento, se você adicionasse o grupo de clientes NOT LOGGED IN, era impossível incluir o produto no carrinho.

Aparecia a mensagem:

cannot add items to the shopping cart.

Bem, uma das soluções apresentadas foi alterar o arquivo app/code/core/Mage/Sales/Model/Quote.php.

Em app/code/Core / Mage / Sales / Model / Quote.php Iinsira o seguinte código no método _afterSave() :

if (null !== $this->_payments) {
           // inserted code start
            $this->getPaymentsCollection();
            if ($this->getId()) {
                foreach ($this->_payments as $payment) {
                    $payment->setQuote($this);
                }
            }
           // inserted code end
            $this->getPaymentsCollection()->save();
        }

Lembrando que o ideal é criar uma cópia do arquivo acima e colocar em app/code/local. Dessa forma se houver alguma atualização você não perderá sua configuração.

Magento: Módulo Offline dos Correios

luciene.silva — Tue, 05 Oct 2010 08:39:19 +0000

Olá Pessoal,

Como já avisamos antes, o nosso site está em manutenção, pois estamos integrando o Magento com o WordPress.

Mas, a partir de amanhã (05/out/2010) o site já estará totalmente funcional e iremos disponibilizar para download gratuito o módulo offline dos correios.

ATENÇÃO: Instabilidade no Blog e Site principal

luciene.silva — Wed, 29 Sep 2010 23:18:52 +0000

Boa noite pessoal,

Gostaria de avisá-los que entre hoje e amanhã o site e o blog webgp.com.br poderão ficar instáveis e até mesmo indisponíveis.
A razão para isso é a mudança do blog(wordpress) para funcionar “dentro” do nosso novo site principal (Magento).

Magento: Mais layouts free

luciene.silva — Wed, 15 Sep 2010 12:24:17 +0000

Pessoal, mais 2 links de layouts free interessantes:

http://www.magentocommerce.com/magento-connect/Mage-World/extension/1937/freepop–magento-theme

http://www.magentocommerce.com/magento-connect/Mage-World/extension/1758/hm-modern-theme-white-skin

Magento: Cuidado com o CACHE!!!!

luciene.silva — Thu, 09 Sep 2010 12:59:11 +0000

Bom dia pessoal,

Esse post é destinado à todos que se aventuram no mundo Magento, incluindo quem tá começando a trabalhar no desenvolvimento, assim como o usuário final que apenas gerencia a sua loja.

Esse post não é para falar sobre as maravilhas do cache nem sobre seus problemas. Na verdade, nem detalhes sobre o seu funcionamento!

Em todos os tutoriais que coloco aqui, sempre chamo a atenção para DESABILITAREM o Cache e até mesmo dar um refresh. Somente dessa forma você poderá ver alterações em seu site!
Não adianta você trocar a configuração de template, se você não atualizar seu cache!

Há um tempo atrás, tive o seguinte problema com um cliente:
Desenvolvi um módulo personalizado e fui fazer a instalação. Como sempre, desabilitei o cache e instalei. Apesar disso, o módulo não aparecia no admin. Sendo assim, dei um refresh no cache e esperei para ver o que acontecia….

Bem, o módulo apareceu no admin mas toda a parte de template ficou bagunçada. Partes do template não estava mais aparecendo, ficou horrivel e impossível de navegar pela loja.

O cliente então, passou a falar que o problema devia ser o módulo instalado! Após afirmar repetidas vezes que o problema não era esse, o cliente ainda não estava convencido. Dizia que fazia tempos qeu não mexia lá e que o simples fato de eu ter atualizado o cache não deveria ter causado problemas.

Bem, aí comecei então a depurar a loja, para descobrir o que havia acontecido.

A primeira coisa que me ocorreu foi: o template não está configurado certo. De alguma maneira ele configurou errado e só agora com o refresh apareceu. Ao olhar na configuração do cliente, estava configurado um template chamado f002.
Estava correto, pois eu tinah visto esse pacote no servidor.
Sendo assim, habilitei o template path hints do Magento, e qual a minha “surpresa” quando vi que os principais arquivos do template estavam sendo “substituidos” hierarquicamente pelos arquivos da pasta default.
Mas isso era inacreditável, já que a pasta estava lá e a configuração estava correta.
Após mais de uma hora buscando as mais loucas explicações, uma luz surgiu ao final do túnel:

Fui passar uns dados para o cliente via msn, e coloquei o caminho de determinado arquivo de cabeça. Passado alguns minutos, fui olhar no servidor e vi que tinha passado errado, pois passei f002 e na verdade era f001. EUREKA!

O cliente tinha em seu servidor uma pasta chamada f001 e havia configurado no admin f002!!!!

Mas como a loja estava funcionando corretamente? Como eu não havia percebido antes?

Bem, eu não havia percebido pois estou cansada de trabalhar com o f001 e o f002, que são dois templates gratuitos disponibilizados em um blog. Além disso, ele realmente tinha uma pasta chamada f002 que não tinha nada a ver com os templates.
Por cansado ou por besteira, apesar de saber qual era o erro, não conseguia “enxergá-lo”.

A loja estava funcionando ha tempos perfeitamente por causa do cache! O cache estava “errado” e ao forçar sua atualização, a “casa caiu”.

Somente após passar todas essas informações, o cliente viu que o problema estava nas alterações que fazia em sua loja e não dava refresh no cache!

Após esse incidente, antes de fazer qualquer coisa em uma loja peço para o cliente dar refresh e ver se está tudo ok. Dessa forma, o próprio cliente pode verificar se sua loja está funcionando corretamente ou não.

Bem, semana passada fui fazer a instalação de um módulo para outro cliente. Solicitei ao mesmo que desse um refresh no cache e ele não sabia nem onde ir. Apesar de explicar, ele não conseguiu.
Entrei no admin e dei um refresh … Adivinhem o que aconteceu? O template, como de costume, ficou distorcido.

Lógico, que o cliente veio irado, falando queeu tinha causado o problema!
Até você explicar que nariz de porco não é tomada….

Então, aí vai mais um alerta, principalmente para os desenvolvedores:

Antes de atualizar o cache em uma loja, deixe bem claro para o cliente o que isso pode acarretar e faça ele assinar uma autorização para o procedimento….rsrs.

Modelagem de Dados no Magento – Parte III

luciene.silva — Thu, 09 Sep 2010 12:24:15 +0000

Parte I
Parte II

Nas partes anteriores do nosso tutorial já vimos como manipulamos certos tipos de dados no BD.
Na verdade, vimos a parte simples, onde os dados estão persistidos em uma única tabela. Mas e o caso do EAV?
Bem, acredito que na maioria das vezes que você precisar criar uma tabela específica para um módulo, você irá optar pelo jeito mais simples, onde cada “objeto” reflete o registro de uma única tabela.
Mas, mesmo que você não for criar um conjunto de tabelas EAV para representar um objeto, você precisa saber o básico para conseguir lidar bem com os Produtos.
Como buscar produtos no BD que tenham apenas uma determinada cor? Busco da mesma forma que estivesse buscando um registro qualquer?

É isso que veremos nessa parte do tutorial.

Bem, mas o que seria o modelo EAV (Entidade – Atributo – Valor)?
Para quem “arranha” no inglês, você poder ver uma discussão sobre o assunto aqui.

Não vou me aprofundar muito, mas seria algo mais ou menos assim:

Quando você tem um “objeto” que pode ter uma quantidade muito grande de dados, é interesse você dividir essas informações em várias tabelas.

Vamos usar o exemplo do Produto, dentro do próprio Magento.

Você pode criar quantos atributos você quiser para um Produto e cada atributo pode ser de N tipos (string, inteiro, texto, decimal, data e etc). Qual a forma mais fácil de modelar esse objeto Produto no nosso BD?

Bem, seria interessente criar uma tabela que define o nosso produto (nossa entidade, vamos assim dizer), tabelas que definam os atrbutos que essa entidade irá ter, e por fim, tabelas com os valores desse atributo.

É mais ou menos assim que estão estruturadas as tabelas no nosso BD do Magento: Há uma tabela de definição do produto, outra que define quais atributos este produto tem, e tabelas próprias para cada tipo (texto, data, inteiro, etc) que irão guardar os valores do atributo.

Para entrarmos a fundo nessa questão da modelagem, vamos mudar um pouco o exemplo (módulo para meucomentario) que temos seguido até aqui. Acho que ficará mais fácil assimilar o “drama”.

Vamos utilizar um exemplo real, de um módulo que iremos disponibilizar logo logo aqui no blog: Forma de Pagamento – Financiamento.

Um cliente uma vez solicitou um módulo que permitisse que o cliente preenchesse uma ficha de financiamento, em vez de simplesmente pagar com boleto ou etc.

Ou seja, no momento do checkout o cliente escolheria o método “Financiamento”, preencheria um formulário que posteriormente seria avaliado.

A primeira pergunta que tive foi a seguinte: Mas quais campos esse formulário vai ter?
A resposta foi: “Depende”.

Na verdade o cliente poderia escolher entre Pessoa Física e Jurídica e de acordo com sua escolha, o formulário teria itens diferenciados.

Além disso, para que o módulo em questão fosse utilizado por mais de uma loja, seria interessante que esses campos fossem configuráveis.

Mas como fazer isso em relação banco de dados, já que cada campo poderia ser de um tipo diferente (data, texto, inteiro e etc)?
O jeito seria criar uma tabela para campos do tipo texto, outra para data e assim por diante.

Bem, o cadastro se parece muito com o cadastro de um produto certo? Pq então não utilizar o mesmo modelo de dados?

Assim foi definida a utilização do EAV!

Como esse tutorial não tem como objetivo a criação de novos módulos, só vou citar as configurações específicas para o modelo de dados utilizado.

Se achar interessante, modifique o exemplo anterior para salvar os comentários em um modelo EAV.

CONFIG.XML

   
    
        
            
                Webgp_FinanciamentoOffline_Model
                financiamentooffline_resource_eav_mysql4
            
            
                Webgp_FinanciamentoOffline_Model_Resource_Eav_Mysql4
                
                    
                        financiamentooffline_proposta
                    
                    financiamentooffline_eav_attribute
                
            
        
        
            
                
                    Webgp_FinanciamentoOffline
                    Webgp_FinanciamentoOffline_Model_Entity_Setup
                
                
                    core_setup
                
            
            
                
                    core_write
                
            
            
                
                    core_read

No nossa definição de modelo notamos que a diferença está no nosso resourceModel, que passa a utilizar a estrutura resource_eav_mysql4.
Na configuração do nosso novo resourceModel, temos que listar nossas entidades. Nesse caso, temos uma entidade chamada proposta (será chamada como Mage::getModel(‘financiamentooffline/proposta’)), que representa o nosso Model principal (seria como Produto, por exemplo) e também uma entidade chamada eav_attribute, que irá guardar as definições dos novos atributos.
Caso você queira utilizar alguma tabela FLAT para representar uma entidade, configure-a normalmente no config.xml. A diferenciação do seu real resource iremos fazer na hora de definir a classe.
Uma diferença também nessa configuração é a definição de uma classe específica para o nosso Setup (Webgp_FinanciamentoOffline_Model_Entity_Setup), que veremos adianta para que ela serve!

mysql4-install-0.1.0.php

startSetup();
$installer->run("
CREATE TABLE `{$installer->getTable('financiamentooffline/eav_attribute')}` (
  `attribute_id` smallint(5) unsigned NOT NULL AUTO_INCREMENT,
  `frontend_input_renderer` varchar(255) DEFAULT NULL,
  `is_global` tinyint(1) unsigned NOT NULL DEFAULT '1',
  `is_visible` tinyint(1) unsigned NOT NULL DEFAULT '1',
  `position` int(11) NOT NULL,
  PRIMARY KEY (`attribute_id`),
  CONSTRAINT `FK_FINANCIAMENTOOFFILINE_EAV_ATTRIBUTE_ID` FOREIGN KEY (`attribute_id`) REFERENCES `{$installer->getTable('eav/attribute')}` (`attribute_id`) ON DELETE CASCADE ON UPDATE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8;");
$installer->endSetup();
$installer->addEntityType('financiamentooffline_proposta',
          Array(
              'entity_model'          =>'financiamentooffline/proposta',
              'attribute_model'       =>'financiamentooffline/resource_eav_attribute',
              'table'         =>'financiamentooffline/proposta',
              'increment_model'       =>'eav/entity_increment_numeric',
              'increment_per_store'   =>'1'
));
$installer->createEntityTables($this->getTable('financiamentooffline/proposta'));
$installer->installEntities();
$describe = $installer->getConnection()->describeTable($installer->getTable('financiamentooffline/eav_attribute'));
foreach ($describe as $columnData) {
    if ($columnData['COLUMN_NAME'] == 'attribute_id') {
        continue;
    }
    $installer->getConnection()->dropColumn($installer->getTable('eav/attribute'), $columnData['COLUMN_NAME']);
}

O nosso arquivo de setup cria a tabela que definimos em config.xml para a entidade ‘financiamentooffline/eav_attribute’.
Além disso, ele cria todas as tabelas para a modelagem EAV:
Antes de tudo precisamos criar um novo tipo de entidade. Como, por exemplo, iremos saber se um conjunto de atributos faz parte de Produtos ou Propostas?
Você pode ver os tipos já cadastrados na tabela eav_entity_type.

Depois que criamos o nosso novo tipo, precisamos criar as tabelas para os tipos de dados (date, varchar, int e etc). Para isso chamamos o método createEntityTables(..).

Quando instalamos o magento, vemos que os produtos já possuem alguns atributos pré cadastrados certo? Na nossa classe de Setup iremos definir os atributos que devem ser instalados inicialmente. Para cadastrá-los no banco precisamos chamar o método installEntities().

Pronto!
Quando nosso módulo for instalado, você verá que as seguintes tabelas foram criadas:

Setup.php

 array(
                'entity_model'      => 'financiamentooffline/proposta',
                'attribute_model'   => 'financiamentooffline/resource_eav_attribute',
                'table'             => 'financiamentooffline/proposta',
                'increment_model'       =>'eav/entity_increment_numeric',
                'additional_attribute_table' => 'financiamentooffline/eav_attribute',
                'entity_attribute_collection' => 'financiamentooffline/eav_attribute',
                'attributes'        => array(
                    'nome' => array(
                        'type'              => 'varchar',
                        'backend'           => '',
                        'frontend'          => '',
                        'label'             => 'Nome',
                        'input'             => 'text',
                        'class'             => '',
                        'source'            => '',
                        // store scope == 0
                        // global scope == 1
                        // website scope == 2
                        'global'            => 0,
                        'visible'           => true,
                        'required'          => true,
                        'user_defined'      => true,
                        'default'           => '',
                        'unique'            => false,
                    ),
                ),
            )
        );
    }

Neste ponto do tutorial você já deve ser capaz de identificar a localização desse arquivo apenas olhando o nome da classe (Webgp/FinanciamentoOffline/Model/Entity/Setup.php).

Quando chamamos o método installEntities() no arquivo mysql4-install-0.1.0.php estamos mandando que as entidades definidas em getDefaultEntities() sejam instaladas.
No nosso exemplo, estamos definindo a entidade financiamento_proposta. O conteúdo do array é bem intuitivo. Apenas como exemplo, estamos cadastrando o atributo NOME.

Vamos mostrar agora as classes referentes ao nosso modelo Proposta e seus respectivos resources.

setType('financiamentooffline_proposta');
          $this->setConnection(
                $resource->getConnection('financiamentooffline_read'),
                $resource->getConnection('financiamentooffline_write')
            );
    }
       /**
     * Default proposta attributes
     *
     * @return array
     */
    protected function _getDefaultAttributes()
    {
        return array('entity_id', 'entity_type_id', 'attribute_set_id', 'order_id', 'is_active', 'created_at', 'updated_at');
    }

_init('financiamentooffline/resource_eav_attribute', 'eav/entity_attribute');
    }
    protected function _initSelect()
    {
        $this->getSelect()->from(array('main_table' => $this->getResource()->getMainTable()))
            ->where('main_table.entity_type_id=?', Mage::getModel('eav/entity')->setType('financiamentooffline_proposta')->getTypeId())
            ->join(
                array('additional_table' => $this->getTable('financiamentooffline/eav_attribute')),
                'additional_table.attribute_id=main_table.attribute_id'
            );
        return $this;
    }
    /**
     * Specify attribute entity type filter
     *
     * @param   int $typeId
     */
    public function setEntityTypeFilter($typeId)
    {
        return $this;
    }
    /**
     * Return array of fields to load attribute values
     *
     * @return array
     */
    protected function _getLoadDataFields()
    {
        $fields = parent::_getLoadDataFields();
        $fields = array_merge($fields, array('additional_table.is_global'));
        return $fields;
    }
    /**
     * Specify filter by "is_visible" field
     *
     */
    public function addVisibleFilter()
    {
        $this->getSelect()->where('additional_table.is_visible=?', 1);
        return $this;
    }
}

_init('financiamentooffline/proposta');
    }
}

_init('financiamentooffline/attribute');
    }
    /**
     * Processing object before save data
     *
     * @return Mage_Core_Model_Abstract
     */
    protected function _beforeSave()
    {
        $this->setData('modulePrefix', self::MODULE_NAME);
        if (isset($this->_origData['is_global'])) {
            if (!isset($this->_data['is_global'])) {
                Mage::throwException('0_o');
            }
        }
        return parent::_beforeSave();
    }
    /**
     * Processing object after save data
     *
     * @return Mage_Core_Model_Abstract
     */
    protected function _afterSave()
    {
        /**
         * Fix saving attribute in admin
         */
        Mage::getSingleton('eav/config')->clear();
        return parent::_afterSave();
    }
    /**
     * Init indexing process after attribute data commit
     *
     */
    public function afterCommitCallback()
    {
        parent::afterCommitCallback();
        return $this;
    }
    /**
     * Register indexing event before delete financiamentooffline eav attribute
     *
     */
    protected function _beforeDelete()
    {
        return parent::_beforeDelete();
    }
    /**
     * Init indexing process after catalog eav attribute delete commit
     *
     */
    protected function _afterDeleteCommit()
    {
        parent::_afterDeleteCommit();
    }
    /**
     * Return is attribute global
     *
     * @return integer
     */
    public function getIsGlobal()
    {
        return $this->_getData('is_global');
    }
    /**
     * Retrieve attribute is global scope flag
     *
     * @return bool
     */
    public function isScopeGlobal()
    {
        return $this->getIsGlobal() == self::SCOPE_GLOBAL;
    }
    /**
     * Retrieve attribute is website scope website
     *
     * @return bool
     */
    public function isScopeWebsite()
    {
        return $this->getIsGlobal() == self::SCOPE_WEBSITE;
    }
    /**
     * Retrieve attribute is store scope flag
     *
     * @return bool
     */
    public function isScopeStore()
    {
        return !$this->isScopeGlobal() && !$this->isScopeWebsite();
    }
    /**
     * Retrieve store id
     *
     * @return int
     */
    public function getStoreId()
    {
        if ($dataObject = $this->getDataObject()) {
            return $dataObject->getStoreId();
        }
        return $this->getData('store_id');
    }
    /**
     * Retrieve source model
     *
     * @return Mage_Eav_Model_Entity_Attribute_Source_Abstract
     */
    public function getSourceModel()
    {
        $model = $this->getData('source_model');
        if (empty($model)) {
            if ($this->getBackendType() == 'int' && $this->getFrontendInput() == 'select') {
                return 'eav/entity_attribute_source_table';
            }
        }
        return $model;
    }
    /**
     * Retrieve don't translated frontend label
     *
     * @return string
     */
    public function getFrontendLabel()
    {
        return $this->_getData('frontend_label');
    }
    /**
     * Get Attribute translated label for store
     *
     * @deprecated
     * @return string
     */
    protected function _getLabelForStore()
    {
        return $this->getFrontendLabel();
    }
    /**
     * Initialize store Labels for attributes
     *
     * @deprecated
     * @param int $storeId
     */
    public static function initLabels($storeId = null)
    {
        if (is_null(self::$_labels)) {
            if (is_null($storeId)) {
                $storeId = Mage::app()->getStore()->getId();
            }
            $attributeLabels = array();
            $attributes = Mage::getResourceSingleton('financiamentooffline/proposta')->getAttributesByCode();
            foreach ($attributes as $attribute) {
                if (strlen($attribute->getData('frontend_label')) > 0) {
                    $attributeLabels[] = $attribute->getData('frontend_label');
                }
            }
            self::$_labels = Mage::app()->getTranslator()->getResource()->getTranslationArrayByStrings($attributeLabels, $storeId);
        }
    }
    /**
     * Get default attribute source model
     *
     * @return string
     */
    public function _getDefaultSourceModel()
    {
        return 'eav/entity_attribute_source_table';
    }
    /**
     * Check is an attribute used in EAV index
     *
     * @return bool
     */
    public function isIndexable()
    {
        $backendType    = $this->getBackendType();
        $frontendInput  = $this->getFrontendInput();
        if ($backendType == 'int' && $frontendInput == 'select') {
            return true;
        } else if ($backendType == 'varchar' && $frontendInput == 'multiselect') {
            return true;
        } else if ($backendType == 'decimal') {
            return true;
        }
        return false;
    }
    /**
     * Retrieve index type for indexable attribute
     *
     * @return string|false
     */
    public function getIndexType()
    {
        if (!$this->isIndexable()) {
            return false;
        }
        if ($this->getBackendType() == 'decimal') {
            return 'decimal';
        }
        return 'source';
    }
}

_init('financiamentooffline/proposta');
    }
   public function getAttributesBySetAndGroup($groupId = 0, $setId = 0)
    {
        return  $this->getAttributesBySet($setId)->setAttributeGroupFilter($groupId);
    }
    public function getAttributesBySet($setId = 0)
    {
        return  Mage::getResourceModel('financiamentooffline/proposta_attribute_collection')->setAttributeSetFilter($setId);
    }
    /**
     *
     * @param   int $attributeId
     * @return  Mage_Eav_Model_Entity_Attribute_Abstract
     */
    public function getAttributeById($attributeId, $setId = 0)
    {
        foreach ($this->getAttributesBySet($setId) as $attribute) {
            if ($attribute->getId() == $attributeId) {
                return $attribute;
            }
        }
        return null;
    }

Vamos lembrar que cada atributo pertence a um grupo e a um conjunto de atributos. Ao instalar as entidades, automaticamente o Magento já cria um Conjunto chamado Default e um grupo também chamado Default.
O Conjunto seria os conjuntos de atributos que você cria para os produtos.

Essa parte de EAV é muito extensa e o assunto parece não ter fim!
Espero que tenha dado para vocês entenderem! Só para fechar..


//instanciar uma proposta com id = 21
        $proposta    = Mage::getModel('financiamentooffline/proposta')->load(21);
//recuperar conjunto de atributos cadastrados para as propostas
        $collection = Mage::getResourceModel('financiamentooffline/proposta_attribute_collection');
//salvar um atributo
        $model = Mage::getModel('financiamentooffline/resource_eav_attribute');
        $model->setEntityTypeId(Mage::getModel('eav/entity')->setType('financiamentooffline_proposta')->getTypeId());
         ...
        $model->save();

Modelagem de Dados no Magento – Parte II

luciene.silva — Wed, 01 Sep 2010 07:45:16 +0000

Dando continuidade ao nosso tutorial iniciado aqui, vamos criar um módulo bem simples para exemplificar a utilização doe Models dentro do Magento.

Como o intuito desse tutorial não é a criação de módulos, que já foi visto em posts anteriores, irei considerar que os leitores já sabem como criá-los.
Caso tenha alguma dúvida, siga este artigo.

Vamos criar um módulo que permita um usuário postar comentários sobre a loja, utilizando um Model que represente uma única tabela.

Passo 1)
Crie um módulo com o seguinte esqueleto em app/code/local:

Aqui é Namespace que escolhi e o meu módulo chama-se MeuComentario.

* Em Aqui/MeuComentario/Helper/Data.php, coloque o seguinte código:

<?php
class Aqui_MeuComentario_Helper_Data extends Mage_Core_Helper_Abstract
{

}

* Em Aqui/MeuComentario/controllers/IndexController.php, coloque o seguinte código:

class Aqui_MeuComentario_IndexController extends Mage_Core_Controller_Front_Action {
    public function testeAction() {
        echo 'Ola!';
    }
}

* Em Aqui/MeuComentario/etc/config.xml, vamos incluir o seguinte código:

<?xml version="1.0"?>
<config>
    <modules>
        <Aqui_MeuComentario>
            <version>1.0.0</version>
        </Aqui_MeuComentario>
    </modules>
    <global>
    	  <models>
            <meucomentario>
                    <class>Aqui_MeuComentario_Model</class>
                    <resourceModel>meucomentario_mysql4</resourceModel>
            </meucomentario>
            <meucomentario_mysql4>
                <class>Aqui_MeuComentario_Model_Mysql4</class>
                <entities>
                    <autor>
                        <table>webgp_meucomentario_autor</table>
                    </autor>
                    <comentario>
                        <table>webgp_meucomentario_comentario</table>
                    </comentario>
                </entities>
            </meucomentario_mysql4>
    	  </models>
        <resources>
            <meucomentario_setup>
                <setup>
                    <module>Aqui_MeuComentario</module>
                </setup>
                <connection>
                    <use>core_setup</use>
                </connection>
            </meucomentario_setup>
           <meucomentario_write>
                <connection>
                    <use>core_write</use>
                </connection>
            </meucomentario_write>
            <meucomentarioe_read>
                <connection>
                    <use>core_read</use>
                </connection>
            </meucomentario_read>
        </resources>
<!--
/**
 * Em blocks, definimos o "padrão", a "localização" dos blocos em nosso módulo.
 * Por enquanto, nenhum bloco foi ainda definido.
 */
-->
        <blocks>
        <meucomentario><class>Aqui_MeuComentario_Block</class></meucomentario>
        </blocks>

<!--
/**
 * Em helpers, definimos o "padrão", a "localização" dos Helpers em nosso módulo.
 * Por enquanto, apenas a classe Aqui_MeuComentario_Helper_Data foi definida.
 */
-->
        <helpers>
            <meucomentario>
                    <class>Aqui_MeuComentario_Helper</class>
            </meucomentario>
        </helpers>
    </global>
    <frontend>
<!--
/**
 * Em frontend/routers, definimos a "url" que deverá ser direcionada para nosso módulo.
 * Ou seja, se o usuário acessar http://www.meusite.com.br/meucomentario/index/teste ele irá chamar o método testeAction definido em Aqui_MeuComentario_IndexController.
 */
-->
        <routers>
            <meucomentario>
                <use>standard</use>
                <args>
                    <module>Aqui_MeuComentario</module>
                    <frontName>meucomentario</frontName>
                </args>
            </meucomentario>
        </routers>
    </frontend>
</config>

Os items não relacionados com o Models foram comentados no arquivo anterior. Vamos agora explicar o significado de cada configuração em global/models:

<global>
    <!-- ... -->
    <models>
        <meucomentario>
            <class>Aqui_MeuComentario_Model</class>
            <resourceModel>meucomentario_mysql4</resourceModel>
        </meucomentario>
    </models>
    <!-- ... -->
</global>

A tag CLASS indica qual o nome BASE (que reflete a localização dos arquivos também) para todos os modelos do nosso módulo. Ou seja, todas as classes que representam os modelos irão iniciar com Aqui_MeuComentario_Model e estarão na pasta Aqui/MeuComentario/Model.
Vamos supor que seja necessário criar o modelo Autor. Iremos criar o arquivo Autor.php em Aqui/MeuComentario/Model, com o nome de classe Aqui_MeuComentario_Model_Autor.
Caso você queira criar algumas pastas, a fim de organizar seu código, não esqueça de incluí-la no nome da classe. Exemplo:

A classe Default.php terá o seguinte nome : Aqui_MeuComentario_Model_Comentario_Default.

<?php
class Aqui_MeuComentario_Model_Comentario_Default extends Mage_Core_Model_Abstract
{
    public function _construct()
    {
        parent::_construct();
        $this->_init('meucomentario/comentario_default');
    }

A classe do Model deve estender Mage_Core_Model_Abstract e implementar o método construtor, definindo a “representação” deste Model.
Neste caso, quando houver a necessidade de instanciar o modelo Default, deve-se chamar por:

$model = Mage::getModel('meucomentario/comentario_default');

A tag RESOURCEMODEL indica “qual” Resource Model (responsável pela manipulação dos dados no banco) será utilizado.
Logo abaixo, no arquivo config.xml, configuramos o próprio resourceModel:

<global>
    <!-- ... -->
    <models>
        <!-- ... -->
        <meucomentario_mysql4>
            <class>Aqui_MeuComentario_Model_Mysql4</class>
                <entities>
                    <autor>
                        <table>webgp_meucomentario_autor</table>
                    </autor>
                </entities>
        </meucomentario_mysql4>
    </models>
</global>

Bem, acabamos de definir com a tag CLASS qual o nome/localização BASE dos nossos arquivos de Resource.
Ou seja, dentro da pasta Aqui/MeuComentario/Model devemos criar uma outra pasta chamada Mysql4.

<?php
class Aqui_MeuComentario_Model_Mysql4_Comentario_Default extends Mage_Core_Model_Mysql4_Abstract
{
    public function _construct()
    {
        $this->_init('meucomentario/comentario_default', 'id');
    }

A classe do ResourceModel deve estender Mage_Core_Model_Mysql4_Abstract e implementar o método construtor, definindo a “representação” deste Model e indicando qual a chave primária da tabela correspondente.
Ou seja, quando for carregado um objeto default, por exemplo Mage::getModel(‘meucomentario/comentario_default’)->load(7), será buscado no banco o registro na tabela com o id = 7.
Perceba que neste construtor, diferente do construtor em Model, ele não chama por parent::_construct();

Na tag ENTITIES fazemos o mapeamento entre Models e tabelas.
No exemplo acima, definimos que a entidade “autor” (‘meucomentario/autor’) representa os dados da tabela webgp_meucomentario_autor.
As tabelas não precisam seguir nenhum padrão de nomenclatura, mas para deixar o código organizado, aconselha-se utilizar um nome significativo.

Quando for preciso executar alguma query customizada, por exemplo, devemos instanciar o ResourceModel e não o Model.

Um ResourceModel deve ser chamado da seguinte forma:

Mage::getResourceModel('meucomentario/comentario_default');

Logo mais daremos alguns exemplos de utilização de um ResourceModel.

Acho que é meio intuitivo que: Quando criamos um Model que possui uma tabela no banco, o ResourceModel correspondente deve ser criado!
Se o seu Model não é persistido no banco, não se aplica essa criação.

<global>
    <!-- ... -->
    <resources>
        <meucomentario_setup>
                <setup>
                    <module>Aqui_MeuComentario</module>
                </setup>
                <connection>
                    <use>core_setup</use>
                </connection>
        </meucomentario_setup>
        <meucomentario_write>
            <connection>
                <use>core_write</use>
            </connection>
        </meucomentario_write>
        <meucomentario_read>
            <connection>
                <use>core_read</use>
            </connection>
        </meucomentario_read>
    </resources>
</global>

Para finalizar precisamos definir as nossas tabelas e os nossos adapters para leitura e escrita no banco.
A tag MEUCOMENTARIO_SETUP indica que haverá um setup inicial do nosso módulo, geralmente a execução de uma query para criação das tabelas.
Onde então está o nosso script a ser executado?

Crie dentro da pasta Aqui/MeuComentario/sql a pasta meucomentario_set. Dentro desta pasta crie um arquivo chamado mysql4-install-1.0.0.php (mysql4-install-{{versao configurada no inicio do config.xml}}.php).

$installer = $this;
$installer->startSetup();

$installer->run("
-- DROP TABLE IF EXISTS {$this->getTable('webgp_meucomentario_comentario')};
CREATE TABLE {$this->getTable('webgp_meucomentario_comentario')} (
  `id` int(11) unsigned NOT NULL auto_increment,
  `comentario` varchar(100) NOT NULL default '',
  `created_time` timestamp NOT NULL default CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

    ");

$installer->endSetup();
?>

Sobre os adapters…
No nosso exemplo estamos utilizando os adapters padrões do Magento, mas caso haja necessidade você pode criar o seu próprio.

ACABOU????

NÃOOOOOOO! Falta falarmos sobre as Collections de dados!

Bem, para carregarmos todos os registros de determinado Model basta chamarmos o seguinte código:

$autores = Mage::getModel('meucomentario/autor')->getCollection();

Neste exemplo estamos chamamos todos os autores cadastrados no nosso banco (pelo que já vimos até aqui, você pode facilmente criar as classes referente a esse modelo e incluir no setup e no config.xml as configurações necessárias).

Mas como definimos esse “método” getCollection()?
Na verdade precisamos criar uma classe (arquivo Collection.php) na nossa pasta de Resource.

Preste atenção na seguinte regra:

Model: Autor => Aqui/MeuComentario/Model/Autor.php
ResourceModel: Autor => Aqui/MeuComentario/Model/Mysql4/Autor.php
ResourceModel: COLLECTION Autor => Aqui/MeuComentario/Model/Mysql4/Autor/Collection.php

Ou seja, criamos uma pasta com o nome do nosso Model e dentro dela criamos o arquivo Collection.php.


<?php

class Aqui_MeuComentario_Model_Mysql4_Autor_Collection extends Mage_Core_Model_Mysql4_Collection_Abstract
{
    public function _construct()
    {
        parent::_construct();
        $this->_init('meucomentario/autor');
    }
}

Bem Pessoal, acho que já deu para entender bem como funciona o Models do Magento.
Amanhã vou postar a parte mais interessante e complicada desse tutorial, que explica passo a passo como criar um módulo utilizando modelos EAV.
Em alguns casos específicos a utilização de uma simples tabela FLAT não resolve um problema de modelagem e temos que recorrer ao EAV.

Espero que o tutorial seja util para vocês!
Para dúvidas, utilize a seção de comentários!

referências para esse artigo:
http://alanstorm.com/magento_models_orm
http://www.magentocommerce.com/knowledge-base/entry/magento-for-dev-part-1-introduction-to-magento/

Modelagem de Dados no Magento – Parte I

luciene.silva — Wed, 01 Sep 2010 05:04:32 +0000

Já tem um tempo que alguns leitores cobram um tutorial sobre a modelagem de dados no Magento.
O assunto é bem extenso e acho que isso explica a demora na postagem deste tutorial. Rsrsrs. Possivelmente o assunto será divididos em 2 ou 3 partes.

Vou tentar cobrir o assunto com exemplos práticos.

Vamos lá então, começando pelo básico…

O Magento é uma típica aplicação MVC (Model – View – Controller). Ou seja, as regras de negócio, assim como os modelos e a apresentação são codificados separadamente.

Podemos definir um módulo do Magento como sendo um conjunto de arquivos, estruturados de forma padrão, que representam uma funcionalidade. Exemplo: o módulo Catalog é responsável pelas principais funcionalidades relacionadas aos Produtos e às Categorias.

Os módulos básicos do Magento são encontrados em

app/code/core/Mage/

Módulos Básicos Magento

Dentro de cada módulo, temos os controladores separados em uma pasta, assim como os modelos em outra e os arquivos responsáveis pela apresentação dos dados em outra.

Estrutura de Diretórios - Módulo Magento

O Magento utiliza o Zend Framework, que é baseado em configurações. Ou seja, quando você desejar adicionar um novo arquivo/classe ao código, não adianta apenas criá-lo. Você deve configurar o Magento para que ele “veja” esse novo arquivo/classe.
Cada módulo do Magento possui um arquivo de configuração chamado config.xml, que fica dentro da pasta etc/. Como visto em tutoriais anteriores, é nesse arquivo que configuramos a localização dos nossos Models.

Os Models do Magento não possuem código para manipular diretamente o Banco de Dados (utiliza-se sistema ORM Object-Relational-Mapping, que permite a manipulação dos dados através de código PHP). A manipulação do banco ocorre em 2 classes associadas (Resources – uma para leitura e outra para escrita).

$model = Mage::getModel('catalog/product')->load(27);
$price = $model->getPrice();
$price += 5;
$model->setPrice($price)->setSku('SK83293432');
$model->save();

No código acima vemos como um model representando o produto com id = 27 é instanciado e como seus atributos são manipulados.

A classe que representa nosso modelo Product é Mage_Catalog_Model_Product, que pode ser encontrada em app/code/core/Mage/Catalog/Model/Product.php.
Ao analisarmos o seu código, podemos perceber que apesar de chamarmos no nosso exemplo acima os métodos “getPrice” e “setPrice”, eles não existem na nossa classe. Isto acontece pois o ORM implementado no Magento utiliza os métodos _get e _set do PHP.
Ao chamarmos o método $product->getPrice(); estamos dando um “get” no atributo “price”.
Para obtermos todos os dados disponíveis em um Model, basta chamarmos o método getData() ($product->getPrice();). Ele irá retornar um array com todos os atributos do nosso Model.
Para obter o valor de um atributo, além do método getNomeAtributo(), você também pode utilizar o método getData(‘nomeAtributo’);

Uma observação importante é que cada método “set” retorna uma instância do Model. Sendo assim, você irá se deparar várias vezes com o seguinte código:

$model->setPrice($price)->setSku('SK83293432');

Ou seja, várias chamadas do método “set” “enfileiradas”.

Como não poderia deixar de ser, a implementação ORM do Magento permite que carregue-se vários objetos através de uma interface de Collections.

$products_collection = Mage::getModel('catalog/product')
->getCollection()
->addAttributeToSelect('*')
->addFieldToFilter('price','5.00');

No código acima carregamos todos os produtos (com todos os seus atributos) que possuem o preço de R$5.00.
A interface Collection permite que os items sejam iterados:

foreach($products_collection as $product)
{
    echo $product->getName();
}

Bem, ao final desse tutorial vou passar alguns exemplos de queries customizadas, utilizadas para buscar diversos tipos de produtos.

Vamos aproveitar o gancho do exemplo para carregar uma coleção de dados, para falarmos sobre os 2 “tipos” de Models existentes no Magento, que variam de acordo com a sua modelagem no banco:

1) Modelos que representam um único registro de alguma tabela e,
2) Modelos que representam um conjuntos de registros salvos em várias tabelas no banco de dados (modelo EAV – Entidade – Atributo – Valor).

O modelo 1 é obviamente o mais simples para trabalhar, mas os principais modelos do Magento, como Produto, utilizam o modelo EAV. Por isso utilizamos o método addAttributeToSelect(*) na construção da nossa query.

Nas próximas partes do nosso tutorial, vamos criar um pequeno módulo para exemplificarmos como utilizar os Models.

Parte 2