Fairsenden Plugin Dokumentation

Inhaltsverzeichnis

  1. Plugin Dokumentation Deutsch

  2. Plugin Documentation English

  3. Plugin Changelog & File

Last Update: 27.04.2020

Plugin Dokumentation Deutsch

Anforderungen

Installation:

  1. Uploaden des Plugins im Shop

  2. Ausführen des Befehls chmod 777 composer.phar innerhalb des Verzeichnisses custom/plugins/FairsendenShipping (nicht mehr ab Version 1.2.1)

  3. Ausführen des Befehls ./composer.phar install in dem gleichen Verzeichnis (nicht mehr ab Version 1.2.1)

  4. Installiere das Plugin im Shop Backend

  5. Unter Credentials werden die von Fairsenden bereitgestellten API Daten hinterlegt

  6. Unter Address werden die Daten des Absenders hinterlegt

  7. Demo Video zur Installation: Loom | Send a video. Not a thousand words.

    1

Nach Installation und Eingabe der benötigten Daten kann das Plugin aktiviert werden. Bei Aktivierung des Plugins, werden Sie aufgefordert, den Cache zu leeren und das Theme zu kompilieren. Das sollte nach jeder Änderung der Stammdaten ausgeführt werden.

Nach der Aktivierung kann das Plugin genutzt werden:

  1. Gehen Sie in den Shop und geben Sie die Bestellung auf. Nachdem Sie die Bestellung aufgegeben haben, müssen Sie ein Konto einrichten und sich dann einloggen. Eine Bestellung als Gast ist ebenfalls möglich.

    2

  2. Wenn Sie die Sendung auswählen, kann mit der Zahlungs- und Versandart fortgefahren werden. Wenn Ihr Geschäft über den Fairsenden-Versandservice verfügt, können Sie diese Versandmethode auswählen. Dieser Service überprüft die Postleitzahl der angegebenen Adresse. Wenn die Postleitzahl gültig ist, ermöglicht sie den Zugriff auf die Fairsenden-Sendung, andernfalls kann eine Fairsenden-Sendung nicht ausgewählt werden

    3
  3. Der Kalender kann nach Auswahl der Fairsenden-Sendung eingesehen werden. Wählen Sie das Zeitfenster nach Ihren Wünschen aus und gehen Sie zu der Checkout-Seite

    Anmerkung 2020-03-23 132059
  4. Gehen Sie zur Checkout-Seite und klicken Sie auf die Schaltfläche "Zahlungspflichtig bestellen".

    5
  5. Ihre Bestellung ist aufgegeben worden.

    6
  6. Sie können die Bestellung über das Shop-Backend einsehen.

    7

  7. Die PDF-Datei mit den Etiketten kann im Backend heruntergeladen werden.

    8

Plugin Documentation English

Requirements:

Installation Steps:

  1. Upload the plugin on your shop

  2. Run chmod 777 composer.phar command inside the custom/plugins/FairsendenShipping directory (not needed from Version 1.2.1)

  3. Then in the same direcotory run the ./composer.phar install command (not needed from Version 1.2.1)

  4. Install the plugin from your shop backend

  5. Address section in the configuration is required for our API. Basically, it’s a sender’s information which would place the shipment

  6. Exmaple video on how to install the plugin: Loom | Send a video. Not a thousand words.

1

Having installed the plugin, enter the plugin configurations to establish connection with the Create Shipment API. Upon activation, it will ask you to clear the cache once, so make sure to always clear the cache if you make any changes here after activating

Having activated, plugin could be used:

  1. Go to the shop and place the order. After placing it, you have to make an account on the shop, then login

    2



  2. Proceeding the payment and shipping method. If your shop has the Fairsenden Shipment services then you are able to use its shipment method. The plugin will check the zipcode from your given address of your destination. Following this, if zipcode is valid, it allows the accessing of Fairsenden shipment, otherwise you wouldn’t be able to choose Fairsenden Shipment.

    3


  3. Calendar can be seen after selecting the Fairsenden shipment. Select the time slot by your convenience and move to the checkout page.

    Anmerkung 2020-03-23 132059


  4. Go to the checkout page and click on Finish button

    5


  5. Your order has been placed

    6


  6. You can see your order through the shop backend

    7


  7. Label PDF can be downloaded from the backend.

8

Plugin Changelog & File

Plugin

Version

Date

Shopware Version

File

release note

1.2.8

27.04.2020

5.6

FairsendenShipping.zip

  • iframe always open

  • first setup for fairsenden not as default shipping method

1.2.7

23.04.2020

5.6

FairsendenShipping.zip

  • cronjob mark order as ready fixed

  • if shipping methd is deactivated deactivate connection to fairsenden

  • send customer back to last step if zip code doesn't match fairsenden

  • fix salutation for shipping address

1.2.6

20.04.2020

5.6

FairsendenShipping.zip

  • send correct shipping address to fairsenden

1.2.5

19.04.2020

5.6

FairsendenShipping.zip

  • fixed 500 error in plugin settings

1.2.4

17.04.2020

5.6

FairsendenShipping.zip

  • added new cronjob to check order status and mark as ready

1.2.3

13.04.2020

5.6

FairsendenShipping 1.2.3.zip

  • compatibility with Guzzle fixed

  • email address for sender and receiver fixed

1.2.1

31.03.2020

5.6

FairsendenShipping.zip

  • bug with duplicate entry in database fixed

1.2

27.03.2020

5.6

FairsendenShipping.zip

  • oAuth Authentication implemented

  • functionality for shipping address implemented

1.0.1

19.03.2020

5.6

FairsendenShipping.zip

  • change_shipping.tpl

    • change Iframe width & height

1.0

19.03.2020

5.6

FairsendenShipping.zip

initial version