Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen gezeigt.

--- public:faqoxid2mollie [2020/03/02 13:07]
ruedigerhaegele [FAQ]
+++ public:faqoxid2mollie [2021/01/20 10:47]
markusmichalski [Cronjobs]
@@ Zeile 1: / Zeile 1: @@
-=====Mollie Payments for Oxid 6=====
+====== OXID Plugin - Mollie Payments ======
+for Oxid 6
-====Requirements====
+===== Requirements =====
-  *  Oxid eShop Version 6 or above
+  * Oxid eShop Version 6 or above
+  * Mollie Account (www.mollie.com)
-  *  Mollie Account (www.mollie.com)
+  * FTP access to your shop system
+  * For OXID versions from 6.2. you need SSH access to the shop installation.
+----
-====Installation====
+==== Installation via Composer ====
+Connect to your webserver via SSH and navigate to the base folder of your OXID eShop (where the composer.json is located) and perform the following command:
+  composer require mollie/mollie-oxid
+----
+==== Manual Installation ====
   * Change to the directory "source/modules" in your OXID eShop installation and create the directory "mollie"
@@ Zeile 14: / Zeile 25: @@
   * Use a Git or SVN client to check out the module-files or download the ZIP-file https://github.com/mollie/mollie-oxid/archive/master.zip and extract its content to this directory.
   * Open the file **composer.json** in the root-directory of your shop and add this autoload-configuration or add/complete an existing configuration with the following:
+<code javascript>
   "autoload": {
     "psr-4": {
@@ Zeile 21: / Zeile 32: @@
     "files": ["./source/modules/mollie/molliepayment/lib/mollie-api-php/vendor/autoload.php"]
   },
+</code>
+  * Open a command-line on your webserver and execute the following command to regenerate the autoloader-files:
-Open a command-line on your webserver and execute the following command to regenerate the autoloader-files:
-''vendor/bin/composer dump-autoload''
+  vendor/bin/composer dump-autoload
-Login to the OXID-admin of your shop and see the module "Mollie Payment" in the list of modules at //Extensions -> Modules//
+  * **In OXID versions from 6.2 on (older versions can skip this step)** you must now import the module configuration. To do this, log in via SSH to the server on which the shop installation is located and navigate to the directory in which the source and vendor folders are located. Execute the following command:
-{{:public:mollie_aktivieren.png?400|}}
+  ./vendor/bin/oe-console oe:module:install-configuration source/modules/mollie/molliepayment/
-Click on "activate" in case you find the module still being deactivated.
+You should then receive the message Module configuration has been installed.
-====Configuration====
-The configuration options of the Mollie Payment module are available in the OXID-admin here: //Extensions -> Modules -> Mollie Payment -> tab "Settings"//
+  * Login to the OXID-admin of your shop and see the module "Mollie Payment" in the list of modules at //Extensions -> Modules//
-{{:public:mollie_konfiguration.png?400|}}
+{{:public:mollie_aktivieren.png?nolink&400|}}
-{{:public:mollie_konfiguration_details.png?400|}}
+  * Click on "activate" in case you find the module still being deactivated.
+----
-|no.|**configuration option**|**description**|
+==== Configuration ====
-|1|"Mode": "Test" or "Live"|choose if you're still testing or already run the shop live / in production-mode|
+The configuration options of the Mollie Payment module are available in the OXID-admin here: //Extensions -> Modules -> Mollie Payment -> tab "Settings"//\\ \\
-|2|"Test API Key"|paste here the "Test API Key" you can find in your Mollie account|
+{{:public:mollie_konfiguration.png?nolink&400|}}
-|3|"Live API Key"|paste here the "Live API Key" you can find in your Mollie account|
-|4|"Log result of transaction handling"|choose to log the result of transactions being performed|
-|5|"Remove deactivated payment types"|choose not to display payment types which haven't been activated in the Mollie account|
-|6|"Show icons"|display the icons of the payment types|
-|7|"Status Pending"|set the order-status before the customer gets redirected to the payment-gateway|
-|8|"Status Processing"|set the order-status for completed payments|
+{{:public:mollie_konfiguration_details.png?nolink&400|}}
-====Usage====
+^  no. ^ configuration option ^ description ^
+|  1  |"Mode": "Test" or "Live"|choose if you're still testing or already run the shop live / in production-mode|
+|  2  |"Test API Key"|paste here the "Test API Key" you can find in your Mollie account|
+|  3  |"Live API Key"|paste here the "Live API Key" you can find in your Mollie account|
+|  4  |"Log result of transaction handling"|choose to log the result of transactions being performed|
+|  5  |"Remove deactivated payment types"|choose not to display payment types which haven't been activated in the Mollie account|
+|  6  |"Show icons"|display the icons of the payment types|
+|  7  |"Status Pending"|set the order-status before the customer gets redirected to the payment-gateway|
+|  8  |"Status Processing"|set the order-status for completed payments|
+----
+==== Usage ====
 Activate payment-types as usual at //Shop Settings -> Payment Methods//. You see if a payment-type is provided by Mollie by selecting it with a click on a list-item, e.g. to "Belfius" or "Credit card". You'll get displayed "This is a Mollie payment type" on top in the tab "Main". It will be displayed, too, if a Mollie payment-type is not activated.
-{{:public:mollie_zahlart.png?400|}}
+{{:public:mollie_zahlart.png?nolink&400|}}
 As soon as the payment-types are correctly configured in your Mollie Account and the OXID-Admin they are available in the checkout of your online-shop.
-====Activation of Mollie Components for credit card====
+----
+==== Activation ====
+of Mollie Components for credit card
 To allow the customers to enter their credit card data without leaving your online-shop you have to
@@ Zeile 65: / Zeile 87: @@
   * choose from the selectbox "Creditcard data": "Input in shop checkout with iframe form inputs".
-{{:public:molliecreditcardcomponents.png?400|}}
+{{:public:molliecreditcardcomponents.png?nolink&400|}}
-====FAQ====
+----
-===1. Where can I see orders in the backend?===
+==== Expiry Date ====
+The Mollie module has the feature to cancel orders automatically after the timeframe you configured here. This applies to orders in the "Status Pending" configured by you. The Mollie cronjob has to be set up for this to work.
+{{public:faq:mollie:201029_mollie_expiry_date.png?nolink}}
+----
+==== Cronjobs ====
+The Mollie module includes a cronjob script which is able to execute certain tasks of the Mollie module periodically.
+For those periodic tasks to work you have to configure a cronjob on the webserver of your OXID eShop.
+The cronjob script can be found here:
+  {PATH TO YOUR SHOP}/source/modules/mollie/molliepayment/cron.php
+This cronjob main script starts all sub-jobs included in the Mollie module.
+You can configure the minute interval in which you want the sub-jobs to run in the database table "molliecronjob".
+You can enable or disable certain sub-jobs in the module configuration in the Cronjobs group.
+=== Subjobs ===
+The Mollie module has the following sub-jobs currently:
+  * **FinishOrders**: When a customer has paid successfully on the Mollie redirect page but he does not return to your shop, the order is not finalized correctly. This can happen for example when the customer loses his internet connection after payment or when the browser tab is closed before return to the shop. This Cronjob will finish these corrupted orders and complete all the unfinished tasks like sending the order confirmation email.
+  * **OrderExpiry**: Orders with pending payments can be cancelled automatically after a certain time. You can configure this timespan in the configuration for each Mollie payment method in the OXID backend. You can select a timespan between 1 and 30 days or deactivate this for each payment method.
+  * **SecondChanceEmail**: This cronjob enables you to send a reminder email to your customer for finishing the order process, when the customer did not continue the checkout during the payment process by e.g., closing the browser or having a failed payment attempt. No emails will be sent for payed orders or orders where the customer canceled the payment explicitly. You can configure the day interval between order attempt and sending the reminder in the Mollie configuration. The email text can be customized by changing the CMS block "Mollie Second Chance Email".
+More sub-jobs will be added in the future.
+You can activate/deactivate these Subjobs in the plugin settings:
+{{public:faq:mollie:210120_mollie_cronjobs.png?nolink}}
+==== FAQ ====
+  - [[#Where can I see orders in the backend?]]
+  - [[#Where can I see refunds in the backend?]]
+  - [[#Where can I see shipping information/ship items in the backend?]]
+  - [[#Where can I find the settings of the Mollie plugin?]]
+  - [[#Are the shipping information transfered to mollie?]]
+  - [[#What settings are possible within the backend?]]
+  - [[#Where can I find the logs?]]
+  - [[#What are the basic things to check while debugging?]]
+  - [[#What are the installation instructions?]]
+  - [[#What are the update instructions?]]
+=== 1. Where can I see orders in the backend? ===
   - Login to the OXID-Admin.
@@ Zeile 79: / Zeile 148: @@
     - See the tab “Main” a.s.o.
-{{:public:mollie_faq_1.png?400|}}
+{{:public:mollie_faq_1.png?nolink&400|}}
-===2. Where can I see refunds in the backend?===
+=== 2. Where can I see refunds in the backend? ===
   - Login to the OXID-Admin.
   - Click on the elements as shown in the screenshot below to
@@ Zeile 89: / Zeile 158: @@
     - See the tab “Mollie”, here the refund-functions are provided.
-{{:public:mollie_faq_2.png?400|}}
+{{:public:mollie_faq_2.png?nolink&400|}}
-===3. Where can I see shipping information/ship items in the backend?===
+=== 3. Where can I see shipping information/ship items in the backend? ===
 In Question 1. and 2.is already described how to get in the OXID-Admin to the place where information about an order can be found. The tabs (numbered with 4 to 10) mentioned in question 1. will be described one by another below.
-{{:public:mollie_faq_3.png?400|}}
+{{:public:mollie_faq_3.png?nolink&400|}}
   - Overview gives a general overview to the order.
@@ Zeile 120: / Zeile 189: @@
     - to perform a partial refund on order-position-base
-===4. Where can I find the settings of the Mollie plugin?===
+=== 4. Where can I find the settings of the Mollie plugin? ===
   - Login to the OXID-Admin.
   - Click on the elements as shown in the screenshot below to
@@ Zeile 129: / Zeile 198: @@
     - Click on “Basic configuration” to get the settings displayed
-{{:public:mollie_faq_4.png?400|}}
+{{:public:mollie_faq_4.png?nolink&400|}}
-===5. What settings are possible within the backend?===
+=== 5. Are the shipping information transfered to mollie? ===
+If you are using the plugin version 1.0.9 or higher, the information will be send to mollie after you saved the shipping information in OXID.\\
+Please update to the latest plugin version, if you using a version smaller than 1.0.9 to use this feature.
+=== 6. What settings are possible within the backend? ===
 See the question 4. to get to the settings for the Mollie Payment module.
-{{:public:mollie_faq_5.png?400|}}
+{{:public:mollie_faq_5.png?nolink&400|}}
-^No. ^configuration-option ^description ^
+^  No.  ^ configuration-option ^ description ^
-|1|„Mode“: „Test“ or „Live“|choose if you're still testing or already run the shop live / in production-mode|
+|  1  |„Mode“: „Test“ or „Live“|choose if you're still testing or already run the shop live / in production-mode|
-|2|„Test API Key“|paste here the „Test API Key“ you can find in your Mollie account|
+|  2  |„Test API Key“|paste here the „Test API Key“ you can find in your Mollie account|
-|3|„Live API Key“|paste here the „Live API Key“ you can find in your Mollie account|
+|  3  |„Live API Key“|paste here the „Live API Key“ you can find in your Mollie account|
-|4|„Log result of transaction handling“|choose to log the result of transactions being performed|
+|  4  |„Log result of transaction handling“|choose to log the result of transactions being performed|
-|5|„Remove deactivated payment types“|choose not to display payment types which haven't been activated in the Mollie account|
+|  5  |„Remove deactivated payment types“|choose not to display payment types which haven't been activated in the Mollie account|
-|6|„Show icons“|display the icons of the payment types|
+|  6  |„Show icons“|display the icons of the payment types|
-|7|„Status Pending“|set the order-status before the customer gets redirected to the payment-gateway|
+|  7  |„Status Pending“|set the order-status before the customer gets redirected to the payment-gateway|
-|8|„Status Processing“|set the order-status for completed payments|
+|  8  |„Status Processing“|set the order-status for completed payments|
-===6. Where can I find the logs?===
+=== 7. Where can I find the logs? ===
 There is a logging accessible for technically enabled users which have access to the MySQL-database of the shop. These can access the table “mollierequestlog” and read the request / response logging being written there.
-=== 7. What are the basic things to check while debugging?===
+=== 8. What are the basic things to check while debugging? ===
   - Try to reproduce the problem in the demo-shop, i.e. go to https://demoshop.rocks/, currently you find here
     - https://ox611.mollie.demoshop.rocks/ respectively
@@ Zeile 157: / Zeile 230: @@
   - If you don't get the problem solved yourself feel free to contact support@fatchip.de.
-=== 8. What are the installation instructions?===
+=== 9. What are the installation instructions? ===
   - Change to the directory „source/modules“ in your OXID eShop installation and create the directory „mollie“.
   - In this directory create a sub-directory „molliepayment“ and change to it. You find yourself in the path „source/modules/mollie/molliepayment“ now.
@@ Zeile 172: / Zeile 245: @@
   - Login to the OXID-admin of your shop and see the module „Mollie Payment“ in the list of modules at Extensions → Modules and click on „activate“ in case you find the module still being deactivated.
-{{:public:mollie_faq_6.png?400|}}
+{{:public:mollie_faq_6.png?nolink&600|}}
-===9. What are the update instructions?===
+=== 10. What are the update instructions? ===
   - Make a backup of all the shop files. Do not proceed before a complete backup is created and stored locally.
   - See the installation instructions in question 8.
@@ Zeile 182: / Zeile 255: @@
   - Test the Mollie Payment in the frontend, i.e. perform a test-order for each activated Mollie payment-method.
+----
 ====Support====
+If you need help from FATCHIP, please send a detailed error description including plug-in and shop version to //support@fatchip.de//.

Fatchip GmbH Wiki

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Unterschiede

Seiten-Werkzeuge