Magento：在页脚中显示特定类别的产品

Question

我正在为页脚构建一个“本月产品”块。它应该加载一个类别的产品并显示第一个。

这是我的模板文件custom/featured-product.phtml:

<?php $_productCollection = $this->getLoadedProductCollection() ?>

<div class="featured-product">
    <h2><?php echo $this->__('Product of the Month') ?></h2>

    <?php foreach ($_productCollection as $_product): ?>
        <div class="item">
            <a class="product-image" href="<?php echo $_product->getProductUrl() ?>">
                <img src="<?php echo $this->helper('catalog/image')->init($_product, 'small_image')->resize(200); ?>" alt="<?php echo $this->htmlEscape($this->getImageLabel($_product, 'small_image')) ?>" />
            </a>

            <a class="product-name" href="<?php echo $_product->getProductUrl() ?>"><?php echo $this->htmlEscape($_product->getName()) ?></a>

            <?php echo $this->getPriceHtml($_product, true) ?>
        </div>

        <?php
        // Note: Exit after first product.
        break;
        ?>
    <?php endforeach ?>
</div>

这只是 Magento 产品列表模板的简化版：catalog/product/list.phtml

工作中

在 CMS 页面中嵌入块时，它可以正常工作。示例：

{{block type="catalog/product_list" category_id="13" template="custom/featured-product.phtml" }}

不工作

当通过local.xml 嵌入块时，它会失败。返回正确的标记，但未加载指定的类别。而是加载了随机（我不知道它们是如何选择的）一组产品。

我的代码在local.xml:

<default>
    <reference name="footer">
        <block type="catalog/product_list" name="custom.featuredProduct" as="product_of_the_month" category_id="13" template="custom/featured-product.phtml" />
    </reference>
</default>

为了完整起见，我在page/html/footer.phtml 中显式渲染该块，如下所示：

<?php echo $this->getChildHtml('product_of_the_month') ?>

有什么想法吗？

我的最佳猜测是我的local.xml 不正确。我需要加载父块吗？

[更新]

我的原始代码使产品页面崩溃。解决方法是不将代码如此依赖于 Magento 核心文件：catalog/product/list.phtml。特别避开这一行：

<?php $_productCollection = $this->getLoadedProductCollection() ?>

[解决方案]

这里包含一个带有用于 CMS 页面和 LayoutXML 示例的工作版本： https://stackoverflow.com/a/12288000/1497746

Answer 1

根据 Alan Storm 的建议找到了可行的解决方案。

/template/custom/featured-product.phtml

<?php
$_categoryId = $this->getCategoryId();

$_productCollection = Mage::getModel('catalog/category')->load($_categoryId)
    ->getProductCollection()
    ->addAttributeToSelect('*')
    ->addAttributeToFilter('status', 1)
    ->addAttributeToFilter('visibility', 4)
    ->setOrder('price', 'ASC');
?>

<div class="featured-product">
    <h2><?php echo $this->__( $this->getLabel() ); ?></h2>

    <?php foreach ($_productCollection as $_product): ?>
        <div class="item">
            <a class="product-image" href="<?php echo $_product->getProductUrl() ?>">
                <img src="<?php echo $this->helper('catalog/image')->init($_product, 'small_image')->resize(200); ?>" alt="<?php echo $this->htmlEscape($this->getImageLabel($_product, 'small_image')) ?>" />
            </a>

            <a class="product-name" href="<?php echo $_product->getProductUrl() ?>"><?php echo $this->htmlEscape($_product->getName()) ?></a>

            <?php echo $this->getPriceHtml($_product, true) ?>
        </div>

        <?php
        // Note: Exit after first product.
        break;
        ?>
    <?php endforeach ?>
</div>

简而言之，集合是手动生成的，而不是接收集合（就像我最初的尝试那样）：

<?php $_productCollection = $this->getLoadedProductCollection() ?>
<?php $_collectionSize = $_productCollection->count(); ?>

在 CMS 页面中使用：

{{block type="core/template" category_id="13" label="Product of the Month" template="custom/featured-product.phtml" }}

在模板中使用：

/layout/local.xml

<default>
    <reference name="footer">
        <block type="core/template" name="custom.featuredProduct" as="featured_product" template="custom/featured-product.phtml">
            <action method="setData"><key>category_id</key><value>13</value></action>
            <action method="setData"><key>label</key><value>Product of the Month</value></action>
        </block>
    </reference>
</default>

/template/page/html/footer.phtml

<?php echo $this->getChildHtml('featured_product') ?>

有用的资源：

如何获得产品集合：

• http://overlycaffeinated.com/2011/02/get-all-sale-products-from-a-category-in-magento/
• Magento products by categories

使用魔法 getter/setter：

• https://stackoverflow.com/a/4008251/1497746
• https://stackoverflow.com/a/4006374/1497746
• http://www.magestore.com/blog/2012/02/29/magento-cetificate-pass-variables-from-layout-to-block/

Answer 2

首先，多年来我遇到了随机问题，使用布局更新 xml 属性节点来设置块上的值（template、as、name、type 或 class 除外，所以尝试这样的事情

<default>
    <reference name="footer">
        <block type="catalog/product_list" name="custom.featuredProduct" as="product_of_the_month" template="custom/featured-product.phtml">
            <action method="setCategoryId"><id>13</id></action>
        </block>
    </reference>
</default>

或者这个

<default>
    <reference name="footer">
        <block type="catalog/product_list" name="custom.featuredProduct" as="product_of_the_month" template="custom/featured-product.phtml">
            <action method="setData"><key>category_id</key><value>13</value></action>
        </block>
    </reference>
</default>

可能会有所帮助，这将是我的第一步。

之后，我会查看加载集合的代码块

#File: app/code/core/Mage/Catalog/Block/Product/List.php
class Mage_Catalog_Block_Product_List extends Mage_Catalog_Block_Product_Abstract
{
    ...
    public function getLoadedProductCollection()
    {
        return $this->_getProductCollection();
    }        
    ...
    protected function _getProductCollection()
    {
        if (is_null($this->_productCollection)) {
            $layer = $this->getLayer();
            /* @var $layer Mage_Catalog_Model_Layer */
            if ($this->getShowRootCategory()) {
                $this->setCategoryId(Mage::app()->getStore()->getRootCategoryId());
            }

            // if this is a product view page
            if (Mage::registry('product')) {
                // get collection of categories this product is associated with
                $categories = Mage::registry('product')->getCategoryCollection()
                    ->setPage(1, 1)
                    ->load();
                // if the product is associated with any category
                if ($categories->count()) {
                    // show products from this category
                    $this->setCategoryId(current($categories->getIterator()));
                }
            }

            $origCategory = null;
            if ($this->getCategoryId()) {
                $category = Mage::getModel('catalog/category')->load($this->getCategoryId());
                if ($category->getId()) {
                    $origCategory = $layer->getCurrentCategory();
                    $layer->setCurrentCategory($category);
                }
            }
            $this->_productCollection = $layer->getProductCollection();

            $this->prepareSortableFieldsByCategory($layer->getCurrentCategory());

            if ($origCategory) {
                $layer->setCurrentCategory($origCategory);
            }
        }

        return $this->_productCollection;
    }                
}

getLoadedProductCollection 方法封装了对_getProductCollection 的调用，_getProductCollection 是实际加载集合的位置。

所以，

中的一些临时调试代码

protected function _getProductCollection()
{
    var_dump(__METHOD__);
    var_dump($this->getCategoryId());
    Mage::Log(__METHOD__);
    Mage::Log($this->getCategoryId());
}

可以帮助确保您的类别 ID 从布局更新 XML 到块。

但是，如果您更深入地查看 _getProductCollection，您会注意到它在一些条件下重置类别 ID。

if ($this->getShowRootCategory()) {
    $this->setCategoryId(Mage::app()->getStore()->getRootCategoryId());
}
...
if (Mage::registry('product')) {
    // get collection of categories this product is associated with
    $categories = Mage::registry('product')->getCategoryCollection()
        ->setPage(1, 1)
        ->load();
    // if the product is associated with any category
    if ($categories->count()) {
        // show products from this category
        $this->setCategoryId(current($categories->getIterator()));
    }
}
...

是否有其他 Magento 代码设置了 show_root_category 属性，或者您在注册表中有产品对象的页面上，Magento 将覆盖您的类别 ID。

让事情变得更加复杂，一旦加载集合，它就会被设置在受保护的属性上

$this->_productCollection = $layer->getProductCollection();

没有公共 getter 方法。

这里有很多方法。如果是我，我会考虑以下之一

1. 使用自定义块类扩展 Mage_Catalog_Block_Product_List 并具有重置集合上的类别或加载新集合的方法

2. 自己加载集合，不依赖product/list中的代码

Answer 3

我在 Magento CE 1.7.0.2 下成功重现了这个问题。

首先我创建了一个包含以下内容的 local.xml：

<default>
    <reference name="footer">
        <block type="catalog/product_list" name="custom.featuredProduct" as="product_of_the_month" category_id="13" template="custom/featured-product.phtml" />
    </reference>
</default>

我发现，缺少一些包装 XML 元素并添加了一些额外的行：

<?xml version="1.0"?>
<layout>
    <default>
        <reference name="footer">
            <block type="catalog/product_list" name="custom.featuredProduct" as="product_of_the_month" category_id="13" template="custom/featured-product.phtml" />
        </reference>
    </default>
</layout>

添加所需的 XML 元素后，它就可以工作了。