404-fout in een WordPress-submap oplossen na installatie

Een 404 fout in een WordPress submap kan verwarrend zijn. De homepage werkt soms gewoon, maar zodra je een pagina, bericht of categorie opent, krijg je een 404-foutmelding.

Dat betekent niet altijd dat de pagina weg is. Vaak staat de inhoud nog gewoon in WordPress, maar wordt de juiste route naar die pagina niet goed gevonden.

Dit gebeurt vooral wanneer WordPress in een aparte map is geïnstalleerd. Denk aan een map zoals website, nieuwesite, testsite of wordpress. De server moet dan precies weten dat WordPress in die submap staat en hoe de onderliggende pagina’s geladen moeten worden.

In dit artikel leggen we uit waarom deze fout ontstaat en hoe je hem veilig oplost.

Wat is een WordPress-submap?

Een WordPress submap is een aparte map binnen je hosting waar WordPress in staat. WordPress staat dan niet direct in de hoofdmap van je domein, maar in een onderliggende map.

Een voorbeeld:

jouwdomein.nl/website

In dit voorbeeld staat WordPress in de map website.

Dat kan handig zijn wanneer je een nieuwe website bouwt, een testomgeving gebruikt of WordPress eerst apart wilt installeren voordat je de website definitief live zet.

Het nadeel is dat de server en WordPress allebei goed moeten weten waar de website staat. Als de paden niet kloppen, kunnen onderliggende pagina’s een 404-fout geven.

Hoe herken je deze fout?

Deze fout herken je vaak aan één duidelijk patroon: de homepage werkt wel, maar andere pagina’s werken niet.

Je opent bijvoorbeeld de homepage en alles lijkt normaal. Maar zodra je naar een andere pagina gaat, krijg je een 404-fout.

Dat kan gebeuren bij:

• Een gewone pagina
• Een blogbericht
• Een categoriepagina
• Een link vanuit het menu
• Een oude link naar de submap
• Een pagina met een aangepaste slug

Dit wijst vaak op een probleem met permalinks, htaccess of de manier waarop de submap wordt doorgestuurd.

Waarom ontstaat een 404 fout in een WordPress submap?

Een 404-fout in een submap ontstaat meestal doordat de server de gevraagde URL niet goed koppelt aan de WordPress-installatie.

WordPress gebruikt permalinks om nette URL’s te maken. Bij een installatie in de hoofdmap is dat meestal simpel. Maar bij een installatie in een submap moet de server ook rekening houden met de mapnaam.

Als die mapnaam ontbreekt of verkeerd staat in de rewrite-regels, kan WordPress de juiste pagina niet vinden.

Ook het htaccess-bestand speelt hierbij een belangrijke rol. Dit bestand vertelt de server hoe URL’s moeten worden verwerkt. Als de regels in dit bestand niet passen bij de submap, kunnen pagina’s 404 geven.

Stap 1: sla de permalinkinstellingen opnieuw op

Begin met de eenvoudigste oplossing. Log in op je WordPress-dashboard en ga naar Instellingen > Permalinks.

Je hoeft niets te wijzigen. Klik alleen op Wijzigingen opslaan.

WordPress probeert daarna de permalinkregels opnieuw op te bouwen. Bij veel 404-problemen is dit al genoeg.

Test daarna meerdere pagina’s:

• Homepage
• Een gewone pagina
• Een blogbericht
• Een categoriepagina
• Een link vanuit het menu

Werken de pagina’s weer? Dan hoef je niets meer aan te passen.

Stap 2: controleer in welke map WordPress staat

Voordat je het htaccess-bestand aanpast, moet je eerst weten waar WordPress precies is geïnstalleerd.

Open File Manager in je hostingpaneel of log in via FTP. Ga daarna naar de map van je website. Vaak is dat public_html.

Kijk waar de WordPress-bestanden staan. Een WordPress-installatie herken je aan deze mappen en bestanden:

• wp-admin
• wp-content
• wp-includes
• wp-config.php

Staan deze onderdelen direct in public_html? Dan staat WordPress waarschijnlijk in de hoofdmap.

Staan deze onderdelen in een aparte map, bijvoorbeeld public_html/website? Dan staat WordPress in een submap.

Schrijf de naam van de submap goed op. Die naam heb je nodig bij het controleren van htaccess.

Voorbeeld:

Als WordPress staat in public_html/website, dan is de submapnaam website.

Als WordPress staat in public_html/nieuwesite, dan is de submapnaam nieuwesite.

Gebruik altijd de echte mapnaam van je eigen hosting. Een verkeerde mapnaam zorgt ervoor dat de 404-fout blijft bestaan.

Stap 3: open het htaccess-bestand in de WordPress-submap

Nu je weet waar WordPress staat, kun je het juiste htaccess-bestand controleren.

Staat WordPress bijvoorbeeld in public_html/website? Dan moet je in die map kijken of daar een htaccess-bestand staat.

Dus niet meteen alleen in public_html kijken, maar eerst in de map waar WordPress echt staat.

Het htaccess-bestand is vaak verborgen. Zie je het bestand niet? Zet dan in File Manager de optie voor verborgen bestanden aan.

Maak eerst een back-up voordat je iets wijzigt. Download het htaccess-bestand naar je computer of maak een kopie in dezelfde map.

Dit is belangrijk. Als er iets misgaat, kun je de oude versie meteen terugzetten.

Stap 4: controleer of htaccess naar de juiste submap verwijst

Bij een WordPress-installatie in een submap moeten de regels in htaccess verwijzen naar die submap.

Stel dat WordPress in deze map staat:

public_html/website

Dan moet de naam website ook terugkomen in de htaccess-regels.

Een voorbeeld voor een WordPress-installatie in de submap website:

# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ – [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress

Gebruik dit voorbeeld alleen als jouw submap echt website heet.

Heet je submap anders? Dan moet je website vervangen door de echte naam van je submap.

Voorbeeld:

Staat WordPress in public_html/nieuwesite, dan wordt RewriteBase:

RewriteBase /nieuwesite/

En de laatste regel wordt:

RewriteRule . /nieuwesite/index.php [L]

Sla het bestand op en test daarna opnieuw een paar pagina’s.

Test minimaal:

• Homepage
• Een gewone pagina
• Een blogbericht
• Een categoriepagina

Krijg je na het opslaan een 500-fout? Zet dan direct de back-up van htaccess terug.

Lees dan ook: 500 Internal Server Error of HTTP Error 500 oplossen.

Stap 5: controleer ook het htaccess-bestand in de hoofdmap

Bij een WordPress-installatie in een submap kan er ook een htaccess-bestand in de hoofdmap staan. Vaak is dat public_html.

Dat bestand kan invloed hebben op de submap. Vooral als er oude redirects, beveiligingsregels of rewrite-regels in staan.

Controleer daarom twee plekken:

• public_html
• public_html/naam-van-de-submap

Het htaccess-bestand in de hoofdmap mag de submap niet verkeerd doorsturen. Als daar een regel staat die alles naar een andere plek stuurt, kunnen pagina’s in de submap 404 geven.

Verwijder geen regels als je niet weet wat ze doen. Maak eerst een back-up.

Twijfel je? Vraag je hostingprovider om te controleren of de regels in de hoofdmap en submap elkaar niet tegenwerken.

Stap 6: controleer WordPress-adres en Siteadres

Ga in WordPress naar Instellingen > Algemeen.

Controleer daar deze twee velden:

• WordPress-adres
• Siteadres

Deze adressen moeten passen bij de plek waar WordPress staat en hoe de website bereikbaar moet zijn.

Als WordPress bereikbaar moet zijn via een submap, dan staat de submap meestal ook in deze adressen.

Voorbeeld:

jouwdomein.nl/website

Pas deze velden niet zomaar aan. Een verkeerde URL kan ervoor zorgen dat je niet meer goed kunt inloggen of dat de website verkeerd doorstuurt.

Weet je niet zeker wat hier moet staan? Maak eerst een back-up en vraag eventueel je hostingprovider of webbeheerder om mee te kijken.

Stap 7: controleer bestandsrechten in de submap

Als WordPress de juiste bestanden niet goed kan lezen, kunnen er ook fouten ontstaan.

Controleer daarom de rechten van de submap, WordPress-bestanden en het htaccess-bestand.

Veelgebruikte instellingen zijn:

• Mappen: 755
• Bestanden: 644

Pas dit niet blind aan als je niet weet wat deze rechten betekenen. Verkeerde rechten kunnen nieuwe problemen veroorzaken of de website minder veilig maken.

Lees ook: Bestands- en mappermissies in WordPress: wat het zijn én hoe je ze oplost.

Stap 8: leeg cache en test opnieuw

Na het aanpassen van permalinks of htaccess kan cache ervoor zorgen dat je nog steeds een oude fout ziet.

Leeg daarom de cache van je WordPress-cacheplugin, hostingcache en eventueel CDN.

Open daarna de website in een incognitovenster of in een andere browser.

Test meerdere onderdelen van de website:

• Homepage
• Pagina binnen de submap
• Blogbericht binnen de submap
• Categoriepagina
• Menu-item
• Interne link vanuit een artikel

Als deze pagina’s goed openen, is de kans groot dat het probleem is opgelost.

Gebruik je WordPress tijdelijk in een submap?

Soms staat WordPress tijdelijk in een submap. Bijvoorbeeld omdat je een nieuwe website bouwt terwijl de oude website nog live staat.

Dat kan prima, maar je moet wel weten wat het einddoel is.

Blijft de website in de submap staan? Dan moeten permalinks, htaccess, WordPress-adres en Siteadres daarop aansluiten.

Moet de website later naar het hoofddomein? Dan is het beter om de website netjes over te zetten. Daarbij moet je ook letten op interne links, afbeeldingen, redirects en databasepaden.

Lees ook: WordPress site overzetten van local naar server.

Veelgemaakte fouten bij een WordPress submap

Bij een WordPress-installatie in een submap gaan vaak dezelfde dingen mis.

Veelvoorkomende fouten zijn:

• De verkeerde submapnaam gebruiken in htaccess
• RewriteBase laten verwijzen naar de hoofdmap
• Het htaccess-bestand in de verkeerde map aanpassen
• Vergeten om verborgen bestanden zichtbaar te maken
• Permalinks niet opnieuw opslaan na een wijziging
• WordPress-adres en Siteadres verkeerd aanpassen
• Cache niet legen na het oplossen
• Regels in de hoofdmap niet controleren

Deze fouten zijn relevant, omdat één verkeerd pad al genoeg kan zijn om pagina’s een 404-fout te geven.

Als je deze punten controleert en de juiste aanpassingen maakt, verdwijnt de fout meestal direct. Wil je meer technische informatie over het gebruik van het htaccess-bestand en mod_rewrite? Bezoek dan de officiële Apache-documentatie voor een complete uitleg.

Wanneer moet je je hostingprovider inschakelen?

Schakel je hostingprovider in als je niet zeker weet welke server je gebruikt.

Bij Apache speelt htaccess een grote rol. Bij NGINX werkt htaccess niet op dezelfde manier.

Vraag je hostingprovider om te controleren:

• Of de website op Apache of NGINX draait
• Of rewrite-regels goed werken
• Of de submap correct wordt gelezen
• Of htaccess in de hoofdmap en submap elkaar niet tegenwerken
• Of bestandsrechten goed staan
• Of servercache oude regels blijft tonen

Als je meerdere stappen hebt geprobeerd en de 404-fout blijft staan, is hulp van de hostingprovider vaak sneller en veiliger.

Hoe weet je dat de fout is opgelost?

De fout is pas opgelost als niet alleen de homepage werkt, maar ook de onderliggende pagina’s goed openen.

Controleer daarom meerdere URL’s.

Test bijvoorbeeld:

• De homepage
• Een gewone pagina
• Een blogbericht
• Een categoriepagina
• Een link vanuit het menu
• Een interne link vanuit een artikel

Gebruik ook een incognitovenster. Zo voorkom je dat je browser nog een oude versie laat zien.

Als alle pagina’s normaal openen en geen 404-fout meer geven, werkt de route naar WordPress weer goed.

Conclusie

Een 404 fout in een WordPress submap ontstaat meestal doordat WordPress in een aparte map staat en de server de juiste route naar pagina’s en berichten niet goed herkent.

Begin met het opnieuw opslaan van de permalinkinstellingen. Controleer daarna waar WordPress precies staat. Pas daarna weet je welk htaccess-bestand je moet controleren.

Let vooral op de juiste submapnaam in htaccess. Controleer ook het htaccess-bestand in de hoofdmap, WordPress-adres, Siteadres, bestandsrechten en cache.

Werk stap voor stap en maak altijd een back-up voordat je htaccess aanpast.

Veelgestelde vragen

1. Wat betekent een 404 fout in een WordPress submap?

Dat betekent dat WordPress in een aparte map staat, maar dat de server de juiste route naar een pagina of bericht niet goed herkent.

2. Waarom werkt mijn homepage wel, maar andere pagina’s niet?

Dat komt vaak doordat de homepage direct opent, maar de permalinkregels voor onderliggende pagina’s niet goed naar de submap verwijzen.

3. Moet ik altijd htaccess aanpassen?

Nee. Begin eerst met Instellingen > Permalinks en klik op Wijzigingen opslaan. Als dat niet helpt, controleer je waar WordPress staat en daarna het htaccess-bestand in die map.

4. Waar moet het htaccess-bestand staan?

Meestal staat het htaccess-bestand in dezelfde map als de WordPress-installatie. Bij een submap is dat dus vaak de submap zelf.

5. Wat moet ik aanpassen in htaccess?

De verwijzing naar de submap moet kloppen. Vooral RewriteBase en de regel die naar index.php verwijst, moeten de juiste mapnaam bevatten.

6. Kan cache deze fout blijven tonen?

Ja. Na het aanpassen van htaccess of permalinks kan cache nog een oude 404-fout tonen. Leeg daarom altijd cache en test opnieuw.

7. Wat als mijn server NGINX gebruikt?

Dan werkt htaccess niet zoals bij Apache. Vraag je hostingprovider om de juiste rewrite-regels of serverconfiguratie te controleren.