Tạo và kích hoạt đoạn mã

Bạn viết đoạn mã trong API Đoạn mã Shopify. API này là một phiên bản của ngôn ngữ lập trình Ruby, do đó, bạn cần có kinh nghiệm lập trình bằng Ruby. Sử dụng Script Editor để tạo, chỉnh sửa, kiểm tra và đăng đoạn mã.

Yêu cầu về gói

Đoạn mã Shopify và ứng dụng Script Editor chỉ dùng được cho các cửa hàng sử dụng gói Shopify Plus. Hiện không thể tải ứng dụng Script Editor xuống từ Shopify App Store nữa.

Vào ngày 30 tháng 6 năm 2026, Đoạn mã Shopify sẽ bị gỡ bỏ và không còn hoạt động. Nếu muốn tiếp tục hỗ trợ các trường hợp sử dụng Đoạn mã Shopify hiện tại, bạn cần chuyển đổi sang các mã thay thế tương thích của Shopify Functions cho các đoạn mã thanh toán, vận chuyển hoặc mục hàng hiện có. Tìm hiểu thêm về việc chuyển từ Đoạn mã Shopify sang Shopify Functions.

Trước khi bắt đầu viết đoạn mã, hãy xem lại các loại đoạn mã (mục hàng, vận chuyển và thanh toán) khác nhau để biết những phương thức mà mỗi loại đoạn mã hỗ trợ. Ví dụ: đoạn mã mục hàng không thể sử dụng các phương thức vận chuyển.

Tại một thời điểm, chỉ có thể đăng một đoạn mã cho mỗi loại. Ví dụ: bạn có thể đăng một đoạn mã mục hàng và một đoạn mã phí vận chuyển, nhưng không thể đăng cùng lúc hai đoạn mã mục hàng.

Các kênh được hỗ trợ

Khi tạo (hoặc chỉnh sửa) đoạn mã, bạn sẽ chọn xem đoạn mã đó chỉ chạy trên cửa hàng trực tuyến hay chạy trên cửa hàng trực tuyến và trong các ứng dụng sau:

• Ứng dụng tùy chỉnh được xây dựng bằng Storefront API, JavaScript Buy SDK, Mobile Buy SDKs (Android và iOS)
• Ứng dụng tùy chỉnh tạo trang thanh toán
• Trình dựng ứng dụng di động Tapcart, Plobal Apps và Vajro

Lưu ý

Đối với các lượt cài đặt ứng dụng diễn ra sau lần cập nhật đoạn mã gần nhất, hãy đăng lại đoạn mã để đảm bảo đoạn mã chạy đúng như dự kiến trong ngữ cảnh của ứng dụng mới cài đặt.

Bạn có thể tìm thấy các ví dụ về đoạn mã phổ biến trong phần mẫu đoạn mã được cung cấp trong Script Editor. Để xem các mẫu này, bạn cần tạo đoạn mã.

Tạo đoạn mã

Để tạo đoạn mã:

Xem lại Shopify Scripts API để tham khảo về cách viết mã cho đoạn mã.

1. Mở Script Editor. Trang tổng quan Đoạn mã sẽ hiển thị danh sách đoạn mã của cửa hàng.
2. Nhấp vào Tạo đoạn mã để bắt đầu tạo đoạn mã mới.
3. Trong hộp thoại Chọn mẫu đoạn mã :
   1. Chọn loại đoạn mã bạn muốn tạo.
   2. Chọn một mẫu ví dụ làm điểm xuất phát hoặc chọn Mẫu trống để bắt đầu viết đoạn mã từ đầu.
   3. Nhấp vào Tạo đoạn mã để tạo đoạn mã theo loại bạn đã chọn.

      Mẹo

      Loại đoạn mã bạn chọn ở đây (Mục hàng, Phí vận chuyển hoặc Cổng thanh toán) sẽ xác định loại đoạn mã và những phương thức mà đoạn mã có thể sử dụng.

4. Trong hộp **Tiêu đề**, nhập tên đoạn mã. Hãy sử dụng tên mang tính mô tả để bạn có thể nhận biết ngay chức năng của đoạn mã. 5. Nhấp vào **Mã** để mở bảng điều khiển **Mã nguồn Ruby**. 6. Nhập mã cho đoạn mã của bạn. Hãy sử dụng [Tài liệu về Shopify Scripts API](/manual/checkout-settings/script-editor/shopify-scripts) làm tài liệu tham khảo. 7. Nhấp vào **Chạy đoạn mã** để chạy đoạn mã. 8. Khi hoàn tất: * nhấp vào **Lưu bản nháp** để lưu bản nháp chưa đăng của đoạn mã * nhấp vào **Lưu và đăng** để tạo và đăng đoạn mã.

Các bước tiếp theo

Sau khi viết xong một đoạn mã, bạn nên kiểm tra và gỡ lỗi trước khi đăng. Bạn cũng có thể cập nhật các tệp mẫu Liquid để cửa hàng phản hồi theo những thay đổi do đoạn mã tạo ra.