Installation

For merchants

Requirements

• Shopware 6.7 (not 6.6), PHP 8.2+.
• Working email sending (Shopware: Mailer) — the store notification and the ready for pickup email use it.
• Optional: the SMS plugin, to text pickup locations.
• A database backup — installation runs migrations that add tables, a delivery state, mail templates and flows.

1. Install the plugin

Click and Pick is proprietary and not available from Packagist by version.

Option A — ZIP upload

1. Get the release ZIP (version 0.9.0) from KommandHub.
2. Extensions → My extensions → Upload extension (Shopware: My extensions), select the ZIP.

Option B — Composer from the repository

Requires read access to the repository. Add it to your project's composer.json:

"repositories": [
  { "type": "vcs", "url": "https://github.com/KommandHub/KommandhubClickAndPickSW.git" }
]

The repository has no release tag yet, so require a branch until one exists:

composer require "kommandhub/click-and-pick-sw:dev-main"

For a private repository, give Composer a GitHub token with read access: composer config --global github-oauth.github.com <token> (never commit it). Background: Shopware: extension management.

2. Activate

bin/console plugin:refresh
bin/console plugin:install --activate KommandhubClickAndPickSW
bin/console cache:clear

Activation creates:

What	Details
Shipping method Self pick-up	technical name kommandhub_self_pickup, price 0, delivery time 15-30 minutes, availability rule All customers
Payment method Pay on pickup	technical name kommandhub_pay_on_pickup, availability rule Payment method is self pick-up
Delivery state Ready	with transitions Open → Ready → Shipped, Ready → Open, Ready → Cancelled
Mail templates	Order ready for pickup (customer) and New pickup order received (pickup location), English and German
Flows (active)	Send pickup ready mail, Send pickup notification to admin
Administration	Content → Pickup Locations, and a Pickup information tab on orders

3. Offer the methods on your storefront

Both methods are created but not assigned to any sales channel:

1. Sales Channels → (storefront) → General: add Self pick-up to Shipping methods and Pay on pickup to Payment methods (Shopware: Sales channels).
2. Save.

Adjust names, prices or delivery time as for any shipping method or payment method.

4. Create a pickup location

Content → Pickup Locations → Add pickup location — name, address, email (receives new pickup orders), time zone, opening schedule, and the sales channel. See Pickup locations.

5. Verify

1. Storefront: add a product, go to checkout, choose Self pick-up, select the location, a date and a time slot, add instructions.
2. Choose Pay on pickup and place the order. The confirmation page shows the pickup location and time.
3. The location's email receives New pickup order received.
4. Administration: the order's Pickup information tab shows location, time and instructions.
5. Set the order's delivery status to Ready: the customer receives Order ready for pickup.

Permissions

Staff need Pickup location permissions (Viewer, Editor, Creator, Deleter, under Content) in their role to manage locations — see Shopware: Users & permissions.

Updating

composer update kommandhub/click-and-pick-sw     # or upload the new ZIP
bin/console plugin:refresh
bin/console plugin:update KommandhubClickAndPickSW
bin/console cache:clear

plugin:update runs new migrations and re-applies the shipping and payment methods.

Uninstalling

Extensions → My extensions → ⋯ → Uninstall, or bin/console plugin:uninstall KommandhubClickAndPickSW.

• Self pick-up and Pay on pickup are deactivated, not deleted — past orders reference them.
• Without keep plugin data, all pickup locations, schedules and order pickup records are deleted. Orders themselves are kept.