PHPackages                             3brs/sylius-ppl-parcelshops-plugin - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. 3brs/sylius-ppl-parcelshops-plugin

ActiveSylius-plugin[Utility & Helpers](/categories/utility)

3brs/sylius-ppl-parcelshops-plugin
==================================

PPL parcelshops plugin for Sylius

v2.1.0(3mo ago)082↓50%MITPHPPHP ^8.3CI passing

Since Nov 28Pushed 3mo agoCompare

[ Source](https://github.com/3BRS/sylius-ppl-parcelshops-plugin)[ Packagist](https://packagist.org/packages/3brs/sylius-ppl-parcelshops-plugin)[ RSS](/packages/3brs-sylius-ppl-parcelshops-plugin/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)Dependencies (43)Versions (9)Used By (0)

 [ ![](https://camo.githubusercontent.com/bb0c16caf210bea68e0e59fc11e0844dc47097f9aeb8b388c3de5f1414d4d1c0/68747470733a2f2f33627273312e667261312e63646e2e6469676974616c6f6365616e7370616365732e636f6d2f336272732f6c6f676f2f334252532d6c6f676f2d73796c6975732d3230302e706e67) ](https://www.3brs.com)

 PPL parcelshop plugin
 [ ![](https://camo.githubusercontent.com/4622096b683cc675707cba4aefa6424becfcd97ae4a76442326ddfe84804e386/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f334252532f73796c6975732d70706c2d70617263656c73686f70732d706c7567696e2e737667) ](https://packagist.org/packages/3BRS/sylius-ppl-parcelshops-plugin "License") [ ![](https://camo.githubusercontent.com/ee8d2149538c0b2d444c959e62e50162388165dc993676084bbb2112b99d2eb9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f334252532f73796c6975732d70706c2d70617263656c73686f70732d706c7567696e2e737667) ](https://packagist.org/packages/3BRS/sylius-ppl-parcelshops-plugin "Version") [ ![](https://github.com/3BRS/sylius-ppl-parcelshops/actions/workflows/tests.yml/badge.svg) ](https://github.com/3BRS/sylius-ppl-parcelshops/actions/workflows/tests.yml "Build status")
===========================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================

[](#----ppl-parcelshop-plugin----------------------------------------------------)

Requirements
------------

[](#requirements)

PackageVersionPHP^8.3Sylius^2.1> For Sylius 2.0 support, use version 2.0.x of this plugin. For Sylius 1.x support, use version 1.x of this plugin.

Features
--------

[](#features)

- Enables sending shipments via [PPL](https://www.ppl.cz/co-jsou-vydejni-mista) to PPL parcelshops.
- The user can choose the PPL parcelshops from the [map](https://www.ppl.cz/mapa-vydejnich-mist) during checkout in the Shipment step [![PPL_modal.png](docs/PPL_modal.png)](docs/PPL_modal.png)
- See PPL parcelshop in final checkout step and also in the admin panel.
- Export CSV with the PPL parcelshops shipments and import it easily into PPL's system.

PPL CSV import configuration
----------------------------

[](#ppl-csv-import-configuration)

- Configure CSV structure in your client zone
    - Navigation (in Czech)

Installation
------------

[](#installation)

### 1. Install the plugin via Composer

[](#1-install-the-plugin-via-composer)

```
composer require 3brs/sylius-ppl-parcelshops-plugin
```

### 2. Register the bundles

[](#2-register-the-bundles)

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

```
return [
    // ...
    ThreeBRS\SyliusShipmentExportPlugin\ThreeBRSSyliusShipmentExportPlugin::class => ['all' => true],
    ThreeBRS\SyliusPplParcelshopsPlugin\ThreeBRSSyliusPplParcelshopsPlugin::class => ['all' => true],
];
```

### 3. Import routing

[](#3-import-routing)

Add routing to `config/routes.yaml`:

```
threebrs_sylius_shipment_export_plugin:
    resource: "@ThreeBRSSyliusShipmentExportPlugin/Resources/config/admin_routing.yml"
    prefix: '/%sylius_admin.path_name%'

threebrs_sylius_ppl_parcelshops_plugin:
    resource: '@ThreeBRSSyliusPplParcelshopsPlugin/Resources/config/routing.yaml'
    prefix: /
```

### 4. Import plugin configuration

[](#4-import-plugin-configuration)

Add config import to `config/packages/_sylius.yaml`:

```
imports:
    # ...
    - { resource: "@ThreeBRSSyliusShipmentExportPlugin/Resources/config/config.yml" }
    - { resource: "@ThreeBRSSyliusPplParcelshopsPlugin/Resources/config/config.yaml" }
```

### 5. Configure entity models

[](#5-configure-entity-models)

Your Entity `Shipment` has to implement `\ThreeBRS\SyliusPplParcelshopsPlugin\Model\PplShipmentInterface`. You can use the trait `\ThreeBRS\SyliusPplParcelshopsPlugin\Model\PplShipmentTrait`.

Example:

```