Ändern einer Template-Datei

Am einfachsten lassen sich Template-Änderungen durch eigene Themes erreichen. Durch Layout-Updates ist es aber möglich, Änderungen in Modulen zu kapseln, sodass sie unabhängig vom jeweiligen Theme eines Shops funktionieren.

Möchten Sie beispielsweise das Template für Cross-Sell-Produkte durch eine Variante mit einem animierten Slider ersetzen, lohnt es sich, dies in einem Modul zu bündeln, um es immer wieder verwenden oder verkaufen zu können.

Ein Modul sollte keine Core-Template-Dateien ersetzen, deswegen erstellen Sie dafür ein neues Template unter „app/design/frontend/default/default/template/meinmodul/checkout/crosssell.phtml“. Durch den folgenden Code in einer Layout-Datei wird das standardmäßige Cross-Sell-Template durch ein eigenes ersetzt:

<layout version="0.1.0">
	<checkout_cart_index>
		<reference name="checkout.cart.crosssell">
			<action method="setTemplate">
				<template>meinmodul/checkout/crosssell.phtml</template>
			</action>
		</refererence>
	</checkout_cart_index>
</layout>

Position von Blöcken ändern

Ein klassisches Beispiel: Der Mini-Warenkorb soll in der linken statt in der rechten Spalte dargestellt werden. Dazu können Sie eine besondere Eigenschaft des Blocktyps „core/text_list“ nutzen, der für die linke und rechte Spalte verwendet wird. Diese Blockklasse ist eine der wenigen, die kein Template zum Rendern der Ausgaben nutzt, sondern alle Child-Blöcke der Reihe nach ausgibt. Wenn ein Blocktyp, der ein Template zur Ausgabe benutzt, verwendet wird, dann muss in der Template-Datei die Anzeige des Child-Blocks mit „echo $this->getChildHtml('cart_sidebar')“ eingefügt werden. Bei „core/text_list“-Blöcken ist das nicht nötig.

Das Ziel, den Sidebar-Warenkorb zu verschieben, kann auf verschiedene Arten erreicht werden. Der einfachste Weg ist es, die Datei „checkout.xml“ in das Themeverzeichnis zu kopieren und nur eine Zeile zu verändern:

<layout version="0.1.0">
	<default>
		...
		<!--Vorher: --><!--<reference name="right">-->
		<!-- Nachher: --><reference name="left">
			<block type="checkout/cart_sidebar" name="cart_sidebar"
template="checkout/cart/sidebar.phtml" before="-">
			...
			</block>
		</reference>
		...
	</default>
</layout>

Das Gleiche können Sie auch durch eine eigene Layout-Datei erreichen:

<layout version="0.1.0">
	<default>
		<reference name="right">

			<!-- Entfernen des Blocks in der rechten Spalte -->
			<action method="unsetChild"><name>cart_sidebar</name></action>
		</reference>
		<reference name="left">

			<!-- Einfügen des Block in der linken Spalte -->
			<block type="checkout/cart_sidebar" name="cart_sidebar" template="checkout/cart/sidebar.phtml" before="-">
				...
				<!-- hier Parameter übernehmen aus checkout.xml -->
			</block>
		</reference>
	</default>
</layout>

Blöcke hinzufügen oder entfernen

Es ist einfach, neue Inhaltsblöcke anzuzeigen. Einen CMS-Block mit dem Bezeichner „mein_cms_block“ in der rechten Spalte erreichen Sie mit folgendem Code:

<layout version="0.1.0">
	<default>
		<reference name="right">
				<block type="cms/block" name="callout2">
					<action method="setBlockId"><block_id>mein_cms_block</block_id></action>
				</block>
		</reference>
	</default>
</layout>

Um den gleichen Code im Contentbereich anzuzeigen, müssen Sie nur das <reference name="right"> gegen ein <reference name="content"> austauschen. Zur Ausgabe fügen Sie ein „echo $this->getChildHtml('callout2')“ an der gewünschten Stelle des Templates ein.

Eigene Datei-Templates hinzuzufügen (im Unterschied zu CMS-Blöcken), ist sogar noch einfacher:

<layout version="0.1.0">
	<!-- Layout Update Handle für alle Kunden-Profilseiten: -->
	<customer_account>
		<reference name="footer">
			<block type="core/template" name="callout3" template=“callouts/meinblock.phtml“/>
		</reference>
	</customer_account>
</layout>

Blöcke entfernen können Sie auf zwei Arten:

<layout version="0.1.0">
	<catalog_category_default>

		<!-- Variante 1: -->
		<reference name="right">
			<action method="unsetChild"><name>right.permanent.callout</name></action>
		</reference>

		<!-- Variante 2: -->
		<remove name="right.permanent.callout" />
	</catalog_category_default>
</layout>

Die erste Variante erzeugt leider eine Fehlermeldung, wenn ein Block mehr als einmal auf diese Art innerhalb eines Layout-Updates entfernt wird.

Das Aufrufen von Methoden einer Blockklasse via Layout-XML wird häufig benutzt, um Links zur Top-Navigation oder der Navigation im Kundenkonto hinzuzufügen:

<layout version="0.1.0">
	<customer_logged_in>
		<reference name="top.links">
			<action method="addLink">
			<label>Spezialangebote</label>
			<path>angebote</path>
			<title>Spezialangebote</title>
			<prepare/>
			<urlParams/>
			<position>300</position>
		</action>
		</reference>
	</customer_logged_in>
</layout>

Die Namen der Tags im <action>-Element haben keine Relevanz – lediglich die Reihenfolge wird ausgewertet. Es lassen sich nur skalare Typen übergeben, keine komplexen Werte wie beispielsweise Arrays oder Objekte.