commit eb157813e53e87a698529363722f4bfc461d3399 Author: Daniel Seifert Date: Tue Feb 19 09:10:12 2019 +0100 Squashed 'docs/daux/' content from commit 59023c3 git-subtree-dir: docs/daux git-subtree-split: 59023c3527581ff993fc7484b93b3c4b4d124fe0 diff --git a/_index.md b/_index.md new file mode 100644 index 0000000..375dd7a --- /dev/null +++ b/_index.md @@ -0,0 +1,2 @@ +Weitere Informationen zum Modul **{$modulename}** finden Sie in unserem Shop: +[https://www.oxidmodule.com/OXID-eShop/Module/MODULNAME-fuer-Oxid-PE.html](https://www.oxidmodule.com/OXID-eShop/Module/MODULNAME-fuer-Oxid-PE.html) diff --git a/changelog/010_Changelog.md b/changelog/010_Changelog.md new file mode 100644 index 0000000..7c8f437 --- /dev/null +++ b/changelog/010_Changelog.md @@ -0,0 +1,18 @@ +--- +title: Changelog +--- + +## noch nicht veröffentlicht + +## 1.0.0.1 +2018-05-29 - #1235 +#### Fixed +- Einstellungs-Überladung korrigiert - verwendet Einstellungen der Hauptsprache, wenn in aktueller Sprache keine Einstellungen gespeichert wurden + +#### Changed +- kleine Textänderungen in der Installationsroutine + +## 1.0.0.0 +2018-05-15 - #1234 +#### Added +- Angepasst für Shopversion 6.x, Installation via Composer diff --git a/config.json b/config.json new file mode 100644 index 0000000..f80c5a2 --- /dev/null +++ b/config.json @@ -0,0 +1,77 @@ +{ + "title": " MODULNAME", + "moduleversion": "5.0.0.0", + "titledesc": "für den Oxid eShop", + "author": "D³ Data Development", + "moduledate": "17.04.2018", + "editors": "XX/YY", + "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", + "Blog": "https://blog.oxidmodule.com", + "FAQ": "https://faq.oxidmodule.com", + "D³ Support-Center": "https://support.shopmodule.com/", + "Kontakt": "https://www.oxidmodule.com/kontakt", + "Impressum": "https://www.oxidmodule.com/impressum" + }, + + "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" : " MODULNAME", + "menutitle" : " MODULNAME", + "modulefolder" : "module_folder", + "modcfgident" : "d3modident", + "composerident" : "d3/moduleident" + }, + "versionselector": false, + "versiondirectoryindex": 2 +} diff --git a/installation/010_Anforderungen/010_Systemanforderungen.md b/installation/010_Anforderungen/010_Systemanforderungen.md new file mode 100644 index 0000000..871351e --- /dev/null +++ b/installation/010_Anforderungen/010_Systemanforderungen.md @@ -0,0 +1,19 @@ +--- +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 +* D3 Modul-Connector ([kostenfrei bei D3 erhältlich](https://www.oxidmodule.com/connector/)) ab Version 5.1.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 **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. diff --git a/installation/010_Anforderungen/030_Kompatibilitaet_mit_anderen_Modulen.md b/installation/010_Anforderungen/030_Kompatibilitaet_mit_anderen_Modulen.md new file mode 100644 index 0000000..5f91b53 --- /dev/null +++ b/installation/010_Anforderungen/030_Kompatibilitaet_mit_anderen_Modulen.md @@ -0,0 +1,5 @@ +--- +title: Kompatibilität mit anderen Modulen +--- + +Das „Modul“ integriert sich auch in die Erweiterung „Visual CMS“ von OXID eSales AG & digidesk - media solutions, sofern diese im Shop installiert wurde. Diese Integration wurde für die Version 3.0.0 des „Visual CMS“-Moduls entwickelt. \ No newline at end of file diff --git a/installation/010_Anforderungen/040_Beiliegende_Bibliotheken.md b/installation/010_Anforderungen/040_Beiliegende_Bibliotheken.md new file mode 100644 index 0000000..29e9adc --- /dev/null +++ b/installation/010_Anforderungen/040_Beiliegende_Bibliotheken.md @@ -0,0 +1,8 @@ +--- +title: beiliegende Bibliotheken +--- + +Dem Modul liegt eine Kopie der **XYZ**-Bibliothek bei. Bitte beachten Sie auch deren folgende Lizenzhinweise: + +- Lizenzhinweis #1 +- Lizenzhinweis #2 \ No newline at end of file diff --git a/installation/010_Anforderungen/050_Vorbereitungen.md b/installation/010_Anforderungen/050_Vorbereitungen.md new file mode 100644 index 0000000..45c5610 --- /dev/null +++ b/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 kostenfreien Connector. +Informationen zu dessen Installation finden Sie auf unserer [Homepage](https://www.oxidmodule.com/Connector/). + +Klicken Sie auf den Reiter [ Downloads ] und wählen dort das für Ihre Installation passende Paket. \ No newline at end of file diff --git a/installation/020_Neuinstallation/005_Vorbereitung.md b/installation/020_Neuinstallation/005_Vorbereitung.md new file mode 100644 index 0000000..58e0a6a --- /dev/null +++ b/installation/020_Neuinstallation/005_Vorbereitung.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, laden Sie den Connector kostenfrei von unserer [Homepage](http://www.oxidmodule.com/Connector/). + +Klicken Sie auf den Reiter [ Download ] und dort auf den Link [ Download Erstinstallation Modul-Connector ]. \ No newline at end of file diff --git a/installation/020_Neuinstallation/020_Modul_hinzufuegen.md b/installation/020_Neuinstallation/020_Modul_hinzufuegen.md new file mode 100644 index 0000000..90d80bf --- /dev/null +++ b/installation/020_Neuinstallation/020_Modul_hinzufuegen.md @@ -0,0 +1,11 @@ +--- +title: Modul zur Installation hinzufügen +--- + +Führen Sie in der Konsole im selben Verzeichnis 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). \ No newline at end of file diff --git a/installation/020_Neuinstallation/030_Verwendung_eigener_Themes.md b/installation/020_Neuinstallation/030_Verwendung_eigener_Themes.md new file mode 100644 index 0000000..154f0c5 --- /dev/null +++ b/installation/020_Neuinstallation/030_Verwendung_eigener_Themes.md @@ -0,0 +1,14 @@ +--- +title: Verwendung eigener Themes +--- + +Das Modul ist für die Verwendung mit den folgenden OXID-Themes vorbereitet: + +* Flow +* Azure + +Verwenden Sie in Ihrem Shop ein angepasstes Verzeichnis für Ihre Templates (neues Theme oder CustomTheme), kopieren Sie die Templates und / oder die CSS-Dateien in die neuen Ordner. + +Ähnelt Ihr neues Theme technisch einem der OXID-Originale, können Sie dieses darauf umleiten. Childs von originalen OXID- Themes benötigen keine Umleitung. + +Weitere Informationen zur Umleitung finden Sie in unserer [FAQ](http://faq.oxidmodule.com/Modulinstallation/Modulanpassungen/themespezifische-Templatebloecke-fuer-eigenes-Theme-verwenden.html). \ No newline at end of file diff --git a/installation/020_Neuinstallation/040_Providerspezifische_Installation.md b/installation/020_Neuinstallation/040_Providerspezifische_Installation.md new file mode 100644 index 0000000..d8d5d0c --- /dev/null +++ b/installation/020_Neuinstallation/040_Providerspezifische_Installation.md @@ -0,0 +1,5 @@ +--- +title: Providerspezifische Installation +--- + +Manche Provider erfordern besondere Einstellungen für installierte Module. Ob Ihr Anbieter spezielle Anforderungen stellt und wie diese aussehen, kontrollieren Sie bitte in unserer [FAQ](http://faq.oxidmodule.com/Modulinstallation/providerspezifische-Installation/). \ No newline at end of file diff --git a/installation/020_Neuinstallation/050_Modul_im_Shop_aktivieren.md b/installation/020_Neuinstallation/050_Modul_im_Shop_aktivieren.md new file mode 100644 index 0000000..02ea797 --- /dev/null +++ b/installation/020_Neuinstallation/050_Modul_im_Shop_aktivieren.md @@ -0,0 +1,7 @@ +--- +title: Modul im Shop aktivieren +--- + +Aktivieren Sie das Modul über den Shopadmin unter [ Erweiterungen ] -> [ Module ]. Klicken Sie nach Auswahl von [ {$menutitle} ] auf den Button [ Aktivieren ]. + +> [!] **Enterprise Editon**: Achten Sie darauf, dass das Modul in weiteren Shops (Mall) ebenfalls aktiviert werden muss, um dessen Funktion dort auch zu nutzen. \ No newline at end of file diff --git a/installation/020_Neuinstallation/060_Shopanpassungen_installieren.md b/installation/020_Neuinstallation/060_Shopanpassungen_installieren.md new file mode 100644 index 0000000..7135098 --- /dev/null +++ b/installation/020_Neuinstallation/060_Shopanpassungen_installieren.md @@ -0,0 +1,11 @@ +--- +title: Shopanpassungen installieren +--- + +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. \ No newline at end of file diff --git a/installation/020_Neuinstallation/070_TMP-Ordner_leeren.md b/installation/020_Neuinstallation/070_TMP-Ordner_leeren.md new file mode 100644 index 0000000..0c31efc --- /dev/null +++ b/installation/020_Neuinstallation/070_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. \ No newline at end of file diff --git a/installation/020_Neuinstallation/080_Lizenz_eintragen.md b/installation/020_Neuinstallation/080_Lizenz_eintragen.md new file mode 100644 index 0000000..259c5b5 --- /dev/null +++ b/installation/020_Neuinstallation/080_Lizenz_eintragen.md @@ -0,0 +1,9 @@ +--- +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. + +Speziell **{$modulename}** wird in unterschiedlichen (teilweise kostenfreien) Editionen für den Livebetrieb angeboten. Besuchen Sie unseren [Moduleshop](https://www.oxidmodule.com/), um mehr darüber zu erfahren. + +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. \ No newline at end of file diff --git a/installation/020_Neuinstallation/090_Cronjob_einrichten.md b/installation/020_Neuinstallation/090_Cronjob_einrichten.md new file mode 100644 index 0000000..2e1d25f --- /dev/null +++ b/installation/020_Neuinstallation/090_Cronjob_einrichten.md @@ -0,0 +1,13 @@ +--- +title: Cronjob einrichten +--- + +Legen Sie den Cronjob für die automatische Bearbeitung der eingerichteten Aufträge an. Die für die Anlage benötigten Daten finden Sie im Adminbereich des Moduls unter [D3 Module] -> [{$menutitle}] -> [Einstellungen] -> [Grundeinstellungen]. Weitere Informationen zum Anlegen von Cronjobs finden Sie in unserer [FAQ](https://faq.oxidmodule.com/Modulinstallation/Wie-werden-Cronjobs-angelegt.html). + +> [!!] Sie sollten unbedingt den Aufruf von `.sh`-Dateien via Browser verhindern, so dass kein Unbefugter die Datei von außen aufrufen kann. Dazu können Sie z.B. die `.htaccess`-Datei des Shops um folgende Zeilen erweitern: + +```htaccess + + Require all denied + +``` \ No newline at end of file diff --git a/installation/020_Neuinstallation/100_Updatefaehigkeit.md b/installation/020_Neuinstallation/100_Updatefaehigkeit.md new file mode 100644 index 0000000..e525385 --- /dev/null +++ b/installation/020_Neuinstallation/100_Updatefaehigkeit.md @@ -0,0 +1,7 @@ +--- +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 verändern und erhalten sich so die Updatefähigkeit des Shops und des Moduls. Beachten Sie, dass Moduldateien bei Updateinstallationen überschrieben werden. + +Weitere Informationen zu den Überladungsmöglichkeiten verschiedener Dateien finden Sie in unserer [FAQ](http://faq.oxidmodule.com/Modulinstallation/Modulanpassungen/). \ No newline at end of file diff --git a/installation/020_Neuinstallation/_index.md b/installation/020_Neuinstallation/_index.md new file mode 100644 index 0000000..99e8a78 --- /dev/null +++ b/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. \ No newline at end of file diff --git a/installation/030_Update/010_Modul_deaktivieren.md b/installation/030_Update/010_Modul_deaktivieren.md new file mode 100644 index 0000000..ba3f82d --- /dev/null +++ b/installation/030_Update/010_Modul_deaktivieren.md @@ -0,0 +1,5 @@ +--- +title: Modul deaktivieren +--- + +Deaktivieren Sie das Modul über den Shopadmin unter [ Erweiterungen ] -> [ Module ]. Klicken Sie nach Auswahl von [ {$menutitle} ] auf den Button [ Deaktivieren ]. \ No newline at end of file diff --git a/installation/030_Update/015_Paketquelle_entfernen.md b/installation/030_Update/015_Paketquelle_entfernen.md new file mode 100644 index 0000000..33179d1 --- /dev/null +++ b/installation/030_Update/015_Paketquelle_entfernen.md @@ -0,0 +1,16 @@ +--- +title: Paketquelle entfernen +--- + +Durch einen Wechsel der Paketquelle ist die veraltete Angabe nicht mehr erforderlich. Um Konflikte zu vermeiden, sollte die alte Paketquelle entfernt werden. Haben Sie diese schon früher entfernt, können Sie diesen Schritt überspringen. + +Starten Sie die Konsole Ihres Webservers und wechseln in das Hauptverzeichnis Ihres Shops (oberhalb des `source`- und `vendor`-Verzeichnisses). Senden Sie dort diesen Befehl ab: + +```bash +php composer config --unset repositories.d3 +php composer config --unset repositories.D3modules +``` + +> [!] 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). diff --git a/installation/030_Update/020_Dateien_erneuern.md b/installation/030_Update/020_Dateien_erneuern.md new file mode 100644 index 0000000..950d51e --- /dev/null +++ b/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). \ No newline at end of file diff --git a/installation/030_Update/030_Providerspezifische_Installation.md b/installation/030_Update/030_Providerspezifische_Installation.md new file mode 100644 index 0000000..d8d5d0c --- /dev/null +++ b/installation/030_Update/030_Providerspezifische_Installation.md @@ -0,0 +1,5 @@ +--- +title: Providerspezifische Installation +--- + +Manche Provider erfordern besondere Einstellungen für installierte Module. Ob Ihr Anbieter spezielle Anforderungen stellt und wie diese aussehen, kontrollieren Sie bitte in unserer [FAQ](http://faq.oxidmodule.com/Modulinstallation/providerspezifische-Installation/). \ No newline at end of file diff --git a/installation/030_Update/040_Modulinformationen_aktualisieren.md b/installation/030_Update/040_Modulinformationen_aktualisieren.md new file mode 100644 index 0000000..5e27899 --- /dev/null +++ b/installation/030_Update/040_Modulinformationen_aktualisieren.md @@ -0,0 +1,5 @@ +--- +title: Modulinformationen aktualisieren +--- + +Wechseln Sie im Adminbereich zu [ Erweiterungen ] -> [ Module ]. Klicken Sie nach Auswahl von [ {$menutitle} ] auf den Button [ Aktivieren ]. \ No newline at end of file diff --git a/installation/030_Update/050_Shopanpassungen_installieren.md b/installation/030_Update/050_Shopanpassungen_installieren.md new file mode 100644 index 0000000..b97fbb8 --- /dev/null +++ b/installation/030_Update/050_Shopanpassungen_installieren.md @@ -0,0 +1,11 @@ +--- +title: Shopanpassungen installierren +--- + +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. \ No newline at end of file diff --git a/installation/030_Update/060_TMP-Ordner_leeren.md b/installation/030_Update/060_TMP-Ordner_leeren.md new file mode 100644 index 0000000..0c31efc --- /dev/null +++ b/installation/030_Update/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. \ No newline at end of file diff --git a/installation/030_Update/070_Lizenzschluessel_aktualisieren.md b/installation/030_Update/070_Lizenzschluessel_aktualisieren.md new file mode 100644 index 0000000..4ee267e --- /dev/null +++ b/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. \ No newline at end of file diff --git a/installation/030_Update/080_Erweiterungen_anpassen.md b/installation/030_Update/080_Erweiterungen_anpassen.md new file mode 100644 index 0000000..5fc0aa2 --- /dev/null +++ b/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. \ No newline at end of file diff --git a/installation/040_Installationspruefung.md b/installation/040_Installationspruefung.md new file mode 100644 index 0000000..2b69e15 --- /dev/null +++ b/installation/040_Installationspruefung.md @@ -0,0 +1,29 @@ +--- +title: Installationsprüfung +--- + +Um die erfolgreiche Installation zu prüfen, können Sie die folgende(n) Checkliste(n) 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 +* Modul zeigt unter [ Artikel verwalten ] -> [ Artikel ] -> [ Erweitert ] die Einstellung [ Wichtigkeit des Artikels im Sortiment ] +* ... um weitere Punkte ergänzen + +### Frontend + +* Punkte einfügen oder Absatz entfernen + +## Einstellungsabhängige Prüfungen + +### Backend + +* Punkte einfügen oder Absatz entfernen + +### Frontend + +* Punkte einfügen oder Absatz entfernen diff --git a/installation/050_Schnellstart.md b/installation/050_Schnellstart.md new file mode 100644 index 0000000..3c3f7b1 --- /dev/null +++ b/installation/050_Schnellstart.md @@ -0,0 +1,7 @@ +--- +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}] -> [Einstellungen] erreichen Sie die Einstellseiten. 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/000_Handbuch.md) umfangreicher beschrieben. diff --git a/installation/060_Deinstallation/010_Modulerweiterungen_deaktivieren_und_entfernen.md b/installation/060_Deinstallation/010_Modulerweiterungen_deaktivieren_und_entfernen.md new file mode 100644 index 0000000..e67e777 --- /dev/null +++ b/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. \ No newline at end of file diff --git a/installation/060_Deinstallation/020_Modul_deaktivieren.md b/installation/060_Deinstallation/020_Modul_deaktivieren.md new file mode 100644 index 0000000..067dc42 --- /dev/null +++ b/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 ]. + diff --git a/installation/060_Deinstallation/030_Modul_aus_der_Installation_entfernen.md b/installation/060_Deinstallation/030_Modul_aus_der_Installation_entfernen.md new file mode 100644 index 0000000..344eb78 --- /dev/null +++ b/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). diff --git a/installation/060_Deinstallation/040_Dateien_loeschen.md b/installation/060_Deinstallation/040_Dateien_loeschen.md new file mode 100644 index 0000000..7eeab89 --- /dev/null +++ b/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? diff --git a/installation/060_Deinstallation/050_Datenbank_bereinigen.md b/installation/060_Deinstallation/050_Datenbank_bereinigen.md new file mode 100644 index 0000000..c72f25a --- /dev/null +++ b/installation/060_Deinstallation/050_Datenbank_bereinigen.md @@ -0,0 +1,31 @@ +--- +title: Datenbank bereinigen +--- + +Das Modul legt Informationen in der Datenbank ab. Sofern diese Daten nicht mehr benötigt werden, können diese gelöscht werden. + +> [!] Legen Sie sich vorab bitte unbedingt eine Sicherung an, um die Daten im Zweifelsfall wiederherstellen zu können. + +Für das Modul **{$modulename}** sind dies die folgende Tabellen und Felder: + +* die komplette Tabelle `tablename` +* sofern vorhanden: `tablename_setX` *) + +und diese Felder in bestehenden Tabellen: + +* in Tabelle `oxorder`: + * das Feld `fieldname1` + * das Feld `fieldname2` +* in Tabelle `oxuser`: + * das Feld `fieldname3` + * das Feld `fieldname4` + +sowie diese Einträge bestehenden Tabellen: + +* in Tabelle `d3_cfg_mod`: + * den Eintrag `oxmodid = "{$modcfgident}"` **) + +*) `_setX` ist eine Tabellenliste, die mit `_set1` beginnen und shopabhängig auch Tabellen mit höheren Nummerierungen enthalten kann (z.B. `_set2`, `_set3`, …). +Zu einigen dieser Tabellen wurden die Config-Einträge `aMultiLangTables` (bei Enterprise Edition auch `aMultiShopTables`) um entsprechende Einträge ergänzt). Bereinigen Sie diese ebenfalls. + +**) Diesen Eintrag gibt es ggf. für jeden Subshop. Entfernen Sie diesen nur für die Mandanten, in denen das Modul **nicht** mehr installiert ist. \ No newline at end of file diff --git a/installation/060_Deinstallation/060_TMP-Ordner_leeren.md b/installation/060_Deinstallation/060_TMP-Ordner_leeren.md new file mode 100644 index 0000000..0c31efc --- /dev/null +++ b/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. \ No newline at end of file diff --git a/installation/_index.md b/installation/_index.md new file mode 100644 index 0000000..8105fae --- /dev/null +++ b/installation/_index.md @@ -0,0 +1,10 @@ +--- +title: Installation / Update / Deinstallation +--- + +* [Anforderungen](installation/010_Anforderungen/010_Systemanforderungen.md) +* [Neuinstallation](installation/020_Neuinstallation/010_Paketquelle_hinzufuegen.md) +* [Update](installation/030_Update/010_Modul_deaktivieren.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. diff --git a/manual/000_Handbuch.md b/manual/000_Handbuch.md new file mode 100644 index 0000000..834f612 --- /dev/null +++ b/manual/000_Handbuch.md @@ -0,0 +1 @@ +It starts here. diff --git a/manual/010_Konfiguration/010_Options.md b/manual/010_Konfiguration/010_Options.md new file mode 100644 index 0000000..fa26afe --- /dev/null +++ b/manual/010_Konfiguration/010_Options.md @@ -0,0 +1,4 @@ +--- +title: Benutzerhandbuch +--- + diff --git a/support/010_Hilfe-und-Support.md b/support/010_Hilfe-und-Support.md new file mode 100644 index 0000000..8e9bd17 --- /dev/null +++ b/support/010_Hilfe-und-Support.md @@ -0,0 +1,16 @@ +--- +title: Hilfe und Support +--- + +Bei Bedarf bieten wir Ihnen auch gern die Installation des Moduls in Ihrem Shop an. Geben Sie uns bitte unter den unten genannten Kontaktdaten Bescheid. + +Haben Sie Fragen oder Unklarheiten in Verbindung mit diesem Modul oder dessen Installation, stehen Ihnen Hilfetexte in unserer [Modul-FAQ](http://faq.oxidmodule.com/) zur Verfügung. Finden Sie darin die benötigten Antworten nicht, kontaktieren Sie uns bitte unter den folgenden Möglichkeiten: +1. per E-Mail: oder +2. über das Kontaktformular auf [Oxidmodule.com](https://www.oxidmodule.com/) oder +3. per Telefon: (+49) 37 21 / 26 80 90 zu unseren Bürozeiten + +Geben Sie bitte an, wo und wie wir gegebenenfalls vorhandene Schwierigkeiten nachvollziehen können. Sind Ihre Fragen shopspezifisch, benötigen wir möglicherweise Zugangsdaten zum betreffenden Shop. + +Wir wünschen Ihnen mit Ihrem Shop und dem Modul viel Erfolg! + +Ihr D³-Team.