PHPackages                             gokarla/shopware - 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. gokarla/shopware

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

gokarla/shopware
================

Automatically transmit orders from your shop to Karla, providing precise and timely updates to your customers and improving the post-purchase experience.

v1.2.0(3mo ago)1516Apache-2.0PHPCI passing

Since Feb 29Pushed 3mo ago2 watchersCompare

[ Source](https://github.com/gokarla-io/shopware)[ Packagist](https://packagist.org/packages/gokarla/shopware)[ RSS](/packages/gokarla-shopware/feed)WikiDiscussions main Synced yesterday

READMEChangelog (10)Dependencies (14)Versions (11)Used By (0)

Karla Shopware Extension
========================

[](#karla-shopware-extension)

[![ci](https://github.com/gokarla-io/shopware/actions/workflows/ci.yaml/badge.svg)](https://github.com/gokarla-io/shopware/actions/workflows/ci.yaml)[![License: Apache-2.0](https://camo.githubusercontent.com/5b60841bea9e11d9d0b0950d690c9bc554e06385634056a7d5d62a15d1a4eabe/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4170616368655f322e302d626c75652e737667)](https://opensource.org/licenses/Apache-2.0)[![PHP Version](https://camo.githubusercontent.com/91e2ff786d2fba1edf015025006e0156a071320b3662eaf2c50f39d4bb4b2369/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344382e332d626c7565)](https://www.php.net/)[![Shopware](https://camo.githubusercontent.com/67ab61d2849b21da22aa3eabb260d44f932f1100fd921cc980878bf988db7c57/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f73686f70776172652d362e782d626c7565)](https://www.shopware.com/)[![Packagist](https://camo.githubusercontent.com/bfaa319c8a6953cb4640d93e6e544206d177e32fd7b51326418d518272a08846/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f676f6b61726c612f73686f7077617265)](https://packagist.org/packages/gokarla/shopware)

Enhance your post-purchase customer experience in [Shopware](https://www.shopware.com/en/) with [GoKarla](https://gokarla.io) - automated order tracking and delivery updates for your customers.

Overview
--------

[](#overview)

The Karla Delivery extension automatically synchronizes your Shopware orders and shipments with GoKarla, enabling you to provide your customers with precise, timely delivery updates and improve satisfaction after purchase.

Features
--------

[](#features)

### Core Capabilities

[](#core-capabilities)

- **Automatic Order Synchronization** - Orders are automatically sent to GoKarla when placed or updated
- **Shipment Tracking Integration** - Delivery tracking codes are synchronized in real-time
- **Customer Segmentation** - Leverage order and customer tags for targeted communication
- **Multi-Channel Support** - Map different sales channels to specific GoKarla shops

### Flexible Configuration

[](#flexible-configuration)

- **Configurable Event Triggers** - Choose which order and delivery statuses trigger synchronization
- **Line Item Type Mapping** - Support for products, promotions, and custom line item types (e.g., deposits)
- **Custom API Endpoint** - Use production or custom GoKarla API endpoints
- **Detailed Logging** - Built-in logging for troubleshooting and monitoring

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

[](#requirements)

- **Shopware 6** - Compatible with Shopware 6.x
- **GoKarla Account** - Sign up at [portal.gokarla.io](https://portal.gokarla.io)
- **API Credentials** - Shop slug and API key from your GoKarla account. See [Authentication](https://docs.gokarla.io/docs/api/authentication).

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

[](#installation)

### Option 1: Via Shopware Admin Panel (Recommended)

[](#option-1-via-shopware-admin-panel-recommended)

1. Download the latest `KarlaDelivery.zip` from [GitHub Releases](https://github.com/gokarla/shopware/releases)
2. In Shopware admin, navigate to **Extensions** → **My Extensions**
3. Click **Upload extension** and select the downloaded ZIP file
4. Click **Install** and then **Activate**
5. Configure your API credentials in the extension settings

For detailed instructions, see [Shopware Integration Documentation](https://docs.gokarla.io/docs/shop-integrations/shopware).

### Option 2: Via Composer

[](#option-2-via-composer)

```
composer require gokarla/shopware
bin/console plugin:refresh
bin/console plugin:install --activate KarlaDelivery
bin/console cache:clear
```

### Option 3: Manual Installation via Console

[](#option-3-manual-installation-via-console)

1. Download and extract `KarlaDelivery.zip` to `/custom/plugins/`
2. Run the following commands:

```
bin/console plugin:refresh
bin/console plugin:install --activate KarlaDelivery
bin/console cache:clear
```

Configuration
-------------

[](#configuration)

After installation, configure the extension:

1. Go to **Extensions** → **My Extensions** → **Karla Delivery** → **Configure**
2. Enter your **Shop Slug** and **API Key** from your GoKarla account
3. Configure which order and delivery statuses should trigger synchronization
4. (Optional) Set up sales channel mapping for multi-shop setups
5. Save the configuration

**Recommended Settings:**

- Order Statuses: Enable "In Progress" and "Completed"
- Delivery Statuses: Enable "Shipped" and "Shipped Partially"

Support
-------

[](#support)

- **Documentation**: [docs.gokarla.io](https://docs.gokarla.io/docs/shop-integrations/shopware)
- **Issues**: [GitHub Issues](https://github.com/gokarla/shopware/issues)
- **Contact**: For additional support, contact your GoKarla account manager

Contributing
------------

[](#contributing)

We welcome contributions! This is an open-source project under the Apache-2.0 License.

**Quality Standards:**

- All code must pass `make check-all` (linting, static analysis, and tests)
- Follow PSR-12 coding standards
- Add tests for new features
- Update documentation as needed

### Development Setup

[](#development-setup)

Install dependencies:

```
composer install
```

### Code Quality

[](#code-quality)

This project follows PSR-12 coding standards and uses modern PHP tooling for quality assurance.

**Available Commands:**

```
# Check code style with PHP-CS-Fixer
make lint

# Auto-fix code style issues
make format

# Run static analysis with PHPStan
make analyse

# Run tests with PHPUnit
make test

# Generate code coverage report
make coverage

# Run all quality checks
make check-all
```

**Tooling:**

- **PHP-CS-Fixer** - Fast, modern code formatter
- **PHPStan** - Static analysis to catch bugs before runtime
- **PHPUnit** - Comprehensive test suite
- **EditorConfig** - Consistent formatting across editors

### Code Coverage

[](#code-coverage)

To generate code coverage reports locally, you need Xdebug installed:

**macOS (Homebrew):**

```
# Install with sudo (Homebrew Cellar requires elevated permissions)
sudo pecl install xdebug
```

Verify installation:

```
php -m | grep xdebug
```

Alternative if PECL fails - compile from source:

```
# Download and compile xdebug
git clone https://github.com/xdebug/xdebug.git
cd xdebug
phpize
./configure
make
sudo make install

# Enable in php.ini
echo "zend_extension=xdebug.so" | sudo tee -a $(php --ini | grep "Loaded Configuration" | sed -e "s|.*:\s*||")
```

**Linux (Ubuntu/Debian):**

```
sudo apt install php8.3-xdebug
```

**Docker/Dockware:**

```
# Xdebug is pre-installed in Dockware containers
```

After installing Xdebug, run:

```
make coverage
# Open coverage/html/index.html in your browser
```

Coverage reports are automatically generated in CI and uploaded to [Codecov](https://codecov.io/gh/gokarla/shopware).

### Local Development with Dockware

[](#local-development-with-dockware)

Start a local Shopware instance:

```
make dockware-start
make dockware-attach
```

Access the development shop:

- **Admin Panel**:  (credentials: `admin` / `shopware`)
- **Storefront**:
- **Logs**:

For detailed development guidelines, see [CLAUDE.md](CLAUDE.md).

Versioning
----------

[](#versioning)

We use [SemVer](http://semver.org/) for versioning. For the versions available, see the tags on this repository.

License
-------

[](#license)

This project is licensed under the Apache-2.0 License - see the [LICENSE](LICENSE) file for details.

###  Health Score

42

—

FairBetter than 88% of packages

Maintenance81

Actively maintained with recent releases

Popularity19

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~107 days

Recently: every ~70 days

Total

8

Last Release

101d ago

Major Versions

0.5.0 → v1.0.02025-10-14

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1042520?v=4)[Darío Blanco Iturriaga](/maintainers/darioblanco)[@darioblanco](https://github.com/darioblanco)

---

Top Contributors

[![darioblanco](https://avatars.githubusercontent.com/u/1042520?v=4)](https://github.com/darioblanco "darioblanco (56 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/gokarla-shopware/health.svg)

```
[![Health](https://phpackages.com/badges/gokarla-shopware/health.svg)](https://phpackages.com/packages/gokarla-shopware)
```

###  Alternatives

[shopware/production

177209.0k](/packages/shopware-production)[kiener/mollie-payments-plugin

Mollie Payments

6565.2k](/packages/kiener-mollie-payments-plugin)[werkstattl/openblogware

OpenBlogware: A Blog Module for Shopware 6.

438.0k](/packages/werkstattl-openblogware)[unzerdev/shopware6

Unzer payment integration for Shopware 6

1233.3k](/packages/unzerdev-shopware6)[frosh/tools

Provides some basic things for managing the Shopware Installation

87820.7k3](/packages/frosh-tools)[adyen/adyen-shopware6

Official Shopware 6 Plugin to connect to Payment Service Provider Adyen

25117.9k](/packages/adyen-adyen-shopware6)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)