Duy trì khả năng tương thích của WPBakery Page Builder với WPML

Khả năng tương thích của WPBakery Page Builder với WPML được đảm bảo thông qua tệp cấu hình ngôn ngữ. Tìm hiểu cách sử dụng tệp này để duy trì khả năng tương thích.

Trang này dành cho nhóm phát triển WPBakery, các nhà phát triển cung cấp phiên bản tùy chỉnh của trình tạo trang, các nhà phát triển tạo tiện ích bổ sung cho WPBakery và các nhà phát triển web sử dụng WPBakery Page Builder.

Nếu bạn là khách hàng đang tìm cách dịch một trang web được xây dựng bằng WPBakery, vui lòng xem tài liệu chi tiết của chúng tôi để tìm hiểu thêm về cách xây dựng các trang web đa ngôn ngữ bằng WPBakery Page Builder và WPML.

Cách thức hoạt động của việc tích hợp WPBakery Page Builder với WPML

Để hiểu cách WPBakery Page Builder hoạt động với WPML, chúng ta sẽ bắt đầu bằng cách tạo một trang đơn giản bằng WPBakery Page Builder. Chúng tôi sẽ đưa vào một vài module, chẳng hạn như Text Block, Message Box và Hover Box.

Để dịch trang chúng ta đã tạo, hãy nhấp vào biểu tượng dấu cộng nằm trong hộp meta Ngôn ngữ ở thanh bên phải.

Điều này sẽ đưa bạn đến màn hình Trình biên tập dịch thuật nâng cao, nơi bạn có thể dịch trang của mình. Điền bản dịch cho từng câu và xác nhận chúng bằng cách nhấp vào dấu kiểm màu xanh lá cây. Khi bạn hài lòng với tất cả các bản dịch của mình, hãy nhấp vào Hoàn thành.

Cập nhật tệp cấu hình ngôn ngữ

Bạn có thể cần cập nhật các shortcode của trình tạo trang trong tệp cấu hình ngôn ngữ vì nhiều lý do khác nhau:

1. Thêm một shortcode mới vào trình tạo trang
2. Thêm một thuộc tính mới vào shortcode hiện có
3. Xóa một shortcode đã 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. Thêm các shortcode hoặc thuộc tính vào các shortcode hiện có trong tệp cấu hình ngôn ngữ.

Đối với các nhà phát triển giao diện có tích hợp phiên bản tùy chỉnh của WPBakery Page Builder vào giao diện của họ, xin lưu ý rằng bạn sẽ cần cập nhật tệp cấu hình ngôn ngữ của phiên bản plugin tùy chỉnh đó.

Cấu trúc shortcode của trình tạo trang trong tệp cấu hình ngôn ngữ

Để trích xuất các chuỗi văn bản từ các trang được xây dựng bằng WPBakery Page Builder và tải chúng lên màn hình Trình biên tập dịch thuật, chúng ta cần cấu hình WPML để xác định các shortcode và thuộc tính chứa các chuỗi văn bản yêu cầu dịch. Việc này được thực hiện bằng cách thêm một tệp có tên wpml-config.xml, thường được đặt trong thư mục gốc của giao diện của bạn. Đối với WPBakery Page Builder, chúng tôi đang lưu trữ tệp cấu hình ngôn ngữ trên máy chủ của mình. Tệp này được thiết lập để ghi đè tệp cấu hình cục bộ được đặt trong thư mục gốc của WPBakery Page Builder, đảm bảo rằng tệp cấu hình luôn được cập nhật.

Tệp wpml-config.xml cũng được sử dụng để cấu hình các thành phần sau:

1. Trường tùy chỉnh
2. Phân loại tùy chỉnh
3. Văn bản quản trị / wp_options
4. Cấu hình bộ chuyển đổi ngôn ngữ
5. Các shortcode của trình tạo trang

Xem tài liệu chi tiết của chúng tôi để tìm hiểu thêm về cấu trúc và cú pháp của tệp cấu hình ngôn ngữ.

Ví dụ: hãy xem cách chúng tôi đã thêm shortcode Tabs vào tệp wpml-config.xml.

<shortcode>
         <tag>vc_tta_tabs</tag>
         <attributes>
            <attribute encoding="allow_html_tags">title</attribute>
         </attributes>
</shortcode>

Cấu trúc của ví dụ trên có thể được phân tích như sau:

• Tất cả các shortcode được bao bọc bởi thẻ shortcodes (số nhiều) chính.
• Thẻ shortcode bao bọc tất cả các thẻ thuộc về một shortcode duy nhất.
• Thẻ tag xác định tên của shortcode, trong trường hợp này là vc_tta_tabs.
• Các shortcode có thể có một hoặc nhiều thuộc tính; do đó, chúng tôi bao bọc chúng trong thẻ attributes (số nhiều) và sử dụng thẻ attribute (số ít) để xác định tiêu đề của từng thuộc tính. Trong trường hợp này, chúng ta có thuộc tính title.

Đối với các shortcode bao gồm thuộc tính liên kết, bạn có thể làm cho các liên kết nội bộ tự động trỏ đến phiên bản đã dịch của bài viết đó bằng cách sử dụng tùy chọn loại (type) cho thuộc tính. Dưới đây là một ví dụ:

<shortcode>
         <tag>vc_button</tag>
         <attributes>
            <attribute encoding="allow_html_tags">title</attribute>
            <attribute encoding="vc_link" type="link">href</attribute>
         </attributes>
</shortcode>

Thử nghiệm tệp cấu hình ngôn ngữ

Để thử nghiệm 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 bản cài đặt có kích hoạt cả WPBakery Page Builder và WPML. Tải xuống và kích hoạt các tiện ích bổ sung Dịch chuỗi và Dịch phương tiện.
2. Bạn sẽ cần ghi đè tệp cấu hình ngôn ngữ từ xa bằng tệp đã cập nhật. Để thực hiện việc 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, 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 đó. 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 ta sẽ giả định rằng module Call To Action mới được thêm vào WPBakery Page Builder. Thêm nó vào trang và Xuất bản.

4. Nhấp vào biểu tượng dấu cộng để dịch trang. Điều này sẽ đưa bạn đến màn hình Trình biên tập dịch thuật nâng cao.
5. Đảm bảo rằng các thành phần văn bản của module được hiển thị trong Trình biên tập dịch thuật nâng cao.
6. Điền các bản dịch của bạn và xác nhận chúng bằng dấu kiểm màu xanh lá cây. Khi bạn hoàn tất, hãy nhấp vào nút Hoàn thành.

7. 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 văn bản đã dịch, ngụ ý rằng tệp cấu hình ngôn ngữ đã cập nhật đang hoạt động bình thường.

Xin lưu ý rằng các kiểu CSS cho các thành phần trang từ ngôn ngữ gốc được sao chép sang ngôn ngữ dịch. Điều này đảm bảo mọi thứ sẽ hiển thị chính xác giữa các ngôn ngữ. Nếu bạn muốn tắt tính năng này, vui lòng xem bài viết này để được hướng dẫn.

Nếu 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ẽ 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 (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ó.

Xin lưu ý rằng tệp cấu hình ngôn ngữ được lưu trữ trên kho lưu trữ của chúng tôi là dành cho phiên bản mặc định của WPBakery Page Builder. Trong trường hợp bạn đang cập nhật tệp cấu hình ngôn ngữ của một phiên bản tùy chỉnh của WPBakery Page Builder, hãy áp dụng các thay đổi cho tệp cấu hình bên trong thư mục gốc của plugin của bạn.