Troubleshooting — Mobile App-Navigation¶

Bar erscheint nicht im Storefront¶

Lösung:

Plugin korrekt installiert und aktiviert?

bin/console plugin:list | grep MobileAppNav

Theme neu kompiliert?

bin/console theme:compile
bin/console cache:clear

Bist du im richtigen Viewport? Der Standard-Breakpoint ist md (= < 768 px) — auf Desktop ist die Bar bewusst aus
Wenn die Bar in der Theme-Vorschau im Admin-Iframe nicht erscheinen soll: prüfe die alte Config-Option (in v1.0 entfernt — die Bar ist jetzt immer sichtbar)

Bar erscheint auf Desktop sichtbar¶

Lösung: Im Plugin-Konfig Sichtbar bis Breakpoint prüfen — Standard md (< 768 px). Wenn auf lg (< 992 px) gestellt, ist die Bar auch auf Tablets sichtbar.

Header-Icons (Konto/Warenkorb) sind doppelt¶

Lösung: In der Plugin-Konfig unter „Header auf Mobile reduzieren" die entsprechenden Toggles aktivieren. Bei aktivem Such-/Menü-Hide-Toggle empfiehlt sich, dass auch das Pendant in der Bar aktiv ist (sonst ist der Eintrittspunkt komplett weg).

Live-Cart-Badge aktualisiert sich nicht¶

Lösung:

Browser-JS-Konsole prüfen — gibt es Fehler?
Cache leeren: bin/console cache:clear + Hard-Reload im Browser (Ctrl+Shift+R)

Storefront-JS neu kompiliert?

PROJECT_ROOT=/var/www/shop npm run --prefix vendor/shopware/storefront/Resources/app/storefront production

Dynamischer „Kaufen"-Button auf PDP funktioniert nicht¶

Lösung: Der Button erkennt das Standard-Shopware-Buy-Widget anhand der Selektoren .product-detail-buy form[action*="/checkout/line-item/add"], form#productDetailPageBuyProductForm, .buy-widget form[...]. Wenn dein Custom-Theme diese Selektoren nicht verwendet, klappt es nicht. In dem Fall:

Im Plugin-Konfig Dynamischer „In den Warenkorb"-Button auf aus stellen
Die Bar-Cart-Button bleibt dann ein normaler Link zur Cart-Seite

Custom-Theme: Header-Icons werden nicht ausgeblendet¶

Lösung: Das Plugin nutzt die Standard-Storefront-CSS-Selektoren (.header-cart, .account-menu-btn, .search-toggle-btn, .menu-button). Wenn dein Custom-Theme andere Klassen verwendet, brauchst du eine zusätzliche CSS-Regel im Theme:

@media (max-width: 767.98px) {
    body:has(.kma-hide-h-account) {
        .your-custom-account-icon { display: none !important; }
    }
}

Lösung: Das Plugin fügt automatisch ein padding-bottom an body ein, sodass die Bar nichts überdeckt. Wenn du ein eigenes Sticky-Element am Footer hast, kann es sein, dass beide kollidieren. Lösung: Sticky-Footer-Element selbst um den --kma-height (= 60 px + iOS Safe-Area-Inset) nach oben verschieben.

Hilfe finden¶

Wenn die Lösung hier nicht steht: schreib uns eine Mail an support@kommora.de.