English Version

Zurück zur Übersicht

Sylius SEO Suite Pro: Konfiguration

Die Einstellungen des Plugins liegen an zwei Stellen: pro Channel im Admin-Bereich (in der Datenbank) und global in einer YAML-Datei. Auf dieser Seite findest Du beides, soweit es keiner eigenen Funktionsseite gehört.

Admin-Bereich

Das Plugin legt genau einen Eintrag in der Seitenleiste an: MMKreativ Plugins > SEO Suite Pro. Er führt zur Liste der Channel-Einstellungen. Alle anderen Bildschirme erreichst Du über Buttons in der Aktionsleiste oben auf den jeweiligen Seiten:

• Auf der Liste der Channel-Einstellungen führen die Buttons SEO-Templates, Weiterleitungen, hreflang, Strukturierte Daten, SEO-Audit und OG-Bilder zu den jeweiligen Bildschirmen.
• Auf der Redirect-Liste führen die Buttons 404-Log, Import und Export weiter. Das 404-Log führt über Weiterleitungen zurück.
• Die übrigen Bildschirme haben einen Button zurück zu den Channel-Einstellungen beziehungsweise (beim Audit) zum SEO-Audit.

Unter dem Seitentitel der Plugin-Listen steht die installierte Plugin-Version.

Sind die Admin-Routen nicht importiert, fehlt der Menüeintrag stillschweigend. Prüfe dann die Routen-Datei aus der Installation.

Alles wird pro Channel konfiguriert. Channel-Einstellungen, SEO-Templates, Schema-, hreflang- und OG-Bild-Einstellungen sowie Redirects gehören jeweils zu einem Channel (bei Templates und Redirects ist auch "alle Channels" möglich). Hat ein Channel keine Zeile, gelten die Standardwerte.

Channel-Einstellungen

Pro Channel gibt es höchstens eine Zeile. Beim Anlegen wählst Du den Channel aus, danach lässt er sich nicht mehr ändern.

robots.txt

Die Route /robots.txt löst den Channel über den Host auf und liefert den Inhalt aus den Channel-Einstellungen als text/plain.

• Ist das Feld leer, hat der Channel keine Zeile oder lässt sich der Host keinem Channel zuordnen, antwortet das Plugin mit User-agent: * und Allow: /. Es gibt also nie ein 404 und nie eine leere Antwort. Der sichere Standard ist "alles erlauben", nicht "alles sperren".
• Ohne gestartete Session ist die Antwort öffentlich cachebar (eine Stunde). Eine Änderung kann dadurch bei einem vorgeschalteten Cache bis zu einer Stunde dauern.
• Das Plugin ergänzt nichts automatisch, auch keine Sitemap:-Zeile. Die produktive robots.txt schreibst Du selbst.

Das Plugin rät nie, was gesperrt werden soll. Prüfe vor dem Go-Live, dass im Feld der echte Inhalt steht, denn leer heißt: alles darf gecrawlt werden.

Facets

Ein Listing zählt als Facet, wenn die URL einen der konfigurierten Query-Parameter (facet_parameters) mit nicht-leerem Wert enthält, standardmäßig criteria, sorting und limit. Die Seitennummer (?page=2) ist bewusst kein Facet: Seite 2 ist echter Inhalt und bleibt index, follow.

Eine Facet-Seite bekommt statt der normalen Robots-Angabe die Channel-Vorgabe, ab Werk noindex, follow: Suchmaschinen überspringen die Variante, folgen aber ihren Links. Ist die Kategorie selbst auf noindex oder nofollow gestellt, bleibt das so, die strengere Angabe gewinnt. Der Canonical bleibt die URL ohne Filter, Sortierung und Tracking-Parameter (nur die Seitennummer bleibt erhalten). Das Plugin erkennt Facets bei Kategorie-Listings allein am Query-String. Eine Filternavigation, die auf einem eigenen URL-Pfad liegt, erkennt es nicht.

Globale Konfiguration

Alle Schlüssel sind optional und liegen unter dem Root mmd_sylius_seo_suite_pro in config/packages/mmd_sylius_seo_suite_pro.yaml. Die folgenden drei gehören keiner eigenen Funktionsseite:

Die übrigen Bereiche sind auf ihren Funktionsseiten beschrieben. Hier die Übersicht aller Schlüssel:

Ein Beispiel mit realistischen Werten für einen Shop mit eigenem CDN und Facet-Parametern:

# config/packages/mmd_sylius_seo_suite_pro.yaml
mmd_sylius_seo_suite_pro:
    facet_parameters: [criteria, sorting, limit, color, size]
    image_base_path: /media/image/
    brand_attribute_code: manufacturer
    seo_templates:
        title_max_length: 60
        description_max_length: 155
    hreflang:
        format: language-region
        min_alternates: 2
    redirects:
        auto_on_slug_change: true
        log_not_found: true
        not_found_log_limit: 10000
    audit:
        keep_runs: 3
        max_subjects: 20000
    og_image:
        format: auto
        quality: 85
        remote_hosts: ['cdn.example.com']

Die Werte des Beispiels sind frei gewählt. Übernimm nur die Schlüssel, die Du wirklich ändern willst, denn die Standardwerte passen für die meisten Shops.

Felder pro Produkt und Kategorie

Hast Du die Felder in der Installation freigeschaltet, erscheinen sie im Admin-Bereich beim Bearbeiten eines Produkts oder einer Kategorie im Tab für die Übersetzungen, je Sprache:

Bei Produkten verwendest Du die Meta-Description von Sylius selbst.

Admin-Grids

Das Plugin bringt acht Listen (Grids) mit. Alle sind per Buttons verbunden, nur die erste hat einen Seitenleisten-Eintrag.

Das Redirect-Grid filtert nach Suchbegriff, Channel (auch "alle Channels"), Herkunft und Aktiv-Status. Das 404-Log filtert nach Suchbegriff und Channel, die Audit-Befunde nach Subjekt-Code, Channel, Check, Schweregrad und Subjekt-Typ.

Was im Head ausgegeben wird

Das Plugin hängt sich über Twig Hooks in den Head der Storefront ein, ohne ein Template zu überschreiben. Es greift auf Produktseiten, Kategorie-Listings und der Startseite. Warenkorb, Checkout und Kundenkonto bleiben unberührt.

• <meta name="description">, <link rel="canonical"> und <meta name="robots">
• <link rel="alternate" hreflang> für die hreflang-Alternates, siehe hreflang
• Open-Graph-Tags (og:type, og:title, og:description, og:url, og:site_name, og:locale, og:image samt Typ, Breite, Höhe und Alt-Text, soweit vorhanden)
• Twitter-Card-Tags (twitter:card, twitter:title, twitter:description, twitter:image, twitter:site, twitter:creator)
• Pro Schema-Knoten ein <script type="application/ld+json">, siehe Strukturierte Daten
• Der <title>: Das Basis-Layout von Sylius rendert ihn über einen Twig-Block, den ein Hook nicht ändern kann. Ein Response-Listener ersetzt deshalb das eine <title>-Element im fertigen HTML.

Die Startseite bekommt denselben Satz Tags, aufgebaut aus dem Channel, behält aber den <title> von Sylius (den Channel-Namen). Die Twitter-Card ist summary_large_image, sobald ein Bild vorhanden ist. Ist der Social-Tags-Schalter des Channels aus, entfallen die Open-Graph- und Twitter-Tags, alles andere bleibt.

Praxisbeispiele

robots.txt für einen Shop

Im Feld Inhalt der robots.txt des Channels trägst Du die gewünschten Regeln ein. Da die Shop-URLs von Sylius ein Sprach-Präfix haben, sperrst Du Warenkorb, Checkout und Konto mit Wildcards:

User-agent: *
Disallow: /*/cart/
Disallow: /*/checkout/
Disallow: /*/account/
Sitemap: https://www.example.com/sitemap-index.xml

Die Pfade sind ein Beispiel. Prüfe sie gegen die echten Routen Deines Shops, denn das Plugin kennt Deine URL-Struktur nicht.

Staging-Channel komplett sperren

Hat Dein Staging einen eigenen Channel, sperrst Du ihn mit diesem Inhalt für alle Crawler:

User-agent: *
Disallow: /

Die robots.txt ist eine Bitte an Crawler und kein Zugriffsschutz. Sichere Staging zusätzlich per Passwortschutz ab. Außerdem setzt diese Regel keine noindex-Tags, sie verbietet nur das Crawlen.

Facet-Richtlinie anpassen

Ein Shop mit den Filtern Farbe und Größe will, dass auch diese Varianten als Facet erkannt werden und noindex, follow bekommen. Dafür ergänzt Du in der globalen Konfiguration die Parameter:

mmd_sylius_seo_suite_pro:
    facet_parameters: [criteria, sorting, limit, color, size]

Die Channel-Einstellung Facetten-/Filterseiten sind indexierbar lässt Du aus. Wenn Du bewusst eine Filterkombination indexieren willst (zum Beispiel eine Landingpage für "blaue Sofas"), baust Du dafür besser eine eigene Kategorie, statt Facets freizugeben: Eine Kategorie hat eine eigene URL, einen eigenen Titel und einen eigenen Canonical.

Die Einstellung für Facets gilt für alle gefilterten Listings eines Channels gemeinsam. Es gibt keine Ausnahme pro Filterkombination.