Trang này dành cho nhóm phát triển CornerStone và các nhà phát triển web sử dụng trình tạo trang CornerStone. Nó giải thích quy trình duy trì khả năng tương thích của CornerStone với WPML, được thực hiện bằng cách cập nhật tệp cấu hình ngôn ngữ.
Trong phần Đăng ký các widget tùy chỉnh của trình tạo trang để dịch, chúng tôi giải thích chi tiết cách đăng ký các widget tùy chỉnh của trình tạo trang để dịch bằng tệp cấu hình ngôn ngữ. Bây giờ, hãy kiểm tra thông tin cần thiết để thực hiện điều này cho các widget của Cornerstone.
Tìm thông tin đăng ký của widget
Để có thể đăng ký một widget tùy chỉnh của Cornerstone trong tệp wpml-config.xml , trước tiên bạn cần tìm một số thông tin cơ bản về nó.
Bạn có thể dễ dàng lấy thông tin này từ trường tùy chỉnh _cornerstone_data hoặc bằng cách sử dụng một plugin như JSM Show Post Metadata. Plugin này hiển thị siêu dữ liệu của bài viết và các giá trị chưa được tuần tự hóa (unserialized) của chúng trong một hộp meta ở cuối các trang chỉnh sửa bài viết.
Ngoài ra, bạn có thể sử dụng các bước sau để lấy thông tin này:
- Truy cập trang WPML → Cài đặt, cuộn đến phần Dịch trường tùy chỉnh và nhấp vào liên kết Hiển thị trường hệ thống .
- Đặt trường tùy chỉnh _cornerstone_data thành Dịch.
- Tạo một trang mới và chỉ thêm widget CornerStone mà bạn muốn đăng ký. Lưu trang.
- Truy cập WPML → Cài đặt và trong phần Trình biên tập dịch thuật , tạm thời kích hoạt tùy chọn Trình biên tập dịch thuật cổ điển.
- Thử dịch trang bạn đã tạo ở Bước 3 bằng Trình biên tập dịch thuật cổ điển, và bạn sẽ nhận thấy một mảng đã được tuần tự hóa, như thế này:
- Sao chép nội dung của mảng đã được tuần tự hóa.
- Sử dụng công cụ giải tuần tự hóa ưa thích của bạn để xem rõ hơn cách widget xuất nội dung của nó. Trong trường hợp của chúng tôi, chúng tôi đã sử dụng trang web Unserialize.
Dưới đây là giải thích về nội dung của mảng mà bạn sẽ thấy:
- [_type] chứa tên được chèn vào thuộc tính name của thẻ widget.
- Giá trị field sẽ là tên bên trong dấu ngoặc vuông chứa tên của trường. Ví dụ: [testimonial_content] => You are never too old to set another goal or to dream a new dream. Trong trường hợp này, “title” là văn bản bạn cần.
Khi bạn đã có thông tin này, bạn có thể tiến hành đăng ký widget để dịch.
Ví dụ, widget Testimonial đi kèm với Cornerstone mang một cấu trúc tương tự như thế này trên trường tùy chỉnh _cornerstone_data của nó. Với thông tin này, widget nên được đăng ký như sau để WPML có thể phát hiện và dịch:
<wpml-config> <cornerstone-widgets> <widget name="testimonial"> <fields> <field type="Testimonial: Content">testimonial_content</field> </fields> </widget> </cornerstone-widgets> </wpml-config>
Tất nhiên, điều này là không cần thiết vì widget Testimonial đã được WPML đăng ký theo mặc định trong kho lưu trữ của chúng tôi. Nhưng nó đóng vai trò như một ví dụ cho các widget tùy chỉnh của bạn.
Kiểm tra tệp cấu hình ngôn ngữ
Khi bạn đã tạo tệp cấu hình của mình, hãy làm theo các bước sau để kiểm tra xem mọi thứ đã được đăng ký như mong đợi chưa:
- Thiết lập một bản cài đặt có kích hoạt cả CornerStone và WPML. Kích hoạt các tiện ích bổ sung Dịch chuỗi và Dịch phương tiện.
- Bạn sẽ cần ghi đè tệp cấu hình ngôn ngữ từ xa của WPML bằng tệp đã được cập nhật. Để làm điều này, hãy điều hướng đến trang WPML → Cài đặt và nhấp vào tab Cấu hình XML tùy chỉnh. Sao chép nội dung tệp cấu hình ngôn ngữ đã cập nhật của bạn vào trình biên tập, và nhấp vào Lưu.
- Tạo một trang mới và thêm (các) module mới vào đó. Trong trường hợp bạn đã cập nhật một số thuộc tính cho các module hiện có, hãy thêm chúng vào trang. Trong ví dụ này, chúng tôi sẽ giả định rằng module Testimonial mới được thêm vào trình tạo trang CornerStone. Thêm nó vào trang và Xuất bản.
- Nhấp vào biểu tượng dấu cộng để dịch trang. Thao tác này sẽ đưa bạn đến màn hình Trình biên tập dịch thuật.
- Đảm bảo rằng các thành phần văn bản của module được hiển thị trên màn hình Trình biên tập dịch thuật nâng cao.
- Điền văn bản đã dịch của bạn và nhấp vào nút Hoàn thành bản dịch.
- Kiểm tra trang đã dịch trên giao diện người dùng (front-end).
Trang đã dịch hiển thị tất cả các chuỗi đã dịch, điều này ngụ ý rằng tệp cấu hình ngôn ngữ đã cập nhật đang hoạt động bình thường. Trong trường hợp bạn gặp bất kỳ sự cố nào, vui lòng liên hệ với nhóm phát triển khả năng tương thích của chúng tôi. Họ sẽ rất sẵn lòng kiểm tra các sự cố liên quan đến tệp cấu hình ngôn ngữ.
Khi đã hoàn tất các bài kiểm tra, vui lòng gửi yêu cầu hợp nhất (merge request) đến kho lưu trữ của chúng tôi. Các nhà phát triển khả năng tương thích của chúng tôi sẽ nhận được yêu cầu của bạn và xem xét nó.