README

Packeta Plugin

Features

• Enables sending shipments via [en] [cz] [pl] [sk] [hu] [ro] to Packeta branch or to the customer's address via Packeta service.
• The user can choose the Packeta branch from the map during checkout in the Shipment step.
• See Packeta branch in final checkout step and also in the admin panel.
• Export CSV with the Packeta shipments (both to Packeta branch or customer's address) and import it easily into Packeta's system.

Installation

1. Run composer require 3brs/sylius-packeta-plugin.

2. Add plugin classes to your config/bundles.php:

   return [
      ...
      ThreeBRS\SyliusShipmentExportPlugin\ThreeBRSSyliusShipmentExportPlugin::class => ['all' => true],
      ThreeBRS\SyliusPacketaPlugin\ThreeBRSSyliusPacketaPlugin::class => ['all' => true],
   ];

3. Use plugin configuration by creating config/packages/threebrs_sylius_packeta_plugin.yaml with content

   imports:
        - { resource: "@ThreeBRSSyliusPacketaPlugin/Resources/config/config.{yml,yaml}" }

4. Add routing to config/routes.yaml

   threebrs_sylius_shipment_export_plugin:
       resource: "@ThreeBRSSyliusShipmentExportPlugin/Resources/config/admin_routing.{yml,yaml}"
       prefix: '/%sylius_admin.path_name%'

5. Your Entity Shipment has to implement \ThreeBRS\SyliusPacketaPlugin\Model\PacketaShipmentInterface. You can use the trait \ThreeBRS\SyliusPacketaPlugin\Model\PacketaShipmentTrait.

   <?php 
   
   declare(strict_types=1);
   
   namespace App\Entity\Shipping;
   
   use Doctrine\ORM\Mapping as ORM;
   use ThreeBRS\SyliusPacketaPlugin\Model\PacketaShipmentInterface;
   use ThreeBRS\SyliusPacketaPlugin\Model\PacketaShipmentTrait;
   use Sylius\Component\Core\Model\Shipment as BaseShipment;
   
   #[ORM\Entity]
   #[ORM\Table(name: 'sylius_shipment')]
   class Shipment extends BaseShipment implements PacketaShipmentInterface
   {
       use PacketaShipmentTrait;
   }

6. Your Entity ShippingMethod has to implement \ThreeBRS\SyliusPacketaPlugin\Model\PacketaShipmentInterface. You can use the trait \ThreeBRS\SyliusPacketaPlugin\Model\PacketaShipmentTrait.

   <?php 
   
   declare(strict_types=1);
   
   namespace App\Entity\Shipping;
   
   use Doctrine\ORM\Mapping as ORM;
   use ThreeBRS\SyliusPacketaPlugin\Model\PacketaShippingMethodInterface;
   use ThreeBRS\SyliusPacketaPlugin\Model\PacketaShippingMethodTrait;
   use Sylius\Component\Core\Model\ShippingMethod as BaseShippingMethod;
   
   #[ORM\Entity]
   #[ORM\Table(name: 'sylius_shipping_method')]
   class ShippingMethod extends BaseShippingMethod implements PacketaShippingMethodInterface
   {
       use PacketaShippingMethodTrait;
   }

7. Override the template in @ThreeBRSSyliusShipmentExportPlugin/_row.html.twig

   {% extends '@!ThreeBRSSyliusShipmentExportPlugin/_row.html.twig' %}
   
   {% block address %}
      {% if row.packeta %}
           {{ include('@ThreeBRSSyliusPacketaPlugin/_exporterRow.html.twig') }}
      {% else %}
          {{ parent() }}
      {% endif %}
   {% endblock %}

8. 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 Packeta branch, create new shipping method in the admin panel, set Packeta api key and leave Carrier ID empty.
• For delivery to customer's address, create new shipping method in the admin panel, set the Carrier ID and leave the Packeta 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.
• Packeta CSV export will be generated for shipping method which has the code 'packeta', 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: ['packeta']

  You should add to this array both methods for shipping to Packeta branch and also to customer's address via Packeta service.
• Packeta API documentation: https://docs.packeta.com/docs/getting-started/client-section-imports#csv-import
• You can expand the list of countries by the parameter

  parameters:
    threebrs_sylius_packeta_plugin_payment_methods: ['cz', 'pl', 'sk', 'hu', 'ro']

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.

make ci

License

This library is under the MIT license.

Credits

Developed by 3BRS
Forked from manGoweb.