DfRedirects: redirects 301 en registratie van 404-fouten voor Shopware 6

Overzicht

DfRedirects voegt aan Shopware 6 een volwaardige redirectbeheerder toe: regels 301, 302, 307, 308 en 410 met exacte overeenkomst, wildcard of reguliere expressie, automatische registratie van de 404-fouten die uw bezoekers tegenkomen, doelsuggesties op basis van URL-gelijkenis en bulkimport via CSV. De plugin werkt op Shopware 6.5, 6.6 en 6.7 met één en dezelfde ZIP.

Installatie

Vanuit de administration

1. Ga naar Extensies > Mijn extensies.
2. Klik op Extensie uploaden en selecteer het bestand DfRedirects-1.0.0.zip.
3. Klik op Installeren en activeer daarna de extensie.

Vanaf de commandoregel

bin/console plugin:refresh
bin/console plugin:install --activate DfRedirects
bin/build-administration.sh
bin/console cache:clear

De installatie maakt twee eigen tabellen aan: df_redirect (uw redirectregels) en df_redirect_404 (het logboek met niet-gevonden URL’s).

Algemene configuratie

Open Extensies > Mijn extensies > DfRedirects > Configureren. Er zijn drie instellingen beschikbaar:

• 404-logboek activeren: registreert de niet-gevonden URL’s die uw bezoekers tegenkomen. Standaard ingeschakeld.
• Genegeerde patronen: één regel per item. De overeenkomende URL’s worden niet omgeleid en niet gelogd. Jokertekens zijn toegestaan (bijvoorbeeld /api-legacy/*); een eenvoudige tekenreeks volstaat ook, die wordt in de URL gezocht.
• Query string behouden: neemt de URL-parameters (bijvoorbeeld ?utm_source=newsletter) mee naar de doel-URL. Standaard ingeschakeld, zonder effect op 410-antwoorden.

Een redirect aanmaken

De module staat in het menu Content > Redirects van de administration. Klik op Redirect toevoegen en vul in:

• Bron-URL: het pad dat u wilt onderscheppen, relatief ten opzichte van de wortel van het verkoopkanaal (bijvoorbeeld /oude-producten/leren-sneakers).
• Doel-URL: het pad of de absolute bestemmings-URL. Dit veld is verborgen bij code 410.
• HTTP-code: 301 (permanent), 302 (tijdelijk), 307, 308 of 410 (pagina definitief verwijderd).
• Type overeenkomst: exact, wildcard of regex (zie het volgende hoofdstuk).
• Prioriteit: evaluatievolgorde van de patronen, van hoog naar laag. Zonder effect op exacte overeenkomsten.
• Verkoopkanaal: laat leeg om de regel op de hele shop toe te passen, of selecteer een specifiek kanaal.
• Actief: hiermee schakelt u een regel uit zonder haar te verwijderen.

De drie soorten overeenkomst

Exact

De bron-URL moet overeenkomen met het opgevraagde pad. Een afsluitende schuine streep maakt niet uit: /mijn-pagina en /mijn-pagina/ activeren dezelfde regel. Dit is de aanbevolen modus, hij dekt de overgrote meerderheid van de gevallen en is het snelst.

Wildcard

Het sterretje * vangt elk willekeurig deel van een URL op. In de doel-URL neemt een sterretje op dezelfde positie de opgevangen waarde over.

Bron  : /collectie/zomer-*
Doel  : /nieuw/*

/collectie/zomer-jurken →  /nieuw/jurken
/collectie/zomer-shorts →  /nieuw/shorts

Regex

Voor de fijnste gevallen voert u een reguliere expressie in (zonder scheidingstekens) en verwijst u in het doel naar de opgevangen groepen met $1, $2 en zo verder.

Bron  : ^/product/([0-9]+)-(.+)$
Doel  : /p/$2

Evaluatievolgorde

1. Exacte overeenkomsten die aan het huidige verkoopkanaal zijn gekoppeld.
2. Globale exacte overeenkomsten.
3. Actieve wildcard- en regexpatronen, gesorteerd op aflopende prioriteit.

404-logboek

Het tabblad 404-logboek toont alle niet-gevonden URL’s die uw bezoekers zijn tegengekomen. Elk item wordt ontdubbeld: dezelfde URL verschijnt maar één keer, met het aantal voorvallen, de referrer van het laatste bezoek en de datum van de laatste keer. Sorteer op aantal voorvallen om eerst de kapotte URL’s aan te pakken die u het meeste verkeer kosten.

Per regel zijn er twee acties beschikbaar:

• Een redirect aanmaken: opent het formulier met de bron-URL al ingevuld en de doelsuggesties al geladen. Na het opslaan wordt de 404 automatisch als opgelost gemarkeerd.
• Als opgelost markeren: archiveert het item zonder een regel aan te maken, bijvoorbeeld voor een URL die nooit heeft bestaan.

Met de schakelaar Opgeloste tonen laat u de afgehandelde items weer zien.

Doelsuggesties

Zodra u een bron-URL invoert, stelt de plugin tot vijf bestemmingen voor, gerangschikt op gelijkenisscore. De berekening vergelijkt het laatste segment van de kapotte URL met uw canonieke SEO-URL’s: een voorfilter in de database beperkt het aantal kandidaten, waarna een tekstuele nabijheidsscore ze rangschikt. Een klik op een suggestie vult het doelveld in.

CSV-import

De knop Importeren opent een venster dat zowel een bestand als een rechtstreekse plakactie accepteert. Het verwachte formaat telt vijf kolommen:

bron;doel;code;type;actief
/oude-pagina;/nieuwe-pagina;301;exact;1
/collectie/zomer-*;/nieuw/*;301;wildcard;1
/verwijderd-product;;410;exact;1

• Scheidingsteken: puntkomma of komma, automatisch gedetecteerd.
• Kopregel: optioneel, wordt genegeerd als hij wordt herkend.
• Kolommen 3 tot 5: optioneel. Standaard: code 301, type exact, regel actief.
• Type: automatisch afgeleid als de bron een sterretje bevat.
• Aanvaarde codes: 301, 302, 307, 308 en 410. Het doel mag leeg blijven bij een 410.

De import werkt bijwerkend: een bestaande regel met dezelfde bron-URL wordt bijgewerkt in plaats van gedupliceerd. Geïmporteerde regels worden globaal aangemaakt (alle kanalen). Aan het einde toont de plugin het aantal aangemaakte, bijgewerkte en overgeslagen regels, met de details van de opgetreden fouten.

Prestatieopvolging

Elke regel telt haar activeringen en onthoudt de datum van de laatste keer. Een regel die maandenlang op nul blijft staan, kan vaak worden gearchiveerd; omgekeerd wijst een veelgebruikte regel op een oude URL die nog altijd breed wordt verspreid, wat het de moeite waard kan maken die aan de bron te laten corrigeren (backlink, campagne, papieren catalogus).

Probleemoplossing

De module verschijnt niet in het menu Content

De compilatie van de administration is na de installatie niet uitgevoerd. Voer bin/build-administration.sh uit en leeg daarna de cache van uw browser.

Een redirect wordt niet geactiveerd

1. Controleer of de regel actief is en of het verkoopkanaal overeenkomt (of dat de regel globaal is).
2. Controleer of de bron-URL relatief is ten opzichte van de wortel van het kanaal: bij een kanaal dat vanuit een submap wordt geserveerd, voert u het domeinvoorvoegsel niet in.
3. Controleer of geen enkel genegeerd patroon deze URL afdekt.
4. Leeg de cache: bin/console cache:clear.
5. Controleer of er niet al stroomopwaarts een redirect wordt toegepast door uw webserver of uw CDN, want dan bereikt de aanvraag Shopware nooit.

Het 404-logboek blijft leeg

Controleer of de optie 404-logboek activeren in de configuratie van de plugin is aangevinkt en of uw genegeerde patronen niet te ruim zijn. Denk eraan dat statische bronnen per ontwerp worden uitgesloten.

Een redirectlus

Die ontstaat wanneer een regel verwijst naar een URL die zelf weer wordt omgeleid, rechtstreeks of via een te ruim wildcardpatroon. Zoek de doel-URL op in de lijst met bronnen en maak het foutieve patroon strakker.

Verwijderen

Bij het verwijderen biedt Shopware aan de gegevens te behouden. Vinkt u die optie uit, dan worden de tabellen df_redirect en df_redirect_404 definitief verwijderd, samen met al uw regels en de 404-geschiedenis. Exporteer uw regels vooraf als u een herinstallatie voorziet.