Báo cáo bài tập lớn bộ môn các hệ thống thương mại Điện tử tài liệu chỉ dẫn và cách sử dụng các tính năng, module tích hợp thêm, api hệ thống

Tài liệu hướng dẫn sử dụng tính năng, module tích hợp thêm, api hệ thống4 – Tỉ giá chuyển khoản và tỉ giá bán luôn cao hơn tỉ giá mua để ngân hàng thu được lợi nhuận từ việc kinh doanh c

Trang 1

TRƯỜNG ĐẠI HỌC CÔNG NGHỆ

BÁO CÁO BÀI TẬP LỚN

BỘ MÔN CÁC HỆ THỐNG THƯƠNG MẠI ĐIỆN

TỬ

TÀI LIỆU CHỈ DẪN VÀ CÁCH SỬ DỤNG CÁC TÍNH NĂNG,

MODULE TÍCH HỢP THÊM, API HỆ THỐNG

Giảng viên: TS Trần Trọng Hiếu

Sinh viên: Trần Văn Quang – 22021198

Lê Tiến Thực - 2202119Nguyễn Việt Cường - 22021211

Trang 2

Chúng em cam kết rằng “Tài liệu chỉ dẫn và cách sử dụng các tính năng, module tích hợp thêm, API hệ thống” là sản phẩm được hoàn thiện bằng tâm huyết và sự hợp tác của tất cả các thành viên trong nhóm, đảm bảo không sao chép từ bất kỳ nhóm nào khác.

Trần Văn Quang Nguyễn Việt Cường

Lê Tiến Thực

Trang 3

1 Các module được tích hợp thêm 1

1.1 Dự báo thời tiết 1

1.1.1 Giới thiệu 1

1.1.2 Hướng dẫn sử dụng 1

1.2 Bản tin kinh doanh 1

1.3 Tỉ giá tiền tệ 2

1.4 Thanh toán - Momo 3

1.4.3 Hướng dẫn cài đặt 4

1.5 Thanh toán - VNPAY 5

1.6 Thanh toán - ZaloPay 7

1.7 Sitemap 9

1.8 Image Gallery 10

1.9 Cookie Notice 13

1.10 Lazy Loading 13

Trang 4

1.11 Order Detail 14

1.12 Đặt câu hỏi về sản phẩm 15

1.13 Price Decimal Precision 16

1.14 Vietnamese Language Pack 18

2 API Hệ thống 20 2.1 Giới thiệu 20

2.2 Hướng dẫn sử dụng API Magento thông qua Swagger 20

2.2.1 Sử dụng API Magento đối với Guest User 20

2.2.2 Sử dụng API Magento đối với Administrator 22

2.2.3 Sử dụng API Magento đối với bên thứ ba 24

Trang 5

Danh sách hình vẽ

1.1 Module dự báo thời tiết 1

1.2 Module bản tin kinh doanh 2

1.3 Module tỉ giá tiền tệ 3

1.4 Thanh toán bằng Momo 4

1.5 Quét mã QR để thanh toán 4

1.6 Chỉnh sửa tùy chọn cho Momo 5

1.7 Thanh toán bằng VNPAY 6

1.8 Chọn hình thức thanh toán 6

1.9 Chỉnh sửa tùy chọn cho VNPAY 7

1.10 Thanh toán bằng ZaloPay 8

1.11 Quét mã QR để thanh toán 8

1.12 Chỉnh sửa tùy chọn cho ZaloPay 9

1.13 Sitemap 10

1.14 Truy cập vào Image Gallery 10

1.15 Image Gallery 11

1.16 Chia sẻ ảnh 11

1.17 Chỉnh sửa tùy chọn Image Gallery 12

1.18 Cookies Notice 13

1.19 Lazy loading 14

1.20 Order Detail 15

1.21 Chỉnh sửa tùy chọn cho Order Details 15

1.22 Đặt câu hỏi về sản phẩm 16

1.23 Không hiển thị chữ số nằm bên phải dấu thập phân 16

1.24 Số chữ số nằm bên phải dấu thập phân = 1 17

1.25 Simple Price Decimal (Precision) 17

1.26 Ngôn ngữ tiếng việt cho Frontend 18

1.27 Ngôn ngữ tiếng việt cho Backend 18

1.28 Chuyển đổi ngôn ngữ cho Frontend 19

1.29 Chuyển đổi ngôn ngữ cho Backend 19

2.1 API Guest User 21

2.2 Các API trong nhóm customerAccountManagementV1 (Quản lý tài khoản khách hàng)

21 2.3 Request API kiểm tra email anhducpn67@gmail có được liên kết với tài khoản khách hàng trên website có id là 1 hay không? 21

2.4 Response API 22

2.5 Request API integrationAdminTokenServiceV1 22

Trang 6

Tài liệu hướng dẫn sử dụng tính năng, module tích hợp thêm, api hệ thống

42.6 Response API integrationAdminTokenServiceV1 23

Trang 7

2.9 Các API trong nhóm catalogProductRepositoryV1 (API về sản phẩm) 23

2.10 Request lấy danh sách các sản phẩm có category_id = 14 24

2.11 Response lấy danh sách các sản phẩm có category_id = 14 24

2.12 Extensions Integrations trong trang quản trị Admin 25

2.13 Integration Info 25

2.14 New Integration - Tab API 25

2.15 Integration Tokens for Extensions 26

Trang 8

Tổng quan trang web :

 Tên miền truy cập : magento.test

 Nội dung : Trang web chuyên cung cấp các sản phẩm a chất lượng cao, bao gồm cue, bàn

bi-a, bóng bi-a và phụ kiện cho cơ thủ Chúng tôi cam kết mang đến những sản phẩm chính hãng, giúp nâng cao trải nghiệm chơi bi-a cho người mới và cả tay chơi chuyên nghiệp.

 Hình ảnh minh họa :

Trang 9

độ gió, chỉ số UV, và dự báo thời tiết ngắn hạn.

• Dữ liệu về thời tiết được thu thập và cập nhật theo thời gian thực thông qua việc gọi API của OpenWeather, một dịch vụ cung cấp thông tin về thời tiết toàn cầu, giúp đảm bảo tính chính xác và độ tin cậy của thông tin Việc kết nối với OpenWeather API giúp module có thể cung cấp thông tin nhanh chóng và hiệu quả cho người dùng

1.1.2 Hướng dẫn sử dụng

Truy cập vào đường dẫn: /custommodule/weather/index

Hình 1.1: Module dự báo thời tiết

1.2 Các Bản tin kinh doanh

1.2.1 Giới thiệu

• Đây là module cung cấp thông tin nhanh chóng về các bài báo kinh doanh, bao gồm tiêu đề và tóm tắt nội dung, giúp người dùng dễ dàng theo dõi các sự kiện, xu hướng

và thông tin quan trọng trong ngày

• Các bài viết được lấy trực tiếp từ RSS của chuyên mục kinh doanh trên VNExpress, mang đến những tin tức mới nhất và chính xác về các xu hướng và sự kiện trong thế giới kinh doanh

• Truy cập vào đường dẫn: /custommodule/news/index

Trang 10

2

• Tại mỗi bài báo, có thể click chữ "Xem thêm"để được điều hướng tới bài viết gốc trên VNExpress

Trang 11

Hình 1.2: Module bản tin kinh doanh

1.3 Tỉ giá tiền tệ

• Đây là module cung cấp thông tin chi tiết về tỉ giá chuyển đổi giữa VND và các đơn

vị tiền tệ quốc tế như USD, EUR, JPY, GBP, và nhiều đồng tiền khác

• Dữ liệu tỉ giá được cung cấp trực tiếp từ API của trang chủ ngân hàngVietcombank,đảm bảo tính chính xác và độ tin cậy cao, giúp người dùng luôn nhận được thông tin tỉ giá cập nhật theo thời gian thực

• Truy cập vào đường dẫn: /custommodule/currencyexchangerate/index

• Các loại tỉ giá được hiển thị:

– Buy - Tỉ giá mua vào: là tỉ giá ngân hàng mua vào đồng tiền yết giá.

– Transfer - Tỉ giá chuyển khoản: là tỉ giá áp dụng cho các giao dịch thanh toán

bằng các đồng ngoại tệ thông qua chuyển khoản

– Sell - Tỉ giá bán ra: là tỉ giá ngân hàng bán ra đồng tiền yết giá.

Trang 12

4

– Tỉ giá chuyển khoản và tỉ giá bán luôn cao hơn tỉ giá mua để ngân hàng thu

được lợi nhuận từ việc kinh doanh các đồng ngoại tệ

Hình 1.3: Module tỉ giá tiền tệ

1.4 Thanh toán - Momo

Trang 13

Hình 1.4: Thanh toán bằng Momo

• Sau đó tiến hành quét mã QR để thanh toán

Hình 1.5: Quét mã QR để thanh toán

1.4.3 Hướng dẫn cài đặt

• Bước 1: Chạy lệnh composer require boolfly/module-momo-wallet

• Bước 2: Chạy lệnh php bin/magento setup:upgrade

Trang 14

6

• Bước 3: Đăng ký tài khoản momo doanh nghiệp tại đậy để lấy các key cần thiết

• Bước 4: Chỉnh sửa tùy chọn cho module trong trang admin

Hình 1.6: Chỉnh sửa tùy chọn cho Momo

1.5 Thanh toán - VNPAY

Trang 15

Hình 1.7: Thanh toán bằng VNPAY

• Sau đó tiến hành thanh toán bằng hình thức mong muốn

Hình 1.8: Chọn hình thức thanh toán

• Bước 1: Download source code tại đây

• Bước 2: Giải nén và di chuyển source code vào thư mục app/code

Trang 16

8

• Bước 4: Đăng ký dịch vụ tại đây và lấy các key cần thiết

• Bước 5: Chính sửa tùy chọn trong trang admin

Hình 1.9: Chỉnh sửa tùy chọn cho VNPAY

1.6 Thanh toán - ZaloPay

Trang 17

Hình 1.10: Thanh toán bằng ZaloPay

• Sau đó tiến hành quét mã QR để thanh toán

Hình 1.11: Quét mã QR để thanh toán

• Bước 1: Chạy lệnh composer require boolfly/module-zalopay

• Bước 3: Lấy các key để test tại đậy

• Bước 4: Chỉnh sửa tùy chọn cho module trong trang admin

Trang 18

Trang 19

Hình 1.13: Sitemap

• Bước 2: Giải nén và dịch chuyển code vào thư mục app/code

• Bước 3: Enable module trong trang admin

• Truy cập image gallery bằng cách chọn vào nút "IMAGE GALLERY"

Hình 1.14: Truy cập vào Image Gallery

• Chọn gallery tương ứng với sở thích

Trang 20

Trang 21

Hình 1.17: Chỉnh sửa tùy chọn Image Gallery

• Bước 4: Enable module trong trang admin trong mục gallery settings

• Bước 5: Tạo ra các gallery trong mục Manage Gallery

• Bước 6: Thêm các ảnh mình muốn trong mục Manage Images

Trang 22

14

• Bước 7: Gắn các ảnh vào các gallery trong mục Manage Gallery

1.9 Cookie Notice

• Đây là module hiện thị thông báo xin phép sử dụng cookie của người dùng

• Khi truy cập website sẽ hiện thông báo xin phép sử dụng cookie của người dùng để tăng trải nghiệm của người dùng

Hình 1.18: Cookies Notice

• Bước 3: Enable module trong trang admin

Trang 23

Hình 1.19: Lazy loading

• Bước 4: Enable module trong trang admin và config các web page mong muốn sử dụng lazy loading

1.11 Order Detail

Đây là module hiện thị chi tiết về đơn đặt hàng của khách hàng sau khi khách hàng đặt hàng thành công

Trang 24

16

Hình 1.20: Order Detail

• Bước 1: Download source code của module từ đây

• Bước 2: Giải nén và di chuyển source code vào thư mục app/code/

• Bước 4: Truy cập vào admin của magento và chỉnh sửa tùy chọn

Hình 1.21: Chỉnh sửa tùy chọn cho Order Details

1.12 Đặt câu hỏi về sản phẩm

Đây là module cho phép người dùng đặt câu hỏi cho cửa hàng về sản phẩm

Trang 25

Truy cập vào 1 web page về 1 sản phẩm muốn đặt câu hỏi

Hình 1.22: Đặt câu hỏi về sản phẩm

• Bước 1: Download source code của module từ đây

• Bước 2: Giải nén và di chuyển source code vào thư mục app/code/

• Bước 4: Truy cập vào admin của magento và enable modules

1.13 Price Decimal Precision

• Đây là module cho phép quản trị viên cửa hàng thiết lập hiển thị số chữ số nằmbên phải dấu thập phân cho giá sản phẩm và các giá trị tiền tệ khác (chiết khấu,thuế, số tiền bán hàng, v.v.) cả bên frontend và bên backend

Hình 1.23: Không hiển thị chữ số nằm bên phải dấu thập phân

Trang 26

18

Hình 1.24: Số chữ số nằm bên phải dấu thập phân = 1

• Truy cập trang admin, vào Stores -> Configuration -> Catalog

Hình 1.25: Simple Price Decimal (Precision)

• Enable: Bật/tắt module

• Show the decimal?: Hiển thị/Không hiển thị chữ số bên phải dấu thập phân

• Decimal Length: Số chữ số nằm bên phải dấu thập phân muốn hiển thị 1.13.3 Hướng dẫn cài đặt

• Bước 1: Chạy lệnh composer require lillik/magento2-price-decimal

• Bước 3: Enable và config module theo hướng dẫn sử dụng

Trang 27

1.14 Vietnamese Language Pack

• Đây là module cho phép chuyển đổi ngôn ngữ cửa hàng sang tiếng Việt Việc chuyển đổi sẽ bao gồm cả frontend và backend

Hình 1.26: Ngôn ngữ tiếng việt cho Frontend

Hình 1.27: Ngôn ngữ tiếng việt cho Backend

Trang 28

20

Hình 1.28: Chuyển đổi ngôn ngữ cho Frontend

• Chuyển ngôn ngfi tiếng việt ở Backend: Truy cập trang admin, nhấn vào

biểu tượng account admin, chọn Account setting (admin) Locale Options Ở

trường Interface Locale chọn Tiếng Việt (Việt Nam)/Vietnamese (Vietnam) và bấm Save Account

Hình 1.29: Chuyển đổi ngôn ngữ cho Backend

• Bước 1: Chạy lệnh composer require pack:dev-master mageplaza/module-smtp

mageplaza/magento-2-vietnamese-language-• Bước 2: Chạy lệnh php bin/magento setup:static-content:deploy vi_VN

• Bước 3: Chạy lệnh php bin/magento indexer:reindex

• Bước 4: Chạy lệnh php bin/magento cache:clean

• Bước 5: Chạy lệnh php bin/magento cache:flush

• Bước 6: Config như phần hướng dẫn sử dụng

Trang 29

2 API Hệ thống

2.1 Giới thiệu

• API là viết tắt của Application Programming Interface (Giao diện lập trình ứngdụng), cho phép truy cập dữ liệu từ một ứng dụng Nói cách khác, API có thể đượcgọi như một người trung gian giữa một người lập trình và một ứng dụng Khi ngườilập trình tạo một yêu cầu thông qua API, nếu yêu cầu đó được chấp thuận thì dữliệu tương ứng sẽ được trả về

• API là một phần thiết yếu của các ứng dụng thương mại điện tử

2.2 Hướng dẫn sfi dụng API Magento thông qua Swagger

• Magento 2 sử dụng công cụ Swagger được tích hợp sẵn (đi kèm với mỗi phiên bảnMagento 2) để tạo tài liệu REST API ngay lập tức

• Một điểm nổi bật của Swagger đó là ta có thể thực thi API trực tiếp trên trìnhduyệt

• Có 3 loại user có quyền truy cập vào tài nguyên của Magento với các phân quyền khác nhau:

– Guest User truy cập vào tài nguyên Magento với quyền anonymous.

– Administrator truy cập vào các tài nguyên của Magento với quyền được cấu

hình ở admin

– Customer truy cập vào các tài nguyên với quyền self hoặc anonymous 2.2.1 Sfi dụng API Magento đối với Guest User

• Để có thể sử dụng Swagger, cần truy cập vào swagger bằng cách thêm từ

“swagger” vào sau URL website: http://shoptechnologydtd.store/swagger

• Khi bạn đã truy cập vào trang swagger thì bạn có thể thấy các API có sẵn choGuest User

Trang 30

22

Hình 2.1: API Guest User

Hình 2.2: Các API trong nhóm customerAccountManagementV1 (Quản lý tài khoản

khách hàng)

• Ví dụ: Sử dụng API /V1/customers/isEmailAvailable để kiểm tra một

email có được liên kết với tài khoản khách hàng trên trang web hay không Tìm API

/V1/customers/isEmailAvailable tại trang swagger và nhấn vào button Try it

out và nhập vào các thông số cần thiết:

Hình 2.3: Request API kiểm tra email anhducpn67@gmail có được liên kết với tài

khoản khách hàng trên website có id là 1 hay không?

Trang 31

Hình 2.4: Response API

2.2.2 Sfi dụng API Magento đối với Administrator

• Khi bạn truy cập vào trang swagger thì bạn chỉ thấy được các method có sẵn choGuest User Để truy cập được các method dành cho Administrator bạn cần tạo mộttoken Tìm integrationAdminTokenServiceV1 tại trang swagger và nhấn vào button

Try it out và nhập vào các thông số cần thiết:

Hình 2.5: Request API integrationAdminTokenServiceV1

Tiêu đề	Báo cáo bài tập lớn bộ môn các hệ thống thương mại điện tử tài liệu chỉ dẫn và cách sử dụng các tính năng, module tích hợp thêm, api hệ thống
Tác giả	Trần Văn Quang, Lê Tiến Thực, Nguyễn Việt Cường
Người hướng dẫn	TS Trần Trọng Hiếu
Trường học	Đại học Quốc gia Hà Nội
Chuyên ngành	Các hệ thống thương mại điện tử
Thể loại	báo cáo
Năm xuất bản	2024
Thành phố	Hà Nội

Định dạng
Số trang	35
Dung lượng	4,09 MB