diff --git a/README.md b/README.md index ea5d9481..b906144e 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ Lassen Sie wiederkehrende Aufgaben automatisch nach frei definierbaren Regeln au [![Latest Stable Release](https://img.shields.io/packagist/v/d3/ordermanager.svg?label=aktuelles%20Release)](https://packagist.org/packages/d3/ordermanager) ![](https://img.shields.io/badge/V6--konform-komplett-brightgreen.svg) ![](https://img.shields.io/badge/softwaregetestet-komplett-brightgreen.svg) -![](https://img.shields.io/badge/Testabdeckung-100%25-brightgreen.svg) +![](https://img.shields.io/badge/Testabdeckung-99%25-brightgreen.svg) [![Downloads](https://img.shields.io/packagist/dt/d3/ordermanager.svg?label=Downloads)](https://packagist.org/packages/d3/ordermanager) [![](https://img.shields.io/badge/documentation-online-brightgreen.svg)](https://docs.oxidmodule.com/Auftragsmanager/) diff --git a/composer.json b/composer.json index 57d0ffff..8365d910 100644 --- a/composer.json +++ b/composer.json @@ -17,7 +17,7 @@ { "name": "D3 Data Development (Inh. Thomas Dartsch)", "email": "info@shopmodule.com", - "homepage": "http://www.d3data.de", + "homepage": "https://www.d3data.de", "role": "Owner" } ], @@ -34,18 +34,25 @@ "require": { "php": "7.1 - 7.4", "ext-ionCube-Loader": "*", "oxid-esales/oxideshop-ce": "6.0 - 6.3", - "d3/modcfg": "^5.3.1.000", - "oxid-projects/pdf-invoice-module": "*", + "d3/modcfg": "^5.3.6.000", "league/flysystem": "^1.0", "splitbrain/php-cli": "^1.1", - "html2text/html2text": "^4.2" + "html2text/html2text": "^4.2", + "d3/oxid-sql-logger": "^1.2.2", + "ext-mbstring": "*" }, "require-dev": { "mikey179/vfsstream": "^1.4" }, + "suggest": { + "d3/pdfdocuments": "enables the automatic generation, dispatch and storage of highly customizable PDF documents", + "oxid-projects/pdf-invoice-module": "enables the automatic generation, dispatch and storage of OXID invoice PDF documents" + }, "autoload": { "psr-4": { - "D3\\Ordermanager\\": "../../../source/modules/d3/ordermanager" + "D3\\Ordermanager\\": "../../../source/modules/d3/ordermanager", + "D3\\Ordermanager\\publicDir\\": "../../../source/modules/d3/ordermanager/public", + "D3\\Ordermanager\\tests\\unit\\publicDir\\": "../../../source/modules/d3/ordermanager/tests/unit/public" } }, "bin": ["src/bin/d3_ordermanager_cron"] diff --git a/docs/daux/changelog/010_Changelog.md b/docs/daux/changelog/010_Changelog.md index 7c4e97d3..8c397181 100644 --- a/docs/daux/changelog/010_Changelog.md +++ b/docs/daux/changelog/010_Changelog.md @@ -2,6 +2,59 @@ title: Changelog --- +## 3.3.1.0 - (2021-03-10) + +** Hinweis für kleinere Versions-Upgrades: Es gibt einige rückwärts-inkompatible Änderungen an dieser Version. ** + +### Added +- erweiterte Konfigurationsprüfung integriert +- Ausführungsabbruch mit passenden Fehlermeldungen bei Konfigurationsfehlern eingefügt +- Debugausgaben werden auch bei Konsolenausführung gezeigt +- statische Auswahllisten sind erweiterbar +- Prüfung und Behandlung von Kompilierungsfehlern aufgrund fehlerhafter Smarty-Codes +- Abfangen leerer Inhalte auf Grund von falsch encodeten Templatedateien +- Profiling für CLI und GUI integriert +- Historyeinträge können optional angelegt werden + +### Changed +- Bedingungen- und Aktioneninterfaces aktualisiert +- Response-Script für automatische Ausführung als abgekündigt markiert +- Exportdateinamen wird für gültige Dateinamen überarbeitet +- Modul verwendet strict types +- Remark anlegen optimiert + +### Fixed +- Bedingung "gesetzte Rechnungsnummer" korrigiert +- Endlosschleifen bei Ausführung von finalizeOrder- und orderSave-Trigger verhindert +- Ordnernamen, die nicht aus Übersetzungen kommen, zeigen keine Fehlermeldung +- nicht generierbare Statusmails korrigiert +- Debugmodus verwendet SQL-Logger für optimierte Anzeige +- nicht geladenes Manager-Objekt im Admincontroller korrigiert +- "Einträge als erledigt markieren" ignoriert "Einträge nicht als erledigt markieren"-Option + +--- + +## 3.3.0.0 - (2020-08-20) + +### Added +- PDF-Dokumente können optional aus D³ PDF Dokumente Modul sowie auch aus OXID PDF Invoice Modul generiert werden + +### Changed +- OXID Invoice PDF Modul ist keine Anforderung mehr +- jeder ausgeführte Task wird auf Abbrüche kontrolliert, um Folgetasks weiter ausführen zu können +- Inhalte der E-Mails werden in Bestellssprache geladen +- Sprachumschalter bei den Moduleinstellungen entfernt, um Verwirrungen bei unterschiedlichen Konfigurationen zu vermeiden +- Währung der Bestellung wird im Maileditor geladen, um passende Formatierung zu verwenden +- umfangreicher Setupschritt wird nur noch einmalig ausgeführt + +### Fixed +- Dateinamen der PDF-Dokumente werden auf ungültige Zeichen geprüft und korrigiert +- RemarkHandler verliert Informationen beim Ausführen von Cronjobs +- ungültige Zeichen in PDF-Dateinamen werden ersetzt +- alte Cronaufrufe ohne Command starten Verarbeitung nicht + +--- + ## 3.2.0.3 - (2020-04-24) ### Changed - Demoprofile werden nicht pauschal im ersten Shopmandanten installiert, sondern im 1. Mandanten mit aktiviertem Modul diff --git a/docs/daux/config.json b/docs/daux/config.json index 635642aa..70d75205 100644 --- a/docs/daux/config.json +++ b/docs/daux/config.json @@ -1,9 +1,9 @@ { "title": " Auftragsmanager", - "moduleversion": "3.2.0.3", + "moduleversion": "3.3.1.0", "titledesc": "für den Oxid eShop", "author": "D³ Data Development", - "moduledate": "24.04.2020", + "moduledate": "09.03.2021", "editors": "", "tagline": "", "image": "", @@ -65,6 +65,7 @@ "modulename" : " Auftragsmanager", "menutitle" : " Auftragsmanager", "modulefolder" : "ordermanager", + "metadataident" : "d3ordermanager", "modcfgident" : "d3_ordermanager", "composerident" : "d3/ordermanager" }, diff --git a/docs/daux/editions/010_Editionen.md b/docs/daux/editions/010_Editionen.md index c8bc69f5..29a04f16 100644 --- a/docs/daux/editions/010_Editionen.md +++ b/docs/daux/editions/010_Editionen.md @@ -6,9 +6,9 @@ Das Modul **{$modulename}** erhalten Sie in verschiedenen Editionen mit untersch ## Funktionsumfang -| | Free-Edition | Standard-Edition | Premium-Edition | +| | Free-Edition | Standard-Edition | Premium-Edition | |-----------------------------------|:-------------:|:-----------------:|:-----------------:| -| Anzahl möglicher Aufgaben | 5 | 25 | beliebig | +| Anzahl möglicher Aufgaben | 5 | 25 | beliebig | | vor-Ausführung-Script möglich | | | X | | nach-Ausführung-Script möglich | | | X | @@ -23,52 +23,53 @@ Das Modul **{$modulename}** erhalten Sie in verschiedenen Editionen mit untersch ## Bedingungen -| | Free-Edition | Standard-Edition | Premium-Edition | +| | Free-Edition | Standard-Edition | Premium-Edition | |---------------------------------------------------|:-------------:|:-----------------:|:-----------------:| -| ab (inklusive) Bestellnummer | X | X | X | -| bis (inklusive) Bestellnummer | X | X | X | -| Zeitraum (1) | X | X | X | -| Zeitraum (2) | X | X | X | -| nicht gesetztes... | X | X | X | -| aus diesen Wochentagen | X | X | X | -| bei diesen Zahlarten | X | X | X | -| bei diesen Versandarten | X | X | X | -| bei gesetztem Trackingcode | X | X | X | -| bei stornierter Bestellung | X | X | X | -| bei nicht stornierter Bestellung | X | X | X | -| bei stornierten Artikeln innerhalb der Bestellung | X | X | X | -| Bestellsumme | X | X | X | -| hat Rechnungsnummer erhalten | X | X | X | -| Transaktionsstatus | X | X | X | -| bei verwendeter Währung | X | X | X | -| bei verwendeter Sprache | X | X | X | -| in einem der Ordner | X | X | X | -| nicht in einem der Ordner | X | X | X | -| enthält selektierte Artikel (1) | X | X | X | -| enthält selektierte Artikel (2) | X | X | X | -| enthält nicht selektierte Artikel (1) | X | X | X | -| enthält nicht selektierte Artikel (2) | X | X | X | -| Suchmuster zur Filterung der Mailadresse | X | X | X | -| Liefer- bzw. Rechnungsadresse aus Land | X | X | X | -| Kunde ist in Gruppe | X | X | X | -| Kunde ist nicht in Gruppe | X | X | X | -| Methode des Auftragslistenobjekts ausführen | | | X | -| Bestellungsfeld auf Wert prüfen | | | X | -| andere Aufgabe | | | X | +| ab (inklusive) Bestellnummer | X | X | X | +| bis (inklusive) Bestellnummer | X | X | X | +| Zeitraum (1) | X | X | X | +| Zeitraum (2) | X | X | X | +| nicht gesetztes... | X | X | X | +| aus diesen Wochentagen | X | X | X | +| bei diesen Zahlarten | X | X | X | +| bei diesen Versandarten | X | X | X | +| bei gesetztem Trackingcode | X | X | X | +| bei stornierter Bestellung | X | X | X | +| bei nicht stornierter Bestellung | X | X | X | +| bei stornierten Artikeln innerhalb der Bestellung | X | X | X | +| Bestellsumme | X | X | X | +| hat Rechnungsnummer erhalten | X | X | X | +| Transaktionsstatus | X | X | X | +| bei verwendeter Währung | X | X | X | +| bei verwendeter Sprache | X | X | X | +| in einem der Ordner | X | X | X | +| nicht in einem der Ordner | X | X | X | +| enthält selektierte Artikel (1) | X | X | X | +| enthält selektierte Artikel (2) | X | X | X | +| enthält nicht selektierte Artikel (1) | X | X | X | +| enthält nicht selektierte Artikel (2) | X | X | X | +| Suchmuster zur Filterung der Mailadresse | X | X | X | +| Liefer- bzw. Rechnungsadresse aus Land | X | X | X | +| Kunde ist in Gruppe | X | X | X | +| Kunde ist nicht in Gruppe | X | X | X | +| Methode des Auftragslistenobjekts ausführen | | | X | +| Bestellungsfeld auf Wert prüfen | | | X | +| andere Aufgabe | | | X | ## Aktionen -| | Free-Edition | Standard-Edition | Premium-Edition | +| | Free-Edition | Standard-Edition | Premium-Edition | |-----------------------------------------------|:-------------:|:-----------------:|:-----------------:| -| E-Mail senden | X | X | X | -| Aufträge in Ordner verschieben | X | X | X | -| Aufträge stornieren | | X | X | -| Versendet-am Datum setzen | | X | X | -| Bezahlt-am Datum setzen | | X | X | -| Versandkosten ändern | | X | X | -| Rabatte ändern | | X | X | -| PDF generieren | | X | X | -| Feld mit Wert füllen | | | X | -| Kundengruppe zuordnen / entfernen | | X | X | -| Export in Liste | | X | X | -| Individualaktionen / -bedingungen definieren | | | X | +| E-Mail senden | X | X | X | +| Aufträge in Ordner verschieben | X | X | X | +| Aufträge stornieren | | X | X | +| Versendet-am Datum setzen | | X | X | +| Bezahlt-am Datum setzen | | X | X | +| Versandkosten ändern | | X | X | +| Rabatte ändern | | X | X | +| PDF generieren (aus OXID Invoice PDF) | | X | X | +| PDF generieren (aus (D3) PDF Dokumente) | | X | X | +| Feld mit Wert füllen | | | X | +| Kundengruppe zuordnen / entfernen | | X | X | +| Export in Liste | | X | X | +| Individualaktionen / -bedingungen definieren | | | X | diff --git a/docs/daux/installation/010_Anforderungen/010_Systemanforderungen.md b/docs/daux/installation/010_Anforderungen/010_Systemanforderungen.md index 5f84c027..a4f7f692 100644 --- a/docs/daux/installation/010_Anforderungen/010_Systemanforderungen.md +++ b/docs/daux/installation/010_Anforderungen/010_Systemanforderungen.md @@ -3,19 +3,24 @@ title: Systemanforderungen --- * PHP Version - * 5.6.x bis 7.3.x + * 5.6.x bis 7.1.x * PHP Decoder * installierter ionCube Loader -* Shopversionen / -editionen - * OXID eShop Community Edition (CE), Professional Edition (PE) oder Enterprise Edition (EE) in Compilation Version +* 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 * Themes * Das Modul benötigt keine Einbindung ins Frontend und ist damit von diesen Themes unabhängig. -* (D3) Modul-Connector ([kostenfrei bei D3 erhältlich](https://www.oxidmodule.com/connector/)) ab Version 5.3.1.0 +* (D3) Modul-Connector ([kostenfrei bei D3 erhältlich](https://www.oxidmodule.com/connector/)) ab Version 5.3.6.0 * Installation via [Composer](https://getcomposer.org) * mindestens ein freier Cronjob zur automatischen Ausführung angelegter Aufgaben (optional) -Beachten Sie, dass die Ihnen vorliegende Modulversion entsprechend für **PHP 5.6**, **PHP 7.0**, **PHP 7.1**, **PHP 7.2** oder **PHP 7.3** 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. +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 (Community Edition (CE), Professional Edition (PE) oder Enterprise Edition (EE)) ausgelegt ist. diff --git a/docs/daux/installation/010_Anforderungen/030_Kompatibilitaet_mit_anderen_Modulen.md b/docs/daux/installation/010_Anforderungen/030_Kompatibilitaet_mit_anderen_Modulen.md index fae9f5e4..9909a23d 100644 --- a/docs/daux/installation/010_Anforderungen/030_Kompatibilitaet_mit_anderen_Modulen.md +++ b/docs/daux/installation/010_Anforderungen/030_Kompatibilitaet_mit_anderen_Modulen.md @@ -2,12 +2,18 @@ title: Kompatibilität mit anderen Modulen --- -Der **{$modulename}** integriert die Erweiterung "Invoice PDF" von OXID eSales AG, sofern diese im Shop installiert wurde. Diese Integration wurde für die Version 2.0.0 des „Invoice PDF“-Moduls entwickelt. +Das Modul **{$modulename}** integriert die Erweiterung "PDF Dokumente" von (D3) Data Development, sofern diese im Shop installiert wurde. Diese Integration wurde für die Version 1.0.0 des "PDF Dokumente"-Moduls entwickelt. -Der **{$modulename}** ist natürlich auch ohne das "Invoice PDF"-Modul einsetzbar, kann jedoch dann keine PDF-Exporte verwenden. +Das Modul **{$modulename}** ist natürlich auch ohne das "PDF Dokumente"-Modul einsetzbar, kann jedoch dann keine PDF-Exporte verwenden. --- -Der **{$modulename}** integriert die Erweiterung "WYSIWYG Editor + Mediathek" von OXID eSales AG & digidesk - media solutions, sofern diese im Shop installiert wurde. Diese Integration wurde für die Version 2.2.0 des "WYSIWYG Editor + Mediathek"-Moduls entwickelt. +Das Modul **{$modulename}** integriert die Erweiterung "Invoice PDF" von OXID eSales AG, sofern diese im Shop installiert wurde. Diese Integration wurde für die Version 2.0.0 des "Invoice PDF"-Moduls entwickelt. -Der **{$modulename}** ist natürlich auch ohne das "WYSIWYG Editor + Mediathek"-Modul einsetzbar. \ No newline at end of file +Das Modul **{$modulename}** ist natürlich auch ohne das "Invoice PDF"-Modul einsetzbar, kann jedoch dann keine PDF-Exporte verwenden. + +--- + +Das Modul **{$modulename}** integriert die Erweiterung "WYSIWYG Editor + Mediathek" von OXID eSales AG & digidesk - media solutions, sofern diese im Shop installiert wurde. Diese Integration wurde für die Version 2.2.0 des "WYSIWYG Editor + Mediathek"-Moduls entwickelt. + +Das Modul **{$modulename}** ist natürlich auch ohne das "WYSIWYG Editor + Mediathek"-Modul einsetzbar. \ No newline at end of file diff --git a/docs/daux/installation/020_Neuinstallation/020_Modul_hinzufuegen.md b/docs/daux/installation/020_Neuinstallation/020_Modul_hinzufuegen.md index 36cf73f4..a239c1ae 100644 --- a/docs/daux/installation/020_Neuinstallation/020_Modul_hinzufuegen.md +++ b/docs/daux/installation/020_Neuinstallation/020_Modul_hinzufuegen.md @@ -2,12 +2,14 @@ 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} --update-no-dev +php composer require {$composerident}:^{$moduleversion} --update-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. +> [!] 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). diff --git a/docs/daux/installation/020_Neuinstallation/050_Modul_im_Shop_aktivieren.md b/docs/daux/installation/020_Neuinstallation/050_Modul_im_Shop_aktivieren.md index 02ea797c..75c2f3e1 100644 --- a/docs/daux/installation/020_Neuinstallation/050_Modul_im_Shop_aktivieren.md +++ b/docs/daux/installation/020_Neuinstallation/050_Modul_im_Shop_aktivieren.md @@ -2,6 +2,18 @@ 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 ]. -> [!] **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 +### **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...`) \ No newline at end of file diff --git a/docs/daux/installation/020_Neuinstallation/060_Shopanpassungen_installieren.md b/docs/daux/installation/020_Neuinstallation/060_Shopanpassungen_installieren.md index 636441d1..6f552786 100644 --- a/docs/daux/installation/020_Neuinstallation/060_Shopanpassungen_installieren.md +++ b/docs/daux/installation/020_Neuinstallation/060_Shopanpassungen_installieren.md @@ -2,10 +2,20 @@ 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. \ No newline at end of file +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 +``` \ No newline at end of file diff --git a/docs/daux/installation/020_Neuinstallation/070_TMP-Ordner_leeren.md b/docs/daux/installation/020_Neuinstallation/070_TMP-Ordner_leeren.md index fb6a3a2f..d845b9b7 100644 --- a/docs/daux/installation/020_Neuinstallation/070_TMP-Ordner_leeren.md +++ b/docs/daux/installation/020_Neuinstallation/070_TMP-Ordner_leeren.md @@ -2,8 +2,20 @@ 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. -> [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 +### **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. \ No newline at end of file diff --git a/docs/daux/installation/020_Neuinstallation/080_Lizenz_eintragen.md b/docs/daux/installation/020_Neuinstallation/080_Lizenz_eintragen.md index fe264fc7..14705443 100644 --- a/docs/daux/installation/020_Neuinstallation/080_Lizenz_eintragen.md +++ b/docs/daux/installation/020_Neuinstallation/080_Lizenz_eintragen.md @@ -2,6 +2,8 @@ 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. Speziell der **{$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. diff --git a/docs/daux/installation/020_Neuinstallation/_index.md b/docs/daux/installation/020_Neuinstallation/_index.md index cac2ce2f..ea7dc79b 100644 --- a/docs/daux/installation/020_Neuinstallation/_index.md +++ b/docs/daux/installation/020_Neuinstallation/_index.md @@ -4,8 +4,13 @@ Title: Schnellstart per Composer ## Schnellstart per Composer +### **auf der Kommandozeile** + ```bash -php composer require {$composerident} --update-no-dev +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. \ No newline at end of file +Detailliertere Angaben zur Installation entnehmen Sie bitte den folgenden Seiten. diff --git a/docs/daux/installation/030_Update/005_Updatedefinition.md b/docs/daux/installation/030_Update/005_Updatedefinition.md index 492cee35..3e3e9f3d 100644 --- a/docs/daux/installation/030_Update/005_Updatedefinition.md +++ b/docs/daux/installation/030_Update/005_Updatedefinition.md @@ -2,7 +2,7 @@ title: Wann kann ein Update ausgeführt werden? --- -Die Updatenaweisungen können verwendet werden, wenn dieses Modul schon früher mit Hilfe von Composer installiert wurde. +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). \ No newline at end of file diff --git a/docs/daux/installation/030_Update/010_Modul_deaktivieren.md b/docs/daux/installation/030_Update/010_Modul_deaktivieren.md index ba3f82d2..4ba4d781 100644 --- a/docs/daux/installation/030_Update/010_Modul_deaktivieren.md +++ b/docs/daux/installation/030_Update/010_Modul_deaktivieren.md @@ -2,4 +2,18 @@ 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 +### **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...`) \ No newline at end of file diff --git a/docs/daux/installation/030_Update/015_Paketquelle_entfernen.md b/docs/daux/installation/030_Update/015_Paketquelle_entfernen.md deleted file mode 100644 index 33179d18..00000000 --- a/docs/daux/installation/030_Update/015_Paketquelle_entfernen.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -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/docs/daux/installation/030_Update/020_Dateien_erneuern.md b/docs/daux/installation/030_Update/020_Dateien_erneuern.md index 950d51e6..15504c31 100644 --- a/docs/daux/installation/030_Update/020_Dateien_erneuern.md +++ b/docs/daux/installation/030_Update/020_Dateien_erneuern.md @@ -2,13 +2,17 @@ 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 update {$composerident} --no-dev +php composer require {$composerident}:^{$moduleversion} --update-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. +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). \ No newline at end of file diff --git a/docs/daux/installation/030_Update/040_Modulinformationen_aktualisieren.md b/docs/daux/installation/030_Update/040_Modulinformationen_aktualisieren.md index 5e278991..157e8fac 100644 --- a/docs/daux/installation/030_Update/040_Modulinformationen_aktualisieren.md +++ b/docs/daux/installation/030_Update/040_Modulinformationen_aktualisieren.md @@ -2,4 +2,18 @@ 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 +### **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...`) \ No newline at end of file diff --git a/docs/daux/installation/030_Update/050_Shopanpassungen_installieren.md b/docs/daux/installation/030_Update/050_Shopanpassungen_installieren.md index 1cf39d1d..15880bbf 100644 --- a/docs/daux/installation/030_Update/050_Shopanpassungen_installieren.md +++ b/docs/daux/installation/030_Update/050_Shopanpassungen_installieren.md @@ -1,11 +1,21 @@ --- -title: Shopanpassungen installierren +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. \ No newline at end of file +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 +``` \ No newline at end of file diff --git a/docs/daux/installation/030_Update/060_TMP-Ordner_leeren.md b/docs/daux/installation/030_Update/060_TMP-Ordner_leeren.md index fb6a3a2f..d845b9b7 100644 --- a/docs/daux/installation/030_Update/060_TMP-Ordner_leeren.md +++ b/docs/daux/installation/030_Update/060_TMP-Ordner_leeren.md @@ -2,8 +2,20 @@ 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. -> [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 +### **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. \ No newline at end of file diff --git a/docs/daux/installation/030_Update/070_Lizenzschluessel_aktualisieren.md b/docs/daux/installation/030_Update/070_Lizenzschluessel_aktualisieren.md index 378a0697..41bf6aed 100644 --- a/docs/daux/installation/030_Update/070_Lizenzschluessel_aktualisieren.md +++ b/docs/daux/installation/030_Update/070_Lizenzschluessel_aktualisieren.md @@ -2,4 +2,6 @@ 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. \ No newline at end of file diff --git a/docs/daux/installation/050_Schnellstart.md b/docs/daux/installation/050_Schnellstart.md index 68b2f12b..15f74b2f 100644 --- a/docs/daux/installation/050_Schnellstart.md +++ b/docs/daux/installation/050_Schnellstart.md @@ -4,8 +4,8 @@ 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. -Richten Sie nun die Aufgaben ein, die der „Auftragsmanager“ für Sie durchführen soll. In der Standardinstallation finden Sie einige Aufgaben als Beispiel vorbereitet. Darin können Sie sich die möglichen Konfigurationen ansehen, diese auf Ihre Bedürfnisse anpassen und auch neue Aufgaben anlegen. +Richten Sie nun die Aufgaben ein, die der "Auftragsmanager" für Sie durchführen soll. In der Standardinstallation finden Sie einige Aufgaben als Beispiel vorbereitet. Darin können Sie sich die möglichen Konfigurationen ansehen, diese auf Ihre Bedürfnisse anpassen und auch neue Aufgaben anlegen. Testen Sie die Aufgaben mit dem modulweiten Debug-Schalter ([ (D3) Module ] -> [ Auftragsmanager ] -> [ Einstellungen ]) und / oder der Mailsende-Option an jeder Aufgabe ([ (D3) Module ] -> [ Auftragsmanager ] -> [ Aufgaben ] -> [ Stamm ]). Diese Optionen sind genauer im jeweils dahinter stehenden Fragezeichenfeld erklärt. Aktivieren Sie die Ausführung der Aufgaben bitte erst, wenn Sie sicher sind, dass alle Optionen richtig sind. Wir übernehmen keine Gewährleistung für evtl. falsche oder verlorene Daten bei fehlerhaft eingestellten Aufgaben. -Weitere Details zur Einrichtung des „Auftragsmanagers“ entnehmen Sie bitte dessen [Handbuch zum Modul](../manual/010_Handbuch.md). +Weitere Details zur Einrichtung des "Auftragsmanagers" entnehmen Sie bitte dessen [Handbuch zum Modul](../manual/010_Handbuch.md). diff --git a/docs/daux/installation/060_Deinstallation/020_Modul_deaktivieren.md b/docs/daux/installation/060_Deinstallation/020_Modul_deaktivieren.md index 067dc42e..4ba4d781 100644 --- a/docs/daux/installation/060_Deinstallation/020_Modul_deaktivieren.md +++ b/docs/daux/installation/060_Deinstallation/020_Modul_deaktivieren.md @@ -2,5 +2,18 @@ title: Modul deaktivieren --- -Deaktivieren Sie das Modul **{$modulename}** über den Shopadmin [ Erweiterungen ] -> [ Module ]. Klicken Sie nach Auswahl von [ {$menutitle} ] auf den Button [ 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...`) \ No newline at end of file diff --git a/docs/daux/installation/060_Deinstallation/030_Modul_aus_der_Installation_entfernen.md b/docs/daux/installation/060_Deinstallation/030_Modul_aus_der_Installation_entfernen.md index 344eb78d..02b3ebea 100644 --- a/docs/daux/installation/060_Deinstallation/030_Modul_aus_der_Installation_entfernen.md +++ b/docs/daux/installation/060_Deinstallation/030_Modul_aus_der_Installation_entfernen.md @@ -2,12 +2,12 @@ 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 ``` -> [!] 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). +> [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). \ No newline at end of file diff --git a/docs/daux/installation/060_Deinstallation/040_Dateien_loeschen.md b/docs/daux/installation/060_Deinstallation/040_Dateien_loeschen.md index 817caf57..b682e529 100644 --- a/docs/daux/installation/060_Deinstallation/040_Dateien_loeschen.md +++ b/docs/daux/installation/060_Deinstallation/040_Dateien_loeschen.md @@ -6,6 +6,5 @@ Löschen Sie den Ordner `{$modulefolder}` und seine enthaltenen Elemente aus dem 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. -> +> 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/docs/daux/installation/060_Deinstallation/060_TMP-Ordner_leeren.md b/docs/daux/installation/060_Deinstallation/060_TMP-Ordner_leeren.md index fb6a3a2f..d845b9b7 100644 --- a/docs/daux/installation/060_Deinstallation/060_TMP-Ordner_leeren.md +++ b/docs/daux/installation/060_Deinstallation/060_TMP-Ordner_leeren.md @@ -2,8 +2,20 @@ 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. -> [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 +### **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. \ No newline at end of file diff --git a/docs/daux/manual/020_Einstellungen/010_Grundeinstellungen.md b/docs/daux/manual/020_Einstellungen/010_Grundeinstellungen.md index 299edae2..7c569700 100644 --- a/docs/daux/manual/020_Einstellungen/010_Grundeinstellungen.md +++ b/docs/daux/manual/020_Einstellungen/010_Grundeinstellungen.md @@ -8,4 +8,4 @@ Setzen Sie das [ Modul aktiv ]: Ohne den Aktiv-Haken können Sie das Modul zwar Über [ Debug aktiv ] lassen sich Informationen während der Ausführung des Moduls ausgeben, die Ihnen und uns nützliche Hinweise zu einer möglichen Fehlersuche geben. Im Normalbetrieb sollte dieser Haken nicht gesetzt sein, da sonst die Aktionen nicht ausgeführt werden. -In der [ Logging ]-Auswahl stellen Sie ein, ob und wie viele Protokollinformationen der Auftragsmanager mitschreiben soll. Die Daten helfen uns bei einer möglichen Ursachensuche, wenn die Auftragsabarbeitung doch einmal nicht wie gewünscht arbeiten sollte. Die Protokolleinträge werden ausschließlich in Ihrer Installation abgelegt. Treffen Sie bei der Entscheidung den Kompromiss zwischen einem ausreichenden Protokoll und dem Speicherplatzbedarf. Im Regelfall ist die Einstellung „Fehler mitschreiben“ ausreichend. +In der [ Logging ]-Auswahl stellen Sie ein, ob und wie viele Protokollinformationen der Auftragsmanager mitschreiben soll. Die Daten helfen uns bei einer möglichen Ursachensuche, wenn die Auftragsabarbeitung doch einmal nicht wie gewünscht arbeiten sollte. Die Protokolleinträge werden ausschließlich in Ihrer Installation abgelegt. Treffen Sie bei der Entscheidung den Kompromiss zwischen einem ausreichenden Protokoll und dem Speicherplatzbedarf. Im Regelfall ist die Einstellung "Fehler mitschreiben" ausreichend. diff --git a/docs/daux/manual/020_Einstellungen/030_allgemeine_Cronjobeinstellungen.md b/docs/daux/manual/020_Einstellungen/030_allgemeine_Cronjobeinstellungen.md index df2b8dbd..e72fcf72 100644 --- a/docs/daux/manual/020_Einstellungen/030_allgemeine_Cronjobeinstellungen.md +++ b/docs/daux/manual/020_Einstellungen/030_allgemeine_Cronjobeinstellungen.md @@ -8,4 +8,10 @@ Setzen Sie hier die Cronjob-Ausführung aktiv, wenn Sie die automatische Abarbei Tragen Sie auch die Anzahl der Bestellungen ein, die pro Cronjob-Aufruf abgearbeitet werden dürfen. Die Menge ist begrenzt, da auch ein Cronjob nur eine vom Server vorgegebene Zeit zur Abarbeitung hat. Jede Bestellung benötigt ebenfalls etwas Zeit. Je nach Anzahl der aufgelaufenen Bestellungen und der auszuführenden Aufgaben sollte diese Anzahl justiert werden. Reicht die maximal nutzbare Anzahl der Bestellungen nicht aus, lassen Sie den Cronjob einfach mehrmals laufen (z.B. alle 2 Stunden). -Das Cronjob-Skript können Sie (und jeder Andere auch) zur Einrichtung oder zur Kontrolle im Browser aufrufen. Neben den serverseitigen Sicherheitsmaßnahmen sollten Sie hier ein Passwort vergeben, mit dem das Skript ausschließlich gestartet werden kann. Ohne das Passwort verweigert der Auftragsmanager seine Arbeit. So stellen Sie sicher, dass kein Unbefugter diese Ausführung startet. +### Scriptaufruf über externe URL (abgekündigt für automatische Ausführung) + +Das manuell ausführbare Cronjob-Skript können Sie (und jeder Andere auch) zur Einrichtung oder zur Kontrolle im Browser aufrufen. Neben den serverseitigen Sicherheitsmaßnahmen sollten Sie hier ein Passwort vergeben, mit dem das Skript ausschließlich gestartet werden kann. Ohne das Passwort verweigert der Auftragsmanager seine Arbeit. So stellen Sie sicher, dass kein Unbefugter diese Ausführung startet. Dieses Script ist abgekündigt und sollte für die automatische Ausführung nicht mehr verwendet werden. Bitte verwenden Sie statt dessen das Konsolenscript. + +### Scriptaufruf über Konsolenbefehl + +Das automatisiert aufrufbare Cronscript lässt sich nur vom Server aus direkt aufrufen und benötigt daher kein Passwort. Rufen Sie `./vendor/bin/d3_ordermanager_cron` im Shop-Root-Ordner auf, um weitere Informationen zu den Ausführungsmöglichkeiten zu erhalten. Neben dem Ausführungsstart können Sie sich darüber auch Statusinformation zu den Aufgaben oder der Installation abfragen. diff --git a/docs/daux/manual/020_Einstellungen/040_Cronjobeinstellungen_fuer_Cronjob-ID.md b/docs/daux/manual/020_Einstellungen/040_Cronjobeinstellungen_fuer_Cronjob-ID.md index 0ca8ab51..fd415a1d 100644 --- a/docs/daux/manual/020_Einstellungen/040_Cronjobeinstellungen_fuer_Cronjob-ID.md +++ b/docs/daux/manual/020_Einstellungen/040_Cronjobeinstellungen_fuer_Cronjob-ID.md @@ -6,9 +6,9 @@ Der Auftragsmanager stellt verschiedene Cronjobs zur Verfügung. Je nach Einrich Für jeden verfügbaren Cronjob sehen Sie in den Einstellungen die für Einrichtung benötigten Informationen: -Den Link mit allen erforderlichen Parametern für den manuellen Aufruf des Bearbeitungsskripts finden Sie in der Zeile „externer Link“. Über den blauen Button können Sie die Ausführung in einem neuen Browser-Tab sofort starten. +Den Shellaufruf mit allen erforderlichen Parametern des Ausführungsskripts finden Sie in der Zeile "interner Cronaufruf". Direkt darunter finden Sie die Möglichkeit, passende Shell-Scripte für die Einrichtung Ihrer Cronjobs zu erstellen. -Direkt darunter finden Sie den Link, den Sie für die Einrichtung des Cronjobs benötigen. Dort ist das Passwort nicht nötigt, da Ihr Server die Identifizierung selbst durchführen kann. +Mit dem "externen Link" können Sie die Ausführung manuell im Browser starten. Beachten Sie, dass dieser Link nicht für Cronjobaufrufe verwendet werden kann. Über den blauen Button können Sie die Ausführung in einem neuen Browser-Tab sofort starten. Dieser Link ist abgekündigt und wird in Zukunft entfernt werden. Ändern Sie Ihre Cronjobs bitte auf den "internen Link" ab. Nachfolgend wird ebenfalls die Zeit gezeigt, zu der dieser Cronjob das letzte Mal erfolgreich gestartet wurde. Haben Sie Zweifel an der Cronjob-Einrichtung bei Ihrem Provider, können Sie dies hier kontrollieren. diff --git a/docs/daux/manual/030_Aufgaben/050_Aktionen.md b/docs/daux/manual/030_Aufgaben/050_Aktionen.md index 49c6dda9..90ec5ba1 100644 --- a/docs/daux/manual/030_Aufgaben/050_Aktionen.md +++ b/docs/daux/manual/030_Aufgaben/050_Aktionen.md @@ -6,7 +6,7 @@ Haben Sie die Bedingungen gesetzt, setzen Sie nun die Aktionen, die ausschließl Auch hier verzichten wir in diesem Handbuch auf die Auflistung der Aktionen, da diese normalerweise selbsterklärend sind. Im Folgenden sind nun Besonderheiten aufgeführt, auf die Sie speziell achten sollten: -Beachten Sie, dass die Aktion „Löschen von Bestellungen“ nicht rückgängig gemacht werden kann. Lassen Sie bei solchen Aktionen erst während eines Testzeitraums die Infomails zusenden, mit denen Sie prüfen können, ob die Löschaktionen auch die richtigen Bestellungen betreffen. Wir übernehmen keine Gewährleistung bei Datenverlust auf Grund von unzureichend geprüften Aufgaben. +Beachten Sie, dass die Aktion "Löschen von Bestellungen" nicht rückgängig gemacht werden kann. Lassen Sie bei solchen Aktionen erst während eines Testzeitraums die Infomails zusenden, mit denen Sie prüfen können, ob die Löschaktionen auch die richtigen Bestellungen betreffen. Wir übernehmen keine Gewährleistung bei Datenverlust auf Grund von unzureichend geprüften Aufgaben. Alle Aktionen, die sich auf Währungsmengen beziehen (z.B. Versandkosten oder Rabatte), verwenden die Angabe immer in der Shop-Hauptwährung. Rechnen Sie Angaben in Fremdwährung für die Aktionen daher bitte immer um. @@ -15,20 +15,20 @@ vorgenommen. Beim Versand von Mails können Sie als Quelle Ihres Mailinhalts CMS-Bausteine aus Ihrem Shop oder komplette Templatedateien verwenden. In beiden Möglichkeiten haben Sie die folgenden Variablen zur Verfügung, um die Mail zu individualisieren: -| Variable | Inhalt | +| Variable | Inhalt | |-------------------|-----------------------------------------------------------------------------------------------------------------------| -| $oShop | enthält das Shop-Objekt und alle seine Möglichkeiten | -| $shop | enthält das Shop-Objekt und alle seine Möglichkeiten | -| $oViewConf | enthält das Shop-Objekt und alle seine Möglichkeiten | -| $oOrder | enthält das Bestellungen-Objekt und alle seine Möglichkeiten | -| $order | enthält das Bestellungen-Objekt und alle seine Möglichkeiten | -| $oUser | enthält das Benutzer-Objekt und alle seine Möglichkeiten | -| $user | enthält das Benutzer-Objekt und alle seine Möglichkeiten | -| $shopTemplateDir | enthält das Verzeichnis zum Template | -| $charset | enthält den Zeichensatz für die Mail | -| $basket | enthält das Warenkorb-Objekt und alle seine Möglichkeiten (erfordert, dass alle Artikel noch im Stamm vorhanden sind) | -| $payment | enthält das Bezahlarten-Objekt und alle seine Möglichkeiten | -| $oDelSet | enthält das Versandarten-Objekt und alle seine Möglichkeiten | -| $currency | enthält das Währungs-Objekt und alle seine Möglichkeiten | +| $oShop | enthält das Shop-Objekt und alle seine Möglichkeiten | +| $shop | enthält das Shop-Objekt und alle seine Möglichkeiten | +| $oViewConf | enthält das Shop-Objekt und alle seine Möglichkeiten | +| $oOrder | enthält das Bestellungen-Objekt und alle seine Möglichkeiten | +| $order | enthält das Bestellungen-Objekt und alle seine Möglichkeiten | +| $oUser | enthält das Benutzer-Objekt und alle seine Möglichkeiten | +| $user | enthält das Benutzer-Objekt und alle seine Möglichkeiten | +| $shopTemplateDir | enthält das Verzeichnis zum Template | +| $charset | enthält den Zeichensatz für die Mail | +| $basket | enthält das Warenkorb-Objekt und alle seine Möglichkeiten (erfordert, dass alle Artikel noch im Stamm vorhanden sind) | +| $payment | enthält das Bezahlarten-Objekt und alle seine Möglichkeiten | +| $oDelSet | enthält das Versandarten-Objekt und alle seine Möglichkeiten | +| $currency | enthält das Währungs-Objekt und alle seine Möglichkeiten | Legen Sie die Templatedateien im auszuwählenden Ordner ab. diff --git a/docs/daux/manual/060_Cronjobs_fuer_unterschiedlich_zu_steuernde_Aufgaben.md b/docs/daux/manual/060_Cronjobs_fuer_unterschiedlich_zu_steuernde_Aufgaben.md index a665ec16..8e691d92 100644 --- a/docs/daux/manual/060_Cronjobs_fuer_unterschiedlich_zu_steuernde_Aufgaben.md +++ b/docs/daux/manual/060_Cronjobs_fuer_unterschiedlich_zu_steuernde_Aufgaben.md @@ -2,7 +2,7 @@ title: Cronjobs für unterschiedlich zu steuernde Aufgaben --- -Neu angelegte Aufgaben oder Aufgaben, denen Sie keine spezielle Cronjob-ID zugewiesen haben, erhalten standardmäßig immer die Cronjob-ID „0“ (Null). Noch nicht zugeordnete oder neu angelegte Aufgaben können Sie gesamt über diese Cronjob-ID steuern. Hierfür können Sie mit den in den Modul-Grundeinstellungen angezeigten Daten einen Cronjob einrichten, der diese Aufgaben automatisch ausführt. +Neu angelegte Aufgaben oder Aufgaben, denen Sie keine spezielle Cronjob-ID zugewiesen haben, erhalten standardmäßig immer die Cronjob-ID "0" (Null). Noch nicht zugeordnete oder neu angelegte Aufgaben können Sie gesamt über diese Cronjob-ID steuern. Hierfür können Sie mit den in den Modul-Grundeinstellungen angezeigten Daten einen Cronjob einrichten, der diese Aufgaben automatisch ausführt. Häufig ist es jedoch der Fall, dass bestimmte Aufgaben nur zu besonderen Zeiten gestartet werden sollen. Beispiele sind: @@ -14,4 +14,4 @@ Weisen Sie dann diesen speziellen Aufgaben jeweils eine eigene Cronjob-ID zu. Di Sobald Sie die Cronjob-ID an der Aufgabe gespeichert haben, werden Ihnen in den Grundeinstellungen des Moduls alle Informationen gezeigt, die Sie für die Einrichtung dieses zusätzlichen Cronjobs benötigen. An diesem Cronjob können Sie nun auch die neuen Ausführungszeiten direkt einstellen. Sofern Ihr Provider dies erfordert, legen Sie für jeden Cronjob eine separate .sh-Datei an (siehe [Aufgaben automatisch ausführen](050_Aufgaben_automatisch_ausfuehren.md)). -Vorherige Modulversionen verwendeten noch keine Cronjob-ID. Wird der Cronjob ohne ID aufgerufen, verwendet dieser automatisch die ID „0“ (Null). Eine Umarbeitung der bisherigen Einstellungen ist nicht nötig. +Vorherige Modulversionen verwendeten noch keine Cronjob-ID. Wird der Cronjob ohne ID aufgerufen, verwendet dieser automatisch die ID "0" (Null). Eine Umarbeitung der bisherigen Einstellungen ist nicht nötig. diff --git a/docs/html/changelog/Changelog.html b/docs/html/changelog/Changelog.html index 1aeb16a8..996cecda 100644 --- a/docs/html/changelog/Changelog.html +++ b/docs/html/changelog/Changelog.html @@ -53,7 +53,7 @@
Shop
Blog
- FAQ
+ FAQ
Dokumentationen
D³ Support Center
Kontakt
@@ -72,16 +72,70 @@
-

3.2.0.3 - (2020-04-24)

+

3.3.1.0 - (2021-03-10)

+

** Hinweis für kleinere Versions-Upgrades: Es gibt einige rückwärts-inkompatible Änderungen an dieser Version. **

+

Added

+

Changed

+

Fixed

+ +
+

3.3.0.0 - (2020-08-20)

+

Added

+ +

Changed

+ +

Fixed

+ +
+

3.2.0.3 - (2020-04-24)

+

Changed

+ -

Fixed

+

Fixed


3.2.0.0 - (2019-12-10)

-

Added

+

Added

diff --git a/docs/html/installation/Update/Modulinformationen_aktualisieren.html b/docs/html/installation/Update/Modulinformationen_aktualisieren.html index 53b3fb66..6d8561cf 100644 --- a/docs/html/installation/Update/Modulinformationen_aktualisieren.html +++ b/docs/html/installation/Update/Modulinformationen_aktualisieren.html @@ -45,7 +45,7 @@
- + @@ -53,7 +53,7 @@
Shop
Blog
- FAQ
+ FAQ
Dokumentationen
D³ Support Center
Kontakt
@@ -72,11 +72,22 @@
-

Wechseln Sie im Adminbereich zu Erweiterungen -> Module. Klicken Sie nach Auswahl von Auftragsmanager auf den Button Aktivieren.

+

im Adminbereich

+

Wechseln Sie im Adminbereich zu Erweiterungen -> Module. Klicken Sie nach Auswahl von Auftragsmanager 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.

+
./vendor/bin/oe-console oe:module:activate d3ordermanager
+
+
+

Enterprise Edition: Achten Sie darauf, dass das Modul in weiteren Shops (Mall) ebenfalls aktiviert werden muss, um dessen Funktion dort auch zu nutzen.

+
+
+

Enterprise Edition: Zur Aktivierung in einem bestimmten Shopmandanten verwenden Sie das --shop-id-Argument (...oe-console --shop-id 1 oe:module...)

+