Produktexporte
| ab Version: | 3.0.5 |
Inhaltsverzeichnis
- 1 Allgemeine Informationen
- 2 Allgemeine Erklärung und Struktur der Oberfläche
- 2.1 Grundeinstellungen die für jeden Export definiert werden können:
- 3 Erweiterte Einstellungen:
- 4 Liste der verfügbaren Variablen:
- 5 Ergänzungen zu den Variablen:
- 6 Grundpreisberechnung / Grundpreisangabe:
- 7 Ausgabe Konfigurationen
Allgemeine Informationen
Mit dem Modul Produkt-Exporte können nicht nur vorhandene Exporte zu Preisportalen genutzt werden, sondern auch komplette Anbindungen an neue Marktplätze geschaffen werden. Dies ist sogar ohne Programmierkenntnisse möglich. Durch die Verwendung eines Export-Templates, welches mit Smarty-Variablen arbeitet, können so schnell Anpassungen/Erweiterungen oder neue Exporte geschaffen werden.
Durch die verschiedenen Einstellungsmöglichkeiten ist auch die Unterstützung der verschiedenen Formate gewährleistet. So können wahlweise Text-Dateien, XML-Dateien oder auch CSV-Dateien erstellt werden. Je nach Anforderung des jeweiligen Portals.
Hier finden Sie die aktuellen Templates zu einzelnen Exporten
Hinweis: Bei den meisten Portalen kann ein Link zur Exportdatei hinterlegt werden. Die Exporte werden automatisch generiert und somit erhält das jeweilige Portal bei der Abholung der Datei immer einen aktuellen Export.
Allgemeine Erklärung und Struktur der Oberfläche
Beim ersten Aufruf des Moduls erhalten Sie einen Überblick über bereits angelegte Exporte. Zusätzlich befinden sich hier die elementaren Grundfunktionen wie:
Feed hinzufügen: Um eine neue, leere Maske zu erhalten
Feed duplizieren: Markieren Sie einen vorhandenen Export. Durch Klicken auf Feed duplizieren erhalte Sie eine neue Maske, welche die exakte Kopie des gewählten Portals ist. Dieser Export kann bearbeitet werden und durch betätigen des Buttons Speichern steht Ihnen dieses Portal auch in der Übersicht zur Verfügung.
Feed editieren: Markieren Sie einen Export und wählen Feed editieren. So kann ein angelegter Export bearbeitet werden.
Feed löschen: Hiermit wird der gewählte Produkt-Export gelöscht.
Grundeinstellungen die für jeden Export definiert werden können:
Title: Name des Exports (relevant für die Bezeichnung in der Produkt-Export-Übersicht)
Dateiname: Bezeichnung der zu erstellenden Datei auf dem Server
PartnerID: Die PartnerID wird an den jeweiligen Artikellink zum Shop angehängt. Somit entsteht beim Kauf des Artikels die Zuordnung zu einem Partner. Dieses wird ebenfalls in den Statistiken berücksichtigt und macht Verkäufe zudem transparenter.
Zugriffsschlüssel: Der Zugriffschlüssel wird beim Anlegen eines neuen Produkt-Exports automatisch generiert. Dieser Schlüssel wird in die URL zur XML/CSV Datei eingebunden. Durch Ändern dieses Zugriffsschlüssels kann das Preisportal nicht mehr auf die Datei zugreifen.
Aktiv: Zum Deaktivieren des Exports
Varianten exportieren: Wahlweise können Varianten und Konfiguratorartikel vom Export ausgeschlossen werden.
Shop: Bei Verwendung von Subshops mit verschiedenen URL's/Domains wird im Export die Artikel- und Bildverlinkung angepasst
Kundengruppe: Definiert die Kundengruppe aus der die Preise entnommen werden (default: Shopkunden)
Sprache: Bei Subshop/Mehrsprachfähigkeit zu exportierende Sprache/Bezeichung
Währung: Export in den verfügbaren Währungen
Kategorie: Hiermit ist ein Export für eine bestimmte Kategorie möglich. Bei Subshop wird hier für einen gesamten Export die Hauptkategorie des jeweiligen Shops ausgewählt.
Erweiterte Einstellungen:
Formatierung:
Zeichenkodierung: standardmäßig ISO-8859-1 für CSV/TSV / UTF-8 für XML-Exporte
Dateiformat: Einstellen des akzeptierten Formats (CSV/TSV/XML)
Kopfzeile: Hier werden bei einer CSV-Datei die Spaltenbezeichnungen definiert, z.B.: id, hersteller, modell_nr, name, kategorie, preis etc. Bei einer XML-Datei befindet sich hier ebenfalls der gesamte Kopf der Datei, sowie der Start-Tag, title, description etc.. Für die Artikel erfolgt die Ausgabe unter dem Reiter Template.
Template: Definieren aller Variablen, die zum jeweiligen Artikel exportiert werden sollen. Das Template wird via Schleife auf jeden Artikel angewendet. Bei CSV/TSV-Exporten ergibt dies jeweils eine Zeile je Artikel. Bei einem XML-Export z.B. Google, ist jeder Artikel durch einen Start- und Endtag eingefasst. So ist es möglich die Exporte, ja nach Struktur und Anforderung, anzupassen.
Liste der verfügbaren Variablen:
| Konfigurationsvariablen | Beschreibung |
|---|---|
| {$sConfig.sBASEPATH} | URL zum Shop |
| {$sConfig.sSHOPNAME} | Name des Shops |
| Exporteinstellungen | Beschreibung |
|---|---|
| {$sSettings.feedID} | Eindeutige ID des Produktexportes |
| {$sSettings.name} | Produktexport-Bezeichnung |
| {$sSettings.last_export} | Datum der letzten Ausführung |
| {$sSettings.hash} | Zugriffs-Hash |
| {$sSettings.count_articles} | Artikelanzahl der letzten Ausführung |
| {$sSettings.formatID} | DateiformatID |
| {$sSettings.filename} | Dateiname |
| {$sSettings.encodingID} | ZeichenkodierungsID |
| {$sSettings.categoryID} | Hauptkategorie |
| {$sSettings.currencyID} | WährungsID |
| {$sSettings.customergroupID} | KundengruppenID |
| {$sSettings.partnerID} | PartnerID |
| {$sSettings.languageID} | SprachID |
| {$sSettings.multishopID} | ShopID |
| {$sSettings.variant_export} | Varianten exportieren |
| {$sSettings.encoding} | Zeichenkodierung |
| Filter-Einstellungen | Beschreibung |
|---|---|
| {$sSettings.active_filter} | Nur aktive Artikel |
| {$sSettings.image_filter} | Nur Artikel mit Bildern |
| {$sSettings.stockmin_filter} | Bestand kleiner Mindestbestand |
| {$sSettings.instock_filter} | Bestand kleiner |
| {$sSettings.price_filter} | Preis kleiner |
| {$sSettings.own_filter} | Eigener Filter |
| {$sSettings.count_filter} | Maximale Artikel Anzahl |
| {$sSettings.header} | Kopfzeile eigener Filter |
| {$sSettings.footer} | Fußzeile |
| {#F#} | Feldmarkierung |
| {#EF#} | Escaped-Feldmarkierung |
| {#S#} | Trennzeichen |
| {#ES#} | Escaped-Trennzeichen |
| {#L#} | Zeilentrennzeichen |
| {#EL#} | Escaped-Zeilentrennzeichen |
Folgende Variablen stehen nur im Body zur Verfügung:
Artikelvariablen
| Konfigurationsvariablen | Beschreibung |
|---|---|
| {$sArticle.articleID} | ArtikelID |
| {$sArticle.name} | Artikel-Bezeichnung |
| {$sArticle.description} | Kurzbeschreibung |
| {$sArticle.description_long} | Beschreibung |
| {$sArticle.shippingtime} | Lieferzeit (In Tagen) |
| {$sArticle.added} | Artikel hinzugefügt |
| {$sArticle.shippingfree} | Versandkostenfrei |
| {$sArticle.releasedate} | Erscheinungsdatum |
| {$sArticle.topseller} | Artikel hervorheben |
| {$sArticle.keywords} | Keywords |
| {$sArticle.minpurchase} | Mindestabnahme |
| {$sArticle.purchasesteps} | Staffelung |
| {$sArticle.maxpurchase} | Maximalabnahme |
| {$sArticle.purchaseunit} | Preis bezieht sich auf |
| {$sArticle.referenceunit} | Referenzeinheit |
| {$sArticle.taxID} | SteuerID |
| {$sArticle.supplierID} | HerstellerID |
| {$sArticle.unitID} | EinheitID |
| {$sArticle.unit_description} | Verpackungseinheit |
| {$sArticle.changed} | Datum der letzten Änderung |
| {$sArticle.active} | Artikel aktiv |
| {$sArticle.articledetailsID} | ArtikeldetailsID |
| {$sArticle.ordernumber} | Artikelnummer |
| {$sArticle.suppliernumber} | Herstellernummer |
| {$sArticle.standard} | Default-Variante |
| {$sArticle.additionaltext} | Variantentext |
| {$sArticle.impressions} | Seitenaufrufe |
| {$sArticle.sales} | Verkäufe |
| {$sArticle.instock} | Bestand |
| {$sArticle.stockmin} | Mindestbestand |
| {$sArticle.esd} | Downloadartikel |
| {$sArticle.weight} | Gewicht |
| {$sArticle.position} | Position |
| {$sArticle.attr1} bis {$sArticle.attr20} | Attribute |
| {$sArticle.supplier} | Hersteller |
| {$sArticle.unit} | Einheit |
| {$sArticle.tax} | Steuer |
| {$sArticle.image} | Artikelbild |
| {$sArticle.netprice} | Netto-Preis |
| {$sArticle.price} | Brutto-Preis |
| {$sArticle.netpseudoprice} | Netto-Pseudopreis |
| {$sArticle.pseudoprice} | Brutto-Pseudopreis |
| {$sArticle.baseprice} | Einkaufspreis |
| {$sArticle.discount} | Preisgruppen-Rabatt |
| {$sArticle.group1} bis {$sArticle.group10} | Konfigurator-Gruppenbezeichnung |
| {$sArticle.option1} bis {$sArticle.option10} | Konfigurator-Optionsbezeichnung |
{$sArticle.articleID|category:" > "|escape}
| Ausgabe der Kategorien |
Ergänzungen zu den Variablen:
| Befehl | Beschreibung |
|---|---|
| strip_tags | Herausfiltern von html-Code |
| strip | Entfernt doppelte Leerzeichen und ersetzt Zeilenumbrüche durch Leerzeichen. |
| trim | Entfernt hinter und vor dem Text überflüssige Leerzeichen |
| truncate:500 | Der Text wird auf 500 Zeichen begrenzt |
| html_entity_decode | Umwandlung der Umlaute |
| escape | Umwandlung Sonderzeichen in html, z.B. & = & |
| @shippingcosts | Berechnet die Versandkosten zum jeweiligen Artikel |
Fußzeile:
Die Fußzeile wird ausschließlich für die XML-Exporte benötigt. In diesem Feld stehen die End-Tags die in der Kopfzeile geöffnet werden. Beispiel Google:
Kategorie Filter:
In diesem Punkt wird der komplette Kategoriebaum des Shop wiedergegeben. Werden hier per Check-Box einige Kategorien angehakt, so werden diese vom Export generell ausgeschlossen.
Hersteller Filter:
Im linken Feld befindet sich eine Livesuche mit der nach Herstellern im Shop gesucht werden kann. Um Artikel eines bestimmten Herstellers vom Export auszuschließen, kann dieser per Doppelklick zur Liste der blockenden Hersteller hinzugefügt werden (rechte Liste).
Artikel Filter:
Diese Struktur ist identisch mit der unter Hersteller Filter. Hier können Sie gezielt einzelne Artikel für den Export blocken.
Weitere Filter:
Preis kleiner: z.B. 1000 Export von Artikeln mit Verkaufspreis > 1000
Bestand kleiner: z.B. 10 Export von Artikeln mit Lagerbestand > 10
Maximale Artikel Anzahl: Limitiert die Ausgabe der Artikel im Export-File
Bestand kleiner Mindestbestand: Artikel mit einem Lagerbestand, der unter dem Mindestbestand liegt, werden vom Export ausgeschlossen.
Nur aktive Artikel: Wenn angehakt, werden nur die aktiven Artikel des Shops exportiert. Außnahme sind hier Konfigurator-Artikel. Hier sind die einzelnen Konfigurationen in der Preiseingabe des Konfigurators zu deaktivieren, ansonsten werden alle möglichen Konstellationen im Export aufgeführt.
Eigene Filter: Dieses Feld setzt MySQL-Kenntnisse voraus. Hier sind z.B. folgende Einträge möglich:
at.attr6!=0 (Attribut 6 ist nicht leer)
a.topseller=1 (Exportiert nur Artikel, die im Shop hervorgehoben werden)
a.releasedate>=CURDATE() OR a.releasedate= 0000-00-00 (Artikel ist bereits erschienen)
Nur Artikel mit Bildern: Wenn aktiv, werden nur Artikel exportiert, die Bilder enthalten
Grundpreisberechnung / Grundpreisangabe:
Mit folgender Ergänzung kann der Inhalt, sowie der Grundpreis, des Artikels mit im Produkt-Export aufgeführt werden:
Kopfzeile:
Grundpreis{#S#} Inhalt{#S#}
Template:
{if $sArticle.referenceunit && $sArticle.purchaseunit} {assign var="sArticleReferenceprice" value=$sArticle.price/$sArticle.purchaseunit*$sArticle.referenceunit} {$sArticle.referenceunit} {$sArticle.unit} = {$sArticleReferenceprice|escape:"number"}{#S#} {$sArticle.purchaseunit} {$sArticle.unit}{#S#} {else} {#S#}{#S#} {/if}
Ausgabe Konfigurationen
Sie können auch die verschiedenen Variationen eines Konfigurator Artikel ausgegeben lassen. Damit die Variablen zur Verfügung stehen muss die oben beschriebene Grundeinstellung Varianten exportieren auf Varianten/Konfiguratoren stehen.
So können die Konfigurator Variablen im Produktexport verwendet werden.
| Konfigurationsvariablen | Ausgabe |
|---|---|
| {$sArticle.additionaltext} | Farbe: weiß, Größe: XXL |
| {if $sArticle.configurator}Konfigurator{else}kein Konfigurator{/if} | Konfigurator oder kein Konfigurator |
| {$sArticle.group1} | Farbe |
| {$sArticle.option1} | weiß |
Wenn Sie Konfigurator-Artikel und Varianten exportieren macht es Sinn, dass Sie den Titel des Templates erweitern. Damit nicht mehrmals der gleiche Artikelname ausgegeben wird empfehlen wir, dass Sie die Variable {$sArticle.additionaltext} hinter dem Titel im Template hinterlegen. So können Sie mit diesem Templatetext:
{$sArticle.name|strip_tags|strip|truncate:80:"...":true|escape|htmlentities} {$sArticle.additionaltext}{#S#}
folgende Ausgabe realisieren:
Nova Jacket Größe: XL, Farbe: Grün
Artikel-PDF erstellen
Weiteres zu "Produktexporte"
Artikel bewerten
Kategorien:
Bestell-Nr.: 53900__4100
Lieferzeit ca. 5 Tage
Preise inkl. gesetzlicher
MwSt. zzgl. Versandkosten*
Preise inkl. gesetzlicher
MwSt. + Versandkosten*


