3brs/sylius-payment-fee-plugin

Payment extra fee plugin for Sylius

Installs: 1 229

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 2

Forks: 5

Open Issues: 4

Type:sylius-plugin

v1.1.0 2024-01-05 09:14 UTC

This package is auto-updated.

Last update: 2024-03-01 00:20:34 UTC


README

68747470733a2f2f33627273312e667261312e63646e2e6469676974616c6f6365616e7370616365732e636f6d2f336272732f6c6f676f2f334252532d6c6f676f2d73796c6975732d3230302e706e67

Payment Fee Plugin
68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f336272732f73796c6975732d7061796d656e742d6665652d706c7567696e2e737667 68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f336272732f73796c6975732d7061796d656e742d6665652d706c7567696e2e737667 68747470733a2f2f636972636c6563692e636f6d2f67682f334252532f73796c6975732d7061796d656e742d6665652d706c7567696e2e7376673f7374796c653d736869656c64

Features

  • Charge extra fee for a payment method
  • Typical usage: Cash on Delivery
  • Taxes are implemented the same way as taxes for shipping fees

admin.png

Installation

  1. Run composer require 3brs/sylius-payment-fee-plugin

  2. Add plugin class to your config/bundles.php

    return [
       ...
       ThreeBRS\SyliusPaymentFeePlugin\ThreeBRSSyliusPaymentFeePlugin::class => ['all' => true],
    ];
  3. Your Entity PaymentMethod has to implement \ThreeBRS\SyliusPaymentFeePlugin\Model\PaymentMethodWithFeeInterface. You can use Trait ThreeBRS\SyliusPaymentFeePlugin\Model\PaymentMethodWithFeeTrait.

For guide how to use your own entity see Sylius docs - Customizing Models

Admin

  1. Include @ThreeBRSSyliusPaymentFeePlugin/Admin/_form.html.twig into @SyliusAdmin/PaymentMethod/_form.html.twig.
{# ... #}

{% include '@ThreeBRSSyliusPaymentFeePlugin/Admin/_form.html.twig' %}
  1. Include @ThreeBRSSyliusPaymentFeePlugin/Admin/_order_show.html.twig into @AdminBundle/Order/Show/Summary/_totals.html.twig.
{# ... #}

{% include '@ThreeBRSSyliusPaymentFeePlugin/Admin/_order_show.html.twig' %}

Shop

  1. Include @ThreeBRSSyliusPaymentFeePlugin/Shop/Checkout/SelectPayment/_choice.html.twig into @ShopBundle/Checkout/SelectPayment/_choice.html.twig.
{# ... #}

{% include '@ThreeBRSSyliusPaymentFeePlugin/Shop/Checkout/SelectPayment/_choice.html.twig' %}
  1. Add variable fee {% set fee = form.method.vars.payment_costs[choice_form.vars.value] %} into @ShopBundle/Checkout/SelectPayment/_payment.html.twig into foreach.
{# ... #}

{% for key, choice_form in form.method %}
    {% set fee = form.method.vars.payment_costs[choice_form.vars.value] %}
    {% include '@SyliusShop/Checkout/SelectPayment/_choice.html.twig' with {'form': choice_form, 'method': form.method.vars.choices[key].data} %}
{% else %}
    {% include '@SyliusShop/Checkout/SelectPayment/_unavailable.html.twig' %}
{% endfor %}
  1. Include @ThreeBRSSyliusPaymentFeePlugin/Shop/Common/Order/Table/_payment.html.twig into @ShopBundle/Common/Order/Table/_totals.html.twig.
{# ... #}

<tr>
    {% include '@SyliusShop/Common/Order/Table/_shipping.html.twig' with {'order': order} %}
</tr>
{% include '@ThreeBRSSyliusPaymentFeePlugin/Shop/Common/Order/Table/_payment.html.twig' with {'order': order} %}
  1. Create and run doctrine database migrations
    bin/console doctrine:migrations:diff
    bin/console doctrine:migrations:migrate

Development

Usage

  • Alter plugin in /src
  • See bin/ dir for useful commands

Testing

After your changes you must ensure that the tests are still passing.

composer install
bin/console doctrine:database:create --if-not-exists --env=test
bin/console doctrine:schema:update --complete --force --env=test
yarn --cwd tests/Application install
yarn --cwd tests/Application build

bin/behat
bin/phpstan.sh
bin/ecs.sh
vendor/bin/phpspec run

Opening Sylius with your plugin

  1. Install symfony CLI command: https://symfony.com/download
    • hint: for Docker (with Ubuntu) use Debian/Ubuntu — APT based Linux installation steps as root user and without sudo command
      • you may need to install curl first apt-get update && apt-get install curl --yes
  2. Run app
(cd tests/Application && APP_ENV=test bin/console sylius:fixtures:load)
(cd tests/Application && APP_ENV=test symfony server:start --dir=public --port=8080)
  • change APP_ENV to dev if you need it

License

This library is under the MIT license.

Credits

Developed by 3BRS
Forked from manGoweb.