PHPackages                             kommandhub/foundation-sw - 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 &amp; Helpers](/categories/utility)
4. /
5. kommandhub/foundation-sw

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

kommandhub/foundation-sw
========================

Kommandhub Foundation plugin for Shopware

1.0.1(1mo ago)060proprietaryPHPCI failing

Since May 17Pushed 1mo agoCompare

[ Source](https://github.com/KommandHub/foundation-sw)[ Packagist](https://packagist.org/packages/kommandhub/foundation-sw)[ RSS](/packages/kommandhub-foundation-sw/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (2)Dependencies (13)Versions (3)Used By (0)

Kommandhub Foundation for Shopware 6
====================================

[](#kommandhub-foundation-for-shopware-6)

[![License: Proprietary](https://camo.githubusercontent.com/41e639cac81d867e862c30b25ebe94d6bb044255bfff41f12a03d0f0f056d9c9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d50726f70726965746172792d7265642e737667)](LICENSE)[![Shopware](https://camo.githubusercontent.com/a8f13c654f88a35e4b0b925e63ceb1e0e9aca826b61273aeddd7e1bc8a531b70/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53686f70776172652d362e36253230253743253230362e372d626c7565)](https://shopware.com)

[![Kommandhub Foundation Logo](src/Resources/config/shopware.png)](src/Resources/config/shopware.png)

A shared **Shopware 6 foundation plugin** that provides reusable installer infrastructure for Kommandhub extensions. It keeps country, state, currency, and language data inside providers and installs them only when explicitly requested by the merchant.

Developed with ❤️ by [Kommandhub Limited](https://kommandhub.com)

---

Table of Contents
=================

[](#table-of-contents)

- [Features](#features)
- [Supported Data](#supported-data)
- [Requirements](#requirements)
- [Installation](#installation)
- [Usage](#usage)
- [Directory Structure](#directory-structure)
- [Development &amp; Testing](#development--testing)
- [Compatibility](#compatibility)
- [Troubleshooting](#troubleshooting)
- [Support](#support)
- [License](#license)

---

Features
========

[](#features)

- Provider-based installation for **countries**, **states**, **currencies**, and **languages**
- **Idempotent** installers that avoid duplicates by natural keys
- Dedicated **Shopware Admin module** under the **Plugins** settings group
- Extensible architecture for adding new providers without changing installer flow
- Admin translations for **en-GB**, **de-DE**, and **fr-FR**

---

Supported Data
==============

[](#supported-data)

The plugin currently focuses on African base data:

- African countries
- Country states/provinces
- Country currencies
- African languages/locales

---

Requirements
============

[](#requirements)

- **Shopware**: `~6.6.0` or `~6.7.0`
- **PHP**: `^8.2` (inside Docker) / `^8.4` (local)
- **Composer**

---

Installation
============

[](#installation)

Via Composer (Recommended)
--------------------------

[](#via-composer-recommended)

```
composer require kommandhub/foundation-sw
bin/console plugin:refresh
bin/console plugin:install --activate KommandhubFoundationSW
bin/console cache:clear
```

Manual Installation (GitHub Upload)
-----------------------------------

[](#manual-installation-github-upload)

1. Download the ZIP from the repository.
2. Ensure the plugin structure is preserved:

    ```
    KommandhubFoundationSW.zip
    ├── src/
    ├── composer.json
    └── README.md

    ```
3. Upload it via:

    **Administration → Extensions → My Extensions → Upload Extension**
4. Install and activate the plugin.

---

Usage
=====

[](#usage)

Open the administration page:

**Administration → Settings → Plugins → Africa Base Data Installer**

Then:

1. Select the countries or languages you want to install.
2. Click **Install**.
3. The plugin inserts the selected base data into the appropriate Shopware tables.

---

Directory Structure
===================

[](#directory-structure)

The plugin uses a feature-based structure:

```
KommandhubFoundationSW/
├── src/
│   ├── Controller/
│   │   └── Api/
│   │       └── Installer/
│   ├── Service/
│   │   └── Installers/
│   │       ├── Address/
│   │       │   └── Country/
│   │       └── Language/
│   └── Resources/
│       ├── config/
│       └── app/administration/
└── tests/
    └── Unit/

```

What each area is for
---------------------

[](#what-each-area-is-for)

- `Controller/`: API endpoints used by the admin UI.
- `Service/Installers/`: provider registries and installer logic.
- `Resources/config/`: service wiring, routes, and plugin configuration.
- `Resources/app/administration/`: admin components, module, and snippets.
- `tests/`: unit tests for installer behavior.

---

Development &amp; Testing
=========================

[](#development--testing)

To keep the environment consistent, run development tools inside the project Docker container.

### 1. Setup Development Environment

[](#1-setup-development-environment)

```
cd custom/plugins/KommandhubFoundationSW
make up
make shell
make prepare
```

### 2. Run Development Commands

[](#2-run-development-commands)

#### Run PHPUnit Tests

[](#run-phpunit-tests)

```
make test
```

#### Run Tests with Coverage

[](#run-tests-with-coverage)

```
make test-coverage
```

#### Static Analysis (PHPStan)

[](#static-analysis-phpstan)

```
make analyse
```

#### Code Style (PHP-CS-Fixer)

[](#code-style-php-cs-fixer)

```
make cs
make cs-fix
```

---

Compatibility
=============

[](#compatibility)

Plugin VersionShopware Version^1.06.6^1.06.7---

Troubleshooting
===============

[](#troubleshooting)

### Installer page not visible?

[](#installer-page-not-visible)

```
bin/console plugin:refresh
bin/console cache:clear
```

### Changes not reflected in Administration?

[](#changes-not-reflected-in-administration)

- Rebuild the administration assets.
- Clear the cache.
- Refresh the browser.

### No data appears after installation?

[](#no-data-appears-after-installation)

- Ensure the selected providers were installed.
- Confirm the provider data exists in the plugin source.
- Check the logs in `var/log/`.

---

Support
=======

[](#support)

For support:

- Email:
- Website:

---

License
=======

[](#license)

This project is licensed under the **Proprietary** license. See the `composer.json` file for details.

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance91

Actively maintained with recent releases

Popularity12

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity35

Early-stage or recently created project

 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 ~16 days

Total

2

Last Release

52d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/0f1debdb2d793fd382ffc606ad8ed6433c9e8b70a9eda51a58227625a2ba412b?d=identicon)[kommandhub](/maintainers/kommandhub)

---

Top Contributors

[![KommandHub](https://avatars.githubusercontent.com/u/225087266?v=4)](https://github.com/KommandHub "KommandHub (15 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/kommandhub-foundation-sw/health.svg)

```
[![Health](https://phpackages.com/badges/kommandhub-foundation-sw/health.svg)](https://phpackages.com/packages/kommandhub-foundation-sw)
```

###  Alternatives

[frosh/tools

Provides some basic things for managing the Shopware Installation

88820.7k3](/packages/frosh-tools)[shopware/storefront

Storefront for Shopware

674.6M247](/packages/shopware-storefront)[shopware/production

177209.0k](/packages/shopware-production)[shopware/conflicts

Shopware 6 conflicting packages

149.5M10](/packages/shopware-conflicts)[shopware/elasticsearch

Elasticsearch for Shopware

153.9M19](/packages/shopware-elasticsearch)[swag/migration-assistant

Migration plugin for shopware/platform

2042.5k](/packages/swag-migration-assistant)

PHPackages © 2026

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