Cập nhật 31/03/ 2022
Zoho Marketplace là nền tảng trực tuyến cung cấp các tiện ích và tiện ích mở rộng giúp người dùng nâng hiệu suất làm việc của họ trên nhiều ứng dụng. Người dùng có thể cài đặt các tiện ích mở rộng từ Zoho Marketplace, để xây dựng dựa trên các chức năng thoát của ứng dụng Zoho.
Ngoài các tiện ích mở rộng đã có, giờ đây các nhà phát triển có thể tạo các tiện ích mở rộng toàn diện hơn cho Zoho Mail. Các tiện ích mở rộng này có thể được xây dựng để tích hợp các chức năng của Zoho Mail với các tính năng của ứng dụng bên thứ ba. Điều này giúp người dùng xây dựng các tiện ích mở rộng để phù hợp với các yêu cầu tùy chỉnh.
Khi bạn đã tạo tiện ích mở rộng, bạn sẽ phải gửi nó để được kiểm tra. Sau khi phân tích chức năng, tiện ích mở rộng của bạn sẽ được chấp thuận và sẽ được xuất bản trên Zoho Marketplace, sẽ có sẵn cho tất cả người dùng Zoho cài đặt và sử dụng.
Bạn có thể bắt đầu tạo tiện ích mở rộng của mình trực tiếp từ nền tảng Zoho Sigma bằng cách sử dụng tệp kê khai plugin Zoho Mail được điền sẵn. Ngoài ra, bạn cũng có thể sử dụng ZET CLI để tạo tiện ích mở rộng của mình và sau đó tải tệp lên Zoho Sigma để gửi.
Để bắt đầu, hãy tạo không gian làm việc cho chính bạn trong Zoho Sigma bằng các bước sau:
1. Đăng nhập vào Zoho Sigma
2. Nhập tên không gian làm việc của bạn
3. Nhấp vào Tạo không gian làm việc
Khi bạn đã tạo không gian làm việc của mình, hãy nhấp vào nút Tiện ích mở rộng mới ở góc trên cùng bên phải. Nhập các chi tiết như tên và mô tả và chọn Zoho Mail từ phần Dịch vụ. Sau đó nhấp vào Lưu dưới dạng Bản nháp và làm theo hướng dẫn chi tiết được cung cấp trong trang trợ giúp này để bắt đầu tạo tiện ích mở rộng của bạn trong Sigma.
Giao diện dòng lệnh (CLI) được sử dụng để tạo và đóng gói các widget. Lệnh Zet là CLI được sử dụng để đóng gói các widget cho Zoho Mail.
Để tạo tiện ích con của riêng bạn cho Zoho Mail, bạn phải tải xuống các nút. Bạn có thể tải về từ đây. (Phiên bản dưới 7 không được hỗ trợ)
Bạn có thể xác minh nút bằng cách chạy các lệnh sau:
$ node -v verifies the version of the node.
$ npm -v verifies the version of the npm.
Cài đặt ZET (Zoho Extension Kit) CLI bằng lệnh dưới đây.
$ npm install -g zoho-extension-toolkit@latest
Chạy lệnh ZET bên dưới để xác minh cài đặt. Chi tiết trợ giúp về các lệnh hỗ trợ khác nhau sẽ được hiển thị:
$ zet
Tạo một dự án bằng lệnh sau:
$ zet
Danh sách các dịch vụ Zoho được hiển thị. Chọn Zoho Mail và nhấn Enter.
Bạn sẽ được nhắc cung cấp tên dự án. Nhập tên dự án mà bạn muốn đặt và nhấn Enter.
Khi bạn nhập tên dự án, một thư mục có cùng tên sẽ được tạo trên hệ thống của bạn. Nó chứa tất cả các thư mục, tệp và gói cần thiết.
Điều hướng đến thư mục dự án và mở thư mục "Ứng dụng". Bao gồm các tài nguyên của tiện ích con của bạn vào các thư mục con có liên quan.
Chạy lệnh sau để khởi động máy chủ http chạy cục bộ tiện ích mở rộng của bạn:
$ zet run
Lệnh này sử dụng cổng 5000 của máy cục bộ của bạn. Trước khi khởi động máy chủ, hãy đảm bảo rằng cổng 5000 không bị chiếm dụng.
Để xác minh việc chạy thành công máy chủ, hãy mở URL đã cho trong trình duyệt của bạn:
http://127.0.0.1:5000/
Thực thi lệnh sau để xác thực tiện ích mở rộng của bạn:
$ zet validate
Tiện ích mở rộng của bạn cần tuân theo đặc điểm kỹ thuật được cung cấp bên dưới. Chạy lệnh validate sẽ xác định bất kỳ vi phạm nào đối với các thông số kỹ thuật nếu có. Bất kỳ vi phạm nào như vậy cần được khắc phục trước khi tải lên zip.
Chạy lệnh pack bên dưới để tạo một tệp zip với tất cả các tệp và thư mục cần thiết để chạy tiện ích mở rộng của bạn:
$ zet pack
Zip có trong thư mục dist của thư mục dự án của bạn. Bạn có thể tải tệp zip này lên Marketplace.
Thư mục dự án của tiện ích mở rộng của bạn bao gồm tệp plugin-manifest.json. Tệp này chứa chi tiết cấu hình của tiện ích mở rộng của bạn. Các khóa có trong tệp này cần tuân theo cấu hình sau:
ngôn ngữ: Đây là ngôn ngữ mặc định cho các tiện ích mở rộng. Thư mục dịch trong thư mục dự án của bạn phải chứa tất cả các tệp dịch. Định dạng của tệp phải là "<locale-code> .json".
* dịch vụ: Sản phẩm Zoho mà tiện ích mở rộng của bạn được tạo.
- Trong khi tạo tiện ích mở rộng cho Zoho Mail, khóa dịch vụ sẽ được tự động điền vào tệp kê khai dưới dạng "dịch vụ": "MAIL".
lưu trữ: Giá trị của khóa này phải được đặt là "true" nếu bạn muốn tiện ích mở rộng của mình lưu trữ dữ liệu ứng dụng.
logo: Đường dẫn đến tệp của hình ảnh bạn muốn sử dụng làm biểu trưng cho tiện ích mở rộng của mình. Ví dụ: "apps / images / logo.png"
* mô-đun: Widget là mô-đun được sử dụng cho Tiện ích mở rộng Zoho Mail. Nó là một loạt các chi tiết của tiện ích mở rộng của bạn. Mô-đun widget bắt buộc phải có các thuộc tính sau.
- vị trí: Vị trí của tiện ích con của bạn trong sản phẩm Zoho. Nó phải là "zoho.mail.preview.rightpanel" cho Zoho Mail.
- tên: Tên thư mục dự án của widget của bạn. Nó sẽ được tự động điền.
- url: Đây là đường dẫn được xác định cho tiện ích con của bạn
MANIFEST SAMPLE:
"modules": {
"widgets": [
{
"location": "zoho.mail.preview.rightpanel",
"name": "extension_name",
"url": "/app/widget.html"
}
]
}
trình kết nối: Trình kết nối cho phép bạn tích hợp tiện ích mở rộng của mình với các ứng dụng bên thứ ba. Nhấn vào đây để biết thêm về các trình kết nối.
Khóa kết nối cần có cấu trúc sau
"connectors": [
{
"serviceName": "name_of_the_service"
}
]:
config: Khóa này bao gồm các tham số cần được định cấu hình trong quá trình cài đặt tiện ích mở rộng của bạn. Cấu trúc của khóa cấu hình sẽ như sau:
"config": [
{
"name": "Param name",
"mandatory": "true/false",
"secure": "true/false",
"inputType": "text /dropdown/ checkbox"
"option": [{
"text": "option1"
"value": "1"
}]
}
]
|
Thông số |
Giá trị |
|
name* |
Dữ liệu biểu thị tên thông số |
|
mandatory* |
true - Nếu tham số cần là bắt buộc false - Nếu tham số không cần thiết là bắt buộc |
|
secure* |
true - Nếu các giá trị đã nhập phải được ẩn False - Nếu không cần ẩn các giá trị |
|
inputType* |
text / dropdown / checkbox |
|
Option |
Được sử dụng để biểu thị các tùy chọn khác nhau trong menu thả xuống và các giá trị tương ứng của chúng. |
Bạn có thể kiểm tra cục bộ tiện ích mở rộng của mình bằng một vài bước đơn giản:
1. Mở thiết bị đầu cuối của bạn và điều hướng đến thư mục dự án của bạn.
2. Thực hiện lệnh này để chạy phần mở rộng: zet run
3. Đăng nhập vào tài khoản Zoho Mail của bạn và truy cập URL https://mail.zoho.com/zm/sandbox.do.
4. Đi tới Cài đặt >> Tích hợp >> Không gian dành cho nhà phát triển
5. Mở bảng eWidget bằng cách nhấp vào biểu tượng tích hợp.
6. BẬT công tắc Chế độ nhà phát triển.
Tiện ích mở rộng của bạn đang chạy cục bộ sẽ được liệt kê ở đây để thử nghiệm thêm.
Sau khi tiện ích mở rộng của bạn được đóng gói, bạn cần gửi mã zip đến Zoho Marketplace để được xem xét.
1. Đăng nhập vào tài khoản Zoho của bạn.
2. Truy cập trang web Sigma.
3. Nhấp vào nút Tiện ích mở rộng mới ở góc trên bên phải của trang.
4. Nhập các chi tiết sau:
- Tên - Tên của các tiện ích mở rộng bạn đang gửi
- Mô tả - Mô tả ngắn gọn về tiện ích mở rộng của bạn
- Dịch vụ - Chọn biểu tượng Zoho Mail từ danh sách
5. BẬT chuyển đổi Tải lên tệp hiện có nếu bạn có tệp ZIP của tệp kê khai Plugin để tải lên.
6. Chọn nút Tôi đồng ý với Điều khoản và Điều kiện. và nhấp vào Lưu dưới dạng bản nháp.
7. Cửa sổ trình chỉnh sửa tệp kê khai plugin sẽ mở ra. Lưu bất kỳ thay đổi nào bạn thực hiện và đóng cửa sổ. Tất cả các tiện ích mở rộng sẽ được hiển thị dưới dạng thẻ.
8. Di chuột qua tiện ích mở rộng bạn đang gửi và nhấp vào biểu tượng Chi tiết tiện ích mở rộng.
9. Sau đó nhấp vào nút Công khai ở góc trên bên phải của trang.
10. Cửa sổ bật lên hiển thị ứng dụng sẽ mở ra. Chọn nếu bạn muốn tiện ích mở rộng là Công khai hay Riêng tư và nhấp vào Công khai.
- Riêng tư - Bạn có thể chọn tùy chọn Riêng tư nếu bạn muốn sử dụng tiện ích mở rộng trong một nhóm nhỏ. Tiện ích mở rộng riêng tư chỉ có thể được sử dụng bởi những người mà bạn chia sẻ liên kết cài đặt.
- Công khai - Nếu bạn muốn tiện ích mở rộng của mình được xuất bản trên Zoho Marketplace để khách hàng cài đặt, bạn cần chọn tùy chọn Công khai.
Tùy thuộc vào việc bạn chọn tải lên Riêng tư hay Công khai, dữ liệu bạn được yêu cầu cung cấp trong hai bước đầu tiên sẽ khác nhau. Chúng như sau:
Nhập các chi tiết sau để xuất bản tiện ích mở rộng Công khai trong Zoho Marketplace:
1. Sơ cấp:
- Cung cấp các thông tin sau:
a. Danh mục - Chọn thẻ phù hợp với mục đích và bản chất của tiện ích mở rộng của bạn.
b. Chính sách bảo mật - Nhập liên kết để biết chi tiết về quyền riêng tư của tiện ích mở rộng của bạn.
c. Điều khoản Dịch vụ - Nhập URL của tài liệu Điều khoản Dịch vụ của tiện ích mở rộng của bạn.
- Chọn hộp kiểm Tôi đồng ý với Thỏa thuận nhà cung cấp trên thị trường.
- Nhấn Tiếp theo.
2. Điều kiện tiên quyết:
- Chọn gói định giá mà bạn muốn hỗ trợ tiện ích mở rộng của mình từ menu thả xuống Phiên bản được hỗ trợ.
- Nhấn Tiếp theo.
3. Hình ảnh:
- Tải lên các tệp sau của tiện ích mở rộng của bạn:
a. Biểu tượng tiện ích mở rộng - Độ phân giải 180 x 180
b. Hình thu nhỏ - Độ phân giải 740 x 340
c. Ảnh chụp màn hình - Thêm ảnh chụp màn hình bắt buộc cho tiện ích mở rộng của bạn.
- Nhấn Tiếp theo.
4. Tóm lược:
- Nhập các chi tiết sau:
a. Dòng giới thiệu
b. Miêu tả
c. Các tính năng chính
d. iên kết hướng dẫn người dùng
e. Liên kết video trợ giúp
- Nhấn Tiếp theo.
5. Định giá:
- Nhập các chi tiết sau:
a. Khả dụng trên toàn cầu - Chọn nếu bạn muốn tiện ích mở rộng của mình có sẵn trên toàn cầu.
b. Định giá - Chọn định giá cho tiện ích mở rộng của bạn.
- Nhấp vào Gửi.
Tiện ích mở rộng của bạn hiện đã được gửi để nhóm Zoho Mail xem xét. Chức năng và khả năng sử dụng của ứng dụng được thử nghiệm và các cải tiến được đề xuất nếu cần. Sau khi quá trình xem xét hoàn tất, ứng dụng được xuất bản trên Zoho Marketplace để người dùng cài đặt.
Bạn có thể chia sẻ các tiện ích mở rộng bạn tạo với các thành viên trong tổ chức của mình từ cài đặt Tích hợp trong Zoho Mail.
1. Đăng nhập vào Zoho Mail
2. Điều hướng đến Cài đặt -> Tích hợp
3. Chọn Tiện ích mở rộng do tôi tạo từ menu bộ lọc để xem tất cả các tiện ích mở rộng do bạn tạo.
4. Nhấp vào tùy chọn Chia sẻ lên tổ chức của tiện ích mở rộng bạn muốn chia sẻ với tổ chức của mình.
5. Nhấp vào Gửi
Tiện ích mở rộng sẽ được gửi để Quản trị viên phê duyệt. Sau khi được quản trị viên của tổ chức của bạn chấp thuận, tiện ích mở rộng sẽ có sẵn để các thành viên tổ chức khác cài đặt và sử dụng. Tìm hiểu thêm.
Bạn có thể cập nhật phiên bản tiện ích mở rộng của mình để thêm các tính năng hoặc sửa lỗi.
1. Truy cập danh sách Ứng dụng Sigma và di chuột qua tiện ích mở rộng bạn muốn cập nhật.
2. Nhấp vào nút Chi tiết tiện ích mở rộng.
3. Nhấp vào nút Chỉnh sửa tiện ích mở rộng ở góc trên bên phải.
4. Cửa sổ Edit Builder sẽ mở ra. Thực hiện các thay đổi cần thiết và nhấp vào Lưu. Đóng cửa sổ.
5. Nhấp vào nút Công khai ở góc trên bên phải của trang để gửi tiện ích mở rộng được cập nhật.
Sau khi quá trình xem xét hoàn tất, phiên bản cập nhật của ứng dụng của bạn sẽ có sẵn trên Zoho Marketplace. Nếu đó là tiện ích mở rộng riêng tư, bạn sẽ nhận được liên kết cài đặt cho ứng dụng đã cập nhật của mình.
Không gian dành cho nhà phát triển API là các lệnh để đính kèm các chức năng khác nhau của Zoho Mail vào ứng dụng bạn tạo. Tham khảo trang trợ giúp này để biết danh sách tất cả các lệnh.
Tiện ích mở rộng mẫu sẽ cho phép bạn khám phá các tính năng được cung cấp bởi Không gian dành cho nhà phát triển Zoho Mail. Chức năng của tiện ích mở rộng mẫu được thiết kế để bạn thử các hành động khác nhau để có thể được kết hợp vào tiện ích mở rộng tùy chỉnh của bạn.
Tải xuống phần mở rộng mẫu tại đây. Bạn cũng có thể thử nghiệm ứng dụng mẫu từ thư viện tiện ích mở rộng Zoho Sigma.
Ghi chú:
- Không gian nhà phát triển chỉ có sẵn cho người dùng tổ chức trả phí.
- Quản trị viên của Tổ chức cần cung cấp Không gian nhà phát triển cho các thành viên tổ chức. Vui lòng liên hệ với quản trị viên của bạn để có quyền truy cập nếu không có sẵn. Tìm hiểu thêm
Vui lòng nhập các thông tin bên dưới để chúng tôi tư vấn tốt hơn cho quy khách!
Hoặc gọi ngay cho chúng tôi:
0919 050 560
