PHPackages                             wako/plugin-admin-toolbar - 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. [Admin Panels](/categories/admin)
4. /
5. wako/plugin-admin-toolbar

ActiveShopware-platform-plugin[Admin Panels](/categories/admin)

wako/plugin-admin-toolbar
=========================

Admin Toolbar for Shopware Storefront

1.5.2(1mo ago)621MITPHP

Since Apr 13Pushed 1mo agoCompare

[ Source](https://github.com/WariKoda/WakoPluginAdminToolbar)[ Packagist](https://packagist.org/packages/wako/plugin-admin-toolbar)[ RSS](/packages/wako-plugin-admin-toolbar/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (6)Dependencies (2)Versions (10)Used By (0)

WakoPluginAdminToolbar
======================

[](#wakopluginadmintoolbar)

Shopware 6 storefront plugin that shows a fixed administration toolbar at the top of the storefront for eligible administration users, including quick links into the Shopware Administration, context-aware edit buttons for products, categories, variants, CMS pages and shopping experiences, customer context insights, rule visibility, copy-to-clipboard helpers, and cache clearing.

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

[](#installation)

From the Shopware root:

```
composer req wako/plugin-admin-toolbar
```

Or download and deploy contents of zip into custom/plugins

Then

```
bin/console plugin:install --activate WakoPluginAdminToolbar
```

Screenshots
-----------

[](#screenshots)

### Screenshot 1

[](#screenshot-1)

[![WakoPluginAdminToolbar Screenshot 1](./docs/images/wakoAdminToolbar_001.png)](./docs/images/wakoAdminToolbar_001.png)

### Screenshot 2 — Context button for products, variants, and shopping experiences

[](#screenshot-2--context-button-for-products-variants-and-shopping-experiences)

[![WakoPluginAdminToolbar Screenshot 2](./docs/images/wakoAdminToolbar_002.png)](./docs/images/wakoAdminToolbar_002.png)

### Screenshot 3 — Customer context

[](#screenshot-3--customer-context)

[![WakoPluginAdminToolbar Screenshot 3](./docs/images/wakoAdminToolbar_003.png)](./docs/images/wakoAdminToolbar_003.png)

What it does
------------

[](#what-it-does)

The toolbar can provide:

- quick links into Shopware Administration
- context-aware edit links for product/category/CMS/landing page related storefront pages
- variant lookup for variant products
- customer context info for the current sales channel session
- active rule visibility
- copy-to-clipboard helpers
- cache clear action
- global feature switches for product links, category links, and CMS/layout links
- per-user feature preferences for product links, category links, CMS/layout links, and customer context

Security &amp; Permission Model
-------------------------------

[](#security--permission-model)

This plugin must adhere to the Shopware Administration **roles, permissions, and privileges** system.

### Mandatory principles

[](#mandatory-principles)

- All privileged actions are enforced **server-side**
- UI visibility is only convenience, not authorization
- The user custom field `wako_admin_toolbar_enabled` is only an opt-in toggle
- Per-user feature preferences and global plugin switches are additional gates, not authorization by themselves
- Toolbar access also requires Shopware ACL privileges
- New privileged features must integrate with ACL end-to-end

### Base access requirement

[](#base-access-requirement)

The toolbar is only available when all of the following are true:

- a valid Shopware admin session exists
- the user enabled the toolbar via `wako_admin_toolbar_enabled`
- the user has the plugin privilege `wako_admin_toolbar:use`

The plugin registers the role permission:

- `wako_admin_toolbar.viewer` → `wako_admin_toolbar:use`

Feature to privilege mapping
----------------------------

[](#feature-to-privilege-mapping)

FeatureRequired privilege(s)Additional gatesUse toolbar at all`wako_admin_toolbar:use`Per-user toolbar opt-inClear cache`system:clear:cache`—Load variants`product:read`Product links enabled globally and for the userEdit product`product:update`Product links enabled globally and for the userEdit category`category:update`Category links enabled globally and for the userEdit CMS page / layout / shopping experience / page`cms_page:update`CMS/layout links enabled globally and for the userEdit landing page`cms_page:update` + `landing_page:update`CMS/layout links enabled globally and for the userView customer context`customer:read`Customer context enabled for the user and at least one customer context data field enabled globallyView active rules / rule links`rule:read`Customer context enabled for the user and active rules enabled globallyDevelopment rule for future changes
-----------------------------------

[](#development-rule-for-future-changes)

Whenever you add a new action, endpoint, or toolbar button:

1. define the needed Shopware/core or plugin privilege
2. enforce it in backend PHP code
3. expose only minimal capability flags if the storefront/admin UI needs them
4. hide or disable the related UI accordingly
5. register admin privilege labels/snippets for plugin-specific permissions

Current user administration module
----------------------------------

[](#current-user-administration-module)

The plugin provides a dedicated administration settings module for the currently logged-in user.

Location:

- **Administration → Settings → Plugins → Admin Toolbar**

Current scope:

- enable or disable the storefront admin toolbar for the own account
- configure personal visibility preferences for product links, category links, CMS/layout links, and customer context
- show disabled feature toggles when the user lacks the required ACL permission or a feature is disabled globally

The module itself is available with:

- `user.update_profile`

Changing toolbar activation and feature preferences requires:

- `user_change_me`
- `wako_admin_toolbar:use`
- the corresponding feature ACL permission when enabling a feature

Notes:

- the toolbar activation setting is no longer edited in the Shopware profile page
- personal feature preferences are stored on the current user and are enforced server-side when toolbar capabilities are built

Plugin configuration
--------------------

[](#plugin-configuration)

The plugin configuration contains:

- `adminBasePath` for the Administration base path
- global toolbar feature switches for product links, category links, and CMS/layout links
- customer context data controls for email, customer number, and active rules

The customer context dropdown only renders sections whose data fields are enabled in the plugin configuration.

Relevant files
--------------

[](#relevant-files)

- `src/WakoPluginAdminToolbar.php`
- `src/Controller/AdminToolbarAuthController.php`
- `src/Controller/AdminToolbarProfileController.php`
- `src/Resources/views/storefront/component/admin-toolbar.html.twig`
- `src/Resources/app/storefront/src/js/admin-toolbar/admin-toolbar.plugin.js`
- `src/Resources/app/administration/src/acl/index.js`
- `src/Resources/app/administration/src/module/wako-admin-toolbar-settings/`
- `src/Resources/app/administration/src/snippet/en-GB.json`
- `src/Resources/app/administration/src/snippet/de-DE.json`

###  Health Score

40

—

FairBetter than 86% of packages

Maintenance92

Actively maintained with recent releases

Popularity13

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity40

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

Recently: every ~15 days

Total

8

Last Release

37d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/3cc4c4390c718a4e1ca76675f634a61cc960a036cdb276374495c95c64d59a38?d=identicon)[nibra180](/maintainers/nibra180)

---

Top Contributors

[![nibra180](https://avatars.githubusercontent.com/u/64105088?v=4)](https://github.com/nibra180 "nibra180 (46 commits)")

---

Tags

shopware-pluginshopware6shopware6-pluginsymfony

### Embed Badge

![Health badge](/badges/wako-plugin-admin-toolbar/health.svg)

```
[![Health](https://phpackages.com/badges/wako-plugin-admin-toolbar/health.svg)](https://phpackages.com/packages/wako-plugin-admin-toolbar)
```

###  Alternatives

[shopware/administration

Administration frontend for the Shopware Core

414.3M119](/packages/shopware-administration)[shopware/storefront

Storefront for Shopware

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

177209.0k](/packages/shopware-production)[frosh/tools

Provides some basic things for managing the Shopware Installation

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

Elasticsearch for Shopware

153.9M19](/packages/shopware-elasticsearch)[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)
