สปาตาคัส

Spartacus และหน้าร้านแบบประกอบได้

สวัสดีและยินดีต้อนรับ!

README นี้เป็นส่วนหนึ่งของสาขา develop ซึ่งเป็นสาขาการพัฒนาที่ใช้งานอยู่ในที่เก็บ Spartacus ด้วยเหตุนี้ ข้อความต่อไปนี้อาจมีการอ้างอิงถึงผลงานที่กำลังดำเนินการและยังไม่เผยแพร่อย่างเป็นทางการ

ตั้งแต่เวอร์ชัน 2211.19 เป็นต้นไป หน้าร้านแบบประกอบได้ปรับเวอร์ชันให้สอดคล้องกับ SAP Commerce Cloud หน้าร้านแบบประกอบได้รุ่นก่อนหน้านี้คือเวอร์ชัน 6.8 สำหรับข้อมูลเพิ่มเติม โปรดดูที่การเปลี่ยนแปลงหมายเลขการวางจำหน่ายและนโยบายการอัปเดตสำหรับหน้าร้านแบบรวมที่เริ่มในเดือนกุมภาพันธ์ 2024

ตั้งแต่เวอร์ชัน 5.0 เป็นต้นไป “SAP Commerce Cloud, หน้าร้านแบบประกอบได้” เป็นชื่อของการเปิดตัวไลบรารีโปรเจ็กต์ “Spartacus” อย่างเป็นทางการที่เผยแพร่โดย SAP หน้าร้านแบบประกอบที่รองรับอย่างเป็นทางการพร้อมใช้งานสำหรับลูกค้า SAP Commerce Cloud เอกสารประกอบมีอยู่ใน SAP Help Portal

หน้าร้านแบบประกอบได้อิงตามโค้ดโอเพ่นซอร์ส Spartacus และรวมอยู่ในใบอนุญาต SAP Commerce Cloud โดยไม่มีค่าใช้จ่ายเพิ่มเติม หน้าร้านแบบรวมมีนโยบายการอัปเดตแบบไปข้างหน้า

ลูกค้าภายในองค์กรอาจยังคงใช้โอเพ่นซอร์ส Spartacus ได้ สำหรับข้อมูลเพิ่มเติม โปรดดูที่การเผยแพร่ไลบรารี Spartacus ด้วยตนเองโดยใช้โค้ดโอเพ่นซอร์ส

สปาร์ตาคัสคืออะไร?

Spartacus เป็นหน้าร้าน JavaScript แบบลีนและอิงเชิงมุมสำหรับ SAP Commerce Cloud Spartacus พูดคุยกับ SAP Commerce Cloud ผ่าน Commerce REST API โดยเฉพาะ

• เอกสารประกอบมีอยู่ใน SAP Help Portal
• ทดลองใช้หน้าร้าน Spartacus ตัวอย่างบนเว็บไซต์สาธิตสาธารณะของเรา
• คำถามทางเทคนิค? ติดต่อเราได้ที่ Stack Overflow
• คำถามที่ไม่ใช่ด้านเทคนิค? เข้าร่วมพื้นที่ทำงาน Slack ของเรา
• สำหรับรายละเอียดเกี่ยวกับการเปิดตัว 4.0 โปรดดูหน้าข้อมูลการเผยแพร่บน SAP Help Portal

สปาร์ตาคัสคือ...

• ขยายได้ : Spartacus ได้รับการออกแบบมาให้อัปเกรดได้ในขณะที่ยังคงความสามารถในการขยายได้เต็มที่ คุณจะสามารถนำ Spartacus เวอร์ชันใหม่มาใช้ได้โดยการอัปเดตไลบรารี Spartacus ที่เราจะปรับปรุงเป็นประจำ (เพื่อให้แน่ใจว่ารุ่นแรกสามารถขยายและอัปเกรดได้ตามที่เราต้องการ การเปลี่ยนแปลงที่แตกหักมีแนวโน้มที่จะถูกนำมาใช้จนถึงการเปิดตัว 1.0)
• อัปเกรดได้ : รหัส Spartacus ได้รับการเผยแพร่และใช้เป็นไลบรารีและเป็นไปตามแบบแผนการกำหนดเวอร์ชันเชิงความหมาย ด้วยการใช้ไลบรารี Spartacus จึงสามารถอัปเกรดได้สำหรับรุ่นรองและรุ่นแพทช์
• ก้าวหน้า : Spartacus อยู่ในระหว่างการเดินทางเพื่อให้สอดคล้องกับรายการตรวจสอบ Progressive Web Application (PWA) โดยสมบูรณ์ เรามุ่งมั่นที่จะเพิ่มการรองรับคุณสมบัติหลักทั้งหมดของหน้าร้านที่เปิดใช้งาน PWA เพื่อมอบประสบการณ์ที่ดีที่สุดให้กับลูกค้าโดยไม่คำนึงถึงอุปกรณ์หรือสถานที่
• โอเพ่นซอร์ส : Spartacus เป็นโอเพ่นซอร์ส จะได้รับการพัฒนาอย่างต่อเนื่องโดยทีมงาน SAP Commerce Cloud แต่เรายินดีเป็นอย่างยิ่งที่จะต้อนรับผู้ร่วมให้ข้อมูลและส่งเสริมชุมชนการพัฒนาที่ครอบคลุมและกระตือรือร้นสำหรับ Spartacus ดูเอกสารประกอบของเราสำหรับข้อมูลเพิ่มเติม
• ทันสมัย ​​: หน้าร้าน Spartacus เป็นส่วนหนึ่งของการเดินทางครั้งใหม่ที่น่าตื่นเต้นของเราสู่เทคโนโลยีที่ปรับแต่งได้แต่สามารถอัพเกรดได้สำหรับการติดตั้ง SAP Commerce Cloud ดูประสบการณ์ลูกค้า SAP สำหรับข้อมูลเพิ่มเติมเกี่ยวกับ SAP Commerce Cloud

คุณสมบัติหน้าร้าน

Spartacus นำเสนอฟีเจอร์หน้าร้านหลัก เช่น:

• หน้าแรก
• ค้นหา
• หมวดหมู่
• รายละเอียดสินค้า
• หน้ารถเข็น
• กำลังหยิบลงตะกร้า
• ชำระเงิน
• ประวัติการสั่งซื้อ

ดูเอกสารประกอบการเปิดตัวบน SAP Help Portal สำหรับข้อมูลเพิ่มเติม

ความต้องการ

หากคุณกำลังทำงานกับ Spartacus 2211 โปรดดูข้อกำหนดสภาพแวดล้อมการพัฒนาเชิงมุม 2211 บน SAP Help Portal

หากคุณกำลังทำงานกับ Spartacus 6.x โปรดดูข้อกำหนดสภาพแวดล้อมการพัฒนาเชิงมุม 6.x ที่เกี่ยวข้องใน SAP Help Portal

หากคุณกำลังทำงานกับ Spartacus 5.x โปรดดูข้อกำหนดสภาพแวดล้อมการพัฒนาเชิงมุม 5.x ที่เกี่ยวข้องใน SAP Help Portal

สำหรับข้อกำหนดส่วนหลัง โปรดดูเมทริกซ์ความเข้ากันได้ของหน้าร้านแบบรวมได้

หากคุณกำลังทำงานกับ Spartacus 4.x สภาพแวดล้อมการพัฒนา Angular ของคุณควรมีสิ่งต่อไปนี้:

• CLI เชิงมุม: 12.0 หรือใหม่กว่า < 13
• เส้นด้าย: v1.15 หรือใหม่กว่า
• node.js: ต้องใช้เวอร์ชัน 14.15 เวอร์ชัน 12.x สิ้นสุดอายุการใช้งานในวันที่ 30 เมษายน 2022 และ Spartacus ไม่รองรับอีกต่อไป ขอแนะนำอย่างยิ่งให้คุณย้ายหน้าร้าน Spartacus ที่มีอยู่ไปยัง Node.js 14 โดยเร็วที่สุด หากมีปัญหาใดๆ กับ Spartacus และ Node.js 14 โปรดอัปเกรดเป็นรุ่นล่าสุด หากคุณยังคงประสบปัญหากับ Node.js 14 ให้สร้างตั๋วสนับสนุนกับ SAP Spartacus ยังรองรับ Node.js เวอร์ชัน 16.x แต่เวอร์ชันนี้ยังไม่รองรับ Commerce Cloud ใน Public Cloud Builder

หากคุณกำลังทำงานกับ Spartacus 3.x สภาพแวดล้อมการพัฒนา Angular ของคุณควรมีสิ่งต่อไปนี้:

• CLI เชิงมุม: 10.1 หรือใหม่กว่า < 11
• node.js: 12.16.1 หรือใหม่กว่า < 13.0 แนะนำให้ใช้เวอร์ชัน 12.x ล่าสุด
• เส้นด้าย: v1.15 หรือใหม่กว่า

หากคุณกำลังทำงานกับ Spartacus 2.x สภาพแวดล้อมการพัฒนา Angular ของคุณควรมีสิ่งต่อไปนี้:

• CLI เชิงมุม: 9.1 หรือใหม่กว่า < 10
• node.js: 10.14.1 หรือใหม่กว่า < 13.0 แนะนำให้ใช้เวอร์ชัน 12.x ล่าสุด
• เส้นด้าย: v1.15 หรือใหม่กว่า

หากคุณกำลังทำงานกับ Spartacus 1.x สภาพแวดล้อมการพัฒนา Angular ของคุณควรมีสิ่งต่อไปนี้:

• CLI เชิงมุม: v8.0.0 หรือใหม่กว่า, < v9.0.0
• node.js: v10 หรือใหม่กว่า < v12
• เส้นด้าย: v1.15 หรือใหม่กว่า

สำหรับส่วนหลัง จำเป็นต้องใช้ SAP Commerce Cloud เวอร์ชัน 1905 หรือสูงกว่า และแนะนำให้ใช้ SAP Commerce Cloud เวอร์ชัน 2005 หรือใหม่กว่า

หมายเหตุ: คุณสมบัติบางอย่างของ Spartacus จำเป็นต้องมีตำแหน่งข้อมูล API ที่มีอยู่ใน SAP Commerce Cloud เวอร์ชันใหม่กว่าเท่านั้น สำหรับข้อมูลเพิ่มเติม โปรดดูที่ เมทริกซ์ความเข้ากันได้ บน SAP Help Portal

ดาวน์โหลดและติดตั้ง

หากต้องการเริ่มต้นใช้งาน Spartacus แนวทางที่แนะนำคือสร้างแอปพลิเคชันหน้าร้านจากไลบรารีสำเร็จรูป คุณยังสามารถโคลนและสร้างจากแหล่งที่มาได้ แต่การอัปเกรดไม่ใช่เรื่องง่าย

ปัจจุบัน Spartacus สามารถใช้ได้กับอินสแตนซ์ SAP Commerce Cloud ผ่าน Commerce API เท่านั้น

หากต้องการเพิ่มไลบรารี Spartacus ลงในแอปพลิเคชัน Angular อย่างรวดเร็ว คุณสามารถใช้ Spartacus schematics: ng add @spartacus/schematics สิ่งนี้จะตั้งค่าและติดตั้งไลบรารี Spartacus ให้กับโปรเจ็กต์ Angular ของคุณ โปรดตรวจสอบเอกสารแผนงาน Spartacus อย่างเป็นทางการเพื่อดูข้อกำหนดเบื้องต้นและคำแนะนำทั้งหมดเกี่ยวกับวิธีใช้แผนงาน Spartacus

สำหรับคำแนะนำในการตั้งค่าทั้งหมด โปรดดูที่ การตั้งค่าหน้าร้านแบบรวมได้ บน SAP Help Portal

การปรับแต่งและการขยาย Spartacus

เพื่อรักษาคำมั่นสัญญาของเราในเรื่องความสามารถในการอัปเกรด รูปแบบการออกแบบของ Spartacus มีไว้สำหรับฟีเจอร์ที่ไม่ใช่คอร์ที่จะสร้างขึ้นเป็นไลบรารีฟีเจอร์ที่เพิ่มหรือเปลี่ยนแปลงฟังก์ชันการทำงานที่มีให้

เมื่อใช้ Spartacus คุณจะสร้างแอปที่ดึงไลบรารี Spartacus ซึ่งมีทรัพยากรหลักที่จำเป็นในการทำงานกับ SAP Commerce จากนั้นคุณจึงสร้างคุณลักษณะใหม่ที่มีฟังก์ชันการทำงานและเพจแบบกำหนดเอง

เนื้อหาสำหรับเพจ Spartacus ถูกดึงมาจาก SAP Commerce Cloud CMS (Content Management System) เช่น โลโก้ ลิงก์ แบนเนอร์ และเพจแบบคงที่ เราขอแนะนำให้คุณลักษณะที่ขับเคลื่อนด้วยเนื้อหาใหม่เป็นไปตามรูปแบบเดียวกันเพื่อให้ผู้จัดการเนื้อหาสามารถแก้ไขเนื้อหาของหน้าผ่านเครื่องมือ CMS

เอกสารสำหรับการปรับแต่งและการขยาย Spartacus ยังอยู่ระหว่างการพัฒนาและกำลังจะเปิดตัวเมื่อพร้อมใช้งาน

เอกสารการสมัคร Spartacus

เวอร์ชัน 5.x และใหม่กว่า

ดู API หน้าร้านแบบรวมได้

เวอร์ชัน 4.x และเก่ากว่า

เอกสารที่สร้างขึ้นล่าสุดสำหรับไลบรารีแอปพลิเคชัน Spartacus (โมดูล คลาส อินเทอร์เฟซ และอื่นๆ) ได้รับการโฮสต์อยู่ที่นี่: https://sap.github.io/spartacus/

เอกสารประกอบการสมัครมีการกำหนดเวอร์ชันและรวมอยู่ในส่วน สินทรัพย์ ของไลบรารี Spartacus ทุกเวอร์ชัน คุณสามารถดาวน์โหลดเอกสารประกอบสำหรับเวอร์ชันใดเวอร์ชันหนึ่งได้โดยเข้าไปที่ส่วน เนื้อหา ของไลบรารี Spartacus จากรีลีสนั้น จากนั้นคลิกที่ docs.tar.gz หรือ docs.zip หากต้องการค้นหาโฟลเดอร์ Assets สำหรับไลบรารีใดไลบรารีหนึ่ง ให้เข้าไปที่ Released Libraries for Spartacus คลิกลิงก์ของไลบรารีที่คุณสนใจ แล้วเลื่อนไปที่ด้านล่างของหน้า

ตัวอย่างเช่น หากต้องการดาวน์โหลดเอกสารแอปพลิเคชันสำหรับรุ่น 3.4.0 คุณสามารถเข้าถึงโฟลเดอร์ Assets ของไลบรารี @spartacus/[email protected] ได้ที่นี่

หมายเหตุ: ไลบรารี Spartacus รุ่น 1.x และ 2.x ใช้งานได้กับ SAP Commerce เวอร์ชัน 1905 และ 2005 เท่านั้น คุณสมบัติบางอย่าง เช่น การยกเลิกและการคืนสินค้า มีเฉพาะใน SAP Commerce 2005 เท่านั้น เนื่องจากการรองรับ OCC API ที่จำเป็นเท่านั้น มีอยู่ใน SAP Commerce 2005

ข้อจำกัด

เมื่อเผยแพร่ 1.0.0 ขอแนะนำให้ใช้ SAP Commerce 1905 Spartacus ทำงานร่วมกับ SAP Commerce Cloud รุ่น 1808 และ 1811 โดยมีข้อจำกัดบางประการ

นอกจากนี้ Spartacus ยังได้รับการอัปเดตเพื่อให้ทำงานได้ดีกับ SAP Commerce Cloud ที่กำลังจะเปิดตัวเร็วๆ นี้ ซึ่งหมายความว่าคุณสมบัติบางอย่างของ Spartacus อาจใช้งานได้กับ SAP Commerce Cloud รุ่นอนาคตที่ยังไม่เผยแพร่เท่านั้น สิ่งนี้จะถูกบันทึกไว้เมื่อเราเปิดตัว Spartacus เวอร์ชันใหม่

ปัญหาที่ทราบ

ปัญหาที่ทราบได้รับการบันทึกไว้ในระบบการติดตามปัญหาของ GitHub

วิธีการรับการสนับสนุน

Spartacus ได้รับการจัดเตรียม "ตามสภาพ" โดยไม่มีการสนับสนุนอย่างเป็นทางการ

หากต้องการความช่วยเหลือจากชุมชน Spartacus:

• สำหรับคำถามของนักพัฒนา ให้โพสต์คำถามไปที่ Stack Overflow ด้วยแท็ก 'spartacus'

มีส่วนร่วม

Team Spartacus ยินดีรับฟังข้อเสนอแนะ แนวคิด คำร้องขอ และโดยเฉพาะอย่างยิ่งการมีส่วนร่วมของโค้ด

• อ่านเอกสารการมีส่วนร่วมและเรียนรู้วิธีการ:
  • ช่วยเหลือผู้อื่น
  • รายงานปัญหา
  • บริจาครหัสให้กับ Spartacus

สิ่งที่ต้องทำ

การปรับปรุงมากมายกำลังจะมา! งานทั้งหมดจะถูกโพสต์ไปยังระบบติดตามปัญหา GitHub ของเรา ตามที่กล่าวไว้ การปรับปรุงบางอย่างจะหมายถึงการเปลี่ยนแปลงที่ไม่สมบูรณ์ แม้ว่าเราจะพยายามหลีกเลี่ยงการทำเช่นนั้น แต่เราไม่สามารถรับประกันได้ว่าสิ่งนี้จะไม่เกิดขึ้นก่อนการเปิดตัวครั้งแรก

ใบอนุญาต

ลิขสิทธิ์ (c) 2024 SAP SE หรือบริษัทในเครือ SAP สงวนลิขสิทธิ์. ไฟล์นี้ได้รับอนุญาตภายใต้ Apache Software License v. 2 ยกเว้นที่ระบุไว้เป็นอย่างอื่นในไฟล์ LICENSE