README

Sell and hand over securely during the coronavirus pandemic!

Because of the coronavirus pandemic, a large part of the world is under lockdown and most shops are closed or with long queues.

Sylius Click 'N' Collect is a solution to sell and hand over your products safely during the lockdown (and even after that). By allowing contactless pick up and preventing queues, Sylius Click 'N' Collect protects your workers and your customers.

Sylius Click 'N' Collect is a plugin for the Sylius eCommerce platform. It's free (as in speech, and as in beer), and it's brought to you by your friends from Les-Tilleuls.coop. It can also be used in addition to all the existing features and plugins of Sylius.

How Does It Work?

As a customer:

Go on the shop's website
Select the products to order
Select the collect location (e.g. the physical shop)
Select an available time slot
Pay online, or select in-store payment (Stripe and PayPal are also supported).
Optional: a PIN is generated, you'll need it to retrieve the order
Pick up your order at the shop during the selected time slot! Use the PIN code to unlock the box if appropriate.

As a seller:

Use the timetable in the admin interface to see the upcoming orders
Prepare the orders: put them in a bag and make the order number noticeable (staple it or use a marker)
Clean carefully the shelf and the lock (if appropriate) with the appropriate cleaning products
Put the bag in the shelf
Optional: use the PIN to lock the box in the shelf to secure the order
Monitor the pick up from afar, from behind a window, or using CCTV

Repeat!

You're now selling while preventing the pandemic to spread!

Install

Note: to test the plugin locally, see CONTRIBUTING.md

Install Sylius
Install Sylius Click 'N' Collect: composer require tilleuls/sylius-click-n-collect-plugin

<?php

// config/bundles.php

return [
    // ...
    CoopTilleuls\SyliusClickNCollectPlugin\CoopTilleulsSyliusClickNCollectPlugin::class => ['all' => true],
];

Import the configuration:

# config/packages/sylius_click_n_collect.yaml
imports:
    - { resource: "@CoopTilleulsSyliusClickNCollectPlugin/Resources/config/app/config.yml" }

Import the routes:

# config/routes/sylius_click_n_collect.yaml
coop_tilleuls_sylius_click_n_collect_shop:
    resource: "@CoopTilleulsSyliusClickNCollectPlugin/Resources/config/shop_routing.yml"
    prefix: /{_locale}
    requirements:
        _locale: ^[a-z]{2}(?:_[A-Z]{2})?$

coop_tilleuls_sylius_click_n_collect_admin:
    resource: "@CoopTilleulsSyliusClickNCollectPlugin/Resources/config/admin_routing.yml"
    prefix: /admin

Update the native entities:

<?php

// src/Entity/Shipping/ShippingMethod.php

namespace App\Entity\Shipping;

use CoopTilleuls\SyliusClickNCollectPlugin\Entity\ClickNCollectShippingMethod;
use CoopTilleuls\SyliusClickNCollectPlugin\Entity\ClickNCollectShippingMethodInterface;
use Doctrine\ORM\Mapping as ORM;
use Sylius\Component\Core\Model\ShippingMethod as BaseShippingMethod;

/**
 * @ORM\Entity
 * @ORM\Table(name="sylius_shipping_method")
 */
class ShippingMethod extends BaseShippingMethod implements ClickNCollectShippingMethodInterface
{
    use ClickNCollectShippingMethod {
        __construct as initializeShippingMethodLocations;
    }

    public function __construct()
    {
        parent::__construct();

        $this->initializeShippingMethodLocations();
    }

    // ...
}

<?php

// src/Entity/Shipping/Shipment.php

namespace App\Entity\Shipping;

use CoopTilleuls\SyliusClickNCollectPlugin\Entity\ClickNCollectShipment;
use CoopTilleuls\SyliusClickNCollectPlugin\Entity\ClickNCollectShipmentInterface;
use CoopTilleuls\SyliusClickNCollectPlugin\Validator\Constraints\SlotAvailable;
use Doctrine\ORM\Mapping as ORM;
use Sylius\Component\Core\Model\Shipment as BaseShipment;

/**
* @ORM\Entity
* @ORM\Table(name="sylius_shipment", indexes={@ORM\Index(columns={"location_id", "collection_time"})})
* @SlotAvailable(groups={"sylius"})
*/
class Shipment extends BaseShipment implements ClickNCollectShipmentInterface
{
   use ClickNCollectShipment;
}

Override the templates:

cp -R vendor/tilleuls/sylius-click-n-collect-plugin/tests/Application/templates/* templates

Create and execute database migrations:

bin/console doctrine:migrations:diff
bin/console doctrine:migrations:migrate

Copy the assets

bin/console assets:install
bin/console sylius:theme:assets:install

Add your products and stocks or import them
Configure the pick up locations, the available time slots, and how many people you can safely serve in parallel
Create a dedicated shipping method
Optionally, configure an online payment method from the admin (Stripe and PayPal are supported out of the box)

Export data

see docs/exports.md

You're ready to sell!

License

Pandemic Clause

To use this software, you MUST ensure that all the workers and customers using it aren't at risk! It means that you MUST reduce the number of contacts between the workers and customers (in most cases the delivery should be contactless), and that you MUST provide masks, hand sanitizers and gloves to the workers who handle products.

Lives matter more than profits.

AGPL

Sylius Click 'N' Collect is licensed under AGPL-3.0. For companies not wanting, or not able to use AGPL-3.0 licensed software, commercial licenses are also available. Contact us for more information.

Credits

Created by Kévin Dunglas for Les-Tilleuls.coop. Commercial support available at Les-Tilleuls.coop.

tilleuls / sylius-click-n-collect-plugin

Maintainers

Details