Zum Hauptinhalt springen

FAQ & Troubleshooting

Schnelle Antworten auf die häufigsten Fragen.

Installation & Setup​

Benötigt Vertex einen Shopify-Plus- oder Advanced-Plan?​

Nein. Vertex installiert sich auf jedem Shopify-Plan. Die nativen B2B-Funktionen (Companies, B2B-Catalogs, NET-Zahlungsziele, Steuerbefreiung, Multi-Location) erfordern jedoch Shopify Plus oder Advanced mit dem B2B-Add-on. Ohne diese läuft Vertex weiterhin als ausgefeiltes B2C-Industriebedarf-Theme — jede B2B-Funktion degradiert elegant.

Benötige ich Companion-Apps?​

Nein. Vertex nutzt Shopifys native B2B-Funktionen durchgängig. Keine Quote-Management-App, keine Wholesale-Pricing-App, keine Multi-Currency-App, keine Compare-App.

Wie lange dauert die vollständige Installation?​

  • Basis-Installation (nur Theme): 5 Minuten
  • Vollständige B2B-Installation (Theme + Native B2B + Companies + Catalogs + Metafields): 45–60 Minuten beim ersten Mal. Nachfolgende Unternehmen benötigen jeweils 5 Minuten.

Kann ich Vertex zuerst auf einem Development Store testen?​

Ja. Installieren Sie Vertex auf einem beliebigen Dev-Store und passen Sie es an, ohne Ihre Live-Storefront zu beeinflussen. Veröffentlichen Sie erst, wenn Sie bereit sind.

B2B-Chrome-Sichtbarkeit​

Warum erscheint die bernsteinfarbene B2B-Begrüßungsleiste nicht?​

In der Reihenfolge der Wahrscheinlichkeit:

  1. Sie sind nicht als B2B-Kunde angemeldet. Die Leiste wird nur gerendert, wenn customer.b2b? true ist UND customer.current_company gesetzt ist.
  2. Der Storefront-Modus ist auf B2C-only gesetzt. Öffnen Sie Theme settings ▸ B2B ▸ Storefront mode und wechseln Sie zu Hybrid (auto) oder B2B-only.
  3. Native B2B ist im Shopify-Admin nicht aktiviert. Gehen Sie zu Settings ▸ Customer accounts ▸ B2B ▸ Manage ▸ Enable B2B.
  4. Das Unternehmen des Käufers wurde gelöscht oder widerrufen. Vertex überspringt die Leiste defensiv, wenn customer.current_company mitten in der Sitzung nil ist.

Warum erscheint die Vertriebs-Pill nicht im Header?​

Die Vertriebs-Pill wird nur gerendert, wenn alle drei Bedingungen erfüllt sind:

  1. Der Käufer ist als B2B angemeldet (customer.b2b? == true)
  2. Das Unternehmen des Käufers hat ein vertex.rep_name-Metafield gesetzt
  3. Der Storefront-Modus ist nicht B2C-only

Überprüfen Sie unter Customers ▸ Companies ▸ [Firmenname] ▸ Metafields, dass vertex.rep_name befüllt ist.

Warum werden Staffelpreis-Stufen nicht auf der PDP angezeigt?​

Vertex liest Staffelpreise aus Shopifys nativem quantity_price_breaks. Die PDP-Volume-Tabelle wird nur gerendert, wenn:

  1. Der Käufer ist bei einem Unternehmen angemeldet
  2. Das Unternehmen ist einem B2B-Katalog zugewiesen
  3. Die Preisliste des Katalogs enthält das Produkt mit mengenbasierten Preisstufen

Wenn die Tabelle leer ist, überprüfen Sie die Preisliste unter B2B ▸ Catalogs ▸ [Katalogname] ▸ Price list.

Warum sieht mein B2B-Käufer "Zum Anzeigen der Preise anmelden", obwohl er angemeldet ist?​

Der Toggle Theme settings ▸ B2B ▸ Hide prices until customer logs in ist aktiv. Diese Funktion verbirgt Preise nur für Gäste. Eingeloggte Kunden (B2C ODER B2B) sollten immer Preise sehen. Falls nicht, deaktivieren Sie die Einstellung und speichern Sie.

Warum fühlt sich die Storefront "B2C" an, obwohl ich als B2B angemeldet bin?​

Entweder:

  1. Der Storefront-Modus ist auf B2C-only gesetzt. Ändern Sie ihn auf Hybrid oder B2B-only.
  2. Der Kundendatensatz ist nicht mit einem Unternehmen verknüpft. Öffnen Sie Customers ▸ [Kundenname] und bestätigen Sie, dass er unter dem Companies-Tab einem Unternehmen zugeordnet ist.

Anpassung​

Wie ändere ich die Markenfarbe?​

  1. Öffnen Sie Theme settings ▸ Colors
  2. Wählen Sie eine Starter-Farbpalette für die Ein-Klick-Neufärbung ODER wählen Sie Custom und überschreiben Sie jede Farbe einzeln

Wie füge ich eine eigene Schrift hinzu?​

Die Font-Picker unter Theme settings ▸ Typography verwenden Shopifys Font-Library. Um eine Schrift außerhalb davon zu verwenden, fügen Sie einen <link> in theme.liquid hinzu und aktualisieren Sie die CSS-Custom-Properties --font-body / --font-heading.

Wie füge ich mein Logo hinzu?​

  1. Öffnen Sie den Theme-Editor und klicken Sie im Sections-Panel auf Header
  2. Klicken Sie auf Logo image und laden Sie Ihre Datei hoch
  3. Empfohlene Höhe: ~40 px; SVG bevorzugt

Wie passe ich den Text der Announcement Bar an?​

  1. Öffnen Sie Header group ▸ Announcement bar im Theme-Editor
  2. Bearbeiten Sie das Feld Text
  3. Die Leiste hat ein integriertes schließbares ×, das localStorage respektiert

Wie füge ich die Sekundär-Navigation (Spezialangebote / Anleitungen / Services / FAQ) hinzu oder bearbeite sie?​

  1. Gehen Sie zu Online Store ▸ Navigation
  2. Erstellen Sie ein neues Menü mit dem Handle secondary-menu (von Vertex automatisch erkannt)
  3. Fügen Sie Links hinzu — sie erscheinen rechtsbündig im Desktop-Header

Wie wechsle ich zwischen den 4 Demo-Storefronts (Vertex / Throttle / OfficeIT / Inkline)?​

Zwei Wege:

  1. Dauerhafte Neufärbung — Theme settings ▸ Colors ▸ Starter color palette — wählen Sie eines der 4 Presets
  2. Temporäre Vorschau — hängen Sie ?view=throttle (oder officeit / printsupply) an eine beliebige URL Ihrer Storefront an

→ Siehe Demo-Presets-Guide für Details.

Performance​

Wie hoch ist der Lighthouse-Score einer Vertex-Storefront?​

Aufgezeichnet auf der Showcase-Demo:

  • Mobile Performance: 65–100 (je nach Seitentyp)
  • Desktop Performance: 90+ auf jeder Seite
  • Accessibility: 92–95
  • Best Practices: 95+
  • SEO: 100

Wie verbessere ich die Lighthouse-Performance weiter?​

  1. Optimieren Sie Hero-Bilder. Verwenden Sie WebP in mehreren Breiten; zielen Sie auf unter 300 KB pro Slide.
  2. Begrenzen Sie den Hero auf 1 Slide. Multi-Slide-Hero-Rotatoren kosten LCP. Der Standard wird mit 1 Slide ausgeliefert.
  3. Begrenzen Sie Shopify-App-Embeds. Jede Drittanbieter-App injiziert JS — jede einzelne erhöht den TBT.

Warum ist meine Mobile-Performance niedriger als meine Desktop-Performance?​

Standard für Shopify-Themes — Mobile wird in Lighthouse gedrosselt (langsamere CPU + langsameres Netzwerk). Echte iPhone-14-/Galaxy-S22-Nutzer erhalten viel bessere Scores als die Lighthouse-Zahl.

Barrierefreiheit & Internationalisierung​

Ist Vertex WCAG 2.1 AA konform?​

Ja. Tastaturnavigation, sichtbarer Fokus, 4,5:1 Mindestkontrast, 24-px-Touch-Targets auf Mobilgeräten, korrekte ARIA-Rollen, Skip-to-Content-Link, beschriftete Formular-Inputs.

Mit welchen Sprachen wird Vertex ausgeliefert?​

5: Englisch (Standard), Französisch, Italienisch, Deutsch, Spanisch. UI-Strings + Schema-Labels sind beide übersetzt.

Unterstützt Vertex RTL-Sprachen?​

Ja — vollständig. <html dir> wechselt automatisch für Arabisch, Hebräisch, Farsi, Urdu, Jiddisch, Kurdisch, Dhivehi und Paschto. CSS verwendet logische Properties, sodass das Layout sauber gespiegelt wird.

Kann ich eine weitere Sprache hinzufügen?​

Ja. Übersetzen Sie locales/en.default.json in Ihre Zielsprache, speichern Sie als locales/{code}.json. Die Schema-Labels liegen in locales/en.default.schema.json — übersetzen Sie in locales/{code}.schema.json, um auch die Editor-UI zu lokalisieren.

Metafields & Produktdaten​

Welche Metafields verwendet Vertex?​

Im vertex-Namespace:

  • vertex.mpn (Produkt) — Manufacturer Part Number, in der Predictive-Search indiziert
  • vertex.ships_from (Produkt) — Pro-Produkt-Versand-aus-Stadt
  • vertex.price_history (Produkt) — JSON-Liste von {date, price}-Einträgen
  • vertex.datasheet, vertex.msds, vertex.brochure, vertex.tech_sheet, vertex.install_guide, vertex.warranty (Produkt) — File-Picker für PDFs
  • vertex.rep_name, vertex.rep_email, vertex.rep_phone (Company) — Pro-Unternehmen-Vertriebsmitarbeiter
  • vertex.payment_terms (Company) — Override des NET-Terms-Badge-Labels

Plus vertex.tech_specs (Produkt) — eine Liste von „spec"-Einträgen (jeweils label, value und optionale unit) für die Tech-Spec-Tabelle. Kein Metaobjekt erforderlich.

→ Vollständige Referenz: Metafield-Setup-Guide.

Was passiert, wenn ein Metafield fehlt?​

Der entsprechende PDP-Block wird automatisch ausgeblendet. Vertex geht defensiv mit fehlenden Metafields um — leere Werte rendern niemals eine defekte UI.

Preise & Lizenzierung​

Was kostet Vertex?​

399 USD Single-Store-Lizenz. Inklusive kostenloser Updates für alle v1.x-Releases.

Kann ich eine Vertex-Lizenz auf mehreren Shops verwenden?​

Nein — die Standard-Theme-Store-Lizenz ist Single-Store. Für Multi-Store-Lizenzierung öffnen Sie ein Ticket über das Theme-Store-Support-Portal.

Erhält Vertex Updates?​

Ja. v1.x-Releases enthalten Bugfixes, Performance-Verbesserungen und neue Sections. Siehe Changelog.

Häufige Fehler & Behebungen​

"Theme Check zeigt 18 Warnungen in meiner angepassten Version"​

Sie haben wahrscheinlich Liquid-Templates bearbeitet und ungenutzte Variablen oder hartkodierte Routen eingeführt. Führen Sie shopify theme check lokal aus, um Details zu sehen. Vertex selbst wird mit 0 Theme-Check-Verstößen ausgeliefert.

"Mein eigenes CSS wird überschrieben"​

Vertex' Per-Section-CSS-Dateien haben höhere Spezifität als ein generisches Stylesheet. Fügen Sie Overrides hinzu via:

  1. Theme settings ▸ Colors ▸ Custom (bevorzugt — die meisten Dinge sind CSS-Variable-gesteuert)
  2. Eigenes CSS in assets/vertex.css nach den bestehenden Regeln
  3. Ein neues assets/custom-overrides.css mit !important (letzte Option)

Weitere Hilfe?​