Därför Visas Inte Dina Översättningar i WordPress (Felsökningsguide)

Inget är mer frustrerande inom WordPress-utveckling än "Silent Failure" (Tyst Fel).

Du gjorde allt rätt. Du översatte .po-filen. Du kompilerade den till en .mo-fil. Du laddade upp den till din server via FTP. Du rensade din cache.

Du uppdaterar sidan och förväntar dig att se spanska, franska eller tyska. Istället ser du... engelska.

Inget felmeddelande, ingen vit skärm – bara envis, oöversatt text. Innan du sliter ditt hår, läs den här guiden. Här är de 5 vanligaste orsakerna till att översättningar inte laddas i WordPress och hur du åtgärdar dem.

1. Du Namnger Filen Fel

WordPress är otroligt strikt med filnamn. Om du missar ett tecken kommer den inte att ladda filen.

Standardformatet är: {text-domain}-{locale}.mo

• Textdomänen: Detta är det unika ID:t för temat eller pluginet (t.ex. woocommerce, twentytwentyfour, my-custom-plugin).
• Språkkoden (Locale): WP:s språkkod (t.ex. es_ES för spanska i Spanien, fr_FR för franska).

Vanliga Misstag:

• Att namnge filen bara es_ES.mo (Detta fungerar bara för globala WordPress-kärnfiler, inte plugins).
• Att använda fel bindestreck: my_plugin_es_ES.mo (Understreck) istället för my-plugin-es_ES.mo (Bindestreck).
• Att gissa textdomänen. Du måste kontrollera pluginets kod (style.css-header eller load_plugin_textdomain-funktionen) för att hitta den exakta slugen.

2. Du Placerade Filen i Fel Mapp

Vart du laddar upp filen spelar lika stor roll som vad du namnger den till. WordPress letar i specifika kataloger i en specifik ordning.

• Den "Säkra" Systemmappen: /wp-content/languages/plugins/ eller /wp-content/languages/themes/.
  • Fördelar: Detta är säkert från plugin-uppdateringar.
  • Nackdelar: Du måste namnge filen textdomain-locale.mo.
• Författarmappen: /wp-content/plugins/plugin-name/languages/.
  • Fördelar: Lätt att hitta.
  • Nackdelar: FARA. När du uppdaterar pluginet raderas den här mappen helt. Dina översättningar kommer att försvinna.

Bästa Praxis: Lägg alltid dina anpassade .mo-filer i den globala katalogen /wp-content/languages/ för att förhindra dataförlust under uppdateringar.

3. Den "Tysta Döparen": Korrupt Syntax i .po-filen

Detta är det svåraste problemet att felsöka, och det händer ofta med generiska AI-översättningsverktyg.

WordPress läser binära .mo-filer, som är kompilerade från .po-textfiler. Om din .po-fil innehåller syntaxfel kan .mo-filen genereras, men den kommer att vara "trasig" internt.

Hur händer detta? Om en översättare (människa eller AI) förstör Gettext-formateringen blir strängen ogiltig.

• Exempel: Saknar ett avslutande citattecken ".
• Exempel: Bryter en variabel (ändrar %s till % s).
• Exempel: Förstör msgid_plural-räkningen.

När WordPress stöter på en trasig post i .mo-filen hoppar den ofta över den eller slutar läsa filen helt och återgår till den ursprungliga engelskan.

4. Du Glömde att Kompilera (.po vs .mo)

WordPress kan inte läsa .po-filer direkt. Det är en vanlig missuppfattning.

• .po = Läsbar av människor (Portable Object).
• .mo = Läsbar av maskiner (Machine Object).

Om du laddar upp en my-theme-es_ES.po-fil men glömmer att generera den matchande .mo-filen kommer ingenting att hända. Du måste kompilera den.

5. Cachelagring (Den Vanliga Misstänkta)

Om du använder cachelagrings-plugins (WP Rocket, LiteSpeed) eller server-side cachelagring (Varnish, Redis) kan din webbplats servera en cachad HTML-version från innan du laddade upp översättningen.

Åtgärda: rensa alla cacheminnen, inklusive din webbläsares cache och objektcache.

Den Ultima Löningen: Valida Filer från Start

Felsökning av filsökvägar och namn är enkelt. Felsökning av korrupt syntax (Orsak #3) är en mardröm.

Om du använder ett verktyg som bryter dina kodvariabler eller förstör Gettext-strukturen kommer du att spendera timmar på att undra varför filen inte fungerar, utan att inse att filen själv är "förgiftad".

Det är därför vi byggde SimplePoTranslate.

• Syntaxlåsning: Vi säkerställer att varje enskild sträng är syntaktiskt giltig innan du laddar ner den. Vi låser variabler som %s så att de inte kan brytas.
• Perfekt Formatering: Vi genererar rena, standard .po-filer som kompileras till fungerande .mo-filer 100 % av tiden.
• Inga Plugins Krävs: Du laddar ner filen, och du vet att den fungerar. Du behöver bara ladda upp den till rätt mapp.
• WordPress Plugin: Föredrar du att hoppa över den manuella uppladdningen helt? Vårt officiella SimplePoTranslate WordPress plugin upptäcker automatiskt dina teman och plugins .pot-filer, översätter dem i molnet och distribuerar resultatet till rätt katalog med rätt filnamn. Inga fler felnamngivna filer, inga felaktiga mappsökvägar – de två vanligaste orsakerna till att översättningar inte visas.

Sluta gissa varför dina översättningar är osynliga. Börja med en fil du kan lita på.

Redo att översätta utan huvudvärk? Börja gratis på SimplePoTranslate.com