Cách tốt nhất để tạo một plugin đã sẵn sàng dịch là gì?
Nó không phải được dịch từ đầu nhưng nó phải dễ dịch để các nhà phát triển đồng nghiệp từ các nền văn hóa khác nhau có thể tham gia vào quá trình bản địa hóa của plugin.
Cách tốt nhất để tạo một plugin đã sẵn sàng dịch là gì?
Nó không phải được dịch từ đầu nhưng nó phải dễ dịch để các nhà phát triển đồng nghiệp từ các nền văn hóa khác nhau có thể tham gia vào quá trình bản địa hóa của plugin.
Câu trả lời:
Không sử dụng echohoặc print()để tạo đầu ra văn bản, thay vào đó hãy sử dụng các chức năng của WordPress __()và _e():
/** Not localization friendly */
echo "Welcome to my plugin";
// OR
print("Welcome to my plugin");
/** Localization friendly */
_e('Welcome to my plugin', 'my-plugin');
// OR
$my_text = __('Welcome to my plugin', 'my-plugin');
echo $my_text;
_e()và __()sẽ cung cấp bản dịch - bằng ngôn ngữ hiện tại - của văn bản được cung cấp làm tham số đầu tiên. _e()sẽ xuất văn bản trong khi __()sẽ trả lại nó.
Tham số thứ hai là miền văn bản , bạn sẽ sử dụng nó để nói với WordPress rằng văn bản được cung cấp làm tham số đầu tiên thuộc về plugin này, bạn có thể sử dụng bất kỳ tên nào bạn muốn nhưng tôi thích sử dụng cùng tên như tôi đã sử dụng cho plugin tập tin của thư mục, tôi thấy nó trực quan hơn.
Với __()và sprintf():
/** Get the username */
$username = 'Magictrick';
/** Not localization friendly */
echo "Hello $username";
/** Localization friendly */
printf(__('Hello %s', 'my-plugin'), $username);
// OR
$my_text = sprintf(__('Hello %s', 'my-plugin'), $username);
echo $my_text;
Định nghĩa
Mở Poedit và tạo một danh mục mới (Tập tin Catallog mới ...) với các cài đặt sau:
..., (chúng tôi sẽ lưu trữ tệp ngôn ngữ trong thư mục con plugin được gọi là ngôn ngữ)__và_eLưu danh mục dưới dạng và quét các tệp plugin của bạn để tìm văn bản có thể dịch bằng cách nhấn nút cập nhật. Khi cập nhật kết thúc đóng danh mục đó, bạn sẽ không cần cập nhật tệp đó trừ khi bạn thêm các chuỗi có thể dịch mới (nghĩa là được bao trong hoặc ) vào plugin của bạn./my_wordpress_blog/wp-content/plugins/my-plugin/languages/my-plugin.pot__()_e()
Bây giờ, hãy tạo bản dịch đầu tiên (tôi sẽ sử dụng fr_FR):
Sử dụng Podeit , tạo một danh mục từ tệp POT (Tập tin Danh mục mới từ tệp POT ...) :
Lưu danh mục như . Dịch một số hoặc tất cả các chuỗi, lưu lại tệp .po, tải lên cả tệp .po và .mo./my_wordpress_blog/wp-content/plugins/my-plugin/languages/my-plugin-fr_FR.po
Lưu ý rằng bất cứ khi nào bạn lưu tệp .po, tệp .mo được tạo cùng tên, tên tệp của tệp .po là rất quan trọng , nó bao gồm sự kết hợp của miền văn bản plugin (my-plugin) và ngôn ngữ địa phương ( fr_FR), luôn đặt tên tệp .po của bạn cho các plugin như thế này: [textdomain] - [locale] .po , đây là một số ví dụ:
wpcf7-it_IT.powpcf7-pt_BR.powpcf7-ar.po... Vâng!Bất cứ khi nào plugin được cập nhật với văn bản mới, hãy cập nhật tệp po, dịch chuỗi mới và tải lại các tệp .po và .mo
Ở đâu đó trong plugin của bạn, bạn phải bảo WordPress sử dụng tệp .mo của mình, bạn có thể làm điều đó bằng cách sử dụng mã này vào đầu tệp plugin của mình:
function my_plugin_init() {
load_plugin_textdomain( 'my-plugin', false, 'my-plugin/languages' );
}
add_action('init', 'my_plugin_init');
Thay thế my-pluginbằng tên plugin của bạn trong tham số thứ 1 và thứ 3 của load_plugin_textdomainhàm.
Một số lý do nó có thể không hoạt động:
_e('my text')bằng _e('my text', 'my-plugin'))Câu trả lời của Nabil khá đầy đủ nhưng có một biến thể dễ dàng được cung cấp:
Plugin của bạn nằm trong kho plugin của WordPress.org
Bạn sẵn sàng yêu cầu plugin của bạn chỉ hoạt động với WordPress 4.6 trở lên.
Các bước là:
Trong tệp readme.txt của plugin, hãy thêm
Requires at least: 4.6. Xem https://developer.wordpress.org/plugins/wordpress-org/how-your-readme-txt-works/
nếu chưa, hãy tải plugin của bạn lên kho lưu trữ plugin WordPress. Xem https://wordpress.org/plugins/developers/add/ .
Tìm tên miền sên / văn bản của plugin của bạn. Để làm điều đó, hãy truy cập trang plugin của bạn trên kho lưu trữ plugin WordPress. URL sẽ giống như https://wordpress.org/plugins/your-plugin-slug/ . Đó là phần cuối cùng của URL, tiếng sên-plugin-sên của bạn, là sên của plugin. Đó là những gì bạn sử dụng cho miền văn bản của chức năng dịch.
Sử dụng các chức năng dịch của WordPress trong plugin của bạn (như __e(‘hello’, ‘my-plugin-domain’);). Chỉ cần đảm bảo sử dụng tên miền văn bản plugin chính xác, có được trong bước trước. Xem https://developer.wordpress.org/plugins/i quốc tế hóa / how-to-i quốc tế-your-plugin / để biết thêm thông tin.
Nếu bạn thực hiện các bước trên, WordPress sẽ chăm sóc:
(Trả lời từ bài đăng trên blog của tôi ở đây: https://cmljnelson.blog/2019/01/01/the-really-lazy-way-to-translate-a-wordpress-plugin/ )