Ein Viewport ist eine spezielle Seiten-Ansicht im Shop. Die Artikeldetailseite und Kategorie-Übersicht sind zum Beispiel "Viewports". Alle Viewports können komplett individualisiert werden.

Die PHP-Dateien die die Ansicht steuern befinden sich im Verzeichnis /engine/core/class/viewports und sich komplett unverschlüsselt bzw. beliebig anpassbar. Bei zukünftigen Updates bleiben diese Dateien unberührt, so dass Sie hier eigene Anpassungen vornehmen können.

Die einzelnen Viewports verbinden die Informationen die aus dem Shopware Core kommen (zum Beispiel die Daten eines einzelnen Artikels) und übergeben diese an das hinterlegte Template. An dieser Stelle können die Daten aus der Shopware beliebig erweitert oder umgeschrieben werden.

Loggen Sie sich in Ihr Shopware Backend ein und wechseln Sie nach Einstellungen -> Grundeinstellungen -> Erweitere Systemeinstellungen -> Viewports

Erstellen Sie per Klick auf den Button "Viewport erstellen" einen neuen Viewport

Key für Aufruf: test Viewport-Klasse: s_test.php Bezeichnung: Mein Test-Viewport

Erstellen Sie die Datei /engine/core/class/viewports/s_test.php

Öffnen Sie die Datei mit Ihrem bevorzugten Editor.

Kopieren Sie folgenden Quelltext in die Datei

 
class sViewportTest{
	var $sSYSTEM;
	function sRender(){
		$variables = array(
			'sBreadcrumb' => array(
				0 => array(
					'name' => 'Test-Viewport'
				)
			),
			'sContent' => 'Hallo Welt'
		);
 
		$templates = array(
			"sContainer" => "/custom/custom_middle.tpl",
			"sContainerRight" => ""
		);
 
		return array(
			"templates" => $templates,
			"variables" => $variables
		);
	}
}	
 

Nun können Sie über die URL http://www.ihrshop.tld/shopware.php/sViewport,test den neu erstellten Viewport aufrufen und sollten die Meldung "Hallo Welt" in Ihrem Template sehen

$variables ist ein assoziatives Array, alle dort angegeben Variablen sind im Smarty Template verfügbar. Über $templates steuern Sie, welche Smarty-Templates für die jeweilige Ansicht geladen werden sollen.

Über $sSYSTEM haben Sie eine Verbindung zum gesamten Shopware-Core und können alle dort bereits bereitgestellten Funktionen, die komplette Konfiguration und alle weiteren in Zusammenhang zu Shopware stehenden Daten abfragen.

Beispiele hierfür finden Sie in den bestehenden Viewports.

Durch das Viewport-System ist die Ansicht komplett von der Programmlogik getrennt. Sie können schnell und einfach eigene Module und Seiten in den Shop integrieren, ohne das Ihre Update-Fähigkeit dadurch beeinträchtigt wird.

Um einen neuen Viewport per Link im Template zu hinterlegen, können Sie folgenden Code nutzen {$sBasefile}?sViewport=IHRVIEWPORT Shopware schreibt alle in dieser Form hinterlegten URLs automatisch um, um ein für Suchmaschinen optimales Ergebnis zu erreichen!