Installation instructions (see below for upgrade instructions)
Download the plugin file and unpack the content to the /plugins folder.
The folder structure under /plugins/ltc_komfortkasse should look like this:
Login to your xt:Commerce Admin and go to Plugin -> Plugin uninstalled. Under the module class "payment", you will find Komfortasse:
Install the module by hitting the "Add" button .
You should see a message telling you that the installation was successful.
Now, go to Content -> Plugin -> Plugin installed. You should see Komfortkasse under the module class "payment".
Hit the "Edit" button .
Change the plugin status to Enabled (check the checkbox).
Make sure that "Export orders" and "Update orders" are set to True.
Choose the relevant payment type codes. Only order with these payment type codes will be exported to Komfortkasse. You can enter multiple values seperated by comma. Normally, this will be "xt_prepayment".
Choose the relevant statuses for open (unpaid) orders. Only orders with these status codes will be exported to Komfortkasse. You can enter multiple values seperated by comma. Typically, this will be 16 (open) and 17 (pending).
Choose the status that an order will be set to if the payment is received. Typically, this will be 23 (payment received).
Choose the status that an order will be set to if the order is cancelled. Typically, this will be your custom "cancelled" state (e.g. 34).
Do not change the other options (encryption, access code, secret keys). These values will be automatically filled in when you connect your shop with Komfortkasse.
If you want to use several subshops, you can add comma seperated IDs such as 1,3,7.
How to upgrade to a newer version of the plugin:
If you have xt:Commerce 4.1.10 or higher and a plugin version of 1.0.6 or higher, you can update the plugin automatically. If you have a lower xt:Commerce version (e.g. 4.0.xx or 4.1.00) or a lower plugin version (e.g. 1.0.5), you have to perform a manual upgrade.
Manual upgrade (for xt:Commerce below 4.1.10 or plugin versions below 1.0.6)
Open the plugin configuration and copy or note down these values:
Uninstall (delete) the plugin from "plugins installed":
Copy the new version to your /plugins folder. Re-name the existing plugin, e.g. to /plugins/ltc_komfortkasse_OLD. Un-zip the new version to /plugins/ltc_komfortkasse.
Re-install the plugin from "plugins uninstalled". You should see a new version number!
Open the plugin configuration and insert the values noted before:
Login to your Komfortkasse Dealer Zone and re-initialize the connection:
Automatic upgrade (for xt:Commerce 4.1.10 or higher and plugin versions 1.0.6 or higher)
Open the plugin configuration and hit "Plugin update":
Confirm starting the update with "Yes".
A backup of your existing plugin will be performed. Hit "Update plugin".
The upgrade will be performed. You will see messages stating "ERROR, ALREADY EXISTS" - this is normal behaviour, because existing configuration values will not be overridden.
After the upgrade is complete, hit "close window".
Important: After the upgrade, the plugin will be disabled!
Do not forget to re-enable the plugin by hitting ! Also, enter the plugin configuration to add any configuration values that have been added in this plugin version.
Note: When using automatic upgrade, you don't have to re-inizialize the connection in your dealer zone. However we recommend that you login to your dealer zone and test the connection.