Bitrix Marketplace 24. Đưa các giải pháp có sẵn vào Bitrix Marketplace: cách tiết kiệm thời gian

Thị trường 1C-Bitrix đã hơn 3 năm tuổi nhưng theo tôi vẫn chưa có tài liệu đào tạo chính thức kèm theo các ví dụ phát triển. Vấn đề này vẫn chưa được giải quyết ngay cả khi phát hành khóa đào tạo 1C-Bitrix chính thức với các bài học video. Có lẽ tài liệu API là đủ đối với các nhà phát triển có kinh nghiệm, nhưng trong vài năm nay, khi nghĩ về cách tạo ra giải pháp của riêng mình, tôi thậm chí còn không biết bắt đầu từ đâu.

Đặc biệt để giải quyết vấn đề này, tôi đã đưa ra giải pháp đơn giản nhất của riêng mình với chức năng tối thiểu (trong phiên bản 0.2) - “SimpleAdaptive Landing”.

Kết cấu:

Đặc điểm:

Kết cấu:

NHỮNG GÌ CHÚNG TÔI ĐẶT - ../site/

“Dịch vụ” - ../services/

Đặc điểm:

*** - Chứa bản sao của các tệp công cộng (có thể chấp nhận được chữ Cyrillic).

Ở những nơi mà nội dung được cho là được thay thế bằng các giá trị được người dùng nhập vào các trường của trình hướng dẫn, sẽ có MACROES.

tuần tự. VÍ DỤ:

Nguyên tắc đóng gói website:

Giai đoạn 3 – Mô-đun

Kết cấu:

Đặc điểm:

Nguyên tắc đóng gói

Hãy làm một bậc thầy.

Giai đoạn 4 – Lưu trữ cho thị trường

Nguyên tắc đóng gói:

Kết cấu:

Giống hệt với kho lưu trữ thị trường với một vài ngoại lệ*

** - /VERSION_NUMBER/..

Đặc điểm:

Nguyên tắc đóng gói:

Chúng tôi lấy bản lưu trữ với mô-đun ổn định mới nhất (đầy đủ), tất cả các thay đổi sẽ có trong trình hướng dẫn cài đặt trang web.
Xóa các tập tin chưa sửa đổi
Chúng tôi chuẩn bị “tệp đi kèm” (cập nhật, phiên bản mô-đun, mô tả)
Lưu trữ thư mục có tất cả nội dung ở dạng VERSION_NUMBER.zip

Hoan hô, mô-đun/bản cập nhật đã sẵn sàng để được gửi ra Thị trường!

Một ví dụ về giải pháp đơn giản được tạo sẵn cho Thị trường 1C-Bitrix

Trong kho GitHub, tôi đã xuất bản 5 cam kết tương ứng với 5 giai đoạn biến một trang web đơn giản thành một mô-đun chính thức cho Thị trường (và bản cập nhật tiếp theo của nó):

Giai đoạn 1 – Trang web

Giai đoạn 2 – Trình hướng dẫn tạo trang web
Giai đoạn 3 – Mô-đun (chứa trình hướng dẫn)
Giai đoạn 4 – lưu trữ để gửi tới Marketplace 1C-Bitrix
Giai đoạn 5 - Lưu trữ với CẬP NHẬT cho Thị trường 1C-Bitrix

Vì vậy, chúng ta hãy xem xét ngắn gọn từng giai đoạn chứa đựng những gì và những biến đổi nào xảy ra với nó:

Giai đoạn 1 – Trang web

Đây

Kết cấu:

Tệp công khai – / (từ thư mục gốc của trang)
Tệp mẫu trang web – /bitrix/templates/TEMPLATE_ID/

Đặc điểm:

Chúng tôi lưu trữ tệp cho các khu vực được bao gồm trong cấu trúc trang web (để bạn có thể dễ dàng thêm trang đích mới vào các phần khác nhau của trang web và kế thừa các “trang trình bày” cần thiết của các khu vực được bao gồm)
Lệnh gọi bao gồm các khu vực nằm trên trang index.php (điều này có vẻ bất tiện đối với tôi vì nó gây ra nguy cơ làm hỏng mã để gọi các thành phần của người chỉnh sửa nội dung, nhưng không mang lại bất kỳ lợi ích nào. Tuy nhiên, đây là một yêu cầu bắt buộc để thông qua việc kiểm duyệt quyết định và các cuộc gọi đã được chuyển từ mẫu sang trang trong phiên bản 0.2.1)

Giai đoạn 2 – Trình hướng dẫn tạo trang web

Đây

Kết cấu:

Bản thân mô-đun này là /bitrix/wizards/NAME_SPACE/MASTER_NAME/..

.description.php* - ../.description.php
Thuật sĩ Wizard.php** - ../wizard.php
Tệp ngôn ngữ trình hướng dẫn (trình hướng dẫn và mô tả!) - ../lang/lingu_ID/
Hình ảnh (được sử dụng trong trình hướng dẫn cài đặt để THIẾT KẾ quá trình cài đặt) - ../images/
NHỮNG GÌ CHÚNG TÔI ĐẶT - ../site/

Tệp công khai*** - ../public/LANGUAGE_ID/
Tệp mẫu**** - ../templates/TEMPLATE_ID/
“Dịch vụ” - ../services/

Danh sách dịch vụ****** - ../.services.php
“Các loại”/“Nhóm” dịch vụ, ví dụ MAIN****** - ../main/

Đặc điểm:

* - chứa phiên bản trình hướng dẫn (không quan trọng) và một loạt các bước hướng dẫn (điều quan trọng là phải thêm các bước mới vào mảng!)
** - Chứa chính các bước của trình hướng dẫn cũng như “giá trị mặc định”. Quan trọng trong tập tin này:

Chuyển các giá trị “mặc định” từ mảng chính sang bước thích hợp và xử lý chúng ở đó, ngay cả khi bạn không có ý định thay đổi chúng theo ý muốn
Trong các bước thích hợp, hãy điền vào các trường, tạo trang web, sao chép tệp từ các thư mục tệp (phần “CHÚNG TÔI ĐƯA GÌ”). Không có hành động cụ thể.
Việc sử dụng bảng chữ cái Cyrillic là không thể chấp nhận được!!! Chúng tôi chèn tất cả các ký tự Cyrillic vào các cụm từ ngôn ngữ!

**** - Chứa bản sao của tệp Mẫu. Quan trọng:

Chữ Cyrillic KHÔNG được phép. Hoặc sử dụng tệp ngôn ngữ hoặc macro.
Ở những nơi mà nội dung được cho là được thay thế bằng các giá trị được người dùng nhập vào các trường của trình hướng dẫn, sẽ có MACROES.

****** - Mảng dịch vụ kết nối tuần tự. VÍ DỤ:

"TYPE_NAME/NHÓM" => Mảng(

"NAME" => GetMessage("SERVICE_MAIN_SETTINGS"),

" GIAI ĐOẠN " => Mảng(

"service_file_1.php",

"service_file_2.php",

"service_file_3.php",

******* - Trong các thư mục có tên nhóm/loại có các tệp dịch vụ. Dịch vụ thực hiện các chỉnh sửa CỤ THỂ. Ví dụ: chúng thay thế macro trong các tệp/mẫu công khai bằng các giá trị từ trình hướng dẫn cài đặt (trong ví dụ) hoặc nhập các khối thông tin (không có trong ví dụ).

Nguyên tắc đóng gói website:

Tải các tệp công khai lên /bitrix/wizards/NAME_SPACE/MASTER_NAME/site/public/LANGUAGE_ID/
Tải mẫu lên /bitrix/wizards/NAME_SPACE/MASTER_NAME/site/templates/template_ID/
Thay thế những phần cần thiết bằng macro
Chúng tôi viết trình hướng dẫn và mô tả từng bước với các biến quan trọng đối với công chúng/mẫu
Chúng tôi viết các dịch vụ hoạt động với macro
Chúng tôi thiết kế (chúng tôi viết các cụm từ ngôn ngữ, v.v.)

Giai đoạn 3 – Mô-đun

Đây

Kết cấu:

* - /bitrix/modules/PARTNER_CODE.MODULE_CODE/..

Bắt buộc bao gồm** - ../include.php
Tệp ngôn ngữ mô-đun - ../lang/LANGUAGE_ID/
trình cài đặt mô-đun - ../install/

Phiên bản mô-đun*** - ../version.php
Trình cài đặt**** - ../index.php
Trình hướng dẫn cài đặt***** - ../wizards/
Thành phần****** - ../thành phần/

Đặc điểm:

* - mã đối tác bằng chữ nhỏ. Mã mô-đun cũng bằng chữ Latinh nhỏ không có dấu gạch dưới (không giống như mẫu/chính)
** - Nếu bạn không triển khai tính năng bảo vệ cho phiên bản demo thì nó có thể trống.
*** - Quan trọng đối với thị trường!
**** - Chứa code của module với đối tác.
***** - Bản sao nội dung của thư mục tương ứng của giai đoạn trước. Khi cài đặt, giải pháp sẽ được sao chép vào thư mục /bitrix/wizards/, chuyển bạn sang Giai đoạn 2.
****** - Không hiển thị trong ví dụ. Nó chỉ được sao chép vào thư mục thích hợp khi cài đặt mô-đun.

Nguyên tắc đóng gói

Hãy làm một bậc thầy.
Chúng tôi sắp xếp tất cả các loại kim tuyến theo chỗ trống.

Giai đoạn 4 – Lưu trữ cho thị trường

Đây

Nguyên tắc đóng gói:

Lấy nội dung của thư mục /bitrix/modules/PARTNER_CODE.MODULE_CODE/ và đặt vào thư mục /.last_version/
Lưu trữ thư mục /.last_version/ vào archive.last_version.zip

Giai đoạn 5 - Cập nhật thị trường

Đây

Kết cấu:

Giống hệt với kho lưu trữ thị trường với một vài ngoại lệ*

** - /VERSION_NUMBER/..

Văn bản mô tả bản cập nhật*** - ../description.ru
Cập nhật trình cài đặt**** - updater.php

Đặc điểm:

* - Chỉ các tệp ĐÃ THAY ĐỔI mới được đưa vào bản cập nhật
** - Thay vì /.last_version/, số phiên bản mô-đun được sử dụng trong tên thư mục (phải khớp với số phiên bản mô-đun trong /VERSION_NUMBER/install/version.php)
*** - Tệp văn bản, được sử dụng để hiển thị thông tin về bản cập nhật trong Thị trường 1C-Bitrix
**** - Trong trường hợp đơn giản nhất, có thể sử dụng mẫu từ kho lưu trữ; chưa có hành động cụ thể nào được đưa vào đó.

Nguyên tắc đóng gói:

Chúng tôi lấy bản lưu trữ với mô-đun ổn định mới nhất (đầy đủ), tất cả các thay đổi sẽ có trong trình hướng dẫn cài đặt trang web.
Xóa các tập tin chưa sửa đổi
Chúng tôi chuẩn bị “tệp đi kèm” (cập nhật, phiên bản mô-đun, mô tả)
Lưu trữ thư mục có tất cả nội dung ở dạng VERSION_NUMBER.zip

Hoan hô, mô-đun/bản cập nhật đã sẵn sàng để được gửi ra Thị trường!

Zadoyny A.V.

Bitrix24 có API mở cho phép khách hàng và đối tác của chúng tôi nâng cao giải pháp mạng nội bộ trên nền tảng đám mây thông qua việc điều chỉnh quy trình làm việc và logic kinh doanh bên trong các cổng dựa trên đám mây của họ. Bitrix24 cũng đại diện cho một nền tảng SaaS tuyệt vời để tạo các ứng dụng doanh nghiệp tùy chỉnh.

Làm cách nào để tạo ứng dụng của bạn cho Bitrix24?

Nếu bạn là chuyên gia CNTT và đang cân nhắc việc tạo một ứng dụng web cho Bitrix24, vui lòng làm theo các hướng dẫn đơn giản sau:

Nếu bạn muốn ứng dụng của mình có sẵn cho tất cả các tài khoản Bitrix24, hãy trở thành đối tác của chúng tôi bằng cách điền vào . Nếu bạn chỉ muốn tạo một ứng dụng riêng cho tài khoản của mình thì không cần đăng ký.
Tìm hiểu tất cả về cách bạn có thể tạo ứng dụng web của mình.
Chọn ‘Thêm ứng dụng’ trong menu Ứng dụng bên trong tài khoản Bitrix24 của bạn (ở bên trái) để tải lên ứng dụng riêng tư của bạn hoặc trong Hồ sơ đối tác nếu bạn muốn ứng dụng của mình được liệt kê công khai!

Ủy quyền và bảo mật ứng dụng web

Quá trình thêm ứng dụng mới vào tài khoản Bitrix24 Cloud của bạn rất dễ dàng và chúng tôi cũng cố gắng làm cho nó minh bạch và an toàn nhất có thể. Mỗi ứng dụng web cung cấp cho bạn danh sách dữ liệu mà nó có thể sử dụng (và thay đổi) trong tài khoản Bitrix24 của bạn và xin phép bạn làm như vậy. Ứng dụng mới sẽ chỉ được cài đặt nếu bạn cho phép.

Cơ chế bảo mật oAuth đảm bảo rằng ứng dụng web này chỉ có quyền truy cập vào dữ liệu bạn đã chỉ định (ví dụ: ứng dụng web có thể yêu cầu bạn cấp quyền truy cập vào các tác vụ, khách hàng tiềm năng CRM, v.v.).

Bạn có ý tưởng cho ứng dụng web?

Nếu bạn không phải là chuyên gia CNTT nhưng bạn có những nhu cầu đặc biệt mà bạn tin rằng có thể giải quyết được thông qua một ứng dụng tùy chỉnh trong cổng Bitrix24, hãy thoải mái chia sẻ ý tưởng của bạn với chúng tôi! Chúng tôi sẽ cố gắng hết sức để làm cho giải pháp mạng nội bộ phù hợp hoàn hảo với doanh nghiệp của bạn! Hãy gửi email cho chúng tôi tới

Marketplace là một dịch vụ của 1C-Bitrix cho phép các nhà phát triển chia sẻ giải pháp của họ với nhiều đối tượng khách hàng và các nhà phát triển khác. Các giải pháp là gì? Đây có thể là mô-đun hoặc thành phần được tạo sẵn cho một dự án trên các sản phẩm từ 1C-Bitrix, chẳng hạn như “Quản lý trang web” hoặc “Cổng thông tin doanh nghiệp” hoặc một trang web được tạo sẵn cũng trên nền tảng 1C-Bitrix. Loại giải pháp đầu tiên chủ yếu liên quan đến đối tượng là các nhà phát triển khác, trong khi loại giải pháp thứ hai tập trung hơn vào khách hàng. Các giải pháp có thể được trả phí hoặc miễn phí.

Ưu điểm của việc sử dụng công cụ này dành cho các nhà phát triển là cơ hội nhận được lợi nhuận, khách hàng mới và điểm bổ sung để tăng xếp hạng của họ trong hệ thống đối tác 1C-Bitrix. Một phần thưởng hấp dẫn: đối với giải pháp đầu tiên được đăng, Bitrix trao thưởng cái gọi là điểm chào mừng - gấp ba số tiền đến hạn.

Để đặt giải pháp trên Marketplace, bạn cần hoàn thành một số bước:

Bạn cần trở thành đối tác 1C-Bitrix.

Ký kết thỏa thuận cấp phép.
Để đặt các giải pháp trả phí, cần phải có thỏa thuận cấp phép. Thỏa thuận được điền vào tài khoản cá nhân của đối tác.

Chuẩn bị giải pháp phù hợp với yêu cầu của công ty.
Bạn có thể tìm thấy các quy tắc, quy định và yêu cầu trong tài khoản cá nhân của mình trong phần “Thị trường” và có thể tìm thấy các yêu cầu đối với giải pháp tại liên kết.

Chuẩn bị tài liệu đồ họa để tạo trình hướng dẫn cài đặt giải pháp và đăng giải pháp lên Marketplace.

Tạo trình hướng dẫn cài đặt và tập hợp gói phân phối của giải pháp.
Tài liệu để tạo các giải pháp làm sẵn Marketplace Bitrix Framework.

Tiến hành thử nghiệm độc lập giải pháp.
Kế hoạch thử nghiệm có thể được tìm thấy trong khóa học dành cho nhà phát triển Bitrix Framework.

Chuẩn bị văn bản mô tả giải pháp, cài đặt và dữ liệu hỗ trợ kỹ thuật.
Đây cũng là một giai đoạn quan trọng, vì từ phần mô tả, khách hàng phải hiểu giải pháp của bạn là gì, có phù hợp với họ hay không và có đáng mua hay không.

Chọn tên của giải pháp và danh mục để đặt trong danh mục các giải pháp làm sẵn.
Cần lưu ý rằng khách hàng thường tìm kiếm giải pháp bằng cách tìm kiếm theo tên và việc thay đổi tên đòi hỏi phải gửi các phiên bản phụ lục mới cho hợp đồng, vì vậy điều quan trọng là phải chọn ngay tên phù hợp cho giải pháp.

Chuẩn bị một trang web demo.
Để giúp khách hàng dễ dàng hiểu rằng giải pháp của bạn chính xác là những gì họ đang tìm kiếm và quyết định mua hàng, bạn cần chuẩn bị bản trình diễn trực tuyến về giải pháp đã hoàn thiện.

Tải gói phân phối về tài khoản cá nhân của đối tác.
Bạn có thể đọc thêm về cách tải xuống trên trang web Marketplace. Bạn có thể tìm thấy các câu hỏi chung về vị trí trong tài khoản cá nhân của mình trong phần “Thị trường”.

Chờ kiểm duyệt quyết định của bạn.
Xin lưu ý rằng quá trình này có thể mất khá nhiều thời gian. Nếu phát hiện thấy có sự không nhất quán với các yêu cầu, quyết định sẽ được trả lại để sửa đổi và sau khi loại bỏ những thiếu sót, quy trình kiểm duyệt sẽ được lặp lại một lần nữa. Trong trường hợp này, quyết định được trả về sau khi tìm thấy sự khác biệt đầu tiên, do đó việc kiểm duyệt có thể không được hoàn thành nhiều lần liên tiếp và sẽ mất rất nhiều thời gian. Do đó, chúng tôi khuyên bạn nên làm quen ngay với các yêu cầu và đừng bỏ qua giai đoạn thử nghiệm sản phẩm của mình.

Hãy suy nghĩ về cách thu hút người mua giải pháp.
Bởi vì tạo ra một sản phẩm tốt thôi chưa đủ mà bạn cần phải giúp đối tượng mục tiêu tìm thấy nó!

Phát triển các giải pháp làm sẵn sẽ cho phép bạn đạt đến mức độ phát triển cao hơn. Bạn sẽ có thể phát triển một sản phẩm theo cách bạn nhìn thấy, có tính đến nhu cầu của khách hàng và sẽ có cơ hội tăng số lượng khách hàng, sự hài lòng của họ phụ thuộc vào chất lượng giải pháp của bạn, việc bảo trì và hỗ trợ kỹ thuật. Và đối với khách hàng, đây là một khởi đầu nhanh chóng và khá tốn kém. Do đó, chúng tôi khuyên bạn nên xem xét kỹ hơn công cụ hữu ích này của 1C-Bitrix.

Marina Sennikova

CTO, whatAsoft