Блог

У меня есть модуль featured products, который я написал, который помещает пользовательский блок на страницу со списком продуктов, соответствующих любому атрибуту (ам), который я определил в блоке. Изначально я заставлял это работать, добавляя {{block...}} строку в раздел содержимого страницы CMS. Это сработало нормально, но я не получал пейджер. Итак, я исправил это, удалив {{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-файл в папку layout для моей темы и поместил туда этот код. Тогда в разделе обновления макета я мог бы просто использовать это вместо:

 <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 для моего пользовательского модуля featured. Я наивно предполагал, что vps_featured.xml это будет включено в макет страницы только тогда, когда на странице будет мой VPS Featured block, что произойдет только в этих нескольких случаях на специальных страницах CMS. Очевидно, это не тот случай. Это нарушало работу всех остальных страниц, я думаю, потому что это переопределяло дескриптор по умолчанию.

Итак, это подводит меня к вопросу № 1: Когда XML-файлы макета включаются в макет страницы? Используются ли они для ВСЕХ страниц, независимо от того, действительно ли используется модуль, ссылающийся на них?

Затем я решил попробовать добавить новый дескриптор макета, на который я мог бы ссылаться, когда захочу, на своих страницах CMS. Я изменил свой XML-файл макета, чтобы основная часть находилась внутри <vps_featured_list> тегов, а не <default> самих тегов. Это вернуло к жизни другие страницы, но, конечно, мои страницы CMS больше не работали, потому что этот дескриптор обновления макета не используется на этих страницах. Я попытался добавить <update handle="vps_featured_list" /> в раздел XML «Обновление макета» страницы CMS XML, но это не сработало (я этого не ожидал).

Итак, это подводит меня к вопросу № 2: каков правильный способ добиться этого?

Не похоже, что это должно быть так сложно, но, очевидно, я чего-то не понимаю. Я прочитал все, что смог найти о макетах, но это всегда простые примеры, например «добавляйте это на страницу КАЖДОГО продукта». Я не хочу, чтобы что-то добавлялось на КАЖДУЮ страницу cms…лишь некоторые из них. Я застрял в использовании XML-раздела обновления макета для рассматриваемых страниц CMS? Я чувствую, что должен быть более чистый способ.

Спасибо,

Брайан

Узел <default/> — это нечто, называемое «дескриптором макета». Каждый запрос в Magent генерирует несколько таких дескрипторов. Перейдите на вкладку Layout на демонстрационном сайте Commerce Bug Bug demo, чтобы получить представление о типах создаваемых дескрипторов.

Magento объединяет все XML-файлы макета в одно гигантское дерево, называемое макетом пакета. Затем дескрипторы определяют, какие фрагменты обновления XML макета используются для конкретного запроса. Эти фрагменты объединяются в макет страницы. Как вы интуитивно поняли, <default/> дескриптор всегда добавляется, вот почему вы загружаете каждый сайт в своей системе.

Плохая новость в том, что, хотя для страниц CMS есть дескриптор ( <cms_page_view /> ), это все равно будет вопросом «все или ничего». Вы могли бы добавить что-нибудь на все страницы CMS, но не на конкретные страницы CMS. Итак, раздел XML «Обновление макета» администратора CMS — это «правильный» способ сделать то, что вы хотите.

Хорошая новость в том, что вы можете воспользоваться двумя подходами, которые чище того, что вы предлагали до сих пор. Сначала вы можете немного почистить вещи, определив свой собственный дескриптор в вашем XML-файле, а затем использовать специальную команду Layout 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>
  

 <update handle="my_fancy_pants_unique_handle_name_which_doesnt_conflict_with_existing_names" />  

 <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>
  

 <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...
}