Download the PHP package gokarla/shopware without Composer

On this page you can find all versions of the php package gokarla/shopware. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of gokarla/shopware

Informations about the package shopware

Karla Shopware Extension

ci License: Apache-2.0 PHP Version Shopware Packagist

Enhance your post-purchase customer experience in Shopware with GoKarla - automated order tracking and delivery updates for your customers.

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

Core Capabilities

Flexible Configuration

Signed Tracking Links in Shopware Emails

After a successful order sync, the extension stores an authenticated Karla tracking link in the order custom field karla_trackpage_url. A native Shopware mail template can use it without letting Karla send the email:

Keep the existing postcode-authenticated tracking link as a fallback for historical orders that do not yet have the custom field. Treat the signed URL as a customer credential: do not expose it in logs or admin exports.

Requirements

Installation

Option 1: Via Shopware Admin Panel (Recommended)

  1. Download the latest KarlaDelivery.zip from GitHub 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.

Option 2: Via Composer

Option 3: Manual Installation via Console

  1. Download and extract KarlaDelivery.zip to <shopware-root>/custom/plugins/
  2. Run the following commands:

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:

Support

Contributing

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

Quality Standards:

Development Setup

Install dependencies:

Code Quality

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

Available Commands:

Tooling:

Code Coverage

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

macOS (Homebrew):

Verify installation:

Alternative if PECL fails - compile from source:

Linux (Ubuntu/Debian):

Docker/Dockware:

After installing Xdebug, run:

Coverage reports are automatically generated in CI and uploaded to Codecov.

Local Development with Dockware

Start a local Shopware instance:

Access the development shop:

For detailed development guidelines, see CLAUDE.md.

Historical ERP migrations

In Extensions → My extensions → Karla Delivery → Configuration, select the intended sales channel. Under Historical migration protection:

  1. Set Original order date cutoff to the first order timestamp that should remain active. The comparison is strictly before the cutoff; orders exactly at the cutoff are included in normal processing. The datetime control uses the administrator's timezone and stores an ISO timestamp with timezone.
  2. Turn on Enable migration protection and save before starting the ERP export. Repeat for each affected sales channel, or configure All sales channels deliberately. Shopware's usual channel overrides and inheritance apply.
  3. Test one historical delivery update and one current order. Historical order and delivery writes must produce no Karla order request or trackpage write; current orders retain their existing behavior. Authenticated shipment webhooks for excluded orders return HTTP 200 with reason: migration_protection and do not trigger Shopware Flow Builder. Claim events remain unchanged.
  4. Keep protection enabled until all migration writes, importer retries and in-flight shipment events have finished. Disable it only when historical orders will no longer be updated or emit events. Disabling does not replay skipped records, but future writes/events will process normally again.

The cutoff uses the stored order's original orderDateTime, not the delivery's last-modified timestamp. No shop or cutoff is built in; protection is off by default. An enabled setting with a missing/invalid cutoff blocks all order sync and shipment flows in that channel and logs an error. Enter a valid cutoff to restore current-order processing. API-configured cutoffs must be ISO timestamps with an explicit timezone (for example 2026-01-01T00:00:00Z).

This plugin guard does not cancel emails or delayed Flow Builder actions already queued before activation, stop other email integrations, or unregister tracking already sent to Karla. Check those separately if an import has already started. The existing Historical delivery cutoff remains independent and unchanged. No Karla backend update is required for this plugin guard.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

License

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

Independent brands on one Shopware installation

Use a separate sales channel and Karla shop for each brand. Set the shop slug and API credentials in that sales channel's plugin configuration. Existing salesChannelMapping entries take precedence over the configured shop slug.

Enable webhooks separately in each channel. Channel subscriptions use /api/karla/webhooks/{salesChannelId}/{webhookId} and a dedicated signing secret; a channel callback only dispatches events for orders belonging to that channel. The existing global callback continues to support single-shop installations. Inherited global subscriptions are never reused or deleted by a channel toggle.

For channel subscriptions created before this update, disable and re-enable webhooks in that channel to register the new callback. Verify the correct Karla shop and credentials before doing so. Changing those credentials or the shop mapping requires recreating the subscription against the intended shop.

Before launching a second brand, test one order and fulfillment per channel. Verify each order reaches its own Karla shop, its tracking link opens the right brand, and its webhook triggers the correct language, sender and email template. Confirm both endpoints return successful responses. A code release alone does not verify a merchant's installed plugin version or webhook health.

All versions of shopware with dependencies

PHP Build Version
Package Version
Requires shopware/core Version *
shopware/administration Version *
shopware/storefront Version *
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package gokarla/shopware contains the following files

Loading the files please wait ...