|
1 | | -<p align="center"><img src="https://postcodeservice.com/wp-content/uploads/2021/01/postcode-service-logo__Logo-color.svg" width="300px" /></p> |
2 | | - |
3 | | -# Postcode Service Magento 2 |
4 | | -[](https://github.com/postcodeservice/postcode-magento2/releases/latest) |
5 | | - |
| 1 | +# Postcode Service Magento 2 extension |
| 2 | +[](https://github.com/postcodeservice/postcode-magento2/releases/latest) |
6 | 3 |  |
| 4 | + |
| 5 | + |
7 | 6 | [](https://packagist.org/packages/tig/postcode-magento2/stats) |
8 | | - |
9 | | - |
10 | | - |
11 | | -## Requirements |
12 | | -- Magento version 2.4.6, 2.4.5, 2.4.4, 2.3.7 or 2.3.6 |
13 | | -- PHP 7.3+ |
14 | 7 |
|
15 | 8 | ## Installation |
16 | | -We strongly recommend that you use a Staging Environment for the installation, and to also make a backup of your environment. |
| 9 | +We strongly recommend that you use a staging environment for the installation, and to also make a backup of your environment. |
17 | 10 |
|
18 | | -### Installation using composer (recommended) |
19 | | -To install the extension login to your environment using SSH. Then navigate to the Magento 2 root directory and run the following commands in the same order as described: |
| 11 | +### Installation using composer (Recommended) |
| 12 | +To install the extension login to your environment using SSH. |
| 13 | +Then navigate to the Magento 2 root directory and run the following commands in the same order as described: |
20 | 14 |
|
21 | 15 | Enable maintenance mode: |
22 | 16 | ~~~~shell |
23 | 17 | php bin/magento maintenance:enable |
24 | 18 | ~~~~ |
25 | 19 |
|
26 | | -1. Install the extension: |
| 20 | +Install the extension: |
27 | 21 | ~~~~shell |
28 | 22 | composer require tig/postcode-magento2 |
29 | 23 | ~~~~ |
30 | 24 |
|
31 | | -2. Enable the Postcode Service Magento 2 extension |
| 25 | +Enable the Postcode Service Magento 2 extension |
32 | 26 | ~~~~shell |
33 | 27 | php bin/magento module:enable TIG_Postcode |
34 | 28 | ~~~~ |
35 | 29 |
|
36 | | -3. Update the Magento 2 environment: |
| 30 | +Update the Magento 2 environment: |
37 | 31 | ~~~~shell |
38 | 32 | php bin/magento setup:upgrade |
39 | 33 | ~~~~ |
40 | 34 |
|
41 | | -When your Magento environment is running in production mode, you also need to run the following comands: |
| 35 | +---------------------------------- |
| 36 | +When your Magento environment is running in production mode, you also need to run the following commands: |
42 | 37 |
|
43 | | -4. Compile DI: |
| 38 | +Compile DI: |
44 | 39 | ~~~~shell |
45 | 40 | php bin/magento setup:di:compile |
46 | 41 | ~~~~ |
47 | 42 |
|
48 | | -5. Deploy static content: |
| 43 | +Deploy static content: |
49 | 44 | ~~~~shell |
50 | 45 | php bin/magento setup:static-content:deploy |
51 | 46 | ~~~~ |
| 47 | +---------------------------------- |
52 | 48 |
|
53 | | -6. Disable maintenance mode: |
| 49 | +Disable maintenance mode: |
54 | 50 | ~~~~shell |
55 | 51 | php bin/magento maintenance:disable |
56 | 52 | ~~~~ |
57 | 53 |
|
58 | | -### Installation manually |
59 | | -1. Download the extension directly from [github](https://github.com/postcodeservice/postcode-magento2) by clicking on *Code* and then *Download ZIP*. |
60 | | -2. Create the directory *app/code/TIG/Postcode* (Case-sensitive) |
61 | | -3. Extract the zip and upload the code into *app/code/TIG/Postcode* |
62 | | -4. Enable the Postcode Service Magento 2 extension |
| 54 | +## How to update the extension |
| 55 | +To update the Postcode Service Extension run the following commands: |
63 | 56 | ~~~~shell |
64 | | -php bin/magento module:enable TIG_Postcode |
| 57 | +composer update tig/postcode-magento2 |
| 58 | +php bin/magento setup:upgrade |
65 | 59 | ~~~~ |
66 | 60 |
|
67 | | -5. Update the Magento 2 environment: |
| 61 | +## Alternatively, install the extension manually |
| 62 | +- Download the extension directly from [github](https://github.com/postcodeservice/postcode-magento2) by clicking on *Code* and then *Download ZIP*. |
| 63 | +- Create the directory *app/code/TIG/Postcode* (Case-sensitive) |
| 64 | +- Extract the zip and upload the code into *app/code/TIG/Postcode* |
| 65 | +- Enable the Postcode Service Magento 2 extension |
68 | 66 | ~~~~shell |
69 | | -php bin/magento setup:upgrade |
| 67 | +php bin/magento module:enable TIG_Postcode |
70 | 68 | ~~~~ |
71 | | - |
72 | | -## Update |
73 | | -To update the Postcode Service Extension run the following commands: |
| 69 | +- Update the Magento 2 environment |
74 | 70 | ~~~~shell |
75 | | -composer update tig/postcode-magento2 |
76 | 71 | php bin/magento setup:upgrade |
77 | 72 | ~~~~ |
78 | 73 |
|
79 | | -## Examples |
| 74 | +## Configuration |
| 75 | +After completing the installation process, the extension should be readily available in the backend of your Magento webshop. From there, you can configure the extension according to your requirements: |
| 76 | + |
| 77 | +1. Go to Stores -> Configuration -> Sales -> Postcode Service International |
| 78 | + |
| 79 | +2. Open the Configuration tab |
| 80 | + |
| 81 | +3. Change the Modus from "Off" to "Test" or "Live" |
| 82 | + |
| 83 | +4. Insert your Client ID and Api key (Secure Code). When you selected “Test” at the Modus, you can find test credentials below the fields - keep in mind there is a daily limit -.\ |
| 84 | +To sign up for a paid account and get your Client ID and Api key, simply visit https://postcodeservice.com and subscribe. |
| 85 | + |
| 86 | +5. In the 'Countries' section, select the country for which you wish to enable the Postcode Service. |
| 87 | +6. Flush your cache |
80 | 88 |
|
81 | | -### Dutch Postcode Service within the Magento 2 checkout |
82 | | - |
| 89 | +## Visual representation of the Postcode Service Magento extension during the checkout process |
| 90 | +### For Dutch postcodes |
| 91 | +<img src="https://postcodeservice.com/wp-content/uploads/2022/08/postcodeservice-magento-2-nl.gif" width="50%"> |
| 92 | + |
| 93 | +### For Belgium postcodes |
| 94 | +<img src="https://postcodeservice.com/wp-content/uploads/2022/08/postcodeservice-magento-2-be.gif" width="50%"> |
| 95 | + |
| 96 | +## Further documentation |
| 97 | +You can find the underlying Postcode Service API documentation here: https://developers.postcodeservice.com |
| 98 | + |
| 99 | +## Frequently Asked Questions |
| 100 | +Q: What are the costs for using the Postcode Service?\ |
| 101 | +A: The Adobe Magento extension can be used free of charge. The fee for using the Postcode Service can be found at our website https://postcodeservice.com |
| 102 | +\ |
| 103 | +Q: Which third party extensions are supported and compatible?\ |
| 104 | +A: At this time, we do not support third-party checkout extensions, including OneStepCheckout.com, Amasty, and MagePlaza. While we understand the importance of these third party extensions for some webshops, we cannot guarantee their compatibility with our extension and therefore cannot provide support for any issues that may arise as a result of their use. We have received reports from some users about compatibility issues with OneStepCheckout and MagePlaza, but this experience may vary from agency to agency, depending on the custom implementations. However, we are constantly working to improve our extension's functionality and compatibility, and we may revisit this decision in the future. |
| 105 | + |
| 106 | +## Requirements |
| 107 | +Adobe Magento Open Source (Community edition) or Adobe Commerce (Enterprise version). |
83 | 108 |
|
84 | | -### Belgium Postcode Service within the Magento 2 checkout |
85 | | - |
| 109 | +## Version support |
| 110 | +We follow the release support lines dates from Adobe https://experienceleague.adobe.com/docs/commerce-operations/release/versions.html for the version support of this extension. |
86 | 111 |
|
87 | | -## Documentation |
88 | | -For further installation guidance |
89 | | -https://developers.postcodeservice.com/ |
| 112 | +## Release history |
| 113 | +See https://github.com/postcodeservice/postcode-magento2/releases |
0 commit comments