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

Nếu bạn hiện đang sử dụng một giao diện riêng tư đượ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 tư trên OS 2.1 và dự định nâng cấp lên OS 3.0 để hưởng lợi từ 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 Riêng Tư OS 2.1	Giao Diện Riêng Tư 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ác 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	Độ linh hoạt hạn chế	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 riêng tư 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ỉ mục 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 riêng tư 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.

Ghi chú:

Plugin có thể khác biệt 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 thực tế.

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à mô-đun.
Sử dụng plugin Dịch đa ngôn ngữ UGC để hỗ trợ di chuyển.
Bắt đầu xác thực từ ngôn ngữ mặc định của thị trường chính.

Ghi chú:

Logic dịch trong trình chỉnh sửa giao diện hầu như không thay đổi.
Chuyển đổi ngôn ngữ vẫn dựa vào mô-đun dịch của 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—khuyến nghị 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.

Lưu ý:

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 thử nghiệm toàn bộ quy trình trong môi trường thử nghiệm trước khi triển khai 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.

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.