add 5.0.6.3 sourceGuardian PHP8

composer.json

@@ -0,0 +1,43 @@
+{
+  "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": "https://www.d3data.de",
+        "role": "Owner"
+    }
+  ],
+  "homepage": "https://www.oxidmodule.com/",
+  "license": [
+    "proprietary"
+  ],
+  "extra": {
+    "oxideshop": {
+      "source-directory": "/src",
+      "target-directory": "d3/importer"
+    }
+  },
+  "require": {
+    "php": "^8.0",
+    "ext-sourceguardian": "*",
+    "oxid-esales/oxideshop-ce": "6.0 - 6.10",
+    "d3/modcfg": "^5.3.0.000 || ^6.0"
+  },
+  "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,473 @@
+---
+title: Changelog
+---
+## 5.0.6.3 - (2022-06-01)
+### Added
+- aktuelle Modul-Screenshots
+
+### Fixed
+- Staffelpreise vorher löschen bei Update
+
+## 5.0.6.2 - (2022-02-28)
+### Added
+- Installierbar in OXID 6.4.x
+
+### Fixed
+- Importtyp "import" legt keinen neuen Artikel an, wenn der Artikelidentifikation existiert
+
+## 5.0.6.1 - (2021-09-10)
+### Added
+- Hinweis auf zu große Uploaddatei
+- Installierbar in OXID 6.3.1
+
+### Fixed
+- Import überschreibt mandantenspezifische Felder mit Standardwerten aus Hauptmandant
+- veraltete explizit dem Bildimport zugewiesene Thumb- und Icondateien werden gelöscht (wenn aktiviert)
+- veraltete Bilder aus Image Slots abweichend vom Import Slot werden gelöscht (wenn aktiviert)
+
+---
+
+## 5.0.6.0 - (2021-07-08)
+### Fixed
+- Fehlerhafte Verwendung beim Aufruf von oxarticles behoben
+- Import der Staffelpreise nun auch mit nicht ganzzahlige Werten möglich
+- Probleme mit der Shop-ID behoben, die neue leere Artikel erzeugt hat
+
+
+---
+
+## 5.0.5.0 - (2021-05-03)
+### Changed
+- Installierbar in OXID 6.2.4 und 6.3
+- Adminmenüeintrag um Icon ergänzt
+- fügt nur die konfigurierte Anzahl Importbilderfelder und -indizes zur Datenbank hinzu
+
+---
+
+## 5.0.4.2 - (2021-04-13)
+### Fixed
+- nicht funktionierendes Preisupdate bei EE-Subshops mit vererbten Preisen korrigiert
+
+### Changed
+- Hinweis für Preisimporte mit prozentualer Veränderung ergänzt
+- Dokumentation aktualisiert
+
+---
+
+## 5.0.4.1 - (2020-11-30)
+### Added
+- Freigabe für OXID 6.2.3
+
+### Changed
+- Shopid für Tabelle d3importconfig auf init(11)
+
+---
+
+## 5.0.4.0 - (2020-04-20)
+### Added
+- installierbar in OXID 6.2
+
+### Changed
+- Abhängigkeiten für Installationen ohne Metapackage von OXID Metapackage zu Shop-Core geändert
+
+---
+
+## 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,73 @@
+{
+    "title": "<i class='fab fa-d3 d3fa-color-blue'></i> Importer",
+    "moduleversion": "5.0.6.3",
+    "titledesc": "für den Oxid eShop",
+    "author": "D³ Data Development",
+    "moduledate": "01.06.2022",
+    "editors": "",
+    "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",
+        "metadataident" : "d3importer",
+        "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,30 @@
+---
+title: Systemanforderungen
+---
+
+* PHP Version
+    * 5.6.x bis 8.0.x
+* PHP Decoder
+    * installierter ionCube Loader
+* Shopeditionen
+    * OXID eShop Community Edition (CE)
+    * OXID eShop Professional Edition (PE)
+    * OXID eShop Enterprise Edition (EE)
+    * OXID eShop B2B Edition
+* Shopversionen
+    * OXID eShop in Compilation Version 
+        * 6.0.x
+        * 6.1.x
+        * 6.2.x
+        * 6.3.x
+        * 6.4.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.3.0.0 
+* Installation via [Composer](https://getcomposer.org)
+* mindestens ein freier Cronjob zur automatischen Ausführung der angelegten Aufgaben
+
+Beachten Sie, dass die Ihnen vorliegende Modulversion entsprechend für Ihre genutzte PHP-Version 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,15 @@
+---
+title: Modul zur Installation hinzufügen
+---
+
+### **auf der Kommandozeile**
+
+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}:^{$moduleversion} --update-no-dev
+``` 
+
+> [!] Achten Sie darauf, dass Composer für die Installation die selbe PHP-Version verwendet, in der auch Ihr Shop ausgeführt wird. Sie erhalten sonst möglicherweise 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/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,19 @@
+---
+title: Modul im Shop aktivieren
+---
+
+### **im Adminbereich**
+
+Aktivieren Sie das Modul über den Shopadmin unter [ Erweiterungen ] -> [ Module ]. Klicken Sie nach Auswahl von [ {$menutitle} ] auf den Button [ Aktivieren ].
+
+### **oder auf der Kommandozeile**
+
+Alternativ können Sie die Modulaktivierung auch auf der Kommandozeile (CLI) im Hauptverzeichnis Ihres Shops (oberhalb des `source`- und `vendor`-Verzeichnisses) durchführen. 
+
+```bash
+./vendor/bin/oe-console oe:module:activate {$metadataident}
+```
+
+> [!] **Enterprise Edition**: Achten Sie darauf, dass das Modul in weiteren Shops (Mall) ebenfalls aktiviert werden muss, um dessen Funktion dort auch zu nutzen.
+
+> [i] **Enterprise Edition**: Zur Aktivierung in einem bestimmten Shopmandanten verwenden Sie das `--shop-id`-Argument (`...oe-console --shop-id 1 oe:module...`)

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

@@ -0,0 +1,21 @@
+---
+title: Shopanpassungen installieren
+---
+
+### **im Adminbereich**
+
+Direkt nach der Modulaktivierung startet der Assistent, der Sie durch die Shopanpassung führt. Darin können Sie verschiedene Optionen der Installation wählen.
+
+Den Installationsassistenten finden Sie auch unter den Menüpunkten [ Admin ] -> [ (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 Nacharbeiten für das Modul ausführen zu lassen.
+
+Möchten Sie die Änderungen manuell installieren, können Sie sich über diesen Assistenten ebenfalls eine Checkliste erstellen.
+
+### **oder auf der Kommandozeile**
+
+Der Installationsassistent steht Ihnen ebenfalls auf der Kommandozeile (CLI) zur Verfügung. Führen Sie diesen Befehl im Hauptverzeichnis Ihres Shops (oberhalb des `source`- und `vendor`-Verzeichnisses) aus:
+
+```bash
+./vendor/bin/d3modules_install
+```

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,21 @@
+---
+title: TMP-Ordner leeren
+---
+
+### **im Adminbereich**
+
+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.
+
+### **oder auf der Kommandozeile**
+
+Alle TMP-leeren-Aktionen stehen Ihnen ebenfalls auf der Kommandozeile (CLI) zur Verfügung. Führen Sie diesen Befehl im Hauptverzeichnis Ihres Shops (oberhalb des `source`- und `vendor`-Verzeichnisses) aus:
+
+```bash
+./vendor/bin/d3cleartmp
+```
+
+> [i] Erfordert Ihre Installation eine andere Vorgehensweise zum Leeren des Caches oder zum Aktualisieren der Datenbank-Viewtabellen, führen Sie diese bitte aus.
+
+> [i] Beim Kommandozeilenaufruf werden Ihnen weitere Optionen gezeigt, mit denen Sie die Aktion gezielt steuern können.

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

@@ -0,0 +1,21 @@
+---
+title: Lizenzschlüssel eintragen
+---
+
+### **im Adminbereich**
+
+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.
+
+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,16 @@
+---
+Title: Schnellstart per Composer
+---
+
+## Schnellstart per Composer
+
+### **auf der Kommandozeile**
+
+```bash
+php composer require {$composerident}:^{$moduleversion} --update-no-dev
+./vendor/bin/oe-console oe:module:activate {$metadataident}
+./vendor/bin/d3modules_install
+./vendor/bin/d3cleartmp
+```
+
+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 Updateanweisungen 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,19 @@
+---
+title: Modul deaktivieren
+---
+
+### **im Adminbereich**
+
+Deaktivieren Sie das Modul unter [ Erweiterungen ] -> [ Module ]. Klicken Sie nach Auswahl von [ {$menutitle} ] auf den Button [ Deaktivieren ].
+
+### **oder auf der Kommandozeile**
+
+Alternativ können Sie die Moduldeaktivierung auch über die Kommandozeile (CLI) im Hauptverzeichnis Ihres Shops (oberhalb des `source`- und `vendor`-Verzeichnisses) durchführen.
+
+```bash
+./vendor/bin/oe-console oe:module:deactivate {$metadataident}
+```
+
+> [!] **Enterprise Edition**: Achten Sie darauf, dass das Modul in allen weiteren Shops (Mall) ebenfalls deaktiviert werden muss.
+
+> [i] **Enterprise Edition**: Zur Deaktivierung in einem bestimmten Shopmandanten verwenden Sie das `--shop-id`-Argument (`...oe-console --shop-id 1 oe:module...`)

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

@@ -0,0 +1,18 @@
+---
+title: Dateien erneuern
+---
+
+### **auf der Kommandozeile**
+
+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 require {$composerident}:^{$moduleversion} --update-no-dev
+```
+
+Im weiteren Ablauf werden Sie gefragt, ob die Moduldateien überschrieben werden sollen. Bestätigen Sie dies für den Eintrag `{$composerident}`.
+
+> [!] Achten Sie darauf, dass Composer für die Installation die selbe PHP-Version verwendet, in der auch Ihr Shop ausgeführt wird. Sie erhalten sonst möglicherweise 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,19 @@
+---
+title: Modulinformationen aktualisieren
+---
+
+### **im Adminbereich**
+
+Wechseln Sie im Adminbereich zu [ Erweiterungen ] -> [ Module ]. Klicken Sie nach Auswahl von [ {$menutitle} ] auf den Button [ Aktivieren ].
+
+### **oder auf der Kommandozeile**
+
+Alternativ können Sie die Modulaktivierung auch über die Kommandozeile (CLI) im Hauptverzeichnis Ihres Shops (oberhalb des `source`- und `vendor`-Verzeichnisses) durchführen. 
+
+```bash
+./vendor/bin/oe-console oe:module:activate {$metadataident}
+```
+
+> [!] **Enterprise Edition**: Achten Sie darauf, dass das Modul in weiteren Shops (Mall) ebenfalls aktiviert werden muss, um dessen Funktion dort auch zu nutzen.
+
+> [i] **Enterprise Edition**: Zur Aktivierung in einem bestimmten Shopmandanten verwenden Sie das `--shop-id`-Argument (`...oe-console --shop-id 1 oe:module...`)

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

@@ -0,0 +1,21 @@
+---
+title: Shopanpassungen installieren
+---
+
+### **im Adminbereich**
+
+Ob Shopanpassungen notwendig sind, ist von der Versionsänderung des Moduls abhängig.
+  
+Möglicherweise sehen Sie nach dem Neuaktivieren des Moduls den Installationsassistent, der Sie durch die Änderungen führt. Folgen Sie dann den einzelnen Schritten. Möchten Sie die Änderungen manuell installieren, können Sie sich über diesen Assistenten ebenfalls eine Checkliste erstellen.
+ 
+Wird der Assistent nicht gezeigt (Sie sehen wieder die Modulübersicht), waren keine Anpassungen am Shop notwendig.
+  
+Ob erforderliche Updates ausgeführt werden sollen, können Sie jederzeit im Adminbereich unter [ (D3) Module ] -> [ Modul-Connector ] -> [ Modulverwaltung ] -> [ Modulinstallation ] prüfen.
+
+### **oder auf der Kommandozeile**
+
+Der Installationsassistent steht Ihnen ebenfalls auf der Kommandozeile (CLI) zur Verfügung. Führen Sie diesen Befehl im Hauptverzeichnis Ihres Shops (oberhalb des `source`- und `vendor`-Verzeichnisses) aus:
+
+```bash
+./vendor/bin/d3modules_install
+```

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

@@ -0,0 +1,21 @@
+---
+title: TMP-Ordner leeren
+---
+
+### **im Adminbereich**
+
+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.
+
+### **oder auf der Kommandozeile**
+
+Alle TMP-leeren-Aktionen stehen Ihnen ebenfalls auf der Kommandozeile (CLI) zur Verfügung. Führen Sie diesen Befehl im Hauptverzeichnis Ihres Shops (oberhalb des `source`- und `vendor`-Verzeichnisses) aus:
+
+```bash
+./vendor/bin/d3cleartmp
+```
+
+> [i] Erfordert Ihre Installation eine andere Vorgehensweise zum Leeren des Caches oder zum Aktualisieren der Datenbank-Viewtabellen, führen Sie diese bitte aus.
+
+> [i] Beim Kommandozeilenaufruf werden Ihnen weitere Optionen gezeigt, mit denen Sie die Aktion gezielt steuern können.

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

@@ -0,0 +1,7 @@
+---
+title: Lizenzschlüssel aktualisieren
+---
+
+### **im Adminbereich**
+
+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,15 @@
+---
+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).
+
+Nach der Installation der Demodaten lassen Sie bitte die Shopanpassungen nachtragen. Verwenden Sie dazu bitte diesen [Ablauf](/installation/020_Neuinstallation/060_Shopanpassungen_installieren.md).

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,19 @@
+---
+title: Modul deaktivieren
+---
+
+### **im Adminbereich**
+
+Deaktivieren Sie das Modul unter [ Erweiterungen ] -> [ Module ]. Klicken Sie nach Auswahl von [ {$menutitle} ] auf den Button [ Deaktivieren ].
+
+### **oder auf der Kommandozeile**
+
+Alternativ können Sie die Moduldeaktivierung auch über die Kommandozeile (CLI) im Hauptverzeichnis Ihres Shops (oberhalb des `source`- und `vendor`-Verzeichnisses) durchführen.
+
+```bash
+./vendor/bin/oe-console oe:module:deactivate {$metadataident}
+```
+
+> [!] **Enterprise Edition**: Achten Sie darauf, dass das Modul in allen weiteren Shops (Mall) ebenfalls deaktiviert werden muss.
+
+> [i] **Enterprise Edition**: Zur Deaktivierung in einem bestimmten Shopmandanten verwenden Sie das `--shop-id`-Argument (`...oe-console --shop-id 1 oe:module...`)

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

@@ -0,0 +1,13 @@
+---
+title: Modul aus der Installation entfernen
+---
+
+### **auf der Kommandozeile**
+
+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
+``` 
+
+> [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#remove).

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,21 @@
+---
+title: TMP-Ordner leeren
+---
+
+### **im Adminbereich**
+
+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.
+
+### **oder auf der Kommandozeile**
+
+Alle TMP-leeren-Aktionen stehen Ihnen ebenfalls auf der Kommandozeile (CLI) zur Verfügung. Führen Sie diesen Befehl im Hauptverzeichnis Ihres Shops (oberhalb des `source`- und `vendor`-Verzeichnisses) aus:
+
+```bash
+./vendor/bin/d3cleartmp
+```
+
+> [i] Erfordert Ihre Installation eine andere Vorgehensweise zum Leeren des Caches oder zum Aktualisieren der Datenbank-Viewtabellen, führen Sie diese bitte aus.
+
+> [i] Beim Kommandozeilenaufruf werden Ihnen weitere Optionen gezeigt, mit denen Sie die Aktion gezielt steuern können.

docs/daux/manual/020_Bedienungsanleitung/005_Demodaten.md

@@ -0,0 +1,15 @@
+---
+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).
+
+Nach der Installation der Demodaten lassen Sie bitte die Shopanpassungen nachtragen. Verwenden Sie dazu bitte diesen [Ablauf](/installation/020_Neuinstallation/060_Shopanpassungen_installieren.md).

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)
+