Tìm hiểu cách duy trì khả năng tương thích của các module Divi với WPML thông qua tệp cấu hình ngôn ngữ wpml-config.xml.
Tài liệu này dành cho nhóm phát triển Divi và các nhà phát triển web sử dụng Divi. Tài liệu giải thích quy trình duy trì khả năng tương thích của Divi Builder 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ữ.
Trang này đề cập đến Divi 5, phiên bản lưu trữ nội dung dưới dạng các khối tương thích với Gutenberg (Divi 4 trước đây sử dụng shortcode).
Cách thức hoạt động của quá trình tích hợp Divi Builder với WPML
Để hiểu cách Divi Builder hoạt động với WPML, hãy bắt đầu bằng cách tạo một trang đơn giản bằng Divi Builder. Chúng tôi đã thêm một vài module trong ví dụ bên dưới, chẳng hạn như Text, Number Counter, Icon, v.v.
Để dịch, hãy truy cập WPML → Bảng điều khiển dịch thuật và tìm trang trong phần Trang. Chọn trang đó và nhấp vào Dịch nội dung của bạn để chọn phương pháp dịch. Nếu bạn có điểm dịch tự động, bạn có thể dịch trang này tự động trong vài phút.
Sử dụng tệp cấu hình ngôn ngữ
Trong tệp wpml-config.xml, bạn có thể cấu hình các thành phần sau:
- Các khối của trình tạo trang
- Trường tùy chỉnh
- Phân loại tùy chỉnh
- Văn bản quản trị / wp_options
- Cấu hình bộ chuyển đổi ngôn ngữ
Để biết thêm thông tin về cấu trúc và cú pháp, hãy xem hướng dẫn về tệp cấu hình ngôn ngữ của chúng tôi.
Lấy tệp cấu hình cho Divi
Việc cấu hình tệp wpml-config.xml sẽ trích xuất các chuỗi văn bản từ các trang được xây dựng bằng Divi Builder và tải chúng lên Trình biên tập dịch thuật nâng cao. Sử dụng tệp này để thêm các loại khối và thuộc tính mới, cũng như xóa các loại khối đã lỗi thời.
Bạn có thể tải xuống tệp cấu hình ngôn ngữ từ kho lưu trữ của chúng tôi và đặt nó vào thư mục gốc của giao diện sau khi cấu hình xong.
Chúng tôi đang lưu trữ tệp cấu hình ngôn ngữ cho Divi trên các máy chủ của mình, do đó tệp này sẽ ghi đè lên tệp cấu hình cục bộ được đặt trong thư mục gốc của Divi. Điều này đảm bảo tệp cấu hình luôn được cập nhật.
Cấu hình các khối trong tệp cấu hình ngôn ngữ
Divi 5 sử dụng cú pháp khối, do đó việc đăng ký các module Divi để dịch tương tự như quy trình dịch các khối Gutenberg:
- Tất cả các định nghĩa khối được bọc bên trong một phần tử cha <gutenberg-blocks>.
- Mỗi khối riêng lẻ được khai báo bằng một phần tử <gutenberg-block>, trong đó thuộc tính type tương ứng với tên đã đăng ký của khối.
- Các trường có thể dịch được khai báo dưới dạng các phần tử con <key>.
Hãy xem ví dụ về module Call to Action của Divi:
<!-- wp:divi/cta {"module":{"title":"CTA","button_text":"Contact Us","button_url":"https://example.com/contact/"}} /-->
Dưới đây là cách nó được cấu hình trong wpml-config.xml:
Ví dụ về xml cho các khối Divi trong tệp cấu hình ngôn ngữ
<gutenberg-blocks>
<gutenberg-block type="divi/cta" translate="1">
<key name="module">
<key name="title" />
<key name="button_text" />
<key name="button_url" type="link" />
</key>
</gutenberg-block>
</gutenberg-blocks>Cấu trúc được phân tích như sau:
- Phần tử <gutenberg-blocks> bọc tất cả các định nghĩa khối.
- Một phần tử <gutenberg-block> định nghĩa một loại khối duy nhất, được xác định bởi thuộc tính type.
translate="1"cho WPML biết để xử lý phần này. - Mỗi phần tử <key> xác định một trường có thể dịch: title và button_text cho các trường văn bản thuần túy, và button_url cho một liên kết.
- Thuộc tính
type="link"cho WPML biết để tự động thay thế URL bằng phiên bản đã dịch của bài viết hoặc trang được liên kết.
Kiểm tra tệp cấu hình ngôn ngữ
Để kiểm tra tệp cấu hình ngôn ngữ đã cập nhật, hãy làm theo các bước sau:
1. Thiết lập một trang web có kích hoạt cả Divi và WPML. Đảm bảo cũng kích hoạt các tiện ích bổ sung Dịch chuỗi và Dịch phương tiện.
2. Để ghi đè tệp cấu hình ngôn ngữ từ xa bằng phiên bản đã cập nhật, hãy điều hướng đến 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 của 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, sau đó nhấp vào Lưu.
3. Tạo một trang mới và thêm (các) module mới vào trang đó. Nếu 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 Button mới được thêm vào Divi Builder. Thêm nó vào trang và sau đó nhấp vào Đăng.
4. Để dịch trang có nút, bạn có thể sử dụng Bảng điều khiển dịch thuật. Một giải pháp thay thế là sử dụng Trình biên tập dịch thuật nâng cao (ATE), điều này có thể hữu ích khi thử nghiệm — nó cho phép bạn xem thẻ module cho mọi thành phần Divi trên trang. Để mở ATE, hãy truy cập vào phần Chỉnh sửa trang và nhấp vào biểu tượng dấu cộng bên dưới Hộp ngôn ngữ ở thanh bên phải.
5. Kiểm tra các thành phần và thêm bản dịch của bạn hoặc cho phép ATE dịch tự động.
Bây giờ, bạn có thể xem trang đã dịch trên giao diện người dùng. Trang đã dịch sẽ hiển thị tất cả các chuỗi văn bản đã dịch, điều này có nghĩa là 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 phải 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ẽ sẵn lòng kiểm tra các sự cố liên quan đến tệp cấu hình ngôn ngữ.
Sau khi hoàn tất các thử nghiệm, vui lòng gửi yêu cầu hợp nhất đế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ó.