Magento – coleção de produtos / catalog/product_collection

Em casos bem comuns trabalhando com ecommerce temos a necessidade em alguns momentos de ter em mãos uma lista de certos produtos. Sejam esses produtos de uma certa categoria, ou tageados com certas palavras chaves ou dentro de uma faixa de valor.

O Magento trata essa lista de produtos como uma coleção de produtos, que possui um modelo próprio para tratar isso, criando uma interface simpática ao desenvolvedor para criar complexas consultas SQL. Há duas formas de acessar essa interface do "Product Collection" usando o modelo do catalog/product ou acessando diretamente o recurso do modelo , resource model, o catalog/product_collection. Se você der uma olhada na classe Mage_Catalog_Model_Resource_Eav_Mysql4_Product_Collection, encontrado pelo caminho core/Mage/Catalog/Model/Resource/Eav/Mysql4/Product/Collection.php, é possível ver todos os métodos disponíveis e como eles são implementados.


Primeira Forma

  1. $produtos = Mage::getModel('catalog/product');
  2. $colecaoProdutos = $produtos->getCollection()
  3. ->addAttributeToSelect('*')
  4.      ->addAttributeToFilter(
  5. 'type_id',
  6. array('eq' => 'customproduct')
  7. );     
  8. ->addAttributeToSort('price','asc')
  9. ->load();

Segunda Forma

  1. $colecaoProdutos = Mage::getResourceModel('catalog/product_collection')
  2. ->addAttributeToSelect('*')
  3. ->addAttributeToSort('price','asc');

Como no dia a dia eu utilizo a segunda forma nos meus exemplos vou fazer o mesmo.

Métodos

Há três metódos que uso com grande frequência são o addAttributeToSelect, addAttributeToFilter e addAttributeToSort. Abaixo uma breve referencia sobre esses métodos com alguns exemplos:

  • addAttributeToSelect()

Com o addAttributeToSelect você define os nomes dos atributos/campos que serão retornados do banco, como uma query SQL. Para retornar todos os atributos/campos do produto use "*", caso queira apenas algumas informações passe campo a campo como nos exemplos listados abaixo.

  1. //Todos os campos
  2. $colecaoProdutos = Mage::getResourceModel('catalog/product_collection')
  3. ->addAttributeToSelect('*');
  1. //Apenas alguns campos
  2. $colecaoProdutos = Mage::getResourceModel('catalog/product_collection')
  3. ->addAttributeToSelect('name')
  4. ->addAttributeToSelect('price')
  5. ->addAttributeToSelect('description')
  6. ->addAttributeToSelect('small_image');
  1. //Alguns campos com uma só chamada
  2. $colecaoProdutos = Mage::getResourceModel('catalog/product_collection')
  3. ->addAttributeToSelect(
  4. array("name", "price","small_image", "description")
  5. );
Para mais informações sobre esse método de uma olhada na Documentação do Magento .
  • addAttributeToFilter()

O addAttributeToFilter é equivalente ao WHERE de uma query de consulta SQL. Da mesma forma como você pode adicionar operadores de condição em uma query assim se faz com esse método, passando como paramêtro um array com o nome do campo e a condição como segue os exemplos abaixo.

  1. //Great than - para valores maiores que 99.99
  2.  
  3. $colecaoProdutos->addAttributeToFilter('price', array('gt' => 99.99));
  1. //Less than or Equals to - para valores maiores ou igual a 99.99
  2.  
  3. $colecaoProdutos->addAttributeToFilter('price', array('lteq' => 99.99));

Há dois campos do produto, news_from_date e news_to_date, que definem de e até quando ele deve ser considerado novo. Uso também com muita frequência esses dois campos pra selecionar esses novos produtos e colocar um diferencial nele pra chamar a atenção, seja uma borda ou ima imagem com "Novo" sobre a imagem do produto. Segue o código

  1. //Coleção de produtos novos
  2. $colecaoProdutos->addAttributeToFilter('news_from_date', array('date' => true, 'to' => $todayDate))
  3. ->addAttributeToFilter('news_to_date', array('or'=>
  4. array(0 => array('date' => true, 'from' => $todayDate),
  5. 1 => array('is' => new Zend_Db_Expr('null')))
  6. ), 'left');
  7.  
  8. //Assim como visto em /app/code/core/Mage/Catalog/Block/Product/New.php

Se quiser saber mais sobre filtros e outros operadores de condição deem uma olhada no post do Adam Moss que aborda com exemplos rápidos e sem baboseira no link http://www.e-commercewebdesign.co.uk/blog/magento-tips/magento-sql-queries-with-addattributetofilter.php .

  • addAttributeToSort()
Se você estiver familiarizado com SQL sabe que é possível ordenar uma consulta com o ORDER BY nome_campo de forma ASCENDENTE(menor pro maior) ou DESCENTENDE (maior pro menor). Sendo assim o mesmo se aplica com o método addAtributeToSort(). No último caso do addAttributeToFilter() faço uma consulta por produtos marcados como novos de uma data até a outra, só que essa condição vai me trazer todos os produtos não necessariamente ordenados do mais novo para o mais velhos, e também se quissemos que a coleção de produtos fique ordenados dos mais velhos para os mais novos, ou ordenados por preço?
  1. //Mais velhos para mais novos
  2. $colecaoProdutos->addAttributeToFilter('news_from_date', array('date' => true, 'to' => $todayDate))
  3. ->addAttributeToFilter('news_to_date', array('or'=>
  4. array(0 => array('date' => true, 'from' => $todayDate),
  5. 1 => array('is' => new Zend_Db_Expr('null')))
  6. ), 'left')
  7. ->addAttributeToSort('news_from_date','desc');
  1. //Mais baratos para os mais caros
  2. $colecaoProdutos->addAttributeToFilter('news_from_date', array('date' => true, 'to' => $todayDate))
  3. ->addAttributeToFilter('news_to_date', array('or'=>
  4. array(0 => array('date' => true, 'from' => $todayDate),
  5. 1 => array('is' => new Zend_Db_Expr('null')))
  6. ), 'left')
  7. ->addAttributeToSort('price','asc');

 

Só espero ter sido bem claro e objetivo nesse post. Com esses exemplos já pode fazer uma página de categoria, ou mesmo uma página de promoção para só listar produtos mais novos ou mais antigos com promoção.

Material de referência:
http://www.e-commercewebdesign.co.uk/blog/magento-tips/magento-sql-queries-with-addattributetofilter.php
http://docs.magentocommerce.com/Mage_Eav/Mage_Eav_Model_Entity_Collection_Abstract.html
http://www.exploremagento.com/magento/some-custom-blocks-to-help-you-show-products.php

3 ideias sobre “Magento – coleção de produtos / catalog/product_collection

  1. Thiago Mendes

    fala amigão, seu post me veio bem acalhar! mas estou tendo dificuldades no momento de exibir os produtos da coleção.

    ainda sou noob no magento e queria uma ajudinha se possível, digamos que estou usando o modo de exibir tudo, como faço para exibir os produtos?

    1. Pereira, Thiago Santos Autor do post

      Fala Thiago,

      Não tenho certeza se entendi bem a sua pergunta, mas você gostaria de iterar sobre a coleção de produtos?

      Você pode simplesmente um foreach.

      foreach($colecaoProdutos as $produto){
      //seu código vai aqui
      }
      

Deixe uma resposta

O seu endereço de email não será publicado Campos obrigatórios são marcados *

Você pode usar estas tags e atributos de HTML: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>