Cursos Magento

Trabalhando com Eventos e Observers no Magento 1

, ,

19 de junho de 2018

Sempre que precisamos modificar uma funcionalidade existente no Magento, ou realizar uma integração, a primeira coisa que devemos fazer é buscar os eventos que cercam aquela entidade ou recurso que queremos mexer.

Evite sobrescrever

Ao invés de sair sobrescrevendo classes e módulos nativos do core do Magento, o uso de events e observers é uma prática bem mais recomendada e menos invasiva, que garante mais compatibilidade com outros módulos, e evita conflitos de sobrescrita em classes que já foram substituídas por outros módulos anteriormente.

O que são os eventos

Pode-se dizer que o Magento é uma plataforma baseada em eventos, e esta é uma das grandes sacadas para sua alta flexibilidade.

Os eventos são pontos de interrupção presentes em diversas partes do núcleo da plataforma. Uma vez que um evento é chamado, o Magento busca todos os módulos que estão “escutando” aquele evento e os chama, passando parâmetros relevantes que podem ser modificados por esses módulos ou utilizados por eles para realizar integrações ou disparar novas ações.

Veja alguns dos eventos presentes do Magento e muito utilizados:

  • sales_order_place_after – disparado logo após a realização de um pedido
  • sales_order_invoice_pay – disparado logo após o pagamento de uma fatura (quando o pedido é pago)
  • checkout_cart_product_add_after – chamado logo após um produto ser adicionado ao carrinho
  • checkout_cart_save_after – chamado após uma modificação no carrinho ter sido realizada
  • admin_user_authenticate_after – chamado após uma tentativa de login no admin da loja

O Magento 1.9 tem aproximadamente 430 eventos em diversos lugares, além de eventos que possuem nomes dinâmicos, construídos com base em variáveis de ambiente e requisição (como por exemplo 'controller_action_predispatch_' . $this->getFullActionName() ).

Uma lista com todos os eventos pode ser obtida através de uma busca por chamadas do método Mage::dispatchEvent() em toda a loja, mas é claro que eu vou facilitar seu trabalho no final deste post.

Usando Observers

Após criar um módulo básico para Magento 1, você pode facilmente adicionar pontos de observação (observers) ao seu módulo. Uma vez que este ponto de observação é atingido, um método e uma classe especificado por você é chamada.

No exemplo abaixo adicionarei um observer para o evento core_block_abstract_to_html_after, declarado em app/code/core/Mage/Core/Block/Abstract.php. Este evento é chamado antes da saída html de todos os blocos do Magento, e como podemos ver, um parâmetro “ block” e “transport” são passados, contendo o bloco que está sendo renderizado e um elemento _transportObject que é usado para pegar o html de saída.

Agora o nosso módulo:

Note que declaramos um Model chamado Magenteiro_EventListener_Model_Observer e que o método addHello será chamado.
O nome do nosso módulo neste caso é Magenteiro_EventListener, mas pode ser qualquer coisa.

Nosso Model Magenteiro_EventListener_Model_Observer não é obrigado a estender nenhuma outra classe, como ocorre com os Models tradicionais. Ele deve apenas conter um método chamado addHello que recebe apenas um parâmetro ( $observer).

Note que para pegar o parâmetro “block” passado pelo app/code/core/Mage/Core/Block/Abstract.php precisamos apenas chamar o método getEvent()->getBlock() ou getEvent()->getData('block').

No nosso exemplo, eu forço a gravação de um arquivo em var/log/magenteiro.log que gravará o nome do bloco que foi chamado, usando o método nativo Mage::log.

Assista o resultado…

 

Modificando valores com eventos

Enquanto no Magento 2 a boa prática não recomenda que modifiquemos os valores passados para Obversers, no Magento 1 esta é uma prática bastante comum. Seguindo nossas modificações na classe acima, eu adicionarei um “Hello” no começo do bloco “footer”.

E o resultado:
Hello antes do Footer

Não faça isso em casa

Este foi apenas um exemplo de como podemos alterar um objeto com o uso de observers, sem precisar sobrescrever a classe inteira, e não de mostrar como inserir um html antes de um bloco. Por favor, não utilize o exemplo acima para este fim. Para isso existem os arquivos de template e layout xml que servem este propósito de forma muito mais eficiente e performática.

Lista de Eventos disponíveis

Quer receber uma lista de eventos disponíveis no Magento 1.9? Informe seu e-mail abaixo e receba um PDF para consulta, com todos os Observers do Magento 1 e onde encontrar a definição deles.

Quer saber mais?

No curso Criação de Módulos e Desenvolvimento Backend para Magento (aula 31) você assiste este e outros exemplos de Observers em vídeo, e ainda pode fazer download de alguns módulos usados como exemplo ao longo do curso.

Imagem principal: Pixabay

Ricardo Martins

Desenvolvedor web há mais de 15 anos, desde 2011 totalmente especializado em Magento, ajudo na criação de conteúdo, e cursos online sobre Magento - hoje com mais de 7000 alunos de 97 países - e criador do módulo PagSeguro Transparente para Magento, usado em mais de 12 mil lojas.

Últimos posts por Ricardo Martins (exibir todos)

Comentários