PartGrid.ai
Documentation menu

Giao diện nội dung nhúng

Kiểm soát giao diện nội dung nhúng bằng các chủ đề được gán và biến CSS được hỗ trợ để mỗi trình xem công khai phù hợp với đúng bối cảnh thương hiệu.

Cách giao diện nội dung nhúng hoạt động

Giao diện nội dung nhúng kiểm soát hệ thống hình ảnh mà trình xem PartGrid sử dụng trên cửa hàng, cổng thông tin, bộ sưu tập và trải nghiệm đại lý. Tạo giao diện có thể tái sử dụng trong Theme Library, xuất bản phiên bản cần dùng và gán ghi đè khi một bộ sưu tập cần khác giao diện mặc định.

Quyền

Quyền với giao diện được tách riêng cho việc xem, tạo, chỉnh sửa, xóa, gán và tạo đề xuất giao diện. Các điều khiển không được vai trò của bạn cho phép sẽ bị ẩn hoặc vô hiệu hóa. Xem Tạo và quản lý vai trò để kiểm tra hoặc thay đổi quyền này.

Mở Theme Library

Mở Theme Library từ bảng điều khiển hoặc Integrations → Embed → Overview. Chọn một giao diện hiện có để chỉnh sửa hoặc tạo một giao diện có thể tái sử dụng nếu hệ thống hình ảnh cần thiết chưa tồn tại.

Thiết lập trong Basic mode

  • Brand colors: Đặt màu primary, accent, background, surface, text, muted và border.
  • Typography: Chọn phông chữ tiêu đề và nội dung, cỡ cơ bản, chiều cao dòng, kiểu chữ hoa/thường và độ đậm của tiêu đề.
  • Layout and spacing: Kiểm soát chiều rộng nội dung, nhịp khoảng cách giữa các phần, mật độ và cường độ chuyển động.
  • Shape and surfaces: Cấu hình bo góc, ghi đè panel và control, bóng đổ, page style, panel style và color mode.
  • Component styles: Chọn cách hiển thị cho card, button, input, badge, navigation, table, tab và dropdown.
  • Semantic surfaces: Đặt màu dùng chung cho canvas của trình xem, panel, trạng thái active và navigation.
  • Annotations and markers: Đặt kiểu đường, hotspot, outline và active glow cho tương tác bản vẽ phân rã.

Tạo bản nháp từ website

Khi vai trò cho phép tạo đề xuất giao diện, nhập Website URL và tùy chọn Logo URL, các trang bổ sung cùng ghi chú. Chọn Generate draft, xem lại nội dung PartGrid đã trích xuất và điều chỉnh trước khi xuất bản.

Phiên bản giao diện

Giao diện đang hoạt động và bản nháp

Gán giao diện cho nội dung nhúng

Đặt giao diện mặc định cần dùng trong Theme Library, sau đó mở Integrations → Embed → Theme selection. Bộ sưu tập và bộ sưu tập đại lý sử dụng giao diện nhúng mặc định trừ khi bạn chọn một giao diện khác cho đúng đối tượng đó.

Cách áp dụng giao diện

  • Default: Được dùng khi bộ sưu tập hoặc bộ sưu tập đại lý không có ghi đè.
  • Collection override: Áp dụng giao diện đã chọn cho một nội dung nhúng bộ sưu tập.
  • Dealer collection override: Áp dụng giao diện đã chọn cho một trải nghiệm đại lý được gán.
  • Để bỏ ghi đè, chọn lại giao diện mặc định.

Sử dụng Advanced mode

Chọn Advanced mode để chỉnh sửa toàn bộ giao diện đã được chuẩn hóa dưới dạng JSON. Active theme JSON kiểm soát phiên bản đang hoạt động. Draft token JSON kiểm soát phiên bản bản nháp riêng.

Quy trình Advanced

  1. Chọn Advanced mode trong trình chỉnh sửa giao diện.
  2. Chỉ chỉnh Active theme JSON khi trải nghiệm đang hoạt động cần thay đổi trực tiếp; dùng Draft token JSON để chuẩn bị thay đổi cần rà soát.
  3. Giữ JSON hợp lệ. PartGrid sẽ từ chối JSON giao diện không hợp lệ thay vì lưu lại.
  4. Dùng Reset JSON để khôi phục trình chỉnh sửa về các giá trị active hoặc draft hiện đang được tải.
  5. Chọn Save theme, Save draft hoặc Publish draft tùy theo phiên bản bạn đã chỉnh sửa.
  6. Xem trước bản vẽ hoặc bộ sưu tập bị ảnh hưởng trước khi phân phối rộng hơn.

Biến CSS ổn định

Với các hợp đồng tùy biến giao diện đã được phê duyệt, --pf-primary là biến nhúng ổn định hiện được tài liệu hóa. Các khóa giao diện và biến thời gian chạy khác không được hỗ trợ như hợp đồng tích hợp cửa hàng trừ khi PartGrid tài liệu hóa riêng.

Kiểm tra giao diện

Xem trước bản vẽ hoặc bộ sưu tập bị ảnh hưởng rồi kiểm tra trên chính trang cửa hàng hoặc cổng thông tin thực tế. Kiểm tra độ tương phản, typography, panel, control, hotspot, thẻ phụ tùng, bố cục responsive và hành động của khách hàng.

Danh sách kiểm tra

  • Xác nhận giao diện mặc định hoặc ghi đè bộ sưu tập mong đợi đã được chọn.
  • Xác nhận phiên bản đang hoạt động dự kiến đã được xuất bản.
  • Kiểm tra cả bố cục desktop và mobile.
  • Kiểm tra giao diện trong cửa hàng hoặc cổng thông tin thực tế, không chỉ trong Theme Library.
  • Quay lại bản nháp khi các thay đổi bổ sung chưa nên ảnh hưởng đến trình xem đang hoạt động.
Giao diện nội dung nhúng | PartGrid documentation