Installation

Um das Zahlungsmodul PayPal Checkout zu installieren, installieren Sie verschiedene Versionen je nach der Version Ihres OXID eShops:

  • Wenn Sie OXID eShop Version 6.3.x bis 6.5.x haben, installieren Sie PayPal Checkout 2.3.x (siehe PayPal Checkout installieren).

  • Wenn Sie OXID eShop Version 7.x haben, installieren Sie PayPal Checkout 3.3.x.
    Weitere Informationen finden Sie in der zugehörigen Modul-Documentation unter PayPal Checkout 3.3.x installieren.

  • Wenn Sie OXID eShop Version 6.1.x oder 6.2.x haben, installieren Sie PayPal Checkout 1.3.x.
    Weitere Informationen finden Sie in der zugehörigen Modul-Documentation unter PayPal Checkout 1.3.x installieren.

Frühere Versionen des OXID eShops werden nicht unterstützt.

PayPal Checkout installieren

Installieren Sie für den OXID eShop ab Version 6.3. das Zahlungsmodul PayPal Checkout Version 2.3.x.

Voraussetzungen

  • Sie haben die OXID eShop-Version 6.3.x bis 6.5.x installiert.

  • Sie haben https konfiguriert.

    1. Öffnen Sie im Verzeichnis <Rootverzeichnis des eShops>/source die Datei config.inc.php.

    2. Stellen Sie sicher, dass für die Basis-URL (Parameter sShopURL) https eingestellt ist.
      Beispiel:

      $this->sShopURL = 'https://www.example.org';
      

Vorgehen

  1. Öffnen Sie eine Shell und wechseln Sie ins Root-Verzeichnis des eShops (in dem die Datei composer.json liegt).
    Beispiel:

    cd /var/www/oxideshop
    
  2. Führen Sie folgende Befehle aus:

    composer require oxid-solution-catalysts/paypal-module ^2.3.0
    
  3. Optional: Um das Modul zu aktivieren, führen Sie folgenden Befehl aus.
    Alternativ: Aktivieren Sie das Modul im Zuge der Konfiguration manuell (siehe PayPal Checkout aktivieren).

    ./vendor/bin/oe-console oe:module:activate osc_paypal
    

Resultat

Sobald der Installationsprozess abgeschlossen ist, erscheint das Modul PayPal Checkout für OXID im Administrationsbereich unter Erweiterungen ‣ Module (Abb.: PayPal Checkout für OXID erfolgreich installiert).

PayPal Checkout für OXID erfolgreich installiert

Abb.: PayPal Checkout für OXID erfolgreich installiert

Minor Update installieren

Installieren Sie bei Bedarf ein Minor Update, beispielsweise von PayPal Checkout Version 2.2.1 auf Version 2.3.0.

composer require oxid-solution-catalysts/paypal-module ^2.3.0
composer update

Patch-Update installieren

Installieren Sie bei Bedarf ein Patch-Update, beispielsweise von PayPal Checkout Version 2.3.0 auf Version 2.3.1.

Vorgehen

  1. Führen Sie folgenden Befehl aus:

    composer update
    
  2. Bestätigen Sie die Abfrage, ob die oxid-solution-catalysts/paypal-module-Dateien überschrieben werden sollen.

Attention

Länderzuordnungen prüfen nach Update auf PayPal Checkout Version 2.1.5

Mit Version 2.1.4 wurde die Länderabdeckung einzelner PayPal Checkout-Zahlungsmethoden erweitert.

Stellen Sie sicher, dass Sie die erweiterte Länderabdeckung nutzen können.

Hintergrund: Mit PayPal Checkout Version 2.1.5 sind bei der Erstinstallation die Länder automatisch den Zahlungsarten zugeordnet (siehe Optional: Länderzuordnung von PayPal Checkout-Zahlungsmethoden konfigurieren).

Dadurch kann es sein, dass Konfigurationseinstellungen Ihrer bestehenden Version die Nutzung neuer Länderzuordnungen blockieren.

Tun Sie Folgendes:

  1. Wählen Sie Shopeinstellungen ‣ Zahlungsarten ‣ <Zahlungsart> ‣ Länder ‣ Länder zuordnen.

  2. Um die gesamte Länderabdeckung einer Zahlungsart zu nutzen, löschen Sie bestehende Zuordnungen.