README

Sylius Nexi Plugin

The SyliusNexiPlugin provides an integration between Sylius and Nexi XPay payment gateway. This plugin implements the Hosted Payment Page integration method.

Note! This plugin is only compatible with the Nexi configuration which allows only one payment per request. It is therefore not possible to retry the payment several times on the Nexi checkout, so make sure that your Nexi gateway is configured to not allow payment retry (you'll have to ask to Nexi customer care for this)!

Installation

Run:

composer require webgriffe/sylius-nexi-plugin

Add Webgriffe\SyliusNexiPlugin\WebgriffeSyliusNexiPlugin::class => ['all' => true] to your config/bundles.php.

Normally, the plugin is automatically added to the config/bundles.php file by the composer require command. If it is not, you have to add it manually.

Create a new file config/packages/webgriffe_sylius_nexi_plugin.yaml:

imports:
    - { resource: "@WebgriffeSyliusNexiPlugin/config/config.php" }

Import the routes needed. Add the following to your config/routes.yaml file:

webgriffe_sylius_nexi_plugin_shop:
    resource: "@WebgriffeSyliusNexiPlugin/config/routes/shop.php"
    prefix: /{_locale}
    requirements:
        _locale: ^[A-Za-z]{2,4}(_([A-Za-z]{4}|[0-9]{3}))?(_([A-Za-z]{2}|[0-9]{3}))?$

webgriffe_sylius_nexi_plugin_ajax:
    resource: "@WebgriffeSyliusNexiPlugin/config/routes/shop_ajax.php"

sylius_shop_payum_cancel:
    resource: "@PayumBundle/Resources/config/routing/cancel.xml"

NB: The file shop_routing needs to be after the prefix _locale, so that messages can be displayed in the right language. You should also include the cancel routes from the Payum bundle if you do not have it already!

Run:
```
php bin/console sylius:install:assets
```

Usage

Go in your Sylius admin panel and create a new payment method. Choose Nexi Gateway as the payment gateway and fill the required fields. You can also enable the Sandbox mode if you want to test the integration with the Nexi test environment.

Contributing

For a comprehensive guide on Sylius Plugins development please go to Sylius documentation, there you will find the Plugin Development Guide - it's a great place to start.

For more information about the Test Application included in the skeleton, please refer to the Sylius documentation.

Traditional

From the plugin skeleton root directory, run the following commands:

(cd vendor/sylius/test-application && yarn install)
(cd vendor/sylius/test-application && yarn build)
vendor/bin/console assets:install

vendor/bin/console doctrine:database:create
vendor/bin/console doctrine:migrations:migrate -n
# Optionally load data fixtures
vendor/bin/console sylius:fixtures:load -n

To be able to set up a plugin's database, remember to configure your database credentials in tests/TestApplication/.env and tests/TestApplication/.env.test.

Run your local server:

symfony server:ca:install
symfony server:start -d

Open your browser and navigate to https://localhost:8000.

Docker

Execute make init to initialize the container and install the dependencies.
Execute make database-init to create the database and run migrations.
(Optional) Execute make load-fixtures to load the fixtures.
Your app is available at http://localhost.

Usage

Running plugin tests

PHPUnit
```
vendor/bin/phpunit
```

Behat (non-JS scenarios)

vendor/bin/behat --strict --tags="~@javascript&&~@mink:chromedriver"

Behat (JS scenarios)

Install Symfony CLI command.
Start Headless Chrome:

google-chrome-stable --enable-automation --disable-background-networking --no-default-browser-check --no-first-run --disable-popup-blocking --disable-default-apps --allow-insecure-localhost --disable-translate --disable-extensions --no-sandbox --enable-features=Metal --headless --remote-debugging-port=9222 --window-size=2880,1800 --proxy-server='direct://' --proxy-bypass-list='*' http://127.0.0.1

Install SSL certificates (only once needed) and run test application's webserver on 127.0.0.1:8080:

symfony server:ca:install
APP_ENV=test symfony server:start --port=8080 --daemon

Run Behat:

vendor/bin/behat --strict --tags="@javascript,@mink:chromedriver"

Static Analysis

PHPStan

vendor/bin/phpstan analyse -c phpstan.neon -l max src/

Psalm
```
vendor/bin/psalm
```

Coding Standard
```
vendor/bin/ecs check
```

Opening Sylius with your plugin

Using test environment:

APP_ENV=test vendor/bin/console vendor/bin/console sylius:fixtures:load -n
APP_ENV=test symfony server:start -d

Using dev environment:

vendor/bin/console vendor/bin/console sylius:fixtures:load -n
symfony server:start -d

webgriffe / sylius-nexi-plugin

Maintainers

Details

README

Sylius Nexi Plugin

Installation

Usage

Contributing

Traditional

Docker

Usage

Running plugin tests

Opening Sylius with your plugin