Γιατί οι μεταφράσεις σας δεν εμφανίζονται στο WordPress (Οδηγός αντιμετώπισης προβλημάτων)

Δεν υπάρχει τίποτα πιο απογοητευτικό στην ανάπτυξη του WordPress από τη "Σιωπηλή Αποτυχία".

Έχετε κάνει τα πάντα σωστά. Έχετε μεταφράσει το αρχείο .po. Το έχετε μεταγλωττίσει σε ένα αρχείο .mo. Το έχετε ανεβάσει στον διακομιστή σας μέσω FTP. Έχετε καθαρίσει την προσωρινή μνήμη σας.

Ανανεώνετε τη σελίδα, περιμένοντας να δείτε Ισπανικά, Γαλλικά ή Γερμανικά. Αντ' αυτού, βλέπετε... Αγγλικά.

Κανένα μήνυμα σφάλματος, καμία λευκή οθόνη — απλώς πεισματικό, αμετάφραστο κείμενο. Προτού τραβήξετε τα μαλλιά σας, διαβάστε αυτόν τον οδηγό. Εδώ είναι οι 5 πιο συνηθισμένοι λόγοι για τους οποίους οι μεταφράσεις αποτυγχάνουν να φορτώσουν στο WordPress και πώς να τους διορθώσετε.

1. Ονομάζετε το αρχείο λάθος

Το WordPress είναι απίστευτα αυστηρό σχετικά με την ονομασία των αρχείων. Αν χάσετε έναν χαρακτήρα, δεν θα φορτώσει το αρχείο.

Η τυπική μορφή είναι: {text-domain}-{locale}.mo

• Το Text Domain: Αυτό είναι το μοναδικό ID του θέματος ή του plugin (π.χ., woocommerce, twentytwentyfour, my-custom-plugin).
• Το Locale: Ο κωδικός τοπικής ρύθμισης WP (π.χ., es_ES για Ισπανικά Ισπανίας, fr_FR για Γαλλικά).

Συνήθη λάθη:

• Ονομάζετε το αρχείο απλώς es_ES.mo (Αυτό λειτουργεί μόνο για τα καθολικά αρχεία του πυρήνα του WordPress, όχι για τα plugins).
• Χρησιμοποιείτε λάθος παύλα: my_plugin_es_ES.mo (Κάτω παύλα) αντί για my-plugin-es_ES.mo (Παύλα).
• Μαντεύετε το text domain. Πρέπει να ελέγξετε τον κώδικα του plugin (style.css header ή load_plugin_textdomain function) για να βρείτε το ακριβές slug.

2. Βάζετε το αρχείο σε λάθος φάκελο

Το πού ανεβάζετε το αρχείο έχει τόση σημασία όσο και το πώς το ονομάζετε. Το WordPress αναζητά σε συγκεκριμένους καταλόγους με συγκεκριμένη σειρά.

• Ο "Ασφαλής" Φάκελος Συστήματος: /wp-content/languages/plugins/ ή /wp-content/languages/themes/.
  • Πλεονεκτήματα: Αυτό είναι ασφαλές από ενημερώσεις plugin.
  • Μειονεκτήματα: Πρέπει να ονομάσετε το αρχείο textdomain-locale.mo.
• Ο Φάκελος του Δημιουργού: /wp-content/plugins/plugin-name/languages/.
  • Πλεονεκτήματα: Εύκολο να το βρείτε.
  • Μειονεκτήματα: ΚΙΝΔΥΝΟΣ. Όταν ενημερώνετε το plugin, αυτός ο φάκελος διαγράφεται εντελώς. Οι μεταφράσεις σας θα εξαφανιστούν.

Βέλτιστη πρακτική: Να βάζετε πάντα τα προσαρμοσμένα αρχεία .mo στον καθολικό κατάλογο /wp-content/languages/ για να αποφύγετε την απώλεια δεδομένων κατά τη διάρκεια των ενημερώσεων.

3. Ο "Σιωπηλός Δολοφόνος": Κατεστραμμένη Σύνταξη στο αρχείο .po

Αυτό είναι το πιο δύσκολο πρόβλημα για εντοπισμό σφαλμάτων και συμβαίνει συχνά με τα γενικά εργαλεία μετάφρασης AI.

Το WordPress διαβάζει δυαδικά αρχεία .mo, τα οποία μεταγλωττίζονται από αρχεία κειμένου .po. Εάν το αρχείο .po περιέχει συντακτικά σφάλματα, το αρχείο .mo μπορεί να δημιουργηθεί, αλλά θα είναι "χαλασμένο" εσωτερικά.

Πώς συμβαίνει αυτό; Εάν ένας μεταφραστής (άνθρωπος ή AI) μπερδέψει τη μορφοποίηση Gettext, η συμβολοσειρά γίνεται μη έγκυρη.

• Παράδειγμα: Λείπει ένα κλείσιμο εισαγωγικού ".
• Παράδειγμα: Σπάσιμο μιας μεταβλητής (αλλαγή του %s σε % s).
• Παράδειγμα: Μπερδεύοντας τον αριθμό msgid_plural.

Όταν το WordPress συναντά μια χαλασμένη καταχώρηση στο αρχείο .mo, συχνά την παραλείπει ή σταματά να διαβάζει ολόκληρο το αρχείο, επιστρέφοντας στα αρχικά Αγγλικά.

4. Ξεχάσατε να μεταγλωττίσετε (.po vs .mo)

Το WordPress δεν μπορεί να διαβάσει απευθείας αρχεία .po. Είναι μια κοινή παρανόηση.

• .po = Αναγνώσιμο από ανθρώπους (Portable Object).
• .mo = Αναγνώσιμο από μηχανές (Machine Object).

Εάν ανεβάσετε ένα αρχείο my-theme-es_ES.po αλλά ξεχάσετε να δημιουργήσετε το αντίστοιχο αρχείο .mo, δεν θα συμβεί τίποτα. Πρέπει να το μεταγλωττίσετε.

5. Προσωρινή αποθήκευση (Ο συνήθης ύποπτος)

Εάν χρησιμοποιείτε plugins προσωρινής αποθήκευσης (WP Rocket, LiteSpeed) ή προσωρινή αποθήκευση από την πλευρά του διακομιστή (Varnish, Redis), ο ιστότοπός σας ενδέχεται να εξυπηρετεί μια αποθηκευμένη έκδοση HTML από πριν ανεβάσετε τη μετάφραση.

Διόρθωση: καθαρίστε όλες τις προσωρινές μνήμες, συμπεριλαμβανομένης της προσωρινής μνήμης του προγράμματος περιήγησής σας και της προσωρινής μνήμης αντικειμένων.

Η απόλυτη λύση: Έγκυρα αρχεία από την αρχή

Η αντιμετώπιση προβλημάτων με τις διαδρομές και τα ονόματα αρχείων είναι εύκολη. Η αντιμετώπιση προβλημάτων κατεστραμμένης σύνταξης (Λόγος #3) είναι εφιάλτης.

Εάν χρησιμοποιείτε ένα εργαλείο που σπάει τις μεταβλητές κώδικα ή καταστρέφει τη δομή Gettext, θα ξοδέψετε ώρες αναρωτώμενοι γιατί το αρχείο δεν λειτουργεί, χωρίς να συνειδητοποιείτε ότι το ίδιο το αρχείο είναι "δηλητηριασμένο".

Γι' αυτό δημιουργήσαμε το SimplePoTranslate.

• Κλείδωμα σύνταξης: Διασφαλίζουμε ότι κάθε συμβολοσειρά είναι συντακτικά έγκυρη πριν τη κατεβάσετε. Κλειδώνουμε μεταβλητές όπως το %s ώστε να μην μπορούν να σπάσουν.
• Τέλεια μορφοποίηση: Δημιουργούμε καθαρά, τυπικά αρχεία .po που μεταγλωττίζονται σε λειτουργικά αρχεία .mo στο 100% των περιπτώσεων.
• Δεν απαιτούνται plugins: Κατεβάζετε το αρχείο και ξέρετε ότι λειτουργεί. Απλώς πρέπει να το ανεβάσετε στον σωστό φάκελο.
• WordPress Plugin: Προτιμάτε να παραλείψετε την μη αυτόματη μεταφόρτωση εντελώς; Το επίσημο SimplePoTranslate WordPress plugin μας εντοπίζει αυτόματα τα αρχεία .pot του θέματος και του plugin σας, τα μεταφράζει στο cloud και αναπτύσσει το αποτέλεσμα στον σωστό κατάλογο με το σωστό όνομα αρχείου. Όχι άλλα αρχεία με λανθασμένο όνομα, όχι λανθασμένες διαδρομές φακέλων — οι δύο πιο συνηθισμένοι λόγοι για τους οποίους οι μεταφράσεις αποτυγχάνουν να εμφανιστούν.

Σταματήστε να μαντεύετε γιατί οι μεταφράσεις σας είναι αόρατες. Ξεκινήστε με ένα αρχείο που μπορείτε να εμπιστευτείτε.

Είστε έτοιμοι να μεταφράσετε χωρίς πονοκέφαλο; Ξεκινήστε δωρεάν στο SimplePoTranslate.com