mangoweb-sylius / sylius-zasilkovna-plugin
Zasilkovna plugin for Sylius
Installs: 5 737
Dependents: 0
Suggesters: 0
Security: 0
Stars: 3
Watchers: 3
Forks: 0
Open Issues: 1
Type:sylius-plugin
Requires
- php: ^7.3
- ext-json: *
- mangoweb-sylius/sylius-shipment-export-plugin: ^0.4.0
- sylius/sylius: ^1.7.0
Requires (Dev)
- behat/behat: ^3.4
- behat/mink: ^1.7@dev
- behat/mink-browserkit-driver: ^1.3
- behat/mink-extension: ^2.2
- behat/mink-selenium2-driver: ^1.3
- friends-of-behat/page-object-extension: ^0.3
- friends-of-behat/suite-settings-extension: ^1.0
- friends-of-behat/symfony-extension: ^2.0
- friends-of-behat/variadic-extension: ^1.1
- lakion/mink-debug-extension: ^1.2.3
- phpspec/phpspec: ^6.0
- phpstan/phpstan: ^0.12.0
- phpstan/phpstan-doctrine: ^0.12.0
- phpstan/phpstan-strict-rules: ^0.12.0
- phpstan/phpstan-symfony: ^0.12.4
- phpstan/phpstan-webmozart-assert: ^0.12.0
- phpunit/phpunit: ^8.0
- sensiolabs/security-checker: ^6.0
- sylius-labs/coding-standard: ^3.1
- symfony/browser-kit: ^4.4
- symfony/debug-bundle: ^4.4
- symfony/dotenv: ^4.4
- symfony/intl: ^4.4
- symfony/web-profiler-bundle: ^4.4
- symfony/web-server-bundle: ^4.4
Conflicts
- symfony/browser-kit: 4.1.8
- symfony/dependency-injection: 4.1.8
- symfony/dom-crawler: 4.1.8
- symfony/routing: 4.1.8
- symfony/symfony: 4.1.8
README
Zásilkovna Plugin
Features
- Enables sending shipments via [cz] [pl] [sk] [hu] [ro] to Zasilkovna branch or to the customer's address via Zasilkovna service.
- The user can choose the Zásilkovna branch from the map during checkout in the Shipment step.
- See Zásilkovna branch in final checkout step and also in the admin panel.
- Export CSV with the Zásilkovna shipments (both to Zasilkovna branch or customer's address) and import it easily into Zásilkovna's system.
Installation
-
Run
$ composer require mangoweb-sylius/sylius-zasilkovna-plugin
. -
Add plugin classes to your
config/bundles.php
:return [ ... MangoSylius\ShipmentExportPlugin\MangoSyliusShipmentExportPlugin::class => ['all' => true], MangoSylius\SyliusZasilkovnaPlugin\MangoSyliusZasilkovnaPlugin::class => ['all' => true], ];
-
Add resource to
config/packeges/_sylius.yaml
imports: ... ... - { resource: "@MangoSyliusZasilkovnaPlugin/Resources/config/resources.yml" }
-
Add routing to
config/_routes.yaml
mango_sylius_shipment_export_plugin: resource: '@MangoSyliusShipmentExportPlugin/Resources/config/routing.yml' prefix: /admin
-
Your Entity
Shipment
has to implement\MangoSylius\SyliusZasilkovnaPlugin\Model\ZasilkovnaShipmentInterface
. You can use the trait\MangoSylius\SyliusZasilkovnaPlugin\Model\ZasilkovnaShipmentTrait
.<?php declare(strict_types=1); namespace App\Entity\Shipping; use Doctrine\ORM\Mapping as ORM; use MangoSylius\SyliusZasilkovnaPlugin\Model\ZasilkovnaShipmentInterface; use MangoSylius\SyliusZasilkovnaPlugin\Model\ZasilkovnaShipmentTrait; use Sylius\Component\Core\Model\Shipment as BaseShipment; /** * @ORM\Entity * @ORM\Table(name="sylius_shipment") */ class Shipment extends BaseShipment implements ZasilkovnaShipmentInterface { use ZasilkovnaShipmentTrait; }
-
Your Entity
ShippingMethod
has to implement\MangoSylius\SyliusZasilkovnaPlugin\Model\ZasilkovnaShipmentInterface
. You can use the trait\MangoSylius\SyliusZasilkovnaPlugin\Model\ZasilkovnaShipmentTrait
.<?php declare(strict_types=1); namespace App\Entity\Shipping; use Doctrine\ORM\Mapping as ORM; use MangoSylius\SyliusZasilkovnaPlugin\Model\ZasilkovnaShippingMethodInterface; use MangoSylius\SyliusZasilkovnaPlugin\Model\ZasilkovnaShippingMethodTrait; use Sylius\Component\Core\Model\ShippingMethod as BaseShippingMethod; /** * @ORM\Entity * @ORM\Table(name="sylius_shipping_method") */ class ShippingMethod extends BaseShippingMethod implements ZasilkovnaShippingMethodInterface { use ZasilkovnaShippingMethodTrait; }
-
Include
@MangoSyliusZasilkovnaPlugin/Admin/ShippingMethod/:zasilkovnaForm.html.twig
into@SyliusAdmin/ShippingMethod/_form.html.twig
.... {{ include('@MangoSyliusZasilkovnaPlugin/Admin/ShippingMethod/_zasilkovnaForm.html.twig') }}
-
Include
@MangoSyliusZasilkovnaPlugin/Shop/Checkout/SelectShipping/_zasilkovnaChoice.html.twig
into@SyliusShop/Checkout/SelectShipping/_choice.html.twig
.... {{ include('@MangoSyliusZasilkovnaPlugin/Shop/Checkout/SelectShipping/_zasilkovnaChoice.html.twig') }}
-
Replace
{% include '@SyliusShop/Common/_address.html.twig' with {'address': order.shippingAddress} %}
with{{ include('@MangoSyliusZasilkovnaPlugin/Shop/Common/Order/_addresses.html.twig') }}
in@SyliusShop/Common/Order/_addresses.html.twig
-
Replace
{% include '@SyliusAdmin/Common/_address.html.twig' with {'address': order.shippingAddress} %}
with{{ include('@MangoSyliusZasilkovnaPlugin/Admin/Common/Order/_addresses.html.twig') }}
in@SyliusAdmin/Order/Show/_addresses.html.twig
-
Override the template in
@MangoSyliusShipmentExportPlugin/_row.html.twig
{% extends '@!MangoSyliusShipmentExportPlugin/_row.html.twig' %} {% block address %} {% if row.zasilkovna %} {{ include('@MangoSyliusZasilkovnaPlugin/_exporterRow.html.twig') }} {% else %} {{ parent() }} {% endif %} {% endblock %}
-
Create and run doctrine database migrations.
For the guide how to use your own entity see Sylius docs - Customizing Models
Usage
- For delivery to the Zasilkovna branch, create new shipping method in the admin panel, set
Zásilkovna api key
and leaveCarrier ID
empty. - For delivery to customer's address, create new shipping method in the admin panel, set the
Carrier ID
and leave theZasilkovna API key
empty. - If you need to filter the points in the map by country, use the
Show only pickup points from specific country in the map
. If you leave this blank, all points in all supported countries will be shown. - Zásilkovna CSV export will be generated for shipping method which has the code 'zasilkovna', you can change this in parameters, it is an array (therefore can contain more codes, e.g. if you need to have different prices for different countries, you will need more shipping methods; it is okay to use always the same API key)
parameters: shippingMethodsCodes: ['zasilkovna']
You should add to this array both methods for shipping to Zasilkovna branch and also to customer's address via Zasilkovna service. - Packeta API documentation: https://docs.packetery.com/03-creating-packets/01-csv-import.html
Development
Usage
- Develop your plugin in
/src
- See
bin/
for useful commands
Testing
After your changes you must ensure that the tests are still passing.
$ composer install
$ bin/console doctrine:schema:create -e test
$ bin/behat
$ bin/phpstan.sh
$ bin/ecs.sh
License
This library is under the MIT license.
Credits
Developed by manGoweb.