=======================================
Systemvorraussetzungen und Installation
=======================================

Systemvorraussetzungen
======================

#. Mindestens PHP 7.0
#. OXID Shop Community oder Professional Edition 6.0.x bis 6.2
#. OXID Shop Enterprise Edition 6.0.x bis 6.1.5

Im Zweifelsfall kontaktieren Sie uns und nennen Sie uns die eingesetzte Shopversion sowie die genutzte PHP-Version. 



Erstinstallation
================

1. Verzeichnispfad erstellen

Erstellen Sie den Verzeichnispfad "packages/ysquare" in der selben Verzeichnisebene, in der die Ordner "source" und "vendor" liegen.


2. Modulordner entpacken

Anschließend entpacken sie die heruntergeladene zip-Datei nach "packages/ysquare/ys_shipcloud".


3. Composer ausführen

Führen Sie anschließend folgende Befehle aus dem Hauptverzeichnis des Shopsystems aus:
   ```
   composer config repositories.ysquare '{"type":"path", "url": "./packages/ysquare/*"}'
   composer require --update-no-dev ysquare/ys_shipcloud
   ```

4. Modul aktivieren

Aktivieren Sie das Modul über den Shopadmin unter **Erweiterungen** --> **Module**. 
Klicken Sie in der Übersicht das Modul "Y-SQUARE Shipcloud Connector" an und klicken Sie anschließend auf **Aktivieren**.


5. tmp-Ordner leeren

Leeren Sie nach dem Aktivieren des Moduls das Verzeichnis *tmp* auf Ihrem Server. Sofern die Views nicht automatisch aktualisiert werden, führen Sie dies ebenfalls durch. 


6. Modulkonfiguration

Im Admin-Bereich des OXID eShops finden Sie einen neuen Menüpunkt "Shipcloud", unter diesem wird die Modulkonfiguration vorgenommen.  


7. Updatefähigkeit

Sollten Sie individuelle Änderungen an den Moduldateien vornehmen, empfehlen wir die Überladungsmöglichkeiten des Shops dafür zu verwenden, damit die originalen Moduldateien nicht verändert werden und Sie die Updatefähigkeit des Moduls erhalten. 


.. note::  Bei der Modulinstallation werden zusätzliche Datenbanktabellen/Felder angelegt. Eine Übersicht der Zusatzfelder können wir bei Bedarf gerne zukommen lassen. 




Update
======

1. Backup 

Erstellen Sie eine Backup-Datei des bereits installierten Moduls.



2. Entpacken der Updatedatei

Entpacken Sie die neue Modulversion in den Ordner "packages/ysquare/ys_shipcloud".


3. Deaktivieren des Moduls

Deaktivieren Sie das Modul über den Shopadmin unter **Erweiterungen** --> **Module**. 
Wählen Sie das shipcloud-connect-Modul an und klicken Sie anschließend auf **Deaktivieren**.-


4. Composer ausführen

Führen Sie anschließend folgende Befehle aus dem Hauptverzeichnis des Shopsystems aus:
   ```
   composer update --no-dev ysquare/ys_shipcloud
   ```
Die Frage, ob die Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y".


5. Modul aktivieren

Aktivieren Sie das Modul wieder im OXID eShop Admin


6. tmp-Ordner leeren

Leeren Sie nach dem Aktivieren des Moduls das Verzeichnis *tmp* auf Ihrem Server. Sofern die Views nicht automatisch aktualisiert werden, führen Sie dies ebenfalls durch. 


7. Konfiguration

Überprüfen Sie die Modulkonfiguration in den Moduleinstellungen. 
