Dies ist eine alte Version des Dokuments!
OXID CE/PE ab Version 4.6.x bis 4.10.x
OXID EE ab Version 4.6.x bis 5.3.x
Konfiguration | Beschreibung |
Supportkey | Den Supportkey finden Sie in der E-Mail mit Ihrem Modul. Ohne Nennung dieses Keys kann Ihnen die FATCHIP GmbH keinen Support leisten. |
Verwendeter PHP-Interpreter | Hier müssen Sie den verwendeten PHP-Interpreter eintragen. Dies sind mögliche PHP-Interpreter-Pfade: /usr/bin/php /usr/bin/php_cli /usr/bin/php5 |
PHP Funktion umask | Die PHP Funktion umask (Rechtevergabe) für das Anlegen von Verzeichnissen benutzen. Hinweis: Kann bei Multithreaded-Webservern zu unerwarteten Verhalten führen! http://php.net/manual/de/function.umask.php |
Konfiguration | Beschreibung |
Im Shop eingestellte Versandkostenregelungen für Exporte übernehmen (Schwächt die Performance) | Mit dieser Option stehen Ihnen die bereits im Shop konfigurierten Versandkosten in Exporten zur Verfügung. Diese Option verlangsamt den Export und erhöht den Ressourcenverbrauch. |
Versandarten trotz Benutzer- und/oder Gruppenzuordnungen verwenden | Wenn Versandarten Benutzern oder Benutzergruppen zugeordnet sind, werden diese für Exporte normalerweise nicht berücksichtigt. Mit dieser Option erzwingen Sie die Verwendung auch solcher Regeln für die Artikelexporte. |
Versandkostenregeln trotz Benutzer- und/oder Gruppenzuordnungen verwenden | Wenn Versandkostenregeln Benutzern oder Benutzergruppen zugeordnet sind, werden diese für Exporte normalerweise nicht berücksichtigt. Mit dieser Option erzwingen Sie die Verwendung auch solcher Regeln für die Artikelexporte. |
Für Versandkostenregeln zu verwendende Benutzergruppen-Ids (Getrennt durch Komma) | In bestimmten Setups ist es unumgänglich Versandkostenregeln einzelnen Benutzergruppen zuzuordnen. Diese werden normalerweise vom Export nicht berücksichtigt. Mit dieser Option erzwingen Sie die Verwendung auch solcher Regeln für die Artikelexporte. Hier haben Sie die Möglichkeit die IDs der Benutzergruppen einzutragen, die in jedem Fall für Exporte verwendet werden sollen. Trennen Sie mehrere Angaben durch ein Komma. |
Fallback auf fixierte Lieferkosten, wenn keine Versandkostenregel greift | Es kann vorkommen, dass für bestimmte Artikel keine Versandkostenregel greift. In diesem Fall würde ein Leerfeld im Export ausgegeben. Mit dieser Option werden als Fallback die fixen Lieferkosten im Tab FC Artikelexporte > Exporte > Liefereinst. verwendet. |
Konfiguration | Beschreibung |
Aktiv | Den Export aktiv oder inaktiv schalten. |
Name | Der Name des angelegten Exportes. |
Vorlage | Die verwendete Vorlage für den Export. |
Sprache | Die Sprache die für den Export verwendet wird. |
Shop exklusive Produkte | Mit dieser Option werden nur Artikel exportiert, die ausschließlich im aktuellen Subshop (nur bei OXID EE) erhältlich sind. |
Export-Typ | In der aktuellen Version ist nur der Export in eine Datei vorgesehen. |
In der aktuellen Version ist nur der Export in eine Datei vorgesehen. | Bitte geben Sie einen Dateinamen für die zu exportierende Datei an. Bitte nur den reinen Dateinamen ohne Dateitypendung wie z. B. „.csv“ oder „.txt“ eintragen. |
ShopId an Dateiname anhängen | Mit dieser Option wird dem Dateinamen die ShopId angehangen. Hiermit können Sie ungewollte Doppelungen vermeiden. |
Dateierweiterung | Dateiendung inkl. dem führenden Punkt z. B. „.csv“ oder „.txt“. |
Encoding der Feldwerte | Wählen Sie die Kodierungseinstellung für die Exportinhalte. Möchten Sie die Daten 1:1 aus der Datenbank erhalten, wählen Sie „Kein Encoding verwenden“. |
Konvertieren unterschiedlicher Kodierungen erzwingen | Bitte wählen Sie, ob die Konvertierung bei vorhandenen Kodierungsdurcheinander erzwungen werden soll. Achtung: Die Verwendung dieser Option führt manchmal zu seltsamen Ausgaben und manchmal funktioniert sie wie erwartet. |
Datei in UTF-8 umwandeln | Mit dieser Option entscheiden Sie, ob die zu exportierende Datei in eine UTF-8 Datei konvertiert werden soll. |
Export Verzeichnis | Wählen Sie das Verzeichnis, ausgehend vom Shop-Hauptverzeichnis, in welches die Exportdatei ausgegeben werden soll. Bitte verwenden Sie hierbei den Schrägstrich („/“) am Ende Ihrer Eingabe. |
Bruttopreise verwenden | Hier können Sie einstellen ob der normale Preis als Brutto- oder Nettopreis angezeigt werden soll. |
Verwendung von Staffelpreisen | Sie können in Ihrer Exportdatei auch die Staffelpreise ausgeben lassen. Hierbei werden auch künstliche OXIDs erzeugt. |
Varianten exportieren | Mit dieser Option werden, wenn vorhanden, nur die Varianten der Artikel exportiert (keine Hauptartikel). |
Hauptartikel immer exportieren | Mit dieser Option werden die Hauptartikel immer exportiert. Auch wenn die Option „Varianten exportieren“ aktiv ist. |
Auch inaktive Artikel exportieren | Mit dieser Option werden Inaktive Artikel ebenfalls exportiert. |
Nur Artikel mit kaufbarem Lagerstatus exportieren | Es werden nur Artikel exportiert, die einen positiven Lagerbestand haben oder deren Lieferstatus auf „Fremdlager“ oder „Standard“ gesetzt wurde. |
Artikel mit Lagerstatus Fremdlager als kaufbar behandeln | Artikel mit dem Lagerstatus „Fremdlager“ werden in den Export mit einbezogen, wenn nur kaufbare Artikel exportiert werden sollen. Diese Artikel werden auch Exportiert wenn der Lagerstatus 0 oder negativ ist. |
Artikel mit Lagerstatus Standard als kaufbar behandeln | Artikel mit dem Lagerstatus „Standard“ werden in den Export mit einbezogen, wenn nur kaufbare Artikel exportiert werden sollen. Diese Artikel werden auch Exportiert wenn der Lagerstatus 0 oder negativ ist. |
Attributsvererbung | Diese Einstellung regelt das Vererbungsverhalten von Artikelattributen. Mögliche Werte sind: Keine Vererbung: Nur die Attributwerte der Kinderartikel werden verwendet. Elternwerte den Kinderwerten hinzufügen: Die Attributwerte der Elternartikel werden an denen der Kinderartikel angehangen. Doppelungen werden entfernt. Kinderwerte durch Elternwerte ersetzen: Statt der Attri-butwerte der Kinderartikel werden nur die der Elternartikel gesucht und ausgegeben. Elternwerte durch Kinderwerte ersetzen: Es werden stets die Kinderwerte bevorzugt. Nur wenn kein solcher Wert vorhanden ist, wird auf die Elternwerte zurückgegriffen. |
Konfiguration | Beschreibung |
Die teuersten Lieferkosten anzeigen | Mit dieser Option können Sie bestimmen, dass die jeweils höchsten Versandkosten exportiert werden. Bei Inaktivität werden die niedrigsten Kosten verwendet. Diese Option funktioniert nur, wenn das Feld für fest definierte Lieferkosten leer ist! |
Fest definierte Lieferkosten | Hier können Sie fest definierte Lieferkosten festlegen. Wenn in diesem Feld etwas eingetragen ist, werden damit automatisch die Werte aus der Shop-Datenbank nicht mehr genommen. |
Mindestbetrag für versandkostenfreie Lieferung | Hier können Sie den Mindestbetrag (Preis) für Artikel mit versandkostenfreier Lieferung festlegen. Um keine Artikel mit versandkostenfreier Lieferung zu generieren, tragen Sie bitte „none“ ein. |
Text für versandkostenfreie Lieferung | Hier können Sie den Text festlegen, der bei versandkostenfreier Lieferung angezeigt werden soll. Wenn in diesem Feld etwas eingetragen ist, werden damit automatisch die Werte aus der Shop-Datenbank nicht mehr genommen. |
Auf-Lager-Text | Hier können Sie den Text festlegen, der bei Artikeln die auf Lager sind, angezeigt werden soll. |
Nicht-Auf-Lager-Text | Hier können Sie den Text festlegen, der bei Artikeln die nicht auf Lager sind, angezeigt werden soll. |
Positive Lieferbarkeitsanzeige bei Lagerstatus Fremdlager ohne Bestand | Hier können Sie festlegen wie das Verhalten bei einem Bestand von Null sein soll. Wenn aktiv wird der „Auf-Lager-Text“ verwendet, ansonsten der „Nicht-Auf-Lager-Text“. |
Positive Lieferbarkeitsanzeige bei Lagerstatus Standard ohne Bestand | Hier können Sie festlegen wie das Verhalten bei einem Bestand von Null sein soll. Wenn aktiv wird der „Auf-Lager-Text“ verwendet, ansonsten der „Nicht-Auf-Lager-Text“. |
Konfiguration | Beschreibung |
Nr. | Bestimmt die Reihenfolge der Felder im Export. |
Überschrift | Der Titel (Bezeichnung) des Feldes im Export. |
Feldwert | Dynamische Datenfelder (Artikelattribute) aus denen die Werte für das Ausgabemuster genommen werden. Mit „+“ lassen sich weitere Datenfelder zum Ausgabemuster hinzufügen. |
Bedingungen | Bedingungen für alle verwendeten Feldwerte: Gleich: Der Wert muss gleich ( == ) der darauf folgenden Angabe sein. Ungleich: Der Wert muss ungleich ( != ) der darauf folgen-den Angabe sein. <>: Der Wert muss numerisch gleich ( <> ) der darauf folgenden Angabe sein. #Dopplung zu „Gleich“.# >: Der Wert muss numerisch größer ( > ) als die darauf folgende Angabe sein. <: Der Wert muss numerisch kleiner ( < ) als die darauf folgende Angabe sein. >=: Der Wert muss numerisch größer oder gleich ( >= ) der darauf folgenden Angabe sein. ⇐: Der Wert muss numerisch kleiner oder gleich ( ⇐ ) der darauf folgenden Angabe sein. Eindeutig: Der Wert darf nur einmal im Export ausgegeben werden, alle folgenden Werte werden ignoriert (unique). Mit „+“ lassen sich weitere Bedingungen zum Ausgabemuster hinzufügen. |
Standard | Rückfallwert (Fallback), wenn der Feldwert nicht vorhanden oder leer ist. |
Ausgabemuster | Dieses Feld bestimmt die endgültige Ausgabe im Export. Die dynamischen Feldwerte können in der definierten Reihenfolge durch den Platzhalter (drei Unterstriche) ausgegeben werden. Beispiel: Sie wollen die Feldwerte Hersteller und Lieferant in einem Feld ausgeben und jeweils einen Text dazwischen verwenden. Nachdem Sie die beiden Feldwerte definiert haben, können Sie die Werte wie folgt im Ausgabemuster verwenden: Hersteller: (drei Unterstriche) Lieferant: (drei Unterstriche) Nehmen wir also an, der Hersteller des Artikels heißt Musterhersteller und der Lieferant heißt Musterlieferant, so würde das im endgültigen Feed folgende Ausgabe erzeugen: Hersteller: Musterhersteller Lieferant: Musterlieferant |
Nachbearbeitung | Mit Nachbearbeitungen können Sie das endgültige Ausgabemuster noch einmal manipulieren. Derzeit stehen zwei Möglichkeiten zur Verfügung: URL enkodieren: Wandelt die Ausgabe so um, dass Sie für URLs verwendet werden kann. UTF-8 umwandeln: Wandelt das Ausgabemuster in die UTF-8 Kodierung um. |
x | Über den „x“ Button können Sie einzelne Felder löschen. |
Konfiguration | Beschreibung |
Art der Herstellerbeschränkung | Bedingungen für den Herstellerexport Whitelist: NUR die Hersteller aus der Liste werden exportiert. Blacklist: ALLE Hersteller, außer die auf der Liste werden exportiert. |
Liste der Hersteller | Über das Dropdown können Sie einzelne Hersteller zu der ausgewählten Liste hinzufügen. In diesem Dropdown werden ALLE (auch inaktive) Hersteller aus Ihrem OXID eShop angezeigt. |
x | Über den „x“ Button können Sie einzelne Hersteller wieder von der Liste löschen. |
Konfiguration | Beschreibung |
Art der Lieferantenbeschränkung | Bedingungen für den Lieferantenexport Whitelist: NUR die Lieferanten aus der Liste werden exportiert. Blacklist: ALLE Lieferanten, außer die auf der Liste werden exportiert. |
Liste der Lieferanten | Über das Dropdown können Sie einzelne Lieferanten zu der ausgewählten Liste hinzufügen. In diesem Dropdown werden ALLE (auch inaktive) Lieferanten aus Ihrem OXID eShop angezeigt. |
x | Über den „x“ Button können Sie einzelne Lieferanten wieder von der Liste löschen. |
Unter FC Artikelexporte > Exporte > Kategorien können Sie bestimmte Kategorien aus dem Export ausschließen (Blacklist) oder nur bestimmte Kategorien im Export einschließen (Whitelist).
Konfiguration | Beschreibung |
Kategorietrennzeichen | Hier können Sie festlegen wie die Kategorien bei Artikeln in Unterkategorien voneinander getrennt werden sollen. Hauptkategorie TRENNZEICHEN Unterkategorie TRENNZEICHEN … |
Art der Kategoriebeschränkung | Bedingungen für den Export der Kategorien: Keine Kategoriebeschränkung verwenden: Keine Beschränkungen für den Export der Kategorien. Nur die ausgewählten Kategorien exportieren (Whitelist): Alle Kategorien auf der Liste werden OHNE ihre Unterkategorien exportiert. Nur die ausgewählten Kategorien inkl. deren Unterkategorien exportieren: Alle Kategorien auf der Liste werden MIT ihren Unterkategorien exportiert. Alle außer den ausgewählten Kategorien exportieren (Blacklist): Alle Kategorien AUßER denen auf der Liste werden OHNE ihre Unterkategorien exportiert. Alle außer den ausgewählten Kategorien inkl. deren Unterkategorien exportieren: Alle Kategorien AUßER denen auf der Liste werden MIT ihren Unterkategorien exportiert. |
Liste der Kategorien | Über das Dropdown können Sie Kategorien und Unterkategorien zu der Liste hinzufügen. In diesem Dropdown werden ALLE (auch inaktive) Kategorien aus Ihrem OXID eShop angezeigt. |
x | Über den „x“ Button können Sie einzelne Kategorien wieder von der Liste löschen. |
Die aktuellsten Informationen hierzu erhalten Sie in der Kompatibilitätsmatrix in unserem Shop.
Ja, wir haben ein Video-Tutorial erstellt, welches die Grundfunktionen des Moduls erklärt. Das Video ist hier erreichbar.
Nach einem Update des Moduls sollte kontrolliert werden, ob es Veränderungen in den Vorlagen gab. Falls ja, ist dies im Menüpunkt Vorlagen auf Klick auf die einzelenen Vorlagen ersichtlich. Die sollten eingespielt werden um eine 100%ige Funktionalität des Artikel Exporters zu gewährleisten.
Nachdem die Vorlagenänderungen eingespielt wurden, müssen noch die einzelnen Exporte angepasst werden. Hierzu müssen die einzelnen Exporte angeklickt werden und die Änderungen eingespielt werden.
Die wichtigsten Features sind in unserem Online Shop unter Features aufgelistet. Eine FeatureRoadmap ist in unserem Online Shop verfügbar
Ja, dies ist grundsätzlich möglich. Um den Exporter zu erweitern liegt dem Paket ein Beispielplugin bei (plugins/ FatchipExporterExamplePlugin/ ). Diese bietet eine Modulvorlage für eigene Erweiterungen und ist mit Kommentaren versehen. Eine Anleitung oder Videotutorial gibt es derzeit leider nicht.
Nachfolgend noch ein paar Tipps zum Coden:
Die Variable $iCurrentIndex muss nicht zwangsläufig an die eigenen Methoden übergeben werden. Es kann stattdessen auch $this→_iArticleIndex verwendet werden.
In Ihrer Erweiterung haben Sie stets Zugriff auf bereits erzeugte Werte des aktuellen Artikels. Der Zugriff erfolgt dann mittels
$this→_aExportArticles[$this→_iArticleIndex]['FELDNAME']
FELDNAME ist dabei durch den entsprechenden Wert der Spalte Feld der hier verlinkten Tabelle zu entnehmen. Diese enthält die Entsprechungen der in der Admin-Verwaltung angezeigten Feldwerte.
Ab Version 1.9.0 steht die Variable $this→_aCurrentRow zur Verfügung, mit welcher man auf den Inhalt eines beliebigen Feldes aus der Datenbanktabelle oxarticles zugreifen kann ( $this→_aCurrentRow['TABELLENSPALTE'] ). Dadurch müssen solche Werte bei eigenen Anpassungen nicht nochmals aus der Datenbank abgefragt werden.
Ja, dies ist mit dem Artikel Exporter Modul möglich. Dazu wird ein Plugin und ein weiteres Modul benötigt, welches hier käuflich zu erwerben ist.
Die Ursache, warum keine Exporte generiert werden sind vielfältig, daher folgt hier eine Auflistung der häufigsten Probleme und deren Lösungen:
Zur Ausführung der Exporte ist die Einstellung des PHP-Interpreters von zentraler Bedeutung. Die Einstellung erreichen Sie über FATCHIP Artikelexporte→Einstellungen→Einstellungen. Der Standardwert ist hier nach der Installation usr/bin/php, da dies der auf Serversystemen übliche Ort für den PHP-Interpreter ist. Je nach Serveranbieter kann der Ort dieses Interpreters jedoch variieren und lautet z. B. /usr/local/php5/bin/php-cli. In diesem Fall müsste dieser Wert hier abgespeichert werden.
Hinweis: Wenn Sie eine Shopversion < 4.6.0 verwenden kann es sein, dass der PHP-Interpreter noch nicht abgespeichert ist. Dies muss in älteren Shops mindestens einmal initial erfolgen, auch wenn der eingestellt Interpreterpfad bereits korrekt angezeigt wird.
Den Pfad zum PHP-Interpreter kann man über einen SSH-Zugang mit dem Befehl „which php“ herausfinden.
Bitte prüfen Sie diesbezüglich den Menüpunkt FATCHIP-Artikelexporte→Systemvoraussetzungen nach roten Punkten und kontaktieren ggf. ihren Hoster.
Prüfen Sie ob das Feld Ausgabemuster bei dynamischen Feldwerten mit dem Platzhalter (drei Unterstriche) konfiguriert ist.
Bei einer OXID-Version < PE/CE 4.7/EE 5 ⇒ Der Artikel Exporter und das Artikel ExporterPlugin müssen auch im Hauptshop aktiviert sein
Bei einer OXID-Version > PE/CE 4.7/EE 5 ⇒ Das Artikel Exporter Plugin muss im Hauptshop aktiviert sein
Das Problem wird bei den Script-Laufzeiten liegen. Diese werden wahrscheinlich mit einen zu niedrigen Wert belegt sein.
Der Export wird dann durch den Server abgebrochen.
Da der Export vorzeitig abgebrochen wird, können auch die LOCK-Dateien vom Modul nicht selbst gelöscht werden.
Dies bedeutet, dass für den Artikel Exporter der Export noch läuft und die Ausführung eines neuen Exportes verhindert wird.
In diesem Fall müssen die LOCK-Dateien dann manuell gelöscht und die Laufzeit für Skripte verlängert werden.
Der Article Exporter ist für HTTPS ausgelegt. Hierfür sind lediglich die richtigen HTTPS Einstellungen in der config.inc.php nötig.
Die einfache Grundpreisausgabe erfolgt beim gewünschten Export unter Felder mit dem Feldwert „Grundpreis (mit Einheit)“. Die Export-Ausgabe wäre dann z.B. „159.00 / Stück“.
Um eine Ausgabe z.B. in dem Format „159.00 Euro / Stück“ zu erhalten stellen Sie im Export bitte folgendes ein: unter Felder beim gewünschten Export als Feldwert: „Grundpreis (Nur Zahl) wählen und als zusätzlichen Feldwert „Mengeneinheit“ hinzufügen. Beim Feld „Ausgabemuster“ wird dann „_ Euro / _“ eingetragen.
Um bei Artikeln ohne Grundpreis die Ausgabe “ Euro / „ bei den Grundpreisen zu unterdrücken können Sie ein Leerzeichen in der der Spalte Standard in der Felder-Konfiguration eintragen. Das heißt, das Leerzeichen ist die Standartausgabe, nur wenn ein Grundpreis vorhanden ist wird der Grundpreis ausgegeben (sonst eben das Leerzeichen).
Sollten Sie Hilfe von FATCHIP benötigen, schicken Sie bitte eine detaillierte Fehlerbeschreibung inkl. Plugin- und Shopversion an support@fatchip.de.