Doku 3: Kategorieansicht - showCategory

[FrankW]

Kategorie Ansicht - showCategory Template

(Wiederholungen die bereits erklärt wurden werden zur besseren Übersicht ausgelassen.)

Egal ob Sie sich in einer affilinet oder Shop Kategorie befinden (nicht Suche in einer Kategorie!), es wird das
Basistemplate showCategory.html verwendet.
Dieses beginnt im Templatebeispiel direkt mit einem guten Beispiel, dass Datendarstellungen aus den
Hilfstemplates auch nahezu frei in den anderen Templates verwendet werden können.
Hier werden Teile aus dem später noch erläuterten Hilfstemplate getCategoryPath.html verwendet um den
Kategorienamen bzw. den Pfad in den Metas oder dem Title Tag darzustellen.

PHP-Code:

{foreach from=$getCategoryPath_data.data item=it name=getCategoryPath_foreach}
{$it.TITLE.0.VALUE} - {/foreach} 


In den affilinet Webservice wird zu jeder Kategorie eine Pfadangabe geliefert, die im cache Ordner
/cache/getCategoryPath/ gespeichert wird.
Die eigentliche Pfadangabe zeigen wir beispielhaft im Stil einer "Sie sind hier" Anzeige im Hilfstemplate getCategoryPath.html.
{foreach bzw. abschließend {/foreach} steuern die Schleife / den Abruf der Daten aus verschiedenen Zeilen in
den XML Daten.
Der Aufbau einer solchen Schleife ist bei Interesse sehr gut in der Smarty Doku erklärt: Smarty foreach.

{foreach
from=Datenquelle
item=Elementname (meist it)
name=Name der Schleife_foreach
}
AUSGABE ({$it.TITLE.0.VALUE} - )
{/foreach}
In unserem Beispiel werden also für die jeweils aktive Kategorie die Pfadangaben automatisch von der
XML-Schnittstelle(oder dem Cache) abgerufen und die Kategorienamen der nach ausgegeben.
{$it.TITLE.0.VALUE} - = Hauptkartegoriename - Level1kategoriename - Level2kategoriename - .... - Name der
besuchten Kategorie -

Danach folgen im Template bereits bekannte Elemente, die wieder über die Config verändert
werden können:
// Kategorie Ansicht
define('AFFILINETKAT_CAT','1'); // Zeige (Seiten)Block mit Affilinet Hauptkategorien
define('GETSHOPLIST_CAT','1'); // getShopList Infos und zeige Shop Dropdown

sowie Einstellungen um die Sucheinstellung und damit die Quelldaten der XML-Schnittstelle zu verändern.
define('CAT_PAGESIZE','15'); // Produkte pro Seite
define('CAT_IMAGESIZE','2'); // Image60 & Logo90
define('CAT_ORDERBY','Price'); // Sortierung
define('CAT_ORDERDIR','1'); // Reihenfolge
define('CAT_PMIN','0'); // Mindestpreis
define('CAT_PMAX','999999'); // Maximalpreis
define('CAT_DETAIL','false'); // Zeige detailinformationen - nicht empfohlen !
define('CAT_IMAGE','false'); // nur mit Bildern = nein

Weitere Details zu den einzelnen Parametern finden Sie auch hier.
Nutzen Sie auch die Möglichkeiten sich durch andere Sortierungen, Produkte pro Seite, Preizgrenzen oder
Bildgrößen zu unterscheiden.

{include file="searchbox.html"}
{include file="news_preview.html"}
{include file="lastKeywords.html"}
{include file="affilinetMain.html"}
Die Hilfstemplates erfolgen seperat.

PHP-Code:

{if $ShopID neq 0}
{foreach from=$getShopList_data.data item=it}
{if $ShopID eq $it.ID.0.VALUE }
Sie befinden sich in der Shop Übersicht des Onlineshop: <i>{$getCategoryPath_data.ShopListTitle}</i>.<br> 
Der Shop bietet aktuell {$it.PRODUCTS.0.VALUE} Angebote in unserem Preisvergleich an. 
Das letzte Produktupdate fand am {$it.LASTUPDATE.0.VALUE} statt.
{/if}
{/foreach}
{/if} 


$ShopID ist uns ja bereits mit der gleichen Anzeige in showShop begegnet.
{if $ShopID neq 0} ist der Start einer einfachen IF-Abfrage:
Wenn die ShopID ungleich (neq) 0 ist, dann zeige / starte den nachfolgenden Code.
Im Klartext: Immer wenn die ShopID ungleich 0 ist muss es sich um eine Shopkategorie handeln, da affilinet die ShopID 0 hat!
Die gleiche Abfrage wäre theoretisch also auch mit {if $ShopID > 0} möglich.
Ebenso könnte ich theoretisch eine Anzeige für ganz bestimmte Shops realisieren:
{if $ShopID eq 0} wenn = 0 = affilinet oder {if $ShopID eq 123} wenn Shop 123 oder {if $ShopID neq 123} bei jedem Shop, nur nicht 123.

Diese IF-Schleifen können auch verknüpft bzw. mehrmals verwendet werden, sprich theoretisch kann ich in einer affilinet Kategorie ein komplett anderes Design als in den Shopkategorien verwenden bzw. diese auch weiter unterteilen, wobei das Template dann natürlich schon recht lang wird (eigene Hilfstemplates verwenden!).

Danach folgt die bereits in showShop beschriebe IF-Schleife um die in der Shopliste verfügbaren Informationen über den aktiven Shop anzuzeigen. Durch die innere IF-Schleife wäre es z.B. auch möglich ganz bestimmte Informationen aus der Shopliste abzurufen {if $it.ID.0.VALUE eq 123}.

{include file="getCategoryPath.html" }
Das Hilfstemplate wurde oben bereits kurz erwähnt und wird separat erklärt.

{include file="getCategoryList.html"}
Hier wird das gleiche Hilfstemplate wie bereits in showShop.html zur Darstellung der gezeigten Unterkategorien verwendet. Erklärung erfolgt separat.

{include file="searchProductsInCategory.html"}
Die Anzeige der Produkte einer Kategorie ist technisch nichts anderes als die gezielte Suche in einer ganzen bestimmten Kategorie nur eben ohne Suchbegriff.
Daher wird hier zur Darstellung der Produkte das Hilfstemplate searchProductsInCategory.html herangezogen, was später auch in der Suche benutzt und separat erklärt wird.
Selbstverständlich kann auch hier ein eigenes Hilfstemplate verwendet oder auch darauf verzichtet werden.

{include file="getShopList.html"}
{include file="lastVisitedProducts.html"}
{include file="footer.html"}
Bereits bekannt oder separat erklärt.

Alle Klarheiten beseitigt ?

Gruß
Frank