DF Smart 404: volledige gids

Overzicht

DF Smart 404 maakt van de pagina « pagina niet gevonden » van uw winkel een conversiepunt. Belandt een bezoeker op een kapotte URL, dan ontleedt de module die URL, haalt er de zoekwoorden uit en toont de producten uit uw catalogus die er het best bij passen, samen met een reeds ingevuld zoekformulier.

Tegelijk wordt elke 404 in een logboek in de backoffice vastgelegd. U ziet precies welke URL’s stuk zijn, hoeveel bezoekers erop terechtkomen en waar zij vandaan komen. Vanuit dat logboek maakt u met één klik een 301-doorverwijzing naar het juiste product.

Wat de module doet

• Injecteert een blok met productsuggesties in de 404-pagina van uw thema, zonder de template te overschrijven.
• Vult het zoekformulier vooraf in met de leesbaar gemaakte zoekwoorden uit de kapotte URL.
• Legt elke 404 vast met ontdubbeling, een hitteller, de referer en de user-agent.
• Maakt met één klik 301- of 302-doorverwijzingen, met bescherming tegen lussen.
• Past die doorverwijzingen toe vóór het dispatchen van de pagina.

Vereisten

• PrestaShop 8.0 tot 9.x
• PHP 7.4 of hoger
• Geen enkele externe afhankelijkheid, geen Composer

Installatie

1. Ga naar Modules > Modulebeheer.
2. Klik op Een module installeren en plaats het bestand df404smart-1.0.0.zip.
3. Klik op Installeren.

Bij de installatie maakt de module twee SQL-tabellen aan (het 404-logboek en de doorverwijzingen), registreert hij drie hooks en voegt hij een menu DF Smart 404 met twee subtabbladen toe aan de backoffice.

Het blok is meteen actief op de 404-pagina, met bruikbare standaardinstellingen. U kunt dat testen door een onbestaande URL van uw winkel te bezoeken.

Configuratie

Open de pagina Configureren van de module. Die toont eerst vier opvolgingsindicatoren en daarna het instellingenformulier.

Dashboard

• Kapotte URL’s om te corrigeren: aantal vermeldingen met de status « nieuw » in het logboek.
• 404-hits op die URL’s: som van de bezoeken op de nog niet behandelde URL’s.
• Actieve doorverwijzingen: aantal regels dat in dienst is.
• Door doorverwijzingen geredde bezoeken: som van de hits die uw doorverwijzingen hebben opgevangen.

Beschikbare instellingen

• De 404-pagina verrijken: schakelt de injectie van het suggestieblok in of uit.
• Het zoekformulier tonen: toont het vooraf ingevulde zoekveld in het blok.
• De doorverwijsmotor inschakelen: past de doorverwijzingen toe die vanuit het logboek zijn gemaakt. Vink dit uit als u al een externe doorverwijsmodule gebruikt.
• Aantal suggesties: tussen 0 en 12 producten. De waarde 0 schakelt de suggesties uit maar behoudt het zoekformulier.
• Standaard type doorverwijzing: 301 permanent (aanbevolen voor SEO) of 302 tijdelijk.
• Robotverkeer loggen: staat dit uit, dan worden hits van bekende crawlers niet in het logboek geschreven.
• Bewaartermijn van het logboek (dagen): oudere vermeldingen worden automatisch opgeruimd. De doorverwijsregels worden nooit opgeruimd.
• Uitsluitingspatronen: één reguliere expressie per regel, ongevoelig voor hoofdletters. De overeenkomstige URL’s worden nooit gelogd.

Standaard uitsluitingspatronen

De module wordt geleverd met een lijst patronen die de ruis van kwetsbaarheidsscanners en geautomatiseerde verzoeken weren: pogingen op wp-admin, wp-login, xmlrpc, phpmyadmin en de map .git, plus de statische bestanden (afbeeldingen, stylesheets, scripts). Voeg uw eigen patronen toe, één per regel. Een ongeldig patroon wordt bij het opslaan gemeld, met het betrokken regelnummer.

Het suggestieblok aan de frontzijde

Hoe de producten worden gekozen

Doet een 404 zich voor, dan splitst de module de laatste twee segmenten van de URL op in zoekwoorden. Stopwoorden worden in vijf talen geweerd (Frans, Engels, Spaans, Duits en Italiaans), alleen tokens van minstens drie tekens blijven over, en louter numerieke identificaties vallen af.

Elk overblijvend token wordt daarna met een gewogen score aan de catalogus getoetst:

• overeenkomst in de link_rewrite van het product: 4 punten
• overeenkomst in de naam van het product: 3 punten
• overeenkomst in de referentie: 2 punten

De producten worden op aflopende score gerangschikt, en alleen die met een score boven nul blijven behouden.

De terugval

Levert de analyse geen enkel product op, wat vaak gebeurt bij een erg korte of duistere URL, dan schakelt de module automatisch over op de bestsellers. Zijn ook die niet beschikbaar (nieuwe catalogus, statistieken nog niet berekend), dan toont hij de recentste producten. De bezoeker ziet dus altijd producten, nooit een leeg blok.

Het zoekformulier

Het zoekveld is vooraf ingevuld met de leesbaar gemaakte zoekwoorden uit de URL. Een bezoeker die op /sneakers-leer-premium-editie belandt, ziet al « sneakers leer premium editie » in het veld staan.

Het formulier verwijst naar de native zoekpagina van uw thema, met de parameters uit de query string correct doorgegeven als verborgen velden. Er is geen conflict met een externe module voor direct zoeken: de module overschrijft niets en gebruikt het standaard toegangspunt van PrestaShop.

Waar het blok verschijnt

De module herkent de inhoudssectie van de 404-pagina van uw thema en voegt het blok daar in, net onder de native melding. Is de structuur van het thema afwijkend, dan zorgen verschillende opeenvolgende terugvallen ervoor dat het blok boven de footer blijft. Er wordt geen enkel themabestand gewijzigd.

Het 404-logboek

Menu DF Smart 404 > 404-logboek.

Kolommen

• Kapotte URL: het opgeroepen pad, genormaliseerd.
• Hits: aantal bezoeken op die URL. De lijst is standaard op aflopend aantal hits gesorteerd: de duurste URL’s staan bovenaan.
• Laatste referer: waar de laatste bezoeker vandaan kwam (Google, een externe site, een interne pagina).
• Status: Nieuw, Doorverwezen of Genegeerd.
• Laatste hit: datum van het laatste bezoek.

Ontdubbeling

De ontdubbeling berust op een hash van de URL, afgebakend per winkel. Duizend bezoeken op dezelfde kapotte URL leveren één regel met duizend hits op, nooit duizend regels. Het schrijven gebeurt in één enkele upsert-query.

Beschikbare acties per regel

• Automatische doorverwijzing (bliksempictogram): maakt meteen een doorverwijzing naar het meest relevante product, via AJAX, zonder de pagina te verlaten. Deze actie wordt alleen aangeboden als de matchscore boven de betrouwbaarheidsdrempel ligt; zo niet nodigt een melding u uit om het begeleide formulier te gebruiken.
• Een doorverwijzing maken: opent het begeleide formulier (zie hieronder).
• Negeren: zet de vermelding op de status « genegeerd ». Zij verdwijnt uit de opvolgingsindicatoren maar blijft raadpleegbaar.
• Verwijderen: haalt de vermelding uit het logboek.

In de werkbalk staan ook een groepsactie om te verwijderen en een CSV-export.

Een doorverwijzing maken

De automatische doorverwijzing

De bliksemknop berekent het product dat het best bij de kapotte URL past. Ligt de score boven de interne betrouwbaarheidsdrempel, dan wordt de doorverwijzing meteen aangemaakt met het ingestelde standaardtype, en gaat de vermelding in het logboek naar de status « doorverwezen ». Een bevestigingsmelding noemt het doelproduct.

De betrouwbaarheidsdrempel voorkomt lukrake doorverwijzingen. Een URL als /promo-zomer-2024 levert waarschijnlijk geen betrouwbare match op: de module weigert dan de automatische doorverwijzing en stuurt u naar het begeleide formulier.

Het begeleide formulier

Het toont de kapotte URL, het aantal hits en daarna de lijst met voorgestelde producten, op score gerangschikt. Elke suggestie is een keuzerondje, waarvan het eerste vooraf is geselecteerd. Een veld Eigen URL laat u om het even welk doel invoeren: een categorie, een CMS-pagina of een externe URL.

Daarna kiest u het type doorverwijzing (301 of 302) en bevestigt u. De module controleert of het doel niet leeg is, of het niet naar de bron-URL zelf wijst (bescherming tegen lussen) en of er voor die bron nog geen doorverwijzing bestaat.

De doorverwijzingen beheren

Menu DF Smart 404 > 404-doorverwijzingen.

Dit scherm biedt volledig beheer over uw doorverwijsregels:

• Bron-URL: het kapotte pad (bijvoorbeeld /oude-categorie/oud-product).
• Doel-URL: het pad of de volledige URL waarnaar u doorverwijst.
• Type: 301 (permanent) of 302 (tijdelijk).
• Hits: aantal bezoeken dat deze regel heeft opgevangen. Dat is uw rechtstreekse maat voor geredde bezoeken.
• Actief: schakelaar om een regel uit te zetten zonder die te verwijderen.

Dezelfde controles als in het begeleide formulier gelden hier: de bron mag niet leeg zijn, er mag geen lus ontstaan en er mag geen dubbele bron zijn (bij het bewerken wordt de huidige identificatie van de controle uitgesloten).

Werking van de motor

De doorverwijzingen worden beoordeeld vóór het dispatchen van de pagina, nog vóór de frontcontroller. Het opgeroepen pad wordt genormaliseerd, waarna een geïndexeerde lookup op de hash ervan een actieve regel voor de huidige winkel zoekt. Past een regel, dan wordt de hitteller verhoogd en wordt de doorverwijzing met de ingestelde HTTP-code verstuurd.

Prestaties

• Het logboek schrijft alleen bij een echte 404, in één enkele upsert-query.
• De doorverwijsmotor doet een geïndexeerde lookup op een hash: verwaarloosbare kost, zelfs met honderden regels.
• Het opruimen van oude vermeldingen wordt willekeurig bij ongeveer 1 % van de hits geactiveerd, zodat een bezoekersverzoek nooit wordt opgehouden.
• Hits van robots kunnen van het schrijven worden uitgesloten, wat de belasting op sterk gecrawlde winkels verder verlaagt.

Multistore

Alle gegevens van de module zijn per winkelidentificatie afgebakend: het logboek, de doorverwijzingen en de suggesties. Elke winkel heeft haar eigen logboek, haar eigen regels en haar eigen configuratie. Een kapotte URL op winkel A verschijnt niet in het logboek van winkel B.

AVG

Het logboek legt de kapotte URL, de referer en de user-agent vast. Er wordt geen enkel IP-adres bewaard en er worden geen persoonsgegevens verzameld. De bewaartermijn is instelbaar en het opruimen gebeurt automatisch. De module stuurt geen enkel gegeven naar een externe dienst.

Verwijderen

Bij het verwijderen worden de twee tabellen van de module (het 404-logboek en de doorverwijzingen), de backofficetabbladen en de configuratie gewist. De aangemaakte doorverwijzingen gaan verloren. Er wordt vooraf om bevestiging gevraagd.

Plant u de module opnieuw te installeren of te migreren, exporteer dan eerst uw doorverwijzingen als CSV vanuit het beheerscherm.

Problemen oplossen

Het blok verschijnt niet op de 404-pagina

• Controleer of de instelling De 404-pagina verrijken aanstaat.
• Leeg de PrestaShop-cache (Geavanceerde parameters > Prestaties > Cache legen).
• Ga na of het thema wel de standaardcontroller pagenotfound gebruikt.

Het blok verschijnt onder de footer

Dat geval is sinds versie 1.0.0 opgelost: de module richt zich op de inhoudssectie en niet op de sluitingstag van de hoofdcontainer. Doet dit gedrag zich toch nog voor, leeg dan de Smarty-cache en meld de structuur van uw thema aan de ondersteuning.

Er wordt geen enkel product voorgesteld

• Controleer of het Aantal suggesties niet op 0 staat.
• Op een nieuwe catalogus zonder verkoophistoriek is de terugval op bestsellers leeg: de module schakelt dan over op recente producten. Zorg dat u minstens één actief en zichtbaar product hebt.

De automatische doorverwijzing wordt geweigerd

Dat is het verwachte gedrag wanneer de matchscore te laag ligt. Gebruik het begeleide formulier, dat de suggesties ook onder de drempel toont en waarmee u een eigen doel kunt invoeren.

Een doorverwijzing wordt niet toegepast

• Controleer of de instelling De doorverwijsmotor inschakelen is aangevinkt.
• Controleer of de regel in het beheerscherm wel actief staat.
• Controleer in een multistore-omgeving of de regel aan de juiste winkel hangt.
• Is er een andere doorverwijsmodule geïnstalleerd, dan kan die het verzoek eerder onderscheppen.

Ondersteuning

Bij uw licentie horen 12 maanden updates en 12 maanden ondersteuning per e-mail. De volledige PHP-broncode wordt meegeleverd en is niet versluierd.