Magento – Inserting a block in a CMS page between content heading and content

blockscmsxml

I am trying to add a custom block on all CMS pages after the page's Content Heading but before the page's Content.

For reference, this is what is in my theme's layout/cms.xml, I haven't touched it:

<cms_page translate="label">
    <label>CMS Pages (All)</label>
    <reference name="content">
        <block type="core/template" name="page_content_heading" template="cms/content_heading.phtml"/>
        <block type="page/html_wrapper" name="cms.wrapper" translate="label">
            <label>CMS Content Wrapper</label>
            <action method="setElementClass"><value>std</value></action>
            <block type="cms/page" name="cms_page"/>
        </block>
    </reference>
</cms_page>

The content of cms/content_heading.phtml is just this (the heading, as expected), again, haven't touched it:

<?php if($_heading = $this->getContentHeading()): ?>
    <div class="page-title">
        <h1><?php echo $_heading; ?></h1>
    </div>
<?php endif; ?>

In my local.xml file, I am adding this:

<default>
    <reference name="content">
        <block type="core/template" name="my.new.block" after="page_content_heading" template="callouts/my_new_block.phtml" />
    </reference>
</default>

This is putting the block below the Content Heading AND the Content of the page.

I have also tried this (adding "before" tag):

<default>
    <reference name="content">
        <block type="core/template" name="my.new.block" before="cms_wrapper" after="page_content_heading" template="callouts/my_new_block.phtml" />
    </reference>
</default>

This is the same as above.

What am I missing? Thanks very much for any help.

(FYI, I am flushing my cache regularly. I'm using Magento 1.8.1)

Best Answer

Have you tried adding a root block between label and content? As follows:

<reference name="root">
    <block type="core/template" name="my_header" as="my_header" template="cms/default/my_header.phtml" />
</reference>

So, for clarity:

<cms_page translate="label">
    <label>CMS Pages (All)</label>
    <!-- ROOT BLOCK HERE -->
    <reference name="content">
        ....
    </reference>
</cms_page>

This block can be called in the view using getChildHtml('my_header').

Related Solutions

Magento – Adding a custom block to the cms home page

I think there are two issues here. For one, the type or class on your block might be wrong and second, the name should be unique.

<block type="core/text_list" name="content" as="content" translate="label">
 <label>Main Content Area</label>
 <block type="core/template" name="some_random_name" template="cms/default/home.phtml"/>
</block>

Magento – How to Change the Design for a Single CMS Page Content Heading

You already got it, "page_content_heading". You just need to reference it rather than adding it over again

<reference name="page_content_heading">
    <action method="setTemplate"><template>cms/headers/custom.phtml</template></action>
</reference>

On a similar topic, if you're literally just looking to add a class to the file, may I recommend using the original template file (copied to your theme of course) and adding the class conditionally.

Somewhere in your template file:

<?php if ($this->getData('added_class')): ?><?php echo $this->getData('added_class') ?><?php endif ?>

Then, you can add whatever class you want with a XML layout update:

<reference name="page_content_heading">
    <action method="setData"><key>added_class</key><val>YOUR_CLASS_NAME</val></action>
</reference>

That way you don't need to have a whole bunch of different .phtml files for the same purpose should you need to start adding different classes per CMS page.

On ANOTHER note... you could just add a class to the body tag without the need to customize any view script.

<reference name="root">
    <action method="addBodyClass"><class>YOU_CLASS_NAME</class></action>
</reference>

Then in your CSS file target the page header using the body class as well:

.YOUR_BODY_CLASS .page-title h1{/* style rules */}

Best Answer

Related Solutions

Magento – Adding a custom block to the cms home page

Magento – How to Change the Design for a Single CMS Page Content Heading

Related Topic