add 5.0.3.0 (ionCube for PHP 7.1 - 7.2)

composer.json

@@ -0,0 +1,42 @@
+{
+  "name": "d3/importer",
+  "description": "Importer for OXID eShop.",
+  "type": "oxideshop-module",
+  "keywords": [
+    "oxid",
+    "modules",
+    "eShop",
+    "d3",
+    "import",
+    "csv"
+  ],
+  "authors": [
+    {
+        "name": "D3 Data Development (Inh. Thomas Dartsch)",
+        "email": "info@shopmodule.com",
+        "homepage": "http://www.d3data.de",
+        "role": "Owner"
+    }
+  ],
+  "homepage": "https://www.oxidmodule.com/",
+  "license": [
+    "proprietary"
+  ],
+  "extra": {
+    "oxideshop": {
+      "source-directory": "/src",
+      "target-directory": "d3/importer"
+    }
+  },
+  "require": {
+    "php": "7.1 - 7.2", "ext-ionCube-Loader": "*",
+    "oxid-esales/oxideshop-metapackage-ce": "~6.0.0 || ~6.1.0 || 6.2.0-beta.1 || 6.2.0-rc.1",
+    "d3/modcfg": "^5.2.0.000"
+  },
+  "suggest": {
+    "d3/importer-demodata": "demodata files for testing purposes"
+  },
+  "require-dev": {
+    "mikey179/vfsstream": "^1.4"
+  }
+}

docs/daux/_index.md

@@ -0,0 +1,2 @@
+Weitere Informationen zum Modul **{$modulename}** finden Sie in unserem Shop:
+[https://www.oxidmodule.com](https://www.oxidmodule.com/OXID-eShop/Module/Importer-fuer-Oxid-EE-Import-Modul.html)

docs/daux/assets/files/exportlisteninhalt.csv

@@ -0,0 +1,2 @@
+Artikelnummer;Titel;Langbeschreibung;Suchbegriffe;Preis;Kategorie;Varianten Name;Hersteller
+1402;Trapez ION MADTRIXX;Langtext;harness, hip harness, madtrixx;45,00 €;1208|1302|1303|1304|1401;6454;Beispielhersteller

docs/daux/changelog/010_Changelog.md

@@ -0,0 +1,404 @@
+---
+title: Changelog
+---
+
+## 5.0.3.0 - (2020-02-07)
+
+### Added
+- Composer installation supported
+
+### Changed
+- documentation adjusted
+
+### fixed
+- 0000000: external picture import runs endlessly when importing 10 or more images  
+
+---
+
+## 5.0.2.0
+- 0001991: Neue Option - Bilder im Importverzeichnis löschen, verschieben
+- 0002805: neue Bildimportoption "Master Bilder am Artikel erst löschen, dann importieren"
+- 0002002: Alle Update Checkboxen an/abwählen
+- 0007825: Mall Tab erlaubt keine Leer Möglichkeit
+- 0000000: [fixed] category import add's a relationship with oxrootid if column is empty
+- 0000000: refactored \d3_importer_Application_Models_Models_Import_Article::setUpdate
+- 0000000: refactored \d3_importer_Application_Models_Models_Import_Article::setInsert
+- 0000000: added methods in class \d3_importer_Application_Models_Models_Import_Article: setArticleOxid, setRemindActiveFlag, addPriceFields
+- 0000000: refactored collector -> moved methods to importService: getCsvLines, addOxidToCSVData
+- 0000000: added class \d3_importer_Application_Models_Service_Import and modified constructor of \d3_importer_Application_Models_Interface_Import + \d3_importer_Application_Models_ImportAbstract
+- 0000000: refactored import models > moved method's getArticleRecords into \d3_importer_Application_Models_Collector;
+         the \d3_importer_Application_Models_Collector assign's oxid's, if they are present in the database
+- 0000000: added abstract class \d3_importer_Application_Models_ImportAbstract for future refactorings in import models
+- 0000000: added interface \d3_importer_Application_Models_Interface_Import for future refactorings in import models
+- 0000000: refactored moved method \d3_importer_Application_Models_Models_Import_Accessories::getImportFields \d3_importer_Application_Controller_Import_Article::getImportFields
+- 0000000: refactored moved method \d3_importer_Application_Models_Models_Import_Article::getImportFields \d3_importer_Application_Controller_Import_Article::getImportFields
+- 0000000: refactored moved method \d3_importer_Application_Models_Models_Import_Attributes::getImportFields \d3_importer_Application_Controller_Import_Article::getImportFields
+- 0000000: refactored moved method \d3_importer_Application_Models_Models_Import_Category::getImportFields \d3_importer_Application_Controller_Import_Article::getImportFields
+- 0000000: refactored moved method \d3_importer_Application_Models_Models_Import_Crossselling::getImportFields \d3_importer_Application_Controller_Import_Article::getImportFields
+- 0000000: refactored moved method \d3_importer_Application_Models_Models_Import_Mall::getImportFields \d3_importer_Application_Controller_Import_Article::getImportFields
+- 0000000: refactored moved method \d3_importer_Application_Models_Models_Import_Manufacturer::getImportFields \d3_importer_Application_Controller_Import_Article::getImportFields
+- 0000000: refactored moved method \d3_importer_Application_Models_Models_Import_Price2Article::getImportFields \d3_importer_Application_Controller_Import_Article::getImportFields
+- 0000000: refactored moved method \d3_importer_Application_Models_Models_Import_Selectlist::getImportFields \d3_importer_Application_Controller_Import_Article::getImportFields
+- 0000000: refactored moved method \d3_importer_Application_Models_Models_Import_Vendor::getImportFields \d3_importer_Application_Controller_Import_Article::getImportFields
+- 0000000: refactored variable names in \d3_importer_Application_Controller_Import_Article::getImportFields
+
+---
+
+## 5.0.1.1
+- 0008260: make it possible to import d3 content tabs fields
+- 0008033: longdesc couldn't imported into variants
+- 0000000: optical changes in picture import
+- 0006221: articlefields will not translated into english
+
+---
+
+## 5.0.1.0
+- 0007694: v6 after import "delete/deactivate articles" doesn't work
+- 0007613: "deactivate articles" overwrite values in table oxarticles
+- 0007733: import scale prices absolute or percentally
+- 0007759: crossselling and accessories works partially
+- 0004280: verify EE compatibility
+- 0000000: update demo importprofile + csv data
+
+---
+
+## 5.0.0.1
+
+### added
+- 0000000: added exception empty if profile is empty
+
+### changed
+- 0000000: refactored template methods to template variables (templates d3_importer_main.tpl + erromessages.tpl)
+- 0000000: closed resource handle
+- 0000000: solved inspection code - results
+- 0000000: reset metadata module id to d3importer
+- 0000000: improve code (use getOne instead of getAll, reduced code)
+- 0000000: replaced execute to getAll while using select query in category model
+- 0000000: replaced select to delete query in deleteArticleAssign method in Selectlist model
+- 0000000: removed unused deleteArticleAssign in vendor model
+- 0000000: corrected some germans typo's
+- 0000000: added notice for category import
+
+### fixed
+- 0000000: handling in d3_importer_cron.php doesn't work
+- 0000000: importer fields in frontend (admin)
+- 0000000: after import ticker
+- 0006856: pictureimport: checkboxes will not saved
+
+---
+
+## 5.0.0.0
+
+**Minor version upgrade notice: there are some backward-incompatible changes to this release.**
+
+- 0005803: upgrade to oxid eShop version 6.0.0.0
+- 0000000: drop support of oxid eShop version 4.10.x / 5.3.x
+
+---
+
+## 4.5.0.0
+
+**Minor version upgrade notice: there are some backward-incompatible changes to this release.**
+
+- 0000000: Modul wurde grundlegend überarbeitet
+- 0006523: Zeitstempel und weitere Informationen im Cronjob hinzugefügt
+- 0002014: nur EE: Profile in anderen Subshops ausblenden
+- 0004280: EE testen und anpassen - Zuweisung Artikel
+- 0006371: Textinfo "Pflicht...Artikelnummer" ist falsch
+- 0000000: Leerwert für Artikelidentifikation hinzugefügt
+- 0000000: Fehler in den "ja"/"nein" Definition behoben
+- 0000000: Button für den Bilderimport hinzugefügt
+- 0000000: Mall Tab nutzt Formularbuilder
+- 0000000: Altes Attributshandling wurde entfernt
+
+---
+
+## 4.4.2.0
+- 0004766: Überarbeitung der automatischen Installation
+- 0004836: Tags werden beim Importvorgang gekürzt
+- 0000000: 4.8.x/5.1.x wird nicht mehr unterstützt
+- 0000000: unbenutzte Felder im Code entfernt
+- 0000000: Sprachidents für d3importpic13-20 hinzugefügt
+- 0005377: d3importerdesc editierbar machen
+- 0005378: Felder für D3 Content Tabs im Importer aufnehmen
+- 0004705: Zeilenumbrüche werden nicht erkannt v4.4.1.6
+- 0004657: oxid als "Auswahl für Artikelidentifikationsfelder" nicht möglich
+- 0004876: Leere Attribute werden angelegt
+- 0004870: Import von Attributen: EE - Handling
+- 0004487: nur 12 Bilder (bis oxpic12) statt 20 können beim Bilderimport verwendet werden
+- 0004771: Navigation speichert Profil ab
+- 0004506: doppelte Kategorien, Hersteller und Lieferanten bei Subsprache
+
+---
+
+## 4.4.1.6
+- 0003728: seo URl's werden bei der Einstellung "Artikel-Kat.-Zuordnungen vorher löschen" nicht gelöscht
+- 0003724: oxremindactive wird nicht aktualisiert
+
+---
+
+## 4.4.1.5
+- 0003570: Vordefinierte Werte funktionieren nicht.
+- 0003572: Fehlerhafte Zählung der aktualisierten Artikel im CronJob
+- 0003681: min. Connector - Version auf 4.3.1.2 setzen
+- 0003624: Hinweise deutlich sichtbarer, wenn eine Demolizenz benutzt wird
+- 0003643: Templates durch Blöcke erweitern
+
+---
+
+## 4.4.1.4
+- Aufteilung der automatischen Installation
+- Strukturänderung: Datei für das automatische Update von models nach setup verschoben
+- fehlende Übersetzungen nachgetragen
+- Hilfe-Link korrigiert
+- Korrektur der automatischen Installation, Übernahme des bereits hinterlegten Lizenzschlüssels
+
+---
+
+## 4.4.1.3
+- Korrektur des Imports von Tags
+- Korrektur zu Kategoriezuweisungen welche nicht übernommen wurden
+- Fehler im Admin behoben - die erste CSV-Spalte konnte in der Kategoriezuweisung nicht abgespeichert werden.
+- Korrektur dass alle Bilder beim Aufruf via Cronjob abgearbeitet werden
+
+---
+
+## 4.4.1.2
+- Inkompatibilität mit 4.9.0 behoben
+- Hilfetext bei Auswahllisten korrigiert
+- Fehler bei noch nicht gespeicherten Grundeinstellungen behoben
+- Fehler im Cronjob behoben - Update entfernt Nachkommastellen bei Preisen mit , (Hinweis: der Cronjob nutzt nun den Admin Modus)
+
+---
+
+## 4.4.1.1
+- d3importflag von enum zu varchar(32) umgeändert
+- Bugfix: Attribute wurden nicht importiert
+- Demoprofil aktualisiert
+
+---
+
+## 4.4.1.0
+- neue mehrsprachige Attributszuordnungen inkl. Fallback
+- Bugfix: im Demomodus werden Profile nicht mehr gespeichert, wenn die maximale Anzahl der Profile erreicht ist
+- Wenn das Modul inaktiv ist, werden die Formulare gesperrt
+- technische Verbesserungen im Quellcode
+
+---
+
+## 4.4.0.2
+- Bugfix: Bilder mit Umlauten werden nicht importiert
+- Bugfix: Bei einem Update werden Preise mit , abgeschnitten
+- Neue Grundeinstellung "Auswahl für Kategorieidentifikationsfelder"
+- Bugfix: Import einer Kategorie ohne Namen, sobald ein Trennzeichen an letzter Stelle steht: "Kat1,Kat2,Kat3,"
+- Bugfix: Bilder mit Sonderzeichen werden nicht importiert
+
+---
+
+## 4.4.0.1
+- Bugfix: defekte XML Profile (Importer < 4.4.0.0) werden nicht migriert
+- Bugfix: wenn MwSt leer importiert wird, wird nun null statt 0 geschrieben
+- Bugfix: Export von Profilen korrigiert
+- Beispiele von Conjob Shell Dateien für Profihost.com Server erweitert
+
+---
+
+## 4.4.0.0
+- Neues Feature Grundeinstellungen
+- Neuer Menüpunkt Logging
+- Neue Einstellungen für den Bilderimport
+- technische Verbesserung im Admin
+- Anzahl der Bilder wird aus der Shopconfiguration ausgelesen
+- Logging "externe Bilder einlesen" implementiert
+- Große CSV-Dateien werden im Admin performanter ausgelesen
+- Auslagerung der Hilfetexte im Admin in ? - Boxen
+- Übernahme der Importer-Smarty-Datei in das Modulverzeichnis
+- externe Bilder werden anhand der Profil ID eingelesen
+- Grosschreibung der Endung von CSV- / TXT-Dateien ermöglichen
+- Bugfix: letzte Zeile der Importdatei importieren
+
+---
+
+## 4.3.3.1
+- Update der precheck.php
+
+---
+
+## 4.3.3.0
+- Zurücksetzen der Artikelanzahl in Kategorien, Lieferanten und Hersteller
+- Bugfix für 4.8.3
+- Bugfix PHP 5.4-Kompatibilität hergestellt
+- Bugfix nach Anlegen eines neuen Profils war das Profil nicht ausgewählt
+- Bugfix Dateinamen für den Bilderimport auf 128 Zeichen (wie oxid Standard) festgelegt
+- Testprofil und CSV Dateien wurden hinzugefügt
+
+---
+
+## 4.3.2.4
+- Bugfix im Bilderimport, lediglich ein Bild wurde importiert
+
+---
+
+## 4.3.2.3
+- Bugfix in der Demoversion beim Bearbeiten der Bilder
+
+---
+
+## 4.3.2.2
+- PHP 5.4-Kompatibilität hergestellt
+
+---
+
+## 4.3.2.1
+- Call By References entfernt (PHP 5.4-Kompatibilität)
+- Installationsfehler korrigiert
+
+---
+
+## 4.3.2.0
+- Fehlermeldungen beim laden der Konfiguration werden abgefangen und unter [Importer]->[Einstellungen]->[Stamm] ausgegeben
+- simple Exportfunktion für Importprofile unter [Importer]->[Einstellungen]->[Stamm] hinzugefügt (SQL basierend)
+- Bugfix beim Speichern von Dateinamen mit Umlauten
+- Bugfix Auslesen nicht zugeordneter Felder (im Tab Artikelfelder) verursachte einen Fatal Error
+- Bugfix automatische Installation
+
+---
+
+## 4.3.1.2
+- Bugfix beim Einlesen der zu importierenden Bilder behoben (Admin fand nur 1 Bild)
+
+---
+
+## 4.3.1.1
+- Bugfix bei Import von Kategorien, welche nicht "via Name" importiert werden
+
+---
+
+## 4.3.1.0
+- automatische Installation eingefügt
+- Aktivierung durch Seriennummern
+
+---
+
+## 4.3.0.0
+- komplette Überarbeitung des Moduls für die neue Shopstruktur des OXID eShop 4.7/5.0
+
+---
+
+## 4.2.5.1
+- Modulversionsnummer und Vorschaubild im Admin korrigiert
+
+---
+
+## 4.2.5
+- Integration der Profil-ID bei bearbeiteten Artikeln. Damit Möglichkeit den "Nach Import" auf die vom Profil betroffenen Artikeln zu beschränken
+- Erweiterung des externen Bilderimports um Fehlerbehandlung und Bildtypprüfung
+  - Änderung des Downloadverfahrens auf Curl für ein besseres Fehlerhandling
+  - Der externe Bilderimport geht nun nicht mehr in eine Endlosschleife wenn ungültige Urls importiert wurden
+
+---
+
+## 4.2.4
+- Nötige Änderungen für Shopversion 4.6.0 eingebaut
+- Support für Shopversionen < 4.2.0 entfernt
+- Install-Doku überarbeitet
+
+---
+
+## 4.2.3
+- Fehler beim Zuordnen mehrerer Artikelbilder über verschiedene Bildslots zu einem Artikel behoben (Shopversion < 4.5.0)
+- kein Update der Langtexte bei älteren Shopversionen
+
+---
+
+## 4.2.2
+- Zusammenfassen bisheriger Bugfixes
+- fehlende Bildslots in Shopversion < 4.5.0
+
+---
+
+## 4.2.1
+- "Nach Import" konnte nicht korrekt gestartet werden
+- Neuer Menüpunkt "Einstellungen" zur besseren Kontrolle der Modulversion
+- Optimierung des Importvorgangs durch Indizierung  diverser DB-Felder
+- Button "Neues Importprofil"
+- In älteren Template-Versionen wurden veraltete Smartyvariablen korrigiert
+- ModId angepasst
+
+---
+
+## 4.2.0
+- Einbau eines Import-cronjobs
+- Überarbeitung diverser Moduldateien für die cronjob-Funktionalität
+
+---
+
+## 4.1.7
+- Fehler beim Bilderimport behoben. Pro Bilderimport konnte immer nur 1 Bild pro Artikel importiert werden
+
+---
+
+## 4.1.6
+- Neue Bildstruktur ab 4.5.1 wird nun unterstützt
+- ggf. vorhandene weitere Datenbankfelder in oxartextends können nun importiert werden (longdesc2 etc.)
+
+---
+
+## 4.1.5
+- Engl. Sprachkomponenten eingefügt
+- Bugfix mit Langtexten und Varianten behoben
+
+---
+
+## 4.1.4
+- OXID 4.5: Probleme mit Einlesen von Datenfeldern aus oxarticles und oxartextends behoben
+- OXID 4.5: Lupenfunktion auf der Artikeldetailseite funktioniert nun wieder
+
+---
+
+## 4.1.3
+- OXID 4.5.0: nötige Templateanpassungen (Smartyvariablen) durchgeführt
+- OXID 4.5.0: getAbsDynImageDir() wurde von OXID entfernt
+- OXID 4.5.0: Probleme mit Bilderweiterungen "_pX" z.B. "bild_p1.jpg" auf der Detailseite. Generierte Bilder erhalten darum nun keine Extension mehr z.B. "bild.jpg"
+- trim() auf Einzelwerte der Kategorienamen
+- Problem mit Mehrsprachigkeit behoben
+- einfaches Profiling eingebaut
+
+---
+
+## 4.1.2
+- Fehler mit den Zoombildern gefixt
+- Einbau des externen Bilderimports (Bild liegt in einer externen Url)
+
+---
+
+## 4.1.1
+- oxTags werden nun beim Import unterstützt
+- "list"-Templates nuntzen nun die globalen JS-Funktionen wie editThis etc.
+- Problem mit fehlendenden oxartextends Einträgen behoben (Artikel-oxId wurde mit NULL aus oxartextends überschrieben)
+- Standard-Datenfelder (oxactive etc.) werden jetzt nur noch mit Standrad-Werten befüllt, wenn die Felder nicht explizit über Importspalten belegt werden
+- "sZoomImageSize" wird nun als globale Zoombildgröße genutzt (seit OXID 4.3.0)
+- "oxpicsgenerated" wird nun generell auf "12" gesetzt (seit OXID 4.3.0)
+- Aktualisierung der language-Datei und der Tabelle "oximporterdesc"
+
+---
+
+## 4.1
+- kompletter UTF8 Support für Importdateien und Shop
+- optionaler Texttrenner in der CSV, so dass auch HTML-Langtexte mit Zeilenumbrüchen korrekt importiert werden
+- Korrektur der Zeilenanzahl bei CSV-Inhalten, die über mehrere Dateizeilen gehen (z.B. HTML-Daten)
+- Wird die Importdatei z.B. per FTP aktualisiert, so erkennt das Modul nun automatisch im Reiter "Stamm" die geänderten Dateiwerte
+- Lieferanten integriert
+- Staffelpreise integriert
+- Auswahllisten integriert
+- Kurzinfo nach Import
+- Löschmöglichkeit nach dem Import
+- Übersetzung für oxarticles-Felder in lang.php hinzugefügt
+- copy_this ab OXID 4.1.4 (nötige Templateänderungen) hinzugefügt
+- Importe mit mehr als einer Kategoriespalte schlugen fehl
+- diverse kleinere Bugfixes
+
+---
+
+## 4.0
+- Komplette Migration des Moduls auf OXID4.

docs/daux/config.json

@@ -0,0 +1,72 @@
+{
+    "title": "<i class='fab fa-d3 d3fa-color-blue'></i> Importer",
+    "moduleversion": "5.0.3.0",
+    "titledesc": "für den Oxid eShop",
+    "author": "D³ Data Development",
+    "moduledate": "07.02.2020",
+    "editors": "KH, DS",
+    "tagline": "",
+    "image": "",
+    "ignore": {
+        "files": [],
+        "folders": [".idea"]
+    },
+    "live": {
+        "clean_urls": true
+    },
+    "html": {
+        "theme": "d3",
+        "breadcrumbs": true,
+        "breadcrumb_separator": "Chevrons",
+        "toggle_code": false,
+        "date_modified": true,
+        "date_modified_format": "d.m.Y",
+        "float": false,
+        "inherit_index": true,
+        "auto_landing": true,
+
+        "links": {
+            "Shop": "https://www.oxidmodule.com"
+        },
+
+        "powered_by": ""
+    },
+    "languages": {
+        "installation": "Installation",
+        "manual": "Handbuch",
+        "changelog": "Changelog",
+        "support": "Support"
+    },
+    "processor": "d3processor",
+    "language": "de",
+    "strings": {
+        "de": {
+            "CodeBlocks_title": "Code-Blöcke",
+            "CodeBlocks_hide": "Aus",
+            "CodeBlocks_below": "Unterhalb",
+            "CodeBlocks_inline": "Linear",
+            "CodeBlocks_show": "Code-Blöcke anzeigen",
+            "Search_placeholder": "Suchen...",
+            "Link_previous": "Zurück",
+            "Link_next": "Weiter",
+            "Edit_on": "Bearbeiten bei :name:",
+            "View_on_github": "Bei GitHub anzeigen",
+            "View_documentation": "Dokumentation anzeigen",
+            "Table_of_contents": "Inhaltsverzeichnis",
+            "author": "Autor",
+            "moduledate": "Stand",
+            "version": "Version",
+            "editors": "Bearbeiter",
+            "selectversion": "Version wechseln"
+        }
+    },
+    "variables": {
+        "modulename"    : "<i class='fab fa-d3 d3fa-color-blue'></i> Importer",
+        "menutitle"     : "Importer",
+        "modulefolder"  : "d3/importer",
+        "modcfgident"   : "d3importer",
+        "composerident" : "d3/importer"
+    },
+    "versionselector": false,
+    "versiondirectoryindex": 2
+}

docs/daux/installation/002_Installation.md

@@ -0,0 +1,10 @@
+---
+title: Installation / Update / Deinstallation
+---
+
+* [Anforderungen](installation/010_Anforderungen/010_Systemanforderungen.md)
+* [Neuinstallation](installation/020_Neuinstallation/005_Vorbereitung.md)
+* [Update](installation/030_Update/005_Updatedefinition.md)
+* [Deinstallation](installation/060_Deinstallation/010_Modulerweiterungen_deaktivieren_und_entfernen.md)
+
+Bei Bedarf bieten wir Ihnen auch gern die Installation des Moduls in Ihrem Shop an. Geben Sie uns bitte unter den unter [Hilfe und Support](support/010_Hilfe-und-Support.md) genannten Kontaktdaten Bescheid.

docs/daux/installation/010_Anforderungen/010_Systemanforderungen.md

@@ -0,0 +1,23 @@
+---
+title: Systemanforderungen
+---
+
+* PHP Version
+    * 5.6.x bis 7.2.x
+* PHP Decoder
+    * installierter ionCube Loader
+* Shopversionen / -editionen
+    * OXID eShop Community Edition (CE), Professional Edition (PE) oder Enterprise Edition (EE) in Compilation Version 
+        * 6.0.x
+        * 6.1.x
+* Themes
+    * Das Modul arbeitet unabhängig von den Frontend-Themes und 
+    * bringt einen eigenen Bereich im Admin unter [ (D3) Module ] / [ Importer ] mit.
+        
+* (D3) Modul-Connector ([kostenfrei bei D3 erhältlich](https://www.oxidmodule.com/connector/)) ab Version 5.1.1.1 
+* mindestens ein freier Cronjob, sofern die Ausführung vollautomatisch per Cronjob gewünscht ist
+
+Beachten Sie, dass die Ihnen vorliegende Modulversion entsprechend für **PHP 5.6**, **PHP 7.0**, **PHP 7.1** oder **PHP 7.2** sowie dem auf Ihrem Server vorhandenen Decoder (**ionCube Loader**) kompatibel ist.  
+Im Zweifelsfall kontaktieren Sie uns und nennen den für Ihren Shop genutzten Decoder und die PHP-Version.
+
+Kontrollieren Sie bitte auch, ob diese Modulversion für die von Ihnen eingesetzte Shopedition (Professional Edition (PE) oder Enterprise Edition (EE)) ausgelegt ist. 

docs/daux/installation/010_Anforderungen/050_Vorbereitungen.md

@@ -0,0 +1,9 @@
+---
+title: Vorbereitungen
+---
+
+Installieren Sie bitte zuerst unseren Modul-Connector in der erforderlichen Version. Ob dies evtl. schon geschehen ist, können Sie im Adminbereich Ihres Shops prüfen.  
+Existiert der Punkt [ (D3) Module ] / [ Modul-Connector ], können Sie die installierte Version unter [ Bibliotheksverwaltung ] ablesen.  
+Fehlt dieser Eintrag, installieren Sie den Modul-Connector bitte vorab.   
+
+Hinweise zu dessen Installation finden Sie in der [Modul-Connector Dokumentation](https://docs.oxidmodule.com/Modul_Connector/).

docs/daux/installation/020_Neuinstallation/005_Vorbereitung.md

@@ -0,0 +1,7 @@
+---
+title: Vorbereitungen
+---
+
+Installieren Sie bitte zuerst unseren Modul-Connector in der erforderlichen Version. Ob dies evtl. schon geschehen ist, können Sie im Adminbereich Ihres Shops prüfen. 
+Existiert der Punkt [ (D3) Module ] -> [ Modul-Connector ], können Sie die installierte Version unter [ Bibliotheksverwaltung ] ablesen. 
+Fehlt dieser Eintrag, installieren Sie den Modul-Connector bitte vorab. Hinweise zu dessen Installation finden Sie in der [Modul-Connector Dokumentation](https://docs.oxidmodule.com/Modul_Connector/).

docs/daux/installation/020_Neuinstallation/020_Modul_hinzufuegen.md

@@ -0,0 +1,11 @@
+---
+title: Modul zur Installation hinzufügen
+---
+
+Führen Sie in der Konsole im Hauptverzeichnis Ihres Shops (oberhalb des `source`- und `vendor`-Verzeichnisses) diesen Befehl aus, um das Modul **{$modulename}** zur Installation hinzuzufügen:
+
+```bash
+php composer require {$composerident} --update-no-dev
+``` 
+
+> [i] Benötigt Ihre Installation einen anderen Aufruf von Composer, ändern Sie den Befehl bitte entsprechend ab. Für weitere Optionen dieses Befehls lesen Sie bitte die [Dokumentation von Composer](https://getcomposer.org/doc/03-cli.md#require).

docs/daux/installation/020_Neuinstallation/030_Verwendung_eigener_Themes.md

@@ -0,0 +1,5 @@
+---
+title: Verwendung eigener Themes
+---
+
+Das Modul arbeitet unabhängig von den Frontend-Themes und ist daher nicht von Änderungen des Themes abhängig.

docs/daux/installation/020_Neuinstallation/040_Providerspezifische_Installation.md

@@ -0,0 +1,6 @@
+---
+title: Providerspezifische Installation
+---
+
+Manche Provider erfordern besondere Einstellungen für installierte Module.  
+Treffen Sie bei der Installation auf spezielle Anforderungen, zu denen Sie Unterstützung benötigen, kontaktieren Sie uns bitte für weiteren Support.

docs/daux/installation/020_Neuinstallation/050_Modul_im_Shop_aktivieren.md

@@ -0,0 +1,9 @@
+---
+title: Modul im Shop aktivieren
+---
+
+Aktivieren Sie das Modul über den Shop-Admin [ Erweiterungen ] / [ Module].  
+Klicken Sie nach Auswahl von [{$modulename}] auf den Button [Aktivieren].
+
+> [!] **Enterprise Editon**:  
+> Achten Sie darauf, dass das Modul in weiteren Subshops (Mall) separat aktiviert werden muss, um es dort zu verwenden.

docs/daux/installation/020_Neuinstallation/060_Shopanpassungen_installieren.md

@@ -0,0 +1,13 @@
+---
+title: Shopanpassungen installieren
+---
+
+Direkt nach der Modulaktivierung startet der Installations-Assistent.  
+Anschließend können Sie eine der verschiedenen Optionen der Installation wählen.   
+
+Den Installationsassistenten finden Sie auch unter dem Menüpunkt  
+[ (D3) Module] / [ Modul-Connector] / [Modulverwaltung] / [Modulinstallation].    
+ 
+Bei tiefgreifenden Änderungen an Ihrem Shop (z.B. Hinzufügen weiterer Sprachen oder Mandanten) rufen Sie den Installationsassistenten bitte erneut auf, um dann eventuell notwendige Anpassungen für das Modul ausführen zu lassen.  
+ 
+Möchten Sie die Änderungen manuell installieren, können Sie sich über den Assistenten eine Checkliste generieren lassen.

docs/daux/installation/020_Neuinstallation/065_Datenbankanpassungen.md

@@ -0,0 +1,9 @@
+---
+title: Datenbankanpassungen
+---
+
+Sollten Sie Ihren Shop im Modus "International" (mit Standardsprache englisch) betreiben, so spielen Sie anschließend folgenden SQL-Befehl zusätzlich ein: 
+                                                                                
+```mysql
+UPDATE `d3importerdesc` SET `OXDESC` = (@TEMP1:=OXDESC), `OXDESC` = `OXDESC_1`, OXDESC_1 = @TEMP1;
+```

docs/daux/installation/020_Neuinstallation/070_TMP-Ordner_leeren.md

@@ -0,0 +1,11 @@
+---
+title: TMP-Ordner leeren
+---
+
+Leeren Sie das Verzeichnis `/tmp/` über [Admin] / [ (D3) Module] / [ ModulConnector] / [TMP leeren].  
+Markieren Sie [komplett leeren] und klicken auf [TMP leeren].  
+  
+Sofern die Views nicht automatisch aktualisiert werden, führen Sie dies noch durch.
+
+> [i] **Hinweis:**  
+>Erfordert Ihre Installation eine andere Vorgehensweise zum Leeren des Caches oder zum Aktualisieren der Datenbank-Viewdaten, führen Sie diese bitte durch. 

docs/daux/installation/020_Neuinstallation/080_Lizenz_eintragen.md

@@ -0,0 +1,22 @@
+---
+title: Lizenzschlüssel eintragen
+---
+
+Das Modul verwendet Lizenzschlüssel, um die Lizenzverwaltung für Sie und auch für uns einfacher zu gestalten.  
+Hierbei haben Sie je nach Modul die Wahl zwischen einer kostenfreien Testlizenz und einer Lizenz für den Einsatz im Livebetrieb. 
+ 
+Rufen Sie zum Anfordern des Lizenzschlüssels die Modulverwaltung im Adminbereich unter [ (D3) Module] / [ Modul-Connector] / [Modulverwaltung] auf.  
+
+Klappen Sie den Eintrag des jeweiligen Moduls aus. Sofern erforderlich, können Sie hier den Lizenzassistenten starten, der schnell und einfach ihr Modul aktiviert.
+  
+> [i] **Hinweis:**  
+>Bitte beachten Sie, dass der Aktivierungsident nur einmal verwendet werden kann.  
+>Wenn sich Ihr System als Testshop unter einer vorübergehenden Domain (URL) befindet, empfehlen wir das Modul vorerst als Testversion laufen zu lassen.  
+ 
+## Im Testmodus gibt es bei diesem Modul Einschränkungen:
+- Artikelimport:  
+    - es können max. 4 Profile angelegt werden  
+    - es werden max. 10 Zeilen importiert  
+
+- Bilderimport:  
+    - es werden max. 5 Bilder (bzw. externe Bilder) importiert

docs/daux/installation/020_Neuinstallation/090_Admin_neu_starten.md

@@ -0,0 +1,7 @@
+---
+title: Admin neu starten
+---
+
+Im linken Menü finden Sie einen neuen Eintrag: [ (D3) Module] / [ {$menutitle}].  
+
+Sollte dieser Menüpunkt bei Ihnen noch nicht vorhanden sein, melden Sie sich vom Shop-Admin bitte kurz ab und anschließend wieder an. 

docs/daux/installation/020_Neuinstallation/100_Updatefaehigkeit.md

@@ -0,0 +1,8 @@
+---
+title: Updatefähigkeit
+---
+
+Bei individuellen Änderungen von Moduldateien empfehlen wir, jeweils die Überladungsmöglichkeiten des Shops dafür zu verwenden.  
+So brauchen Sie die originalen Moduldateien nicht zu verändern und erhalten sich so die Updatefähigkeit des Shops und des Moduls.  
+
+Weitere Informationen zu den Überladungsmöglichkeiten verschiedener Dateien finden Sie in unserer [FAQ](https://faq.d3data.de/category/oxid-eshop/module-oxid-eshop/anpassungen/).

docs/daux/installation/020_Neuinstallation/_index.md

@@ -0,0 +1,11 @@
+---
+Title: Schnellstart per Composer
+---
+
+## Schnellstart per Composer
+
+```bash
+php composer require {$composerident} –-update-no-dev
+```
+
+Detailliertere Angaben zur Installation entnehmen Sie bitte den folgenden Seiten.

docs/daux/installation/030_Update/005_Updatedefinition.md

@@ -0,0 +1,8 @@
+---
+title: Wann kann ein Update ausgeführt werden?
+---
+
+Die Updatenaweisungen können verwendet werden, wenn dieses Modul schon früher mit Hilfe von Composer installiert wurde.
+
+Wurde die Installation bisher noch nicht durchgeführt oder die Installation wurde **nicht** über Composer 
+durchgeführt (weil das Modul dies z.B. früher nicht unterstützte), verwenden Sie bitte die Beschreibung unter [Neuinstallation](../020_Neuinstallation/_index.md).

docs/daux/installation/030_Update/010_Modul_deaktivieren.md

@@ -0,0 +1,14 @@
+---
+title: Modul deaktivieren
+---
+
+Deaktivieren Sie das Modul über den Shop-Admin [Erweiterungen] / [ Module]. 
+
+Klicken Sie nach Auswahl von [{$menutitle}] auf den Button [Deaktivieren].
+
+
+> [!] **Hinweis**:  
+> Bitte deaktivieren Sie ggf. laufende Cronjobs während der Aktualisierung.
+
+> [!!] **wichtiger Hinweis (Enterprise Edition)**:  
+> Deaktivieren Sie das Modul auch in den separaten Subshops.

docs/daux/installation/030_Update/020_Dateien_erneuern.md

@@ -0,0 +1,14 @@
+---
+title: Dateien erneuern
+---
+
+Starten Sie die Konsole Ihres Webservers und wechseln in das Hauptverzeichnis Ihres 
+Shops (oberhalb des `source`- und `vendor`-Verzeichnisses). Führen Sie dort diesen Befehl aus:
+
+```bash
+php composer update {$composerident} --no-dev
+```
+
+> [!] Achten Sie darauf, dass die Installation über Composer mit derselben PHP-Version erfolgt, in der auch Ihr Shop installiert ist. Sie erhalten sonst unpassende Modulpakete.
+
+> [i] Benötigt Ihre Installation einen anderen Aufruf von Composer, ändern Sie den Befehl bitte entsprechend ab. Für weitere Optionen dieses Befehls lesen Sie bitte die [Dokumentation von Composer](https://getcomposer.org/doc/03-cli.md#require).

docs/daux/installation/030_Update/030_Providerspezifische_Installation.md

@@ -0,0 +1,6 @@
+---
+title: Providerspezifische Installation
+---
+
+Manche Provider erfordern besondere Einstellungen für installierte Module.  
+Treffen Sie bei der Installation auf spezielle Anforderungen, zu denen Sie Unterstützung benötigen, kontaktieren Sie uns bitte für weiteren Support.

docs/daux/installation/030_Update/040_Modulinformationen_aktualisieren.md

@@ -0,0 +1,11 @@
+---
+title: Modulinformationen aktualisieren
+---
+
+Um auch alle Moduländerungen Ihrem Shop bekannt zu machen, wechseln Sie bitte im Adminbereich  zu [Erweiterungen] / [ Module].  
+Klicken Sie nach Auswahl von [{$modulename}] auf den Button [Aktivieren]. 
+
+Es werden alle Änderungen der neuen Modul-Version im Shop registriert.
+
+> [!!] **wichtiger Hinweis (Enterprise Edition)**:  
+> Achten Sie darauf, dass das Modul in weiteren Subshops (Mall) separat reaktiviert werden muss, um es dort zu verwenden.

docs/daux/installation/030_Update/050_Shopanpassungen_installieren.md

@@ -0,0 +1,16 @@
+---
+title: Shopanpassungen installierren
+---
+
+Abhängig von dem Umfang der Modulaktualisierung, kann nach der Reaktivierung der Installationsassistent aktiv werden (Sie sehen die Auswahl der Aktualisierungsmöglichkeiten).  
+Folgen Sie den einzelnen Schritten.  
+
+Möchten Sie die Änderungen manuell installieren, können Sie sich über den Assistenten eine Checkliste generieren lassen.  
+ 
+Bleibt der Assistent inaktiv (Sie sehen wieder die Modulübersicht), waren keine Aktualisierungen am Shop notwendig.
+
+Sie können jederzeit im Adminbereich unter [ (D3) Module ] / [ Modul-Connector ] / [ Modulverwaltung ] / [ Modulinstallation ] prüfen, ob eine Aktualiserung bereit steht.
+
+> [!!] **wichtiger Hinweis (Enterprise Edition)**:  
+> Achten Sie darauf, dass das Modul in weiteren Subshops (Mall) separat aktualisiert werden muss, um es dort zu verwenden.
+

docs/daux/installation/030_Update/060_TMP-Ordner_leeren.md

@@ -0,0 +1,11 @@
+---
+title: TMP-Ordner leeren
+---
+
+Leeren Sie das Verzeichnis `/tmp/` über [Admin] / [ (D3) Module] / [ ModulConnector] / [TMP leeren].   
+Markieren Sie [komplett leeren] und klicken auf [TMP leeren].   
+
+Sofern die Views nicht automatisch aktualisiert werden, führen Sie dies noch durch.
+
+> [i] **Hinweis:**  
+>Erfordert Ihre Installation eine andere Vorgehensweise zum Leeren des Caches oder zum Aktualisieren der Datenbank-Viewdaten, führen Sie diese bitte durch. 

docs/daux/installation/030_Update/070_Lizenzschluessel_aktualisieren.md

@@ -0,0 +1,5 @@
+---
+title: Lizenzschlüssel aktualisieren
+---
+
+Wird für die neue Modulversion ein aktualisierter Lizenzschlüssel benötigt, tragen Sie diesen im Adminbereich unter [ (D3) Module ] -> [ Modul-Connector ] -> [ Modulverwaltung ] ein. Klappen Sie dazu den Eintrag des jeweiligen Moduls aus und starten den Lizenzassistent.

docs/daux/installation/030_Update/080_Erweiterungen_anpassen.md

@@ -0,0 +1,5 @@
+---
+title: Erweiterungen anpassen
+---
+
+Haben Sie für dieses Modul eigene Erweiterung entwickelt, gleichen Sie dies bitte mit der neuen Fassung des Moduls ab.

docs/daux/installation/040_Installationspruefung.md

@@ -0,0 +1,13 @@
+---
+title: Installationsprüfung
+---
+
+Um die erfolgreiche Installation zu prüfen, können Sie die folgende Checkliste verwenden:  
+
+## Einstellungsunabhängige Prüfungen
+### Backend   
+- Modul ist unter [ Erweiterungen ] / [ Module] aktiv geschaltet 
+
+- Modul ist unter [ (D3) Module] / [ Modul-Connector] / [Modulverwaltung] aktiv geschaltet
+ 
+- Modul zeigt unter [ (D3) Module] / [ {$menutitle} ] einen eigenen Bereich für Einstellungen

docs/daux/installation/050_Schnellstart.md

@@ -0,0 +1,16 @@
+---
+title: Schnellstart
+---
+
+Das Modul **{$modulename}** bringt einen umfangreichen Adminbereich mit, in dem Sie die Konfigurationseinstellungen des Moduls setzen können. 
+Über das Menü [ (D3) Module ] / [{$menutitle}] sehen Sie folgende Menüpunkte:
+- [Einstellungen] - Definieren Sie die Grundeinstellungen für die ImportProfile  
+- [Artikelimport] - Übersicht für die Importprofile + Einstellungen für den Artikelimport eines jeweiligen Importprofils  
+- [Bildimport] - Übersicht für die Importprofile + Einstellungen für den Bildimport pro Importprofil  
+- [Artikelfelder] - Übersicht der aktuell konfigurierbaren Artikelfeldzuordnungen  
+
+Arbeiten Sie idealerweise die Optionen einmal durch.
+  
+Hinweise zu den einzelnen Einstellungen finden Sie in dem dahinter, stehenden Fragezeichenfeld [ ? ]. Durch einen Klick darauf öffnet sich der Hinweistext.
+
+Die meisten Optionen sind zusätzlich im [Handbuch zum Modul](../manual/020_Bedienungsanleitung/010_Beschreibung_Funktionsumfang.md) umfangreicher beschrieben.

docs/daux/installation/055_Demodaten.md

@@ -0,0 +1,13 @@
+---
+title: Demodaten
+---
+
+Wir stellen für das Modul Demodaten bereit, mit denen Sie einfache Tests ausführen können. Weiterhin können Ihnen diese als Vorlage für eigene Importdateien dienen.
+
+Führen Sie in der Konsole im Hauptverzeichnis Ihres Shops (oberhalb des `source`- und `vendor`-Verzeichnisses) diesen Befehl aus, um die Demodaten zur Installation hinzuzufügen:
+
+```bash
+php composer require d3/importer-demodata --update-no-dev
+``` 
+
+> [i] Benötigt Ihre Installation einen anderen Aufruf von Composer, ändern Sie den Befehl bitte entsprechend ab. Für weitere Optionen dieses Befehls lesen Sie bitte die [Dokumentation von Composer](https://getcomposer.org/doc/03-cli.md#require).

docs/daux/installation/060_Deinstallation/010_Modulerweiterungen_deaktivieren_und_entfernen.md

@@ -0,0 +1,5 @@
+---
+title: Modulerweiterungen deaktivieren und entfernen
+---
+
+Deaktivieren Sie alle vorhandenen Erweiterungen, die auf dem Modul **{$modulename}** aufbauen und löschen bitte alle Dateien dieser Erweiterungen. Entfernen Sie ebenfalls alle individuellen Templateanpassungen für dieses Modul.

docs/daux/installation/060_Deinstallation/020_Modul_deaktivieren.md

@@ -0,0 +1,6 @@
+---
+title: Modul deaktivieren
+---
+
+Deaktivieren Sie das Modul **{$modulename}** über den Shopadmin [ Erweiterungen ] -> [ Module ]. Klicken Sie nach Auswahl von [ {$menutitle} ] auf den Button [ Deaktivieren ].
+

docs/daux/installation/060_Deinstallation/030_Modul_aus_der_Installation_entfernen.md

@@ -0,0 +1,13 @@
+---
+title: Modul aus der Installation entfernen
+---
+
+Starten Sie die Konsole Ihres Webservers und wechseln in das Hauptverzeichnis Ihres Shops (oberhalb des `source`- und `vendor`-Verzeichnisses). Führen Sie Sie dort diesen Befehl aus:
+
+```Bash
+php composer remove {$composerident} --no-update
+``` 
+
+> [!] Achten Sie darauf, dass die Installation über Composer mit derselben PHP-Version erfolgt, in der auch Ihr Shop installiert ist. Sie erhalten sonst unpassende Modulpakete.
+    
+> [i] Benötigt Ihre Installation einen anderen Aufruf von Composer, ändern Sie den Befehl bitte entsprechend ab. Für weitere Optionen dieses Befehls lesen Sie bitte die [Dokumentation von Composer](https://getcomposer.org/doc/03-cli.md#require).

docs/daux/installation/060_Deinstallation/040_Dateien_loeschen.md

@@ -0,0 +1,9 @@
+---
+title: Dateien löschen
+---
+  
+Löschen Sie den Ordner `{$modulefolder}` und seine enthaltenen Elemente aus dem Verzeichnis `source/modules/d3` Ihres Shops. 
+Bestätigen Sie anschließend im Shopadmin unter [ Erweiterungen ] -> [ Module ] -> [ Installierte Shop-Module ] die Nachricht:
+
+> Es gibt registrierte Erweiterungen im eShop, deren Verzeichnis nicht vorhanden ist.    
+> Möchten Sie alle Modulinformationen einschließlich Konfigurationseinstellungen und Blockinformationen für Templates löschen?

docs/daux/installation/060_Deinstallation/060_TMP-Ordner_leeren.md

@@ -0,0 +1,9 @@
+---
+title: TMP-Ordner leeren
+---
+
+Leeren Sie das Verzeichnis `tmp` über [ Admin ] -> [ (D3) Module ] -> [ Modul-Connector ] -> [ TMP leeren ]. Markieren Sie [ komplett leeren ] und klicken auf [ TMP leeren ]. 
+
+Sofern die Views nicht automatisch aktualisiert werden, führen Sie dies noch durch.
+
+> [i] Erfordert Ihre Installation eine andere Vorgehensweise zum Leeren des Caches oder zum Aktualisieren der Datenbank-Viewtabellen, führen Sie diese bitte aus.

docs/daux/manual/020_Bedienungsanleitung/010_Beschreibung_Funktionsumfang.md

@@ -0,0 +1,33 @@
+---
+Beschreibung / Funktionsumfang
+---
+
+## Beschreibung / Funktionsumfang  
+Modul für den individuellen und wiederkehrenden Import großer Artikelmengen aus einer Excel Datei (CSV-Format) 
+ 
+ 
+## Importiert werden können: 
+- alle Artikelstammdaten 
+- Artikellangtexte (auch HTML) 
+- Artikelbilder 
+- Kategorien
+- Crossselling (Zubehör / Ähnliche Artikel)  
+- Attribute 
+- Auswahllisten 
+- Varianten 
+- Staffelpreise 
+- Hersteller / Lieferanten   
+
+## Wichtige Features:
+- Wählen Sie einen von 3 Importtypen aus:
+  - Bei "Import und Update" werden Artikel importiert und aktualisiert (Standard Auswahl).
+  - Bei "nur Import" werden Artikel nur importiert. Es werden keine vorhandenen Artikeldaten überschrieben.
+  - Bei "nur Update" werden Artikel nur aktualisiert. Es werden keine neuen Artikel angelegt.
+- Speicherung der verwendeten Import-Profil-ID an importierten/aktualisierten Artikeln z.B. für Nachimport-Aktionen
+- automatische Importe (z.B. Nachts) für beliebige, gespeicherte Importprofile
+- Speicherung beliebig vieler Importprofile
+- Exportfunktion für Importprofile unter [ {$menutitle} ] / [Einstellungen] / [Stamm]
+- Variable Strukturen in der Importdatei möglich.  
+  Die Zuordnungen "CSV zu Shop" können über das Importprofil eingestellt werden.
+- definierbare Standardwerte für die Einstellungen der Import-Profile  
+- Alle Artikel die nicht aktualisiert wurden, können Sie nachträglich über den Admin im [Nach Import] löschen oder deaktivieren.

docs/daux/manual/020_Bedienungsanleitung/020_Technische_Vorraussetzungen.md

@@ -0,0 +1,8 @@
+---
+Technische Vorraussetzungen
+---
+
+Sie benötigen einen sFTP/FTPs-Zugang, Zugriff auf den [Shop-Admin] und den [Shop] (Backend/Frontend) zur Kontrolle des Importes. 
+
+Sofern Sie die CSV-Datei manuell editieren möchten, empfehlen wir den Einsatz eines Tabellenkalkulationsprogramm's.  
+Damit können Sie Ihre Importdatei öffnen (beispielsweise Microsoft Excel oder LibreOffice Calc/OpenOfficeCalc).

docs/daux/manual/020_Bedienungsanleitung/030_Schnelleinstieg/020_Teil1_Artikelimport.md

@@ -0,0 +1,33 @@
+---
+title: Teil 1 Artikelimport
+---
+
+- Öffnen Sie im Admin [ (D3) Module] / [ Importer ] / [Artikelimport] 
+- Wählen Sie im Stamm einen Profilnamen 
+- Wählen Sie eine vorhandene Datei aus oder wählen Sie eine neue Datei für den Upload.
+- Geben Sie die [Datei-Spaltentrennung] und ggf. den [Texttrenner] an. 
+- Ordnen Sie unter [Artikelfelder] alle in Ihrer Liste vorkommenden Spalten den richtigen Datenfeldern zu.
+- Setzen Sie bei Update einen/mehrere Haken, wenn die Informationen am Artikel aktualisiert werden sollen.
+> [!] **wichtiger Hinweis**:  
+> Für den Bilderimport verwenden Sie die Feldnamen "_Bild Importfeld 1-10(d3importpic1-10)_" anstatt "_Bild 1-10(oxpic1-10)_". 
+- Ordnen Sie die [Kategorien] zu. Sie können beliebig viele Zuordnungen erstellen 
+- Ordnen Sie unter [Crossselling] die entsprechenden Datenfelder für Crossselling und Zubehör zu. 
+- Unter [Attribute] können Sie mehrsprachig, den [Attributsnamen] und den [Attributswert am Artikel] importieren. Sie können beliebig viele Attribute festlegen. 
+- Nehmen Sie die Konfiguration für die [Auswahllisten] vor. Sie können beliebig viele Auswahllisten festlegen.
+- Geben Sie bei [Varianten] die Spalten für [Variantenname], [Variante von] und [Variantenbezeichnung] an. 
+- Geben Sie bei [Staffelpreisen] die Felder [Staffelpreis], [Menge von] und [Menge bis] an. Sie können beliebig viele Staffelpreise festlegen. 
+- Wählen Sie bei [Hersteller] die Datenfelder für Hersteller und Lieferanten 
+- Unter [Konfig.] wählen Sie: 
+  - Wie viele [Dateizeilen pro Durchlauf] importiert werden sollen, 
+  - den [Importtyp], 
+  - die [Anzahl Datei-Kopfzeilen] 
+  - und die [Artikelidentifikation]. 
+  - Zusätzlich können Sie die [Preis Optionen] 
+  - und [Artikel-Ident Optionen (Expertenmodus)] einstellen
+- Klicken Sie im Reiter [ Import ] auf [Artikelimport starten]  
+- Unter [Nach Import] werden Informationen zu den -zuletzt mit diesem Profil importierten- Artikeln angezeigt.
+  - [Alle Artikel deaktivieren] - deaktiviert alle Artikel <sup>1.</sup>
+  - [Alle Artikel löschen] - löscht alle Artikel <sup>1.</sup>  
+  
+<sup>1. Betrifft Artikel, welche mit dem letztem Import **dieses** Profils nicht aktualisiert wurden.  
+Wurde ein Artikel bereits mit einem anderen Profil bearbeitet, wird dieser nicht beeinflusst.</sup>

docs/daux/manual/020_Bedienungsanleitung/030_Schnelleinstieg/030_Teil2_Vorbereitung_Bilderimport.md

@@ -0,0 +1,7 @@
+---
+title: Teil 2 Vorbereitung Bilderimport
+--- 
+
+- Öffnen Sie vom root-Verzeichnis `/source/` ausgehend, den Unterordner `/import/pictures/`. 
+- In das Verzeichnis laden Sie alle Artikelbilder, die vom Namen her identisch mit den Bildnamen in Ihrer Liste sind (z.B. `/import/pictures/beispielbild.jpg`). 
+- Externe Bilder werden automatisch über den Bildimport in das Verzeichnis `/source/import/pictures/` heruntergeladen.

docs/daux/manual/020_Bedienungsanleitung/030_Schnelleinstieg/040_Teil3_Bilderimport.md

@@ -0,0 +1,12 @@
+---
+title: Teil 3 Bilderimport
+--- 
+
+- Gehen Sie in den Admin unter [ (D3) Module ] / [ Importer ] / [Bilderimport].
+- Wählen Sie in der Auswahl [Bild Importfeld 1] für das 1. Artikelbild und ordnen Sie die jeweiligen Zielfelder zu (bzw. Vorschaubild, Detailbild 1-10, Icon).
+- Gehen Sie für weitere Bildimportfelder gleich vor, setzen Sie noch gewünschte Einstellungen und klicken Sie anschließend auf [Speichern].
+- Gehen Sie auf den Reiter [ Import ] und wählen Sie optional die Einstellung [ Externe Bilder einlesen ].  
+  Mit [Bildimportverzeichnis einlesen] werden alle Bilder aus dem Verzeichnis `/import/pictures/` ausgelesen.  
+  (bei aktivierter Einstellung [externe Bilder einlesen] werden die Bilder vorher in das Bildimportverzeichnis geladen)  
+- Danach klicken Sie auf [Bilderimport starten].
+- Nachdem Bilderimport wird Ihnen angezeigt, wie viele Bilder bearbeitet und importiert wurden.  

docs/daux/manual/020_Bedienungsanleitung/040_Importanleitung_ausfuehrlich/010_Einleitung.md

@@ -0,0 +1,18 @@
+---
+title: Einleitung 
+---
+
+In den folgenden Kapitel wird der komplette Ablauf eines Artikel- und des Bilderimports ausführlich beschrieben.  
+Es wird erklärt, wie Sie Importprofile anlegen können, die gewünschte Importdatei in den Shop laden und alle Vorbereitungen für den Bild-/Import treffen. 
+ 
+ 
+Der Import gliedert sich in folgende Schritte:
+- [Anlegen einer eigenen Importdatei](015_Anlegen_einer_eigenen_Importdatei.md)
+- [Artikelimport](040_Artikelimport/020_anlegen_von_Importprofilen.md)
+- [Bilderimport](050_Bilderimport/010_Upload_Bilder_in_Importverzeichnis.md)
+
+> [!!] wichtiger Hinweis:  
+> Der Artikelimport muss immer vor einem Bilderimport durchgeführt werden.  
+  Siehe [Artikelimport / Artikelfelder / Bildnamen](040_Artikelimport/040_Artikelfelder.md)
+
+Optional bieten die Menüpunkte [Artikelfelder](020_Artikelfelder.md) und [Grundeinstellungen](030_Grundeinstellungen.md) fortgeschrittene Konfigurationsmöglichkeiten. 

docs/daux/manual/020_Bedienungsanleitung/040_Importanleitung_ausfuehrlich/015_Anlegen_einer_eigenen_Importdatei.md

@@ -0,0 +1,23 @@
+---
+Legen Sie sich Ihre eigene Importdatei in Excel oder OpenOffice an
+---
+
+Speichern Sie Ihre Importdatei vorzugsweise mit dem Datei-Spaltentrenner ; (Semikolon).  
+Die interne Spaltentrennung (Beispielsweise bei Varianten oder Staffelpreisen) sollten mit Komma oder | (Pipe) getrennt sein.  
+Schauen Sie sich Ihre Importdatei am besten mit einem Tabellenkalkulationsprogramm (Excel, LibreOffice, etc.) an und setzen Sie optional Spaltenüberschriften.  
+**Für Ihren Import benötigen Sie nur die Spalten, die Sie auch tatsächlich für Ihren Artikel brauchen.**  
+Möchten Sie eine Liste selbst anlegen, können Sie sich an diesem Beispiel orientieren:  
+
+[Beispiel .csv-Datei](../../../assets/files/exportlisteninhalt.csv)
+
+```csv
+Artikelnummer;Titel;Langbeschreibung;Suchbegriffe;Preis;Kategorie;Varianten Name;Hersteller
+1402;Trapez ION MADTRIXX;Langtext;harness, hip harness, madtrixx;45,00 €;1208|1302|1303|1304|1401;6454;Beispielhersteller
+```  
+
+> [!] Die Artikelnummer bzw. die Identifikation (EAN, MPN) muss immer eindeutig sein und im Admin als Artikelidentifikation hinterlegt werden.  
+
+Ein vollständiges Beispiel einer CSV finden Sie im Modulpaket unter /setup+doku/examples/demo_artikel_klomplett.xls.  
+Diese können Sie in das Importdatei-Format umwandeln, indem Sie unter [Datei] / [speichern unter] klicken und dann als Dateityp "Text Importdatei (.csv )" auswählen.
+
+> [i] Weitere Informationen finden Sie unter [Häufig gestellte Fragen](../080_Haeufig_gestellte_Fragen.md)

docs/daux/manual/020_Bedienungsanleitung/040_Importanleitung_ausfuehrlich/020_Artikelfelder.md

@@ -0,0 +1,41 @@
+---
+title: Artikelfelder
+---
+
+![Artikelfelder](../../../assets/newAssets/Artikelfelder.png)
+
+Im Admin unter [(D3) Module] / [Importer] / [Artikelfelder] können Sie einzelne Felder aus der Tabelle oxarticles definieren.  
+Die Einstellungen eines jeden Felds wird beim Import und in der Adminoberfläche des Importers genutzt.  
+So können individuelle Feldnamen (bspw. oxarticles__d3newfield) mit einem aussagekräftigen Namen ausgestattet werden.  
+
+### Folgende Einstellungen kann man pro Feld definieren:
+<dl>
+    <dt>[Aktiv]</dt>
+    <dd>De/Aktivieren Sie das Artikelfeld für die Adminoberfläche des Importers</dd>
+    <dt>[Bild]</dt>
+    <dd>
+        <del>De/Aktivieren Sie das Artikelfeld für die Adminoberfläche des Bildimports (neue Felder werden im Admin nicht angezeigt)</del><br>
+        Diese Einstellung wird derzeit nicht effektiv genutzt.
+    </dd>
+    <dt>[Datenbankfeldname]</dt>
+    <dd>Tragen Sie hier den Namen des Datenbankfelds von oxarticles oder oxartextends ein.</dd>
+    <dt>[Artikelfeld Sprache 1] + [Artikelfeld Sprache 2]</dt>
+    <dd>Geben Sie dem Artikelfeld einen lesbaren Namen in der entsprechenden Sprache an.</dd>
+    <dt>[Sortierung]</dt>
+    <dd>
+        Hier können Sie die Sortierreihenfolge für den Admin festlegen.
+        Oft benutzte Artikelfelder können mit einer niedrigen Zahl weiter oben angezeigt werden.
+    </dd>
+</dl>
+  
+  
+### Das Modul verwendet die <u>aktiven</u> Artikelfelder in den Admin-Bereichen unter /(D3) Module/Importer/:  
+
+<dl>
+    <dt>Artikelimport/Artikelfelder</dt>
+    <dd>Die Dropdown Felder unter [Spalteninhalt und Zuordnung] zeigen den [Datenbankfeldname] sowie dessen gepflegte Übersetzung [Artikelfeld Sprache n] an.</dd>
+    <dt>Artikelimport/Varianten</dt>
+    <dd>Die Artikelfelder beginnend mit <i>oxvarname</i> (Name der Auswahl) und <i>oxvarselect</i> (Auswahl) werden hier als einstellbare CSV-Zuordnung bereitgestellt.</dd>
+    <dt>Einstellungen/Grundeinstellungen/Auswahl für Artikelidentifikationsfelder</dt>
+    <dd>Der [Datenbankfeldname] wird in der Mehrfach-Auswahlliste angezeigt.</dd>
+</dl>

docs/daux/manual/020_Bedienungsanleitung/040_Importanleitung_ausfuehrlich/030_Grundeinstellungen.md

@@ -0,0 +1,22 @@
+---
+title: Grundeinstellungen
+---
+Im Admin unter [(D3) Module] / [Importer] / [Einstellungen] befinden sich die [Grundeinstellungen].  
+Die verschiedenen Optionen sind konfigurierbare Voreinstellungen für Importe und Importprofile.  
+Jede Option auf der Seite wird als Voreinstellung bei der Anlage der Importprofile genutzt.  
+
+| Voreinstellung | Wo wird diese genutzt? (Admin: /(D3) Module/Importer/) |
+|:-----------------------------|:------------------------------------------------|
+| Auswahl für Artikelidentifikationsfelder  |  Artikelimport / Konfig. / Artikelidentifikation <sup1>(1.)</sup1> |
+| Definition von "ja" Werten |  Artikelimport / Konfig. / Definition von "ja" Werten |
+| Definition von "nein" Werten |  Artikelimport / Konfig. / Definition von "nein" Werten |
+| vordefinierte Werte für Artikelfelder |  Artikelimport / Konfig. / vordefinierte Werte für Artikelfelder |
+| Dateizeilen pro Durchlauf  |  Artikelimport / Konfig. /  Dateizeilen pro Durchlauf |
+| Anzahl Datei-Kopfzeilen  |  Artikelimport / Konfig. /  Anzahl Datei-Kopfzeilen |
+| Auswahl für Kategorieidentifikationsfelder  |  Artikelimport / Kategorien /  Kategoriefeld Zuordung |
+| Start des nächsten Bilddurchlaufes |  Bilderimport / Stamm /  Start des nächsten Bilddurchlaufes |
+| lokale Bilder (/import/pictures/) durch Externe überschreiben? |  Bilderimport / Stamm /  lokale Bilder (/import/pictures/) durch Externe überschreiben? |
+| Masterbilder am Artikel vorher entfernen (empfohlen)  |  Bilderimport / Stamm /  Masterbilder am Artikel vorher entfernen (empfohlen) |
+
+ 
+<sup1>(1.)</sup1> Die Sichtbarkeit der Felder im Importer Admin, kann unter [ (D3) Module ] / [Importer] / [[Artikelfelder]](020_Artikelfelder.md) editiert werden.  

docs/daux/manual/020_Bedienungsanleitung/040_Importanleitung_ausfuehrlich/040_Artikelimport/020_anlegen_von_Importprofilen.md

@@ -0,0 +1,17 @@
+---
+title: Anlegen von Importprofilen 
+---
+## Wofür werden Importprofile benötigt?   
+ 
+Bei der täglichen Arbeit mit Artikelimporten kommt es häufig vor, dass Sie aus verschiedenen Quellen (bspw. Lieferanten) CSV-Daten erhalten.  
+Meist ist der Aufbau der Quelldaten sehr unterschiedlich.  
+Das Modul ermöglicht diese einfach in den Shop zu integrieren.
+
+Der Kernpunkt eines jeden Imports ist das Importprofil.  
+Sie können für jede unterschiedliche Datenquelle schnell und übersichtlich ein Importprofil konfigurieren.  
+Danach kann der Importvorgang entweder über den Shop-Admin oder per Cronjob gestartet werden.
+ 
+Für die Erstellung eines neuen Importprofils öffnen Sie Ihren Shop-Admin und navigieren Sie zu:  
+[(D3) Module] / [ Importer ] / [Artikelimport]  
+Sie können direkt die Felder ausfüllen und das Importprofil mit [Speichern] anlegen.  
+Alternativ können Sie am unteren Fensterrand folgenden Link finden: [Neues Importprofil anlegen]

docs/daux/manual/020_Bedienungsanleitung/040_Importanleitung_ausfuehrlich/040_Artikelimport/030_Stamm.md

@@ -0,0 +1,24 @@
+---
+title: Stamm
+---
+
+![Artikelimport | Stamm](../../../../assets/newAssets/Artikelimport-Stamm.png)   
+   
+   
+| Stammdaten                              | Hinweise                                                                                                                      |  
+| :---------------------------------------| :-----------------------------------------------------------------------------------------------------------------------------|
+| Profilname                              | Geben Sie hier Ihrer Importliste einen Namen (z.B. Hersteller XYZ Import ). |
+| Importdatei                             | Zeigt die aktuelle Dateizuordnung und zeigt eine Dateiliste des Verzeichnisses `/source/import/` |
+| Neue Datei hochladen                    | Klicken Sie auf [Durchsuchen] und wählen Sie eine CSV-Datei aus. (Mit [Speichern] wird die Datei auf den Server geladen.) |
+| Datei-Spaltentrennung                   | Geben Sie an, welches Trennzeichen Ihre Importdatei für die einzelnen Spalten verwendet. (bspw.: ; oder \| oder TAB) | 
+| Texttrenner (optional)                  | Der Texttrenner umschließt in einer CSV-Datei einzelne Zellen. (bspw.: " oder ') |
+
+Klicken Sie dann auf [Speichern]. 
+ 
+## Datei-Info: 
+In diesem Block finden Sie alle wichtigen Informationen zu der aktuell ausgewählten Importdatei:
+- Name 
+- Dateigröße 
+- letzte Änderung 
+- Datei-Rechte (ist die Datei lesbar/beschreibbar) 
+- CSV-Daten: bspw. Zeilen/Spalten Anzahl

docs/daux/manual/020_Bedienungsanleitung/040_Importanleitung_ausfuehrlich/040_Artikelimport/040_Artikelfelder.md

@@ -0,0 +1,44 @@
+---
+title: Artikelfelder
+---
+
+![Artikelimport | Artikelfelder](../../../../assets/newAssets/Artikelimport-Artikelfelder.png)
+
+Hier können Sie die Spalten Ihrer Importdatei den jeweiligen Artikel-Datenbankfeldern zuordnen. 
+ 
+> [!] Hinweis:  
+> Lassen Sie Felder an dieser Stelle frei, für die es einen eigenen Reiter/Tab gibt.  
+> bspw: Kategorie, Cross-Selling, Attribute, Auswahllisten, Varianten, Staffelpreise, Hersteller, Mall
+ 
+Für jede CSV-Spalte wird ein Dropdown Feld angezeigt.  
+Aus der aktuell ausgewählten Zeile wird der Inhalt der CSV-Zelle über dem Dropdown-Feld angezeigt.  
+Sie können durch die einzelnen Zeilen in Ihrer CSV-Datei navigieren.  
+Wechseln Sie von der Zeile 1 (bspw. Spaltenüberschrift) auf die Zeile 2 (nächste Artikeldaten).  
+
+Wählen Sie aus dem Drop-Down Feld die richtige Zuordnung aus.
+Hier ein paar Beispiele: 
+- Titel (oxtitle) 
+- Langbeschreibung (oxlongdesc)
+- Suchbegriffe (oxsearchkeys)
+- Preis (oxprice) 
+- Bild 1-10 (oxpic1-10):
+    > [!!] wichtiger Hinweis:   
+    > Bitte wählen Sie statt oxpic1-10 für den Bilderimport die moduleigenen Felder:  
+    > - Bild Importfeld 1 (d3importpic1) 
+    > - Bild Importfeld 2 (d3importpic2) 
+    > - ... 
+    > - Bild Importfeld 10 (d3importpic10)
+
+### Pflicht ist die Zuordnung der Artikelidentifikation!
+> [!!] wichtiger Hinweis:  
+> Das Feld für die Artikelidentifikation muss hier für jedes Importprofil zugeordnet werden.  
+> Der Wert muss einzigartig sein, damit keine Artikelduplikate entstehen.  
+> Bspw.: Artikelnummer, Hersteller EAN, EAN, etc.
+
+Die Checkboxen hinter den Dropdown-Feldern regulieren, ob der Inhalt nur importiert oder geschrieben wird.  
+- **Checkbox aktiv:** Ist ein Artikel bereits in der Datenbank vorhanden, wird der Inhalt aktualisiert.
+- **Checkbox inaktiv:** Der Inhalt wird nur geschrieben, wenn der Artikel noch nicht existiert.
+
+Die Einstellung zur Art des Importprofils (Import & Update, nur Import, nur Update) finden Sie im Tab [Konfig.].  
+ 
+Klicken Sie abschließend auf [Speichern].

docs/daux/manual/020_Bedienungsanleitung/040_Importanleitung_ausfuehrlich/040_Artikelimport/050_Kategorien.md

@@ -0,0 +1,31 @@
+---
+title: Kategorien
+---
+
+![Artikelimport | Kategorien](../../../../assets/newAssets/Artikelimport-Kategorien.png)
+
+Sie können einen Artikel beliebig vielen Kategorien zuordnen.   
+- Wählen Sie den [Importtyp] aus. 
+    - [Nur Import] Die Kategorien werden normal importiert bzw. dem Artikel zugeordnet 
+    - [Artikel-Kat.-Zuordnungen vorher löschen] Alle Kategorie-Zuordnungen des aktuellen Artikels werden vor dem Import gelöscht. 
+- [Kategoriefeld Zuordnung] Wählen Sie die gewünschte Identifikation der Zuordnung aus.  
+
+| Folgende Werte stehen standardmäßig zur Auswahl: |  |
+|:-----------------------------|:------------------------------------------------|
+| oxtitle                      | exakter Name der Kategorie / Kategoriebaum  |
+| oxid                         | shopinterne Identifikation der Kategoie |
+| oxsort                       | Sortierungsnummer der Kategorie |
+| oxdesc                       | Kurzbeschreibung der Kategorie |
+
+- [Spaltenzuordnung n] Wählen Sie in dem Dropdown-Feld die CSV-Spalte aus, welche den Inhalt der [Kategoriefeld Zuordnung] hat. 
+- [interne Spaltentrennung] Wenn Sie beispielsweise [Hauptkategorie|Unterkategorie|Unterunterkategorie] angegeben haben, tragen Sie das Zeichen | ein. 
+ 
+Beim Import wird registriert, ob die Kategorie Struktur in dieser Form besteht. Wenn nicht, wird diese mit der Information der [Spaltenzuordnung n] angelegt.  
+> [!]Bitte achten Sie auf die korrekte Schreibweise, Groß- und Kleinschreibung! 
+ 
+Sie können einen Artikel beliebig vielen Kategorien zuordnen.  
+Neue Möglichkeiten der [Spaltenzuordnung n] werden nach dem Speichern automatisch erweitert.  
+ 
+Klicken Sie abschließend auf [Speichern]. 
+
+> [i] Weitere Informationen finden Sie unter [Häufig gestellte Fragen](../../080_Haeufig_gestellte_Fragen.md)

docs/daux/manual/020_Bedienungsanleitung/040_Importanleitung_ausfuehrlich/040_Artikelimport/060_Cross-Selling_+_Zubehoer.md

@@ -0,0 +1,20 @@
+---
+title: Cross-Selling und Zubehör
+---
+
+![Artikelimport | Crossselling](../../../../assets/newAssets/Artikelimport-Cross-Selling.png)
+## Cross-Selling
+- Wählen Sie den [Cross-Selling Importtyp] aus. 
+    - [Nur Import] Das Cross-Selling wird normal dem Artikel zugeordnet
+    - [[Artikel-Cross-Sell.-Zuordnungen vorher löschen] Alle Zuordnungen des aktuellen Artikels werden vor dem Import gelöscht. 
+- [Spaltenzuordnung n] Wählen Sie in dem Dropdown-Feld die entsprechende CSV-Spalte aus. 
+- [interne Spaltentrennung] Wenn Sie beispielsweise [7353|80085|0815] angegeben haben, tragen Sie das Zeichen | ein. 
+
+## Zubehör
+- Wählen Sie den [Zubehör Importtyp] aus. 
+    - [Nur Import] Das Zubehör wird normal dem Artikel zugeordnet
+    - [[Artikel-Zubehör-Zuordnungen vorher löschen] Alle Zuordnungen des aktuellen Artikels werden vor dem Import gelöscht. 
+- [Spaltenzuordnung n] Wählen Sie in dem Dropdown-Feld die entsprechende CSV-Spalte aus. 
+- [interne Spaltentrennung] Wenn Sie beispielsweise [1402|1503|0815] angegeben haben, tragen Sie das Zeichen | ein. 
+
+Klicken Sie abschließend auf [Speichern].

docs/daux/manual/020_Bedienungsanleitung/040_Importanleitung_ausfuehrlich/040_Artikelimport/070_Attribute.md

@@ -0,0 +1,24 @@
+---
+title: Attribute
+---
+
+![Artikelimport | Attribute](../../../../assets/newAssets/Artikelimport-Attribute.png)
+
+- Wählen Sie den [Attribute Importtyp] aus: 
+  - [Nur Import] Die Attribute werden normal dem Artikel zugeordnet.
+  - [Artikel-Attribut-Zuordnungen vorher löschen] Alle Attribut-Zuordnungen des aktuellen Artikels werden vor einem Update gelöscht. 
+ 
+> [i] In Version 4.4.1.0 gab es eine Umstellung der Attributszuordnungen. Weitere Informationen finden Sie in unserer FAQ: [Anleitung zur Umstellung von Attributszuordnungen](https://faq.d3data.de/module/importer/anleitung-zur-umstellung-von-attributszuordnungen/). 
+
+- [n. Attributszuordnung] Sie können mehrere Attribute importieren.  
+   Jede Attributszuordnung wird als Attribut angesehen. D.h. für 1 Attribut kann nur eine Attributszuordnung verwendet werden.  
+  - pro Sprache können Sie Name und Wert definieren: 
+    - [Attributsname] Wählen Sie die CSV-Spalte mit dem Namen des Attributs aus.   
+      Bspw. "_Material_",  "_Höhe_" oder "_Farbe_" (ohne Anführungszeichen). 
+    - [Attributswert am Artikel] Wählen Sie hier die zugehörige CSV-Spalte mit dem Wert des Attributs am Artikel aus.   
+      Bspw. "_Aluminium_",  "_30cm_" oder "_matt_" (ohne Anführungszeichen). 
+
+Neue Möglichkeiten der [n. Attributszuordnung] werden nach dem Speichern automatisch erweitert.
+ 
+Klicken Sie auf [Speichern] um die Attributszuordnung zu sichern. 
+

docs/daux/manual/020_Bedienungsanleitung/040_Importanleitung_ausfuehrlich/040_Artikelimport/080_Auswahllisten.md

@@ -0,0 +1,31 @@
+---
+title: Auswahllisten
+---
+
+![Artikelimport | Auswahllisten](../../../../assets/newAssets/Artikelimport-Auswahllisten.png)
+
+- [Auswahllisten-Importtyp] 
+  - [Nur Import] Eine neue Auswahlliste wird erstellt und dem Artikel zugeordnet. 
+  - [Alle Auswahllisten vorher löschen] Alle Auswahllisten, die ausschließlich dem aktuellen Artikel zugeordnet sind, werden vor dem Update gelöscht.  
+- [Titel der Auswahlliste n] Geben Sie hier die CSV-Spalte an, worin der Titel z.B. _"Farbe"_ hinterlegt ist.
+- [Alternativtitel] Ist kein "Titel der Auswahlliste" vorhanden oder ist der Inhalt teilweise leer, so kann hier ein Alternativtitel z.B. _"Auswahl"_ angegeben werden.
+- [Auswahlfelder n] Wählen Sie die CSV-Spalte aus, welche die Auswahlen (Werttrenner-separiert) z.B. _"rot\|grün\|blau"_ enthält.
+- [Werttrenner] Stehen mehrere Werte im CSV-Importfeld "Auswahlfelder", so muss der verwendete Werttrenner angegeben werden. Z.B. "@" wenn in der CSV "rot@gelb@grün" steht.
+- [Preistrenner] Zusätzlich können Preisänderungen (absolute Werte und in %) importiert werden. z.B. "rot\|2,34@gelb\|5%@grün\|1,23". In dem Beispiel müsste als Werttrenner "@" und als Preistrenner "\|" eingetragen werden.
+
+Es sind beliebig viele Auswahllisten mit entsprechenden Werten pro Artikel importierbar. 
+
+> [i] Hinweise:  
+> Auswahllisten werden immer neu angelegt.   
+> Eine Zuordnung wird nicht unterstützt, da eine Auswahlliste nicht eindeutig sein muss.  
+> Fallbeispiel: Zwei Artikel haben jeweils eine Auswahlliste mit Namen **Farbe**:  
+> - T-Shirt A: 
+>   - Name der Auswahlliste: **Farbe** 
+>   - Werte: **rot, blau**  
+> - T-Shirt B: 
+>   - Auswahlliste: **Farbe** 
+>   - Werte: **gelb, grün**  
+>
+> Die Auswahlliste hat keine eindeutige Identifizierungsmöglichkeit.
+
+Klicken Sie abschließend auf [Speichern]. 

docs/daux/manual/020_Bedienungsanleitung/040_Importanleitung_ausfuehrlich/040_Artikelimport/090_Varianten.md

@@ -0,0 +1,17 @@
+---
+title: Varianten
+---
+
+![Artikelimport | Varianten](../../../../assets/newAssets/Artikelimport-Varianten.png)
+
+- [Varianten Importtyp] 
+  - [Nur Import] Die Varianten werden dem Eltern-Artikel neu zugeordnet oder aktualisiert 
+  - [Varianten vorher löschen] Alle Varianten-Artikel des aktuellen Eltern-Artikels werden vor dem Update gelöscht.  
+- [Variantenerkennung] Geben Sie hier die CSV-Spalte mit der Artikelidentifikation (z.B. Artikelnummer, EAN, etc.) an.  
+  Der Eltern-Artikel wird daran identifiziert und dient der Zuordnung der Variante.
+- [Name der Auswahl] Diese sollte nur am Eltern-Artikel hinterlegt werden und definiert, wie die Auswahl zwischen den verschiedenen Varianten heißen soll. Z.B.: _"Größe"_, _"Farbe"_, _"Material"_
+- [Sprache 2: Name] Wählen Sie optional die CSV-Spalte für die 2te Sprache (Sprach-ID 1, [Name der Auswahl] hat die Sprach-ID 0)  aus. Z.B.: _"size"_, _"color"_, _"material"_
+- [Varianten: Auswahl] Hier wählen Sie die CSV-Spalte mit den Inhalten für die Variante aus. Z.B.: _"rot"_, _"grün"_, _"blau"_
+- [Varianten Sprache 2: Auswahl] Wählen Sie optional die CSV-Spalte für die 2te Sprache (Sprach-ID 1, [Varianten: Auswahl] hat die Sprach-ID 0)  aus. Z.B.: _"red"_, _"green"_, _"blue"_
+
+Klicken Sie abschließend auf [Speichern].

docs/daux/manual/020_Bedienungsanleitung/040_Importanleitung_ausfuehrlich/040_Artikelimport/100_Staffelpreise.md

@@ -0,0 +1,19 @@
+---
+title: Staffelpreise
+---
+![Artikelimport | Staffelpreise](../../../../assets/newAssets/Artikelimport-Staffelpreise.png)
+
+- [Importtyp] 
+  - [Nur Import] Die Staffelpreise werden dem Artikel neu zugeordnet oder aktualisiert. 
+  - [Staffelpreise vorher löschen] Alle Staffelpreise des Artikels werden vor dem Update gelöscht. 
+
+- Jede Preisstaffel benötigt mind. 3 Datenfelder: 
+  - [Staffelpreis n] CSV-Spalte mit dem jeweiligen Staffelpreis wählen 
+  - [Menge von] CSV-Spalte mit dem "ab Preis" wählen 
+  - [Menge bis] CSV-Spalte mit dem "bis Preis" wählen 
+  - [ist % Rabatt Preis?] Hier definieren Sie (optional), ob die Preisstaffel als prozentual importiert wird.  
+  Alternativ können Sie in der CSV-Datei den Wert in der Spalte [Staffelpreis n] mit % versehen (bspw.  5% oder 10%). 
+ 
+Klicken Sie abschließend auf [Speichern].
+
+> [i] Weitere Informationen finden Sie unter [Häufig gestellte Fragen](../../080_Haeufig_gestellte_Fragen.md)

docs/daux/manual/020_Bedienungsanleitung/040_Importanleitung_ausfuehrlich/040_Artikelimport/110_Hersteller_Lieferanten.md

@@ -0,0 +1,11 @@
+---
+title: Hersteller / Lieferanten
+---
+
+![Artikelimport | Hersteller & Lieferanten](../../../../assets/newAssets/Artikelimport-Hersteller.png)
+
+- [Lieferanten Importspalte] / [Hersteller Importspalte]  Ordnet die Dateispalte mit dem Lieferanten- bzw. Herstellernamen zu.  
+  - [ Ja] Existiert der Lieferant/Hersteller nicht im Shop, wird er neu angelegt und dem Artikel zugeordnet.   
+  - [Nein, nur Zuordnung] Der Artikel wird nur einem vorhandenen Lieferant/Hersteller zugeordnet.   
+  
+Klicken Sie abschließend auf [Speichern]. 

docs/daux/manual/020_Bedienungsanleitung/040_Importanleitung_ausfuehrlich/040_Artikelimport/120_Konfiguration/010_Grundeinstellungen.md

@@ -0,0 +1,25 @@
+---
+title: Grundeinstellungen
+---
+
+![Artikelimport | Konfiguration](../../../../../assets/newAssets/Artikelimport-KonfigGrundeinstellungenf.png)
+
+- [Importtyp] 
+  - [Import und Update] Alle CSV-Daten werden erst aktualisiert und anschließend -wenn nicht vorhanden- importiert. 
+  - [Nur Import] Alle CSV-Daten werden nur importiert. Vorhandene Artikeldaten werden **nicht** überschrieben. 
+  - [Nur Update] Alle CSV-Daten werden nur geschrieben, wenn bereits ein Artikel in der Datenbank gefunden wurde. 
+- [Dateizeilen pro Durchlauf]  
+  Legen Sie fest, wie viele Zeilen pro Importdurchlauf geladen werden sollen.  
+  Wenn Sie z.B. 100 eintragen, werden die ersten 100 Zeilen importiert.  
+  Danach wird die untere Seite neu geladen und die nächsten 100 Zeilen werden importiert, solange bis die komplette CSV-Datei eingelesen ist.  
+  Damit wird sichergestellt, dass der Importvorgang nicht abbricht (durch bspw. eingestellte Server Limitierungen).  
+- [Anzahl Datei-Kopfzeilen (werden nicht importiert)]  
+  Wenn Sie eine Spaltenüberschrift in Ihrer Import-Datei haben, können Sie die Anzahl der zu überspringenden Zeilen eintragen.  
+- [Artikelidentifikation]   
+  Legen Sie die eindeutige Artikelidentifikation fest. Das gewählte Feld **muss zwingend** unter [Artikelfelder], einer Importspalte zugeordnet werden.
+- [Definition von "ja" und "nein" Werten]  
+  In einer CSV-Datei können verschiedene Werte für einen "Aktiv"-Haken stehen.  
+  bspw.: _Ja/Nein_, _true/false_, _1/0_, _j/n_, _aktiv/inaktiv_.  
+  Geben Sie die einzelnen Werte zeilenweise getrennt ein, damit beim Importvorgang die Werte für den Shop übersetzt werden können.  
+
+> [i] Weitere Informationen finden Sie unter [Häufig gestellte Fragen](../../../080_Haeufig_gestellte_Fragen.md)

docs/daux/manual/020_Bedienungsanleitung/040_Importanleitung_ausfuehrlich/040_Artikelimport/120_Konfiguration/020_Preis_Optionen.md

@@ -0,0 +1,14 @@
+---
+title: Preis Optionen
+---  
+![Artikelimport | KonfigPreis](../../../../../assets/newAssets/Artikelimport-KonfigPreis.png)
+
+- [ Importierten Artikelpreis um x % erhöhen. ]  
+  Hier können Sie den importierten Artikelpreis prozentual erhöhen.  
+- [ Importierten Artikelpreis auf x Nachkommastellen runden. ]  
+  Geben Sie hier einen Wert ein, um den Artikelpreis zu runden.  
+  Beispiel: "2" bedeutet, dass von 12.3456 auf 12.35 oder von 1.95583 auf 1.96 gerundet wird.  
+  bei "1" wird von 12.3456 auf 12.3 oder von 1.95583 auf 2 gerundet.  
+
+> [!]Hinweis:  
+> Beide Optionen greifen lediglich bei dem normalen Artikelpreis (oxprice)!

docs/daux/manual/020_Bedienungsanleitung/040_Importanleitung_ausfuehrlich/040_Artikelimport/120_Konfiguration/030_Artikel_Ident_Optionen.md

@@ -0,0 +1,14 @@
+---
+title: Artikel-Ident Optionen (Expertenmodus)
+---  
+![Artikelimport | KonfigArtIdent](../../../../../assets/newAssets/Artikelimport-KonfigArtikIdent.png)
+
+- [ Artikelidentifikationsfeld als Ident (Datenfeld "oxid") nutzen ]  
+  Mit dieser Einstellung wird die verwendete [Artikelidentifikation] als interne Shop-Identifikationsnummer (oxid) genutzt.
+  Der Shop verwaltet die eindeutigen Shop-Identifikationsnummern selbst, daher sollte die Option mit Bedacht genutzt werden. 
+
+- [ Zusätzlich das Identfeld mit MD5 codieren ]  
+  Damit kann ein ähnlicher Ident wie bei einer oxid erzeugt werden.
+  Diese Option greift nur mit der aktiven Option [Artikelidentifikationsfeld als Ident (Datenfeld "oxid") nutzen].
+
+Klicken Sie abschließend auf [Speichern].

docs/daux/manual/020_Bedienungsanleitung/040_Importanleitung_ausfuehrlich/040_Artikelimport/125_Mall.md

@@ -0,0 +1,11 @@
+---
+title: Mall (nur EE)
+---
+
+![Artikelimport | Mall ](../../../../assets/newAssets/Artikelimport-Mall.png)
+
+> [i] Diese Seite betrifft nur EE-Funktionalität.
+ 
+- [Spaltenzuordnung] Setzen Sie die CSV-Spalte mit einer Liste von beliebig vielen Shop-ID's. Z.B. 1,2,3,4,5,6...  
+- [interne Spaltentrennung] Sofern mehr als ein Shop zugeordnet wird, geben Sie das verwendete Trennzeichen an.
+

docs/daux/manual/020_Bedienungsanleitung/040_Importanleitung_ausfuehrlich/040_Artikelimport/130_Import.md

@@ -0,0 +1,11 @@
+---
+title: Import
+---
+
+![Artikelimport | Import](../../../../assets/newAssets/Artikelimport-Import.png)
+
+Wenn Sie nun alle Einstellungen gespeichert haben, können Sie den [Artikelimport starten].  
+Danach zeigt Ihnen der Import, wie viele Zeilen aus Ihrer CSV-Datei importiert wurden, sowie das Ergebnis der bearbeiteten Artikel.  
+
+![Artikelimport | Import2](../../../../assets/newAssets/Artikelimport-Import2.png)
+

docs/daux/manual/020_Bedienungsanleitung/040_Importanleitung_ausfuehrlich/040_Artikelimport/140_nach_Import.md

@@ -0,0 +1,19 @@
+---
+title: Nach Import
+---
+
+![Artikelimport | Nach Import](../../../../assets/newAssets/Artikelimport-Nachimport.png)
+
+Sie sehen eine Übersicht, wie viele Artikel bereits mit diesem Profil bearbeitet wurden.
+(Die Informationen orientieren sich an Einträgen aus der Spalte d3importprofileid in oxarticles.)
+Folgende Einstellungen können Sie vornehmen:
+- [ Artikel pro Durchlauf ]  
+  Legen Sie fest, wie viele Zeilen pro Durchlauf geladen werden sollen.  
+  Wenn Sie z.B. 100 eintragen, werden die ersten 100 Artikel bearbeitet.  
+  Danach wird die untere Seite neu geladen und die nächsten 100 Artikel werden bearbeitet.  
+- [Alle Artikel deaktivieren] - deaktiviert alle Artikel <sup>1.</sup>
+- [Alle Artikel löschen] - löscht alle Artikel <sup>1.</sup>  
+  
+<sup>1. Betrifft Artikel, welche mit dem letztem Import **dieses** Profils nicht aktualisiert wurden.  
+Wurde ein Artikel bereits mit einem anderen Profil bearbeitet, wird dieser nicht beeinflusst.</sup>
+