Magento 1.7+ : How to use the page layout handle

Question

在尝试调试了几个小时之后，我已经没有想法了，希望得到一些澄清(我想我在某个时候误解了一个概念)。

背景故事:一些基本类别需要一个“概览页面”，它应该从子类别和产品自动生成。所以我的方法是为每个基本类别添加一个子类别，并创建一个自定义页面布局，所有这些子类别都在使用该布局。对于我的客户来说，这在 Magento 后端很容易管理，因为他只需要在一个下拉菜单中更改值。所以我创建了一个简单的模块来定义新的页面布局。在后端，我也可以选择这个。

模块配置:

<?xml version="1.0"?>
<config>
    <modules>
        <Company_Layouts>
            <version>0.1.0</version>
        </Company_Layouts>
    </modules>  
    <global>
        <page>
            <layouts>
                <company_category_overview module="page" translate="label">
                    <label>Kategorie-Übersicht</label>
                    <template>page/1column.phtml</template>
                    <layout_handle>company_category_overview</layout_handle>
                </company_category_overview>
            </layouts>
        </page>
    </global>
    <frontend>
        <layout>
            <updates>
                <company_layouts>
                    <file>company_layouts.xml</file>
                </company_layouts>
            </updates>
        </layout>
    </frontend>
</config>

由于这些特殊的概览页面需要一些布局更改，我希望在特定布局文件 ( company_layouts.xml ) 中引用布局...这里我的逻辑是:

与 <layout_handle>company_category_overview</layout_handle>我希望定义一个句柄，仅当使用此特定页面模板时我才可以使用它来更改布局。事实并非如此。我的布局更新位于句柄内 company_category_overview只是被忽略了。

深入挖掘后我意识到，这似乎不是我的代码，而更像是一个普遍问题。在旧的 Magento 1.4 安装中，页面布局句柄被传送到所有站点，例如 page_one_column .在 Magento 1.7 和(我现在使用的)1.8 中，这只是主页上的情况。我正在使用 Commerce Bug 进行调试。我刚刚尝试使用全新的 1.7 和全新的 1.8 安装。

这是我不理解的一些概念还是只是一个普通的错误？

此外，我知道可以在后端实现布局更新，但这只是我的最后一个选择，因为我觉得将其放在单独的文件中更清晰，而无需复制/粘贴此类内容。

Answer 1

Is this some concept I don't understand or just a plain bug?

两者都有？两者都不？ <page><layout>...</layout></page>中的信息node 被类别页面和 CMS 页面使用，但每个系统使用信息的方式不同，并且两个系统都不会以您期望的方式使用它。以下是关于类别 页面如何使用此信息的概述。

类别页面由以下 Controller 操作呈现

#File: app/code/core/Mage/Catalog/controllers/CategoryController.php
public function viewAction()
{
    ...
}

此 Controller 操作没有标准 loadLayout和 renderLayout方法调用。相反，此方法中有很多额外的代码用于添加布局句柄以及在生成 block 和呈现最终布局之间执行操作。我们感兴趣的部分是这个

$design = Mage::getSingleton('catalog/design');
$settings = $design->getDesignSettings($category);

#...other stuff we don't care about...

if ($settings->getPageLayout()) {
    $this->getLayout()->helper('page/layout')->applyTemplate($settings->getPageLayout());
}

当您在“自定义设计”选项卡中使用“页面布局”保存类别时，getPageLayout上面的方法调用应该返回 company_category_overview .在类别页面上，Magento 不使用它来应用句柄，而是将值传递给 applyTemplate方法。这是完整的方法。

#File: app/code/core/Mage/Page/Helper/Layout.php
public function applyTemplate($pageLayout = null)
{
    if ($pageLayout === null) {
        $pageLayout = $this->getCurrentPageLayout();
    } else {
        $pageLayout = $this->_getConfig()->getPageLayout($pageLayout);
    }

    if (!$pageLayout) {
        return $this;
    }

    if ($this->getLayout()->getBlock('root') &&
        !$this->getLayout()->getBlock('root')->getIsHandle()) {
            // If not applied handle
            $this->getLayout()
                ->getBlock('root')
                ->setTemplate($pageLayout->getTemplate());
    }

    return $this;
}

相关部分是这一行，

$pageLayout = $this->_getConfig()->getPageLayout($pageLayout);

将从您的配置加载信息

<label>Kategorie-Übersicht</label>
<template>page/1column.phtml</template>
<layout_handle>company_category_overview</layout_handle>

作为 Varien_Object .然后，它将使用此信息将模板应用于根 block 。

$this->getLayout()
->getBlock('root')
>setTemplate($pageLayout->getTemplate());

因此，对于类别页面，<layout_handle/> 中的信息从未使用过节点。这就是您的布局更新未被应用的原因——Magento 实际上应用了您的句柄。