Wie kann man das eBay Template individualisieren?
Was ist das eBay Template?



Für die Beschreibung seines Angebots hat man die Möglichkeit detaillierte Informationen aufzulisten. Viele Händler möchten in dem Bereich gerne eine eigene Webseite darstellen, um einen Wiedererkennungswert zu schaffen. Hierzu lassen sich die eBay Templates einsetzen.







Wie sieht das Template standardmäßig aus?



Im Standard stellt der Marketplace Connector das Template mit den Farben dar, die im Theme-Manager von Shopware hinterlegt sind. Hier ein Beispiel:









Bei eBay können keine interaktiven Elemente eingesetzt werden. Wir haben uns deswegen die Mühe gemacht, ein ansprechendes Menü und Bildgalerie zu realisieren.







Wie kann ich mir eine Vorschau des Templates anzeigen lassen?



Im Plugin gibt es den Menü-Button "Template Preview". Dort wird ein Artikel aus dem Marketplace Connector genommen und so dargestellt, wie es nach der Übermittlung zu eBay aussehen würde. Wenn Sie Ihr Browserfenster verkleinern, können Sie auch eine Mobileansicht simulieren.







Wie kann ich das Template als nicht-Entwickler individualisieren?



Es gibt im Marketplace Connector einige Attribute, die für die Darstellung des Templates zuständig sind. Diese fangen alle mit "Template" an:



Bullet PointsHier kann man Quellen hinterlegen, wo die Bullet Points (auch "Selling Points" genannt) pro Produkt gepflegt werden. Ein Beispiel ist etwa ein "Made in Germany" Bullet Point.Artikeleigenschaften auflistenHier entscheidet man, ob man die Artikeleigenschaften aus Shopware (im Beispiel die untere Tabelle) auflisten möchte oder nicht.Kategorie "Sonstige" anzeigenFalls Sie einen eBay-Store betreiben, haben Sie die Möglichkeit Kategorien daraus im Template mit aufzunehmen. Dieses Attribut ermöglicht es die Standard-Kategorie "Sonstige" auszublenden.Preis anzeigenHier entscheidet man, ob der Artikelpreis auch im Template angezeigt werden soll. Das ist z.B. wichtig für eine Mobilversion der eBay Website. Dort werden Endkunden nämlich auf eine neue Seite (das Template) weitergeleitet.



Es gibt die Möglichkeit im Footer des Templates einige Standardtexte anzuzeigen. Dort kann man z.B. rechtliche Hinweise, Zertifizierungen oder sonstiges auflisten. Dafür geht man in Shopware unter "Eigenschaften" -> "Textbausteine". Im Plugin finden Sie die entsprechende Funktion wenn Sie in der Suche "ebay_marketplace/template" eingeben.







Wie kann ich das Template als Entwickler individualisieren?



Als Entwickler hat man viele weitere Möglichkeiten der Individualisierung. Es ist dabei wichtig, dass die Quelldateien vom eBay-Plugin nicht geändert werden, da diese bei einem Plugin-Update wieder überschrieben werden. Es ist also besser ein eigenes Plugin zu entwickeln. 







LESS / CSS



Die Standard CSS-Regeln werden definiert im WebcuEbayMarketplace/Resources/views/ebay/webcu_ebay_marketplace/basic.less. 



Variablen dafür werden aus dem aktiven Theme genommen. 



Im Shopware Filter-Event WebcuEbayMarketplace_CompileLess können Sie die Liste der LESS-Dateien ändern. Dabei können Sie z.B. Ihre eigene LESS-Dateien einbinden. 



Diese Datei wird einmal generiert pro Synchronisationsverlauf und inline im eBay-Template hinzugefügt. 





public function addLessFiles(\Enlight_Event_EventArgs $args) {

    /** @var ArrayCollection $collection */
    $collection = $args->getReturn();

    $collection->add('path_to_my_less_file.less');

    return $collection;
}



HTML / Smarty Templates



Die Hauptstruktur ist definiert im Smarty-Template WebcuEbayMarketplace/Resources/views/ebay/webcu_ebay_marketplace/_structure.tplHier werden viele blocks eingesetzt, damit Sie das Template nach Bedarf ersetzen oder erweitern können. Dafür müssen Sie Ihre Template-Dateien am TemplateManager-Service von Shopware hinzufügen.



Es gibt in diesem Template ein eingeschränktes Shopware-ListProduct, woraus man die Artikeldaten lesen kann. Diese Variable heißt $ebayArticle.



{extends file="parent:ebay/webcu_ebay_marketplace/_structure.tpl"}
{block name="footer" prepend}
My footer example
{/block}



Controller



Es wird im Shopware-Event WebcuEbayMarketplace_CompileTemplate das Template-Object übermittelt, wobei Sie Variablen zuweisen und ersetzen können. 



Hier haben Sie die Möglichkeit, in der Variablen ebayArticle zusätzliche Informationen zu speichern, zu ändern oder komplett neue Variablen hinzuzufügen. Die Artikelinformationen finden Sie dort. Anhand der Id und VariantId können Sie Informationen aus der Datenbank nachladen. 





$tpl->assign('myVariable', 150);