Hướng Dẫn Di Cư Từ OS 2.1 Lên OS 3.0 Cho Chủ Đề Tùy Chỉnh – Help Center (Beta)

Nếu bạn hiện đang sử dụng một giao diện tùy chỉnh được xây dựng trên OS 2.1 và dự định nâng cấp lên OS 3.0, hướng dẫn này sẽ giúp bạn thực hiện toàn bộ quá trình di chuyển. Nó bao gồm so sánh tính năng, thay đổi cú pháp, tương thích plugin, cấu hình đa ngôn ngữ, di chuyển dữ liệu UGC và các lưu ý quan trọng. Phiên bản này đã được tối ưu hóa để dễ đọc và rõ ràng hơn.

Tổng Quan Lợi Ích Khi Di Chuyển

Khi Nào Nên Sử Dụng:

Điều này áp dụng cho các thương nhân đã phát triển và ra mắt giao diện riêng trên OS 2.1 và dự định nâng cấp lên OS 3.0 để tận hưởng kiến trúc thống nhất hơn, chức năng nâng cao và cải thiện hiệu suất lâu dài.

Khu Vực So Sánh	Giao Diện Tùy Chỉnh OS 2.1	Giao Diện Tùy Chỉnh OS 3.0 (Sau Khi Di Chuyển)
Kiến Trúc Hệ Thống	Hệ thống cũ, sắp ngừng hỗ trợ	Kiến trúc mới với cải tiến liên tục
Cú Pháp Mẫu	Handlebars	Sline (kết xuất nhanh hơn, gỡ lỗi thống nhất)
Đa Ngôn Ngữ/Thị Trường	Hạn chế về tính linh hoạt	Hỗ trợ đầy đủ cho thị trường chính, đa ngôn ngữ
Quản Lý Mẫu	Hỗ trợ mẫu đơn	Quản lý mẫu chính và mẫu phụ
Cấu Hình Module	Tính năng phân tán	Cấu trúc module mạnh mẽ hơn với hỗ trợ lồng nhau
Hiệu Suất Kết Xuất	Cơ bản	Biên dịch nhanh hơn và hiệu suất tốt hơn
Tương Thích Plugin	Phụ thuộc nhiều vào plugin tùy chỉnh	Nhiều tính năng gốc hơn và tích hợp thống nhất
Phát Triển Tương Lai	Chỉ bảo trì	Đổi mới cốt lõi sẽ tập trung vào 3.0

Sự Khác Biệt Cú Pháp và Hướng Dẫn Di Chuyển

Khi di chuyển từ giao diện tùy chỉnh 2.1 sang OS 3.0, bạn sẽ cần chuyển đổi hoàn toàn cú pháp mẫu Handlebars sang Sline. Xem so sánh cú pháp bên dưới:

Mục so sánh		Handlebars (OS 2.1)	Sline (OS 3.0)
Ngữ cảnh dữ liệu		Thủ công hoặc không nhất quán	Cấu trúc dữ liệu thống nhất
Chuỗi	Dấu nháy đơn	Nhiều ký tự:`'str'`	Chỉ dùng cho ký tự đơn: `'a'`
	Dấu nháy kép	Nhiều ký tự:`"str"`	Nhiều ký tự:`"str"`
	Dấu backtick	Không hỗ trợ	Nhiều ký tự: `str`
Phạm vi	`this`	`{{ this.title }}`	`{{ title }}`
	`./`	`{{ ./title }}`	`{{ title }}`
	`../`	`{{ ../title }}`	Không thể truy cập biến trong phạm vi cha
Biểu thức	Chỉ số mảng	`{{ products.[0].title }}`	`{{ products[0].title }}`
Biểu thức	Truy cập biến	`{{ get key (get index products) }}`	`{{ products[index][key] }}`
Chú thích		`{{!-- Đây là một chú thích --}}` `{{#comment}} Chú thích {{/comment}}`	`{{!-- Đây là một chú thích --}}`
Khả năng mở rộng	Trợ giúp	Dòng đơn:`{{capitalize "test"}}` Khối:`{{#if true}} OK {{/if}}`	Thay vào đó sử dụng thẻ/bộ lọc
	Thẻ	Không được hỗ trợ	Tự đóng:`{{#component "a" /}}` Khối:`{{#if true}} OK {{/if}}`
	Bộ lọc	Không được hỗ trợ	`{{ "a,b,c" \| split(",") \| join("-") }}`

Tổng Quan Về Tương Thích Plugin

Khi Nào Sử Dụng:

Nếu các plugin bên thứ ba đã được cài đặt trong giao diện tùy chỉnh 2.1 của bạn, bạn cần xác nhận xem chúng có tương thích với giao diện 3.0 trước khi di chuyển không.

Hành Động Được Khuyến Nghị:

Liệt kê tất cả các plugin đang hoạt động và đối chiếu với danh sách tương thích chính thức.
Tham khảo danh sách tương thích plugin chính thức (có sẵn từ Quản Lý Thành Công Khách Hàng của bạn).
Nếu một plugin chưa được hỗ trợ trong OS 3.0, đánh giá xem liệu một tính năng hệ thống tích hợp có cung cấp chức năng tương đương hay không, hoặc liên hệ với nhà cung cấp plugin để được hỗ trợ.
Đối với các plugin không còn tương thích, hãy cân nhắc gỡ bỏ hoặc phát triển một giải pháp thay thế tùy chỉnh.

Lưu Ý:

Plugin có thể khác nhau về hành vi giao diện người dùng/trải nghiệm người dùng và cấu trúc dữ liệu giữa OS 2.1 và OS 3.0.
Rất khuyến khích kiểm tra kỹ chức năng plugin trên trang thử nghiệm trước khi đưa vào hoạt động chính thức.

Di Chuyển Cấu Hình Đa Ngôn Ngữ

Khi Nào Sử Dụng:

Nếu giao diện 2.1 của bạn có nội dung đa ngôn ngữ, hãy đảm bảo cấu trúc trường dữ liệu vẫn nguyên vẹn trong OS 3.0.

Các Bước:

Xem xét các trường dịch trong tất cả cấu hình văn bản phong phú và module.
Sử dụng plugin Dịch Thuật Đa Ngôn Ngữ UGC để hỗ trợ quá trình di chuyển.
Bắt đầu xác thực từ ngôn ngữ mặc định của thị trường chính.

Lưu Ý:

Logic dịch thuật trong trình chỉnh sửa giao diện hầu như không thay đổi.
Việc chuyển đổi ngôn ngữ vẫn dựa vào module dịch thuật hệ thống.
Cấu trúc văn bản phong phú lồng nhau có thể hoạt động khác trong Sline — nên kiểm tra thủ công.

Di Chuyển Các Thành Phần UGC

Khi Nào Sử Dụng:

Nếu UGC được sử dụng trong giao diện 2.1 của bạn, chúng phải được di chuyển thủ công sang OS 3.0.

Các Bước:

Xuất cấu hình JSON của từng UGC từ trang cài đặt trước khi di chuyển.
Tạo lại cấu trúc thành phần tương ứng trong giao diện OS 3.0.
Nhập các tệp JSON vào các UGC mới và liên kết chúng với giao diện của bạn.

Ghi chú:

Không hỗ trợ di chuyển tự động.
Đảm bảo xuất dữ liệu đầy đủ trước khi bắt đầu.
Sử dụng đặt tên nhất quán để đảm bảo liên kết và hiển thị mượt mà.

Rủi ro và Biện pháp phòng ngừa

Tất cả mã Handlebars phải được viết lại thủ công bằng cú pháp Sline.
Xác nhận tính tương thích của plugin trước và chuẩn bị các phương án thay thế.
Khuyến nghị dành cho các thương nhân có hỗ trợ từ nhà phát triển.
Khuyến cáo mạnh mẽ nên kiểm tra toàn bộ quy trình trong môi trường thử nghiệm trước khi đưa vào hoạt động thực tế.
Tất cả dữ liệu UGC phải được xuất, xây dựng lại và kết nối lại thủ công.

Các câu hỏi thường gặp về di chuyển giao diện OS 2.1 sang 3.0

Q1 Làm thế nào các nhà phát triển giao diện tùy chỉnh OS 2.1 có thể thích ứng với giao diện OS 3.0?

Giao diện OS 3.0 sử dụng cú pháp mẫu Sline mới, vì vậy mã giao diện tùy chỉnh OS 2.1 hiện tại không thể di chuyển trực tiếp — cần phải phát triển lại. Hướng dẫn này sẽ trình bày chi tiết sự khác biệt về cú pháp, tính tương thích plugin ứng dụng, và các bước di chuyển ứng dụng đa ngôn ngữ/UGC Multi-Language Visual Translator appUGC bên dưới.

Bài viết này được dịch bằng AI và có thể chứa sai sót. Để có thông tin chính xác nhất, vui lòng tham khảo phiên bản tiếng Anh gốc.