使用 CMS 页面进行布局更新的正确方法是什么？

Question

我编写了一个特色产品模块，该模块在页面上放置了一个自定义块，其中包含与我在块中定义的任何属性相匹配的产品列表。最初，我通过向 CMS 页面的内容部分添加 {{block...}} 行来使其工作。这工作得很好，但我没有得到寻呼机。因此，我通过从内容部分删除 {{block...}} 行并将 XML 添加到布局更新 XML 部分来解决这个问题，如下所示：

<reference name="content">
    <block type="cms/block" name="product_list_top" />
    <block type="vps_featured/list" name="vps_featured_list" template="catalog/product/sale_list.phtml">
        <block type="catalog/product_list_toolbar" name="product_list_toolbar" template="catalog/product/list/toolbar.phtml">
            <block type="page/html_pager" name="product_list_toolbar_pager"/>
        </block>
        <action method="setToolbarBlockName"><name>product_list_toolbar</name></action>
        <action method="setAttributeName"><name>my_attribute</name></action>
    </block>
</reference>

这也很有效。然后我决定，由于该块有如此多的实例，如果我将一个 XML 文件添加到我的主题的布局文件夹中并将此代码放入其中，则会更加清晰。然后，在“布局更新”部分中，我可以简单地使用以下内容：

<reference name="vps_featured_list">
    <action method="setAttributeName"><name>other_attribute</name></action>
</reference>

因此，我创建了一个名为 vps_featured.xml 的文件，并将其添加到其中：

<layout version="0.1.0">
    <default>
        <reference name="content">
            <block type="cms/block" name="product_list_top" />
            <block type="vps_featured/list" name="vps_featured_list" template="catalog/product/sale_list.phtml">
                <block type="catalog/product_list_toolbar" name="product_list_toolbar" template="catalog/product/list/toolbar.phtml">
                    <block type="page/html_pager" name="product_list_toolbar_pager" />
                </block>
                <action method="setToolbarBlockName"><name>product_list_toolbar</name></action>
            </block>
        </reference>
    </default>
</layout>

中引用了此布局更新 XML 文件config.xml 用于我的自定义特色模块。我天真地认为，只有当我的 VPS 精选块位于页面上时，vps_featured.xml 才会合并到页面布局中，而这种情况只会发生在特殊 CMS 页面上的少数实例中。显然事实并非如此。我猜这破坏了所有其他页面，因为它覆盖了默认句柄。

因此，这引出了问题 #1：布局 xml 文件何时包含在页面布局中？它们是否用于所有页面，无论引用它们的模块是否实际使用？

然后，我决定尝试添加一个新的布局句柄，当我需要在 CMS 页面中引用时，我可以引用该句柄。我修改了布局 XML 文件，因此主要部分位于 标记内，而不是 标记内。这使其他页面恢复了生机，但当然，我的 CMS 页面不再工作，因为这些页面上没有使用布局更新句柄。我尝试将 添加到 CMS 页面的布局更新 XML 部分，但这不起作用（我没想到它会起作用）。

因此，这让我想到了问题#2：完成此操作的正确方法是什么？

这听起来并不应该如此困难，但显然我错过了一些东西。我已经阅读了我能在布局上找到的所有内容，但它们总是简单的示例，例如“将其添加到每个产品页面”。我不想在每个 cms 页面上添加一些内容...只是其中的几个。我是否在使用相关 CMS 页面的布局更新 XML 部分时遇到困难？我觉得必须有一种更清洁的方法。

谢谢，

布莱恩

Answer 1

节点 称为“布局句柄”。每个对 Magent 的请求都会生成许多这样的句柄。查看Commerce Bug 演示网站上的布局选项卡，了解生成的句柄类型。

Magento 将所有布局 XML 文件合并到一棵称为包布局的巨型树中。然后，句柄确定哪些布局 XML 更新片段用于特定请求。这些片段被组合到页面布局中。正如您的直觉， 句柄是始终 添加的，这就是为什么您要屏蔽系统中的每个站点。

坏消息是，虽然有 CMS 页面的句柄 ()，但它仍然是一件要么全有要么全无的事情。您可以向所有 CMS 页面添加内容，但不能向特定CMS 页面添加内容。所以，是的，CMS 管理的布局更新 XML 部分是执行您想要的操作的“正确”方法。

好消息是，您可以采取两种比您迄今为止提出的更干净的方法。 首先，您可以通过在 XML 文件中定义自己的句柄来清理一些内容，然后使用特殊的布局 XML 命令来包含该句柄。

在 XML 中，将布局更新 XML 片段添加到自定义句柄内。

<代码>

<layout version="0.1.0">  <my_fancy_pants_unique_handle_name_which_doesnt_conflict_with_existing_names>
        <reference name="content">
            <block type="cms/block" name="product_list_top" />
            <block type="vps_featured/list" name="vps_featured_list" template="catalog/product/sale_list.phtml">
                <block type="catalog/product_list_toolbar" name="product_list_toolbar" template="catalog/product/list/toolbar.phtml">
                    <block type="page/html_pager" name="product_list_toolbar_pager" />
                </block>
                <action method="setToolbarBlockName"><name>product_list_toolbar</name></action>
            </block>
        </reference>
    </my_fancy_pants_unique_handle_name_which_doesnt_conflict_with_existing_names>
</layout>

然后在 CMS 管理中，为您想要的页面添加以下布局更新 XML

<update handle="my_fancy_pants_unique_handle_name_which_doesnt_conflict_with_existing_names" />

Magento 允许布局更新 XML 片段向请求添加额外的句柄。这就是你上面所做的。这使事情变得简单一些，如果您想更改某些 XML，可以在一个集中的位置进行更改。

更新：事实证明，命令只能在布局 XML 文件本身中使用。加载 CMS 页面的布局更新 XML 的代码与加载和处理 XML 文件更新的代码不同。 Magento 将字面上添加任何内容到 CMS 表单中作为布局更新。它不会对其进行递归更新处理。因此，将类似的内容添加到 local.xml 中是可行的

<mock_product_list>
    <reference name="head">
    <label>Mock Product List</label>        
                <action method="addItem"><type>skin_js</type><name>js/sw/wall.js</name></action>
    </reference>    
</mock_product_list>

<cms_page_view>
    <update handle="mock_product_list" />
</cms_page_view>

，但您不能直接通过 CMS 管理员应用更新来执行此操作。生活和学习。

尽管如此，小部件方法可能仍然可行，并且可以作为上述方法的替代方案。

1. 使用自定义块类创建自定义模块

   使用

2. 块类不呈现 HTML

3. 块类包含一个名为“addFooToLayout”的单个方法

然后，在您的 CMS 页面中添加这样的更新

<block type="yourmodule/yourblock" name="unique_name" alias="unique_name">
    <action method="addFooToLayout" />
</block>

，然后在您的块定义中

public addFooToLayout()
{
    $layout = Mage::getSingleton('core/layout');
    $head   = $layout->getBlock('head');
    $head->addItem('skin_js','js/sw/wall.js');
    //etc...
}

添加类似的内容 应该可以工作并且更清晰一点（取决于您想要添加多少布局更新 XML）。然而，我还没有测试过它，我的可信度已经被破坏了，所以买家要小心。

第二种方法是创建一个包含您要添加到页面的内容的单个小部件，然后使用小部件实例管理来将该小部件添加到特定页面上的特定块。该链接应该可以帮助您入门。

最后，冒着被骗的风险，我最近自行出版了一本关于 Magento 布局的书 深入涵盖了此类问题。如果您有兴趣了解整个系统的工作原理，那么值得您花时间。

Answer 2

不过这个问题已经很老了，我通过谷歌找到了它，并想为将来阅读这篇文章的人添加一些信息。

昨天，当我读到这个问题和答案时，还有 this 和 这个帖子，我变得相当确保不可能或很难仅针对特定页面覆盖/扩展 CMS 页面布局句柄。这促使我开发了一个小型扩展，它可以在任何特定页面中注入任何自定义布局句柄。我将很快用扩展的公共链接更新这篇文章。

但后来我发现实际上可以为 CMS 页面创建一个新模板并将任何自定义布局句柄分配给该模板，请参阅 此问题和答案，来自 Marius。以下是该代码示例的重要部分：

<global>
    <page>
        <layouts> 
            <lookbook module="page" translate="label">
                <label>Lookbook</label>
                <template>page/1column-lookbook.phtml</template>
                <layout_handle>lookbook</layout_handle>
            </lookbook> 
        </layouts>
    </page>
</global>

将任何自定义布局句柄注入到任何页面非常容易，并且仅对使用此模板和自定义布局句柄的页面执行您想要的任何操作。我希望我之前就知道这一点，希望这篇文章能够节省某人的时间。