Κώδικας

Διεθνοποιήστε το πρόσθετο WordPress

Τα πρόσθετα WordPress σάς επιτρέπουν να τροποποιείτε και να βελτιώνετε εύκολα το ιστολόγιό σας προσφέροντας νέες λειτουργίες που δεν διατίθενται άλλως στον βασικό κώδικα.

Η χρήση των plugins λειτουργεί πιο αποτελεσματικά από ό, τι προσπαθεί να τροποποιήσει τον συνολικό πυρήνα προγραμματισμού που συνθέτει το WordPress. Ορίζοντας ως πρόγραμμα ή σύνολο λειτουργιών γραμμένο σε PHP, τα πρόσθετα προσθέτουν συγκεκριμένες λειτουργίες που μπορούν εύκολα να ενσωματωθούν στο blog μέσω του API WordPress.

Αν έχετε γράψει ένα WordPress plugin, μπορείτε να το καταστήσετε πολύ πιο προσιτό μεταφράζοντάς το σε άλλη γλώσσα. Αυτό είναι γνωστό ως διεθνοποίηση.

Διεθνοποίηση έναντι εντοπισμού

Πριν μπορέσετε να διεθνοποιήσετε το plugin σας, πρέπει να ξέρετε τι σημαίνει. Επίσης γνωστό ως i18n, αυτό σημαίνει ότι τροποποιείτε το plugin, έτσι ώστε άλλοι πολιτισμοί που μιλούν άλλες γλώσσες να μπορούν εύκολα να χρησιμοποιήσουν το plugin σας.

Ο εντοπισμός, αντίθετα, είναι η πραγματική διαδικασία τροποποίησης.

Υπάρχουν περισσότερα για τη διεθνοποίηση απ'ότι απλώς μεταφράζουμε τη διεπαφή. Για παράδειγμα, οι υποθέσεις που κάνατε σχετικά με τις αυτοκρατορικές μονάδες και τις μετρικές μονάδες, πρέπει να αντιμετωπιστούν οι στίγματα, όπως η χρήση κόμματος για να διαχωρίσετε χιλιάδες αντί για μια περίοδο, καθώς και άλλα πολιτιστικά θέματα, προτού μπορέσετε να εντοπίσετε σωστά την εργασία σας.

Αν και αυτός είναι ένας οδηγός που απευθύνεται στην προετοιμασία για να εντοπίσει ένα plugin, είναι ακόμα σημαντικό να έχουμε υπόψη αυτές τις πρόσθετες προσαρμογές.

Τομείς και αρχικοποίηση

Η τοποθέτηση του plugin σας σημαίνει ότι πρέπει να βρείτε έναν τομέα κειμένου, διατηρώντας το κάθε ένα ξεχωριστά από αυτά που χρησιμοποιεί το WordPress ή που έχουν ορίσει άλλα πρόσθετα. Ό, τι θέλετε να χρησιμοποιήσετε για έναν τομέα κειμένου είναι κάτω από σας, αλλά θα θέλετε να διαλέξετε κάτι τόσο μοναδικό όσο και λογικό, σχετικά με το περιεχόμενο του plugin σας.

Για να μπορέσετε να εντοπίσετε πλήρως το plugin σας, πρέπει να το κάνετε να λέει στο WordPress πώς μπορεί να βρει τις χορδές σας. Αν ο κώδικας δεν υπάρχει ήδη, θα πρέπει να εισαγάγετε κάτι παρόμοιο με την ακόλουθη γραμμή στην κωδικοποίηση: 

add_action( 'init', 'myFunction' );

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

function myFunction() {load_plugin_textdomain( 'mytextdomain', 'wp-content/plugins' );}

Η συνάρτηση WordPress load_plugin_textdomain ενημερώνει το WordPress ότι υπάρχει ένας τομέας κειμένου που ονομάζεται mytextdomain και τα αρχεία που έχουν τις εντοπισμένες συμβολοσειρές να βρίσκονται στο φάκελο του διακομιστή wp-content / plugin. (Φυσικά, αν βάλεις τα αρχεία plugin σε διαφορετικό φάκελο και διαδρομή, θα πρέπει να το αντικαταστήσεις με την κατάλληλη διαδρομή.)

Flags

Διεθνής εικόνα μέσω Shutterstock.

Προετοιμασία χορδών

Μετά την αρχικοποίηση, θα χρειαστεί να αλλάξετε τις στατικές συμβολοσειρές σε μια λειτουργία που επιτρέπει στο WordPress να χρησιμοποιήσει την κατάλληλη εντοπισμένη έκδοση αυτής της συμβολοσειράς. Μετά από όλα, δεν λειτουργεί καλά για να έχει το WordPress να τραβήξει λάθος γλώσσα.

Αυτή η λειτουργία προσφέρει ένα σύντομο όνομα που διευκολύνει τη διεθνοποίηση: η λειτουργία διπλού υποβόλου (string, domain). Η συνάρτηση έχει δύο παραμέτρους, η πρώτη είναι η προεπιλεγμένη συμβολοσειρά που χρησιμοποιεί το plugin αν δεν υπάρχει διαθέσιμη τοπική έκδοση. Η δεύτερη παράμετρος είναι ο ίδιος τομέας κειμένου που έχετε επιλέξει στον κώδικα νωρίτερα.

Πριν από αυτό το βήμα, ο κώδικας μπορεί να εμφανίζεται ως εξής: 

function addMyAdminPage() {add_options_page('A Page Title','A Menu Title',7, __FILE__, 'myAdminFunction' );}

Μετά την προσθήκη του κώδικα, μπορεί να φαίνεται σαν εξής: 

function addMyAdminPage() {add_options_page(__( 'A Page Title', 'textdomain' ),__( 'A Menu Title', 'textdomain' ),7, __FILE__, 'myAdminFunction' );}
Flags

Διεθνής εικόνα μέσω Shutterstock.

Εντοπισμός

Με όλη την προετοιμασία έξω από το δρόμο, είστε τελικά προετοιμασμένοι για την πραγματική διαδικασία μετατροπής του WordPress plugin σας σε πολλές γλώσσες.

Η δημιουργία ενός εντοπισμού για το plugin σας απαιτεί την δημιουργία ενός αρχείου .po με ένα όνομα παρόμοιο με το όνομα του αρχείου προσθήκης καθώς και με τους κωδικούς ISO 2 9 γράμματα για κάθε χώρα και γλώσσα. Για παράδειγμα, εάν το plugin σας ονομάστηκε examplename και θέλετε να το εντοπίσετε στην ισπανική (ευρωπαϊκή), θα εμφανίζεται ως "examplename-es_ES.po".

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

msgid "Options"msgstr "Opciones"

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

Αφήνοντας τους άλλους μεταφραστές να βοηθήσουν

Κανείς δεν γνωρίζει κάθε γλώσσα, οπότε θα θελήσετε να επεκτείνετε τους πόρους σας και να αφήσετε άλλα άτομα να μεταφράσουν σε άλλες γλώσσες. Ωστόσο, θα χρειαστεί να υποβάλετε μια ειδική διαδικασία για να δημιουργήσετε τα απαραίτητα αρχεία που θα δώσετε στους μεταφραστές σας, αφού δεν θέλετε να έχουν ο πηγαίος κώδικας σας να σπάσει τυχαία.

Το αρχείο που θέλετε να δώσετε στους μεταφραστές είναι ένα αρχείο POT, το οποίο μοιάζει με αυτό: 

#: wp-admin/admin-header.php:49msgid "Options"msgstr ""

Υπάρχουν δύο τρόποι δημιουργίας αυτού του αρχείου. Εάν έχετε τοποθετήσει την προσθήκη σας στο αποθετήριο, απλά πηγαίνετε στη σελίδα διαχειριστή και επιλέξτε "Δημιουργία αρχείου POT". Αυτό το αρχείο είναι αυτό που θα στείλετε στους μεταφραστές για να τα εντοπίσετε, αν και πιθανότατα θέλετε να στείλετε το plugin μαζί του, έτσι οι μεταφραστές δεν χρειάζεται να σας κάνουν ερωτήσεις σχετικά με το plugin.

Αν δεν έχετε ακόμα το plugin σας στο αποθετήριο, μπορείτε να το επισκεφθείτε Ο κατάλογος εργαλείων WordPress I18n και χρησιμοποιήστε το script makepot.php με τον ακόλουθο τρόπο: 

php makepot.php wp-plugin the-plugin-directory

Λάβετε υπόψη ότι θα χρειαστεί να εγκαταστήσετε το πακέτο βοηθημάτων διεθνοποίησης GNU στον διακομιστή σας πριν εκτελέσετε αυτήν την εντολή.

Flags

Διεθνής εικόνα μέσω Shutterstock.

Δοκιμές

Με όλα τα localized αρχεία σας στη θέση τους, ήρθε η ώρα να τα δοκιμάσετε και να δείτε αν υπάρχει κάτι που ξεχάσατε. Η δοκιμή του εντοπισμού σας σημαίνει ότι αλλάζετε μια απλή γραμμή στη διαμόρφωσή σας στο WordPress για να το ξεγελάσετε να σκέφτεστε ότι θα έπρεπε να χρησιμοποιήσει ένα διαφορετικό αρχείο. Αλλάξτε το αρχείο wp-config και εντοπίστε την ακόλουθη γραμμή: 

define ('WPLANG', 'en_US');

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

define ('WPLANG', 'es_ES');

Τέλος, ενεργοποιήστε την προσθήκη σας για να ελέγξετε πώς φαίνεται. Θυμηθείτε να επιστρέψετε στην αρχική προεπιλεγμένη γλώσσα μόλις ολοκληρώσετε τη δοκιμή.

Ενημέρωση της προσθήκης σας

Με όλες τις αλλαγές που κάνει το WordPress με την πάροδο του χρόνου, το plugin σας ενδέχεται να μην είναι πλήρως λειτουργικό με τις επόμενες ενημερώσεις. Βεβαιωθείτε ότι έχετε πάντοτε το χρόνο να ενημερώσετε το plugin σας όποτε είναι δυνατόν. Υποθέτοντας ότι έχετε ήδη φιλοξενήσει στο WordPress Plugin Plugin, μπορείτε να κάνετε κάποια βήματα για να προσθέσετε νέες δυνατότητες ή να ενημερώσετε τις ενημερώσεις κώδικα στο plugin σας με την πάροδο του χρόνου. Μπορείτε να το κάνετε αυτό όσο συχνά θέλετε.

Όταν ολοκληρώσετε την ενημέρωση της προσθήκης σας και θέλετε να απελευθερώσετε την πιο πρόσφατη έκδοση, θα πρέπει να έχετε υπόψη σας μια λίστα ελέγχου:

  • Δοκιμάστε το πρόσθετο και βεβαιωθείτε ότι η πιο πρόσφατη έκδοση λειτουργεί σωστά. Βεβαιωθείτε ότι έχετε κατά νου όλες τις διαφορετικές εκδόσεις WordPress που υπάρχουν και δοκιμάστε τις με κάθε έκδοση όσο το δυνατόν. Μην δοκιμάζετε απλώς καινούργια χαρακτηριστικά δεδομένου ότι ενδέχεται να σπάσετε τυχαία τα παλαιότερα χαρακτηριστικά.
  • Μεταβείτε στο φάκελο κορμού και τροποποιήστε το σχόλιο κεφαλίδας στο κύριο αρχείο PHP, ώστε να μπορείτε να ενημερώσετε τον αριθμό έκδοσης. Βεβαιωθείτε ότι αλλάζετε επίσης τον αριθμό έκδοσης στο αρχείο readme.txt στο φάκελο κορμού στο σταθερό πεδίο ετικέτας.
  • Είναι πάντα συνετό να δημιουργήσετε μια άλλη υποδιαίρεση της περιοχής changelog του αρχείου readme.txt, ώστε να μπορείτε να περιγράψετε εν συντομία τι νέο υπάρχει στην πιο πρόσφατη έκδοση σε σχέση με την προηγούμενη έκδοση. Ό, τι βάζετε εδώ θα προστεθεί στην καρτέλα καταγραφής αλλαγών στη σελίδα για το plugin σας.
  • Βεβαιωθείτε ότι έχετε δημιουργήσει μια νέα ετικέτα SVN ως τμήμα του κορμού.
  • Αφήστε μερικά λεπτά για να καταχωρίσει το σύστημα τις νέες αλλαγές και, στη συνέχεια, κατευθυνθείτε στη σελίδα του plugin σας και σε ένα blog που έχει εγκαταστήσει το νέο σας plugin για να επαληθεύσετε ότι όλα ενημερώνονται σωστά. Έχετε υπόψη ότι αυτοί οι έλεγχοι ενημερώσεων μπορούν να αποθηκευτούν προσωρινά, οπότε ίσως χρειαστεί να περιμένετε λίγο περισσότερο για να ενημερωθεί πλήρως.

Γενικά, δεν υπάρχει τίποτα άλλο για τη διεθνοποίηση του plugin σας σε διαφορετικές γλώσσες. Εφόσον ακολουθείτε προσεκτικά αυτά τα βήματα, μπορείτε να εντοπίσετε το plugin σας σε όσες διαφορετικές γλώσσες χρειάζεστε.

Έχετε εντοπίσει ένα plugin WordPress; Ποιες γλώσσες επιθυμούν υποστηρίζονται συχνότερα; Ενημερώστε μας στα σχόλια.

οικοδόμηση plug-ins του wordpress wordpress i18n wordpress διεθνοποίηση wordpress γλώσσες wordpress localization τα αρχεία δοχείων wordpress