tig / postnl-magento2
TIG Magento 2 PostNL extension
Installs: 365 097
Dependents: 2
Suggesters: 0
Security: 0
Stars: 58
Watchers: 26
Forks: 61
Open Issues: 6
Type:magento2-module
Requires
- php: ~7.3|~7.4|~8.1|~8.2
- ext-soap: *
- laminas/laminas-barcode: ~2.5|~2.8
- magento/framework: ~102.0|~103.0
- setasign/fpdf: ^1.8.2
- setasign/fpdi: ^2.3.2
Requires (Dev)
- dev-master
- 1.14.0
- 1.13.1
- 1.13.0
- 1.12.9.1
- 1.12.9
- 1.12.8
- 1.12.7
- 1.12.6.1
- 1.12.6
- 1.12.5
- 1.12.4
- 1.12.3
- 1.12.2
- 1.12.1
- 1.12.0
- 1.11.1-RC1
- 1.11.0-RC1
- 1.10.1
- 1.10.0
- 1.9.9
- 1.9.8
- 1.9.7
- 1.9.6
- 1.9.5
- 1.9.4.1
- 1.9.4
- 1.9.3
- 1.9.2.2
- 1.9.2.1
- 1.9.2
- 1.9.1.1
- 1.9.1
- 1.9.0.1
- 1.9.0
- 1.8.1
- 1.8.0.1
- 1.8.0
- 1.7.4
- 1.7.4-RC1
- 1.7.3
- 1.7.2
- 1.7.1
- 1.7.0
- 1.6.0
- 1.5.1
- 1.5.1-RC1
- 1.5.0
- 1.4.4
- 1.4.3
- 1.4.3-RC1
- 1.4.2
- 1.4.0
- v1.3.5
- v1.3.4
- v1.3.3
- v1.3.2
- v1.3.1
- v1.3.0
- v1.2.0
- v1.1.6-alpha
- v1.1.5-alpha
- v1.1.4-alpha
- v1.1.3-alpha
- v1.1.2-alpha
- v1.1.1-alpha
- v1.1.0-alpha
- dev-POSTNL-41/jira-workflow
- dev-POSTNL-11/jira-integration
- dev-sprint197_changing_ending_tag
- dev-beta-be
This package is auto-updated.
Last update: 2024-04-09 15:02:56 UTC
README
PostNL Magento 2
This is the official PostNL Magento 2 extension to connect your Magento 2 webshop with PostNL.
Requirements
- Magento version 2.3.6 - 2.3.7-p4, 2.4.3 - 2.4.6-p3
- PHP 7.3+, PHP 8.1+ for 2.4.4+
- In order to use this extension you need to be a contract customer of PostNL. If you are not a customer of PostNL, you can register yourself here.
Installation
We strongly recommend that you use a Staging Environment for the installation, and to also make a backup of your environment.
Installation using composer (recommended)
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:
Enable maintenance mode:
php bin/magento maintenance:enable
- Install the extension:
composer require tig/postnl-magento2
- Enable the PostNL Magento 2 plugin
php bin/magento module:enable TIG_PostNL
- Update the Magento 2 environment:
php bin/magento setup:upgrade
When your Magento environment is running in production mode, you also need to run the following comands:
- Compile DI:
php bin/magento setup:di:compile
- Deploy static content:
php bin/magento setup:static-content:deploy
- Disable maintenance mode:
php bin/magento maintenance:disable
Installation manually
- Download the extension directly from github by clicking on Code and then Download ZIP.
- Create the directory app/code/TIG/PostNL (Case-sensitive)
- Extract the zip and upload the code into app/code/TIG/PostNL
- Enable the PostNL Magento 2 plugin
php bin/magento module:enable TIG_PostNL
- Update the Magento 2 environment:
php bin/magento setup:upgrade
Update
To update the PostNL Extension run the following commands:
composer update tig/postnl-magento2 php bin/magento setup:upgrade
Uninstalling the PostNL extension
To remove the PostNL extension, simply make use of the uninstall command Magento provides: https://devdocs.magento.com/guides/v2.4/install-gde/install/cli/install-cli-uninstall-mods.html#instgde-cli-uninst-mod-uninst
PostNL uses uninstall scripts. Please make sure to add the --remove-data flag to your command. The uninstall script will ask if you would like to remove Order related PostNL data. Removing this data is optional. The recommended uninstall command is:
php bin/magento module:uninstall TIG_PostNL --backup-db --remove-data --clear-static-content`
Running tests (advanced)
Place this code in a working Magento 2 installation in the folder app/code/TIG/PostNL (Case-sensitive).
Install all the dependencies:
- composer install
- npm install
- npm install -g grunt-cli
- Setup the integration tests as advised by Magento.
- Paste the following xml within the
<testsuites>
tag of dev/tests/integration/phpunit.xml:
<testsuite name="TIG PostNL Integration Tests"> <directory>../../../app/code/TIG/PostNL/Test/Integration</directory> <directory>../../../vendor/tig/postnl/Test/Integration</directory> <exclude>../../../app/code/Magento</exclude> </testsuite>
Run:
grunt test
This command will run the following tests:
- Unit tests.
- Integration tests.
- CodeSniffer (PSR-2, Object Calisthenics and the Magento 2 Extension Quality Program).
- Lint all PHP files.
- JS lint all JS files.
The build status can be viewed on Travis-ci.com
Support
This extension is developed by Total Internet Group (TIG) commissioned by PostNL.
Extension basic configuration and account information
For questions related to your PostNL account and PostNL delivery options, please contact PostNL.
- Phone: +31 (0)88-2255651
- Website: www.postnl.com
Extension support and advanced configuration
For questions about installing and configuring the extension please consult the relevant documentation:
- Knowledge base: PostNL Magento 2 Knowledge base
- Phone: +31 (0)88-2255652
- Email: digitaleklantsupport@postnl.nl