Маркетплейс 1С-Бітрікс вже більше 3 років, а повноцінних навчальних матеріалівз прикладами розробки, на мій погляд, немає досі. Ця проблема не вирішилася навіть із виходом офіційного навчального курсу 1С-Бітрікс із відео-уроками. Можливо, досвідченим розробникам достатньо документації API, проте я вже не перший рік, замислюючись про те, як зробити своє рішення, навіть не знав з чого почати.
Спеціально для вирішення цієї проблеми я випустив власне найпростіше рішення із мінімальним функціоналом (у версії 0.2) – «Простий адаптивний Лендінг».
Структура:
особливості:
Структура:
- ЩО СТАВИМО - ../site/
- "Сервіси" - ../services/
особливості:
- *** - Містить копію файлів публики (допустима кирилиця).
- На місцях, де передбачається заміна контенту, введеними в поля майстра користувачем значення, знаходяться МАКРОСИ.
- послідовно. ПРИКЛАД:
Принцип запакування сайту:
Стадія 3 – Модуль
Структура:
особливості:
Принцип запакування
- Робимо майстер.
Стадія 4 – Архів для Маркету
Принцип запакування:
Структура:
Ідентична архіву для маркету за кількома винятками*
- ** - /НОМЕР_ВЕРСІЇ/..
особливості:
Принцип запакування:
- Беремо архів з останнім стабільним модулем (повним), усі зміни будуть у майстрі встановлення сайту.
- Видаляємо немодифіковані файли
- Оформлюємо "супровідні файли" (апдейтер, версію модуля, опис)
- Архівуємо папку з усім вмістом у НОМЕР_ВЕРСІЇ.zip
Ура, модуль/оновлення готові до відправки до Маркету!
Приклад простого готового рішення для Маркетплейса 1С-Бітрікс
Маркетплейс 1С-Бітрікс вже більше 3 років, а повноцінних навчальних матеріалів з прикладами розробки на мій погляд немає досі. Ця проблема не вирішилася навіть із виходом офіційного навчального курсу 1С-Бітрікс із відео-уроками. Можливо, досвідченим розробникам достатньо документації API, проте я вже не перший рік, замислюючись про те, як зробити своє рішення, навіть не знав з чого почати.
Спеціально для вирішення цієї проблеми я випустив своє найпростіше рішення з мінімальним функціоналом (у версії 0.2) – «Простий адаптивний Лендінг».
У репозиторії на GitHub я опублікував 5 коммітів, що відповідають 5 стадіям перетворення просто сайту на повноцінний модуль для Маркета (і його подальше оновлення):
- Стадія 1 – Сайт
- Стадія 2 – Майстер створення сайту
- Стадія 3 – Модуль (який містить майстер)
- Стадія 4 – архів для відправлення до Маркетплейс 1С-Бітрікс
- Стадія 5 - Архів з ОБНОВЛЕННЯМ для Маркетплейсу 1С-Бітрікс
Отже, давайте коротко розберемо, що містить кожна зі стадій і які перетворення з нею відбуваються:
Стадія 1 – Сайт
Тут
Структура:
- Файли публики – / (від кореня сайту)
- Файли шаблону сайту - /bitrix/templates/ІД_ШАБЛОНА/
особливості:
- Файли областей, що включаються, зберігаємо в структурі сайту (щоб можна було легко додати нові сторінки-лендинги в різних розділах сайту і успадковувати необхідні «слайди» областей, що включаються)
- Виклик областей, що включаються, знаходиться на сторінці index.php(мені це здається незручним, оскільки вносить ризик пошкодження коду виклику компонентів контент-редакторами, але не додає ніякої користі. Однак це було обов'язковою вимогою проходження модерації рішення і виклики були перенесені з шаблону на сторінку у версії 0.2.1)
Стадія 2 – Майстер створення сайту
Тут
Структура:
- Сам модуль - /bitrix/wizards/ПРОСТІР_ІМЕН/ІМ'Я_МАЙСТРА/..
- .description.php* - ../.description.php
- Майстер wizard.php** - ../wizard.php
- Мовні файли майстра (візарда та дескрипшена!) - ../lang/ІД_мови/
- Картинки (використовуються в майстрі установки для ОФОРМЛЕННЯ процесу встановлення) - ../images/
- ЩО СТАВИМО - ../site/
- Файли публики*** - ../public/ІД_МОВИ/
- Файли шаблону**** - ../templates/ІД_ШАБЛОНА/
- "Сервіси" - ../services/
- Список сервісів****** - ../.services.php
- "Типи"/"Групи" сервісів, наприклад MAIN******* - ../main/
особливості:
- * - містить версію майстра (не критично) та масив кроків майстра (важливо додати нові кроки в масив!)
- ** - Містить самі кроки майстра, а також «значення за замовчуванням». Важливо в цьому файлі:
- Передати значення «за замовчуванням» з первинного масиву у відповідний крок і там обробити, навіть якщо не планується їх змінювати
- У відповідних кроках заповнюємо поля, створюємо сайти, копіюємо файли з папок файлів (розділу «ЩО СТАВИМО»). Жодних конкретних дій.
- Неприпустимо використання кирилиці! Всі кирилиці вставляємо мовними фразами!
- **** - Містить копію файлів Шаблону. Важливо:
- НЕ допустима кирилиця. Або використовувати мовні файли, або макорси.
- На місцях, де передбачається заміна контенту, введеними в поля майстра користувачем значення, знаходяться МАКРОСИ.
- ****** - Масив сервісів, що підключаються послідовно. ПРИКЛАД:
"НАЗВА_ТИПА/ГРУПИ" => Array( "NAME" => GetMessage("SERVICE_MAIN_SETTINGS"), "STAGES" => Array( "файл_сервісу_1.php", "файл_сервісу_2.php", "файл_сервісу_3.php", |
- ******* - У папках із назвами груп/типів лежать файли сервісів. Сервіси здійснюють КОНКРЕТНІ редагування. Наприклад, замінюють макроси у файлах публічно/шаблоні на значення з майстра установки (у прикладі) або імпортують інфоблоки (ні в прикладі).
Принцип запакування сайту:
- Заливаємо файли публики в /bitrix/wizards/ПРОСТІР_ІМЕН/ІМ'Я_МАЙСТРА/site/public/ІД_МОВИ/
- Заливаємо шаблон в /bitrix/wizards/ПРОСТІР_ІМЕН/ІМ'Я_МАЙСТРА/site/templates/ІД_шаблону/
- Замінюємо потрібні шматки макросами
- Пишемо Візард і Дескрипшн по кроках зі змінними, які важливі для публики/шаблона
- Пишемо сервіси, що працюють із макросами
- Оформляємо (пишемо мовні фрази тощо)
Стадія 3 – Модуль
Тут
Структура:
- * - /bitrix/modules/КОД_ПАРТНЕРА.КОД_МОДУЛЯ/..
- Обов'язковий іклуд** - ../include.php
- Мовні файли модуля - ../lang/ІД_МОВИ/
- інсталятор модуля - ../install/
- Версія модуля*** - ../version.php
- Інсталятор**** - ../index.php
- Майстер установки***** - ../wizards/
- Компоненти****** - ../components/
особливості:
- * - Код партнера маленькими літерами. Код модуля теж маленькими латинськими літерами без підкреслень (на відміну від шаблону/майстра)
- ** - Якщо ви не реалізуєте захист демо-версії, то він може бути порожнім.
- *** - Критичне значення для маркету!
- **** - Містить код модуля з партнером.
- ***** - Копія вмісту відповідної папки попередньої стадії. При встановленні рішення копіюється до папки /bitrix/wizards/, переводячи вас до Стадії 2.
- ****** - У прикладі не представлено. Просто копіюється у відповідну папку під час встановлення модуля.
Принцип запакування
- Робимо майстер.
- Оформляємо будь-яку мішуру по заготівлі.
Стадія 4 – Архів для Маркету
Тут
Принцип запакування:
- Беремо вміст папки /bitrix/modules/КОД_ПАРТНЕРА.КОД_МОДУЛЯ/ і складаємо в папку /.last_version/
- Архівуємо папку /.last_version/ в архів.last_version.zip
Стадія 5 - Оновлення для Маркету
Тут
Структура:
Ідентична архіву для маркету за кількома винятками*
- ** - /НОМЕР_ВЕРСІЇ/..
- Текстовий опис оновлення*** - ../description.ru
- Інсталятор оновлення**** - updater.php
особливості:
- * - До оновлення прикладаються тільки файли, що ЗМІНИЛИСЯ
- ** - Замість /.last_version/ в імені папки використовується номер версії модуля (має співпадати з номером версії модуля в /НОМЕР_ВЕРСІЇ/install/version.php)
- *** - Текстовий файл, що використовується для оформлення інформації про оновлення в Маркетплейсі 1С-Бітрікс
- **** - У найпростішому випадку може бути використаний зразок з репозиторію, жодних специфічних дій до нього поки що не закладено.
Принцип запакування:
- Беремо архів з останнім стабільним модулем (повним), усі зміни будуть у майстрі встановлення сайту.
- Видаляємо немодифіковані файли
- Оформлюємо "супровідні файли" (апдейтер, версію модуля, опис)
- Архівуємо папку з усім вмістом у НОМЕР_ВЕРСІЇ.zip
Ура, модуль/оновлення готові до відправки до Маркету!
Як встановити безкоштовне рішення?
1. Встановіть 1С-Бітрікс: Управління сайтомабо Корпоративний портал .Завантажити їх можна по ційпосилання .
2. На сторінці вибраного рішення натисніть зелену кнопку "Встановити".
У спливаючому вікні введіть адресу вашого сайту або порталу (див. пункт 1), натисніть "Встановити"
3. Установка відкриється в новій вкладці, далі виконайте кроки майстра.
4. У кожного рішення є своя специфіка, можуть бути потрібні різні дії для закінчення установки та налаштування.
Детальна інформація та документація вказані у картці рішення у блоці "Установка". Рекомендуємо ознайомитись з цією інформацією до початку встановлення.
Як купити платне рішення
Для покупки натисніть кнопку «Купити» у картці рішення, оформіть замовлення, вибравши зручний для вас спосіб оплати. Після оплати на вказаний вами при замовленні e-mail прийде лист із купоном та інструкцією щодо його активації.
Увага! Активуйте купон
тількина тому проекті, для якого набуває рішення. Не активуйте його на NFR та ДЕМО ключах.Повторна активація купона неможливаДля встановлення рішення необхідно:
- Авторизуватись у панелі управління Вашого сайту під правами адміністратора.
- Зайти в розділ Marketplace > Оновлення рішень - вкладка «Активація купона» та ввести купон у спеціальному полі.
- Після введення купона у списку рішень для встановлення з'явиться рішення. Натисніть кнопку «Встановити» і дотримуйтеся вказівок.
Технічна підтримка та оновлення
1С-Бітрікс не несе відповідальності за рішення партнерів у Маркетплейсі. Технічна підтримка рішень у Маркетплейсі здійснюється їх розробниками. Контактні дані та регламент вказані у картці рішення у вкладці "Підтримка"
Усі рішення з каталогу Маркетплейс встановлюються лише на продукти «1С-Бітрікс» зактивною ліцензією.
Перевірити статус можна в панелі керування вашого сайту, у розділі «Оновлення» або у нас насайті.
Оновлення та підтримка для платних рішень у «1С-Бітрікс: Маркетплейс» діють протягом1 рік.Після закінчення терміну підтримки ви можете в будь-який момент купити нову версію за ціною 50% від вартості рішення (за умови, що розробник випустив нову версію та її номер вище за ту, яка у вас встановлена). До цього часу ваше рішення працюватиме в колишньому режимі, відсутність оновлень не впливає на працездатність.
Купівля нової версії здійснюється з панелі керування вашого сайту: Marketplace - Встановлені рішення. Там же зазначаються терміни отримання оновлень.
Маркетплейс - це сервіс від 1С-Бітрікс, який дозволяє розробникам ділитися своїми рішеннями з широкою аудиторією, що складається з клієнтів та інших розробників. Що являють собою рішення? Це може бути готовий модуль або компонент для проекту на продуктах від 1С-Бітрікс, таких як "Керування сайтом" або "Корпоративний портал", або готовий сайт також на платформах 1С-Бітрікс. Перша категорія рішень передбачає переважно аудиторію з інших розробників, а друга більше орієнтована на клієнтів. Рішення може бути як платними, і безкоштовними.
Переваги використання даного інструменту для розробників – це можливість отримання прибутку, нових клієнтів, а також додаткових балів для підвищення рейтингу в системі партнерів 1С-Бітрікс. Приємний бонус: за перше розміщене рішення Бітрікс нараховує так звані вітальні бали – у потрійному розмірі від тих, хто належить.
Для розміщення рішень у Маркетплейс необхідно виконати кілька етапів:
Необхідно стати партнером 1С-Бітрікс.
Укласти ліцензійну угоду.
Для розміщення платних рішень потрібне оформлення ліцензійного договору. Заповнення договору здійснюється у особистому кабінетіпартнера.
Підготувати рішення відповідно до вимог компанії.
Правила, регламент та вимоги можна знайти в особистому кабінеті у розділі «Маркетплейс», а також вимоги до рішень можна знайти за посиланням.
Підготувати графічні матеріали для створення майстра встановлення рішення та для розміщення рішення в Маркетплейс.
Створити майстер установки та зібрати дистрибутив рішення.
Документація щодо створення готових рішень Маркетплейс Bitrix Framework.
Провести самостійне тестування рішення.
План тестування можна знайти у курсі розробників Bitrix Framework.
Підготувати тексти опису рішення, встановлення та дані технічної підтримки.
Це також важливий етап, оскільки за описом клієнт повинен зрозуміти, що є вашим рішенням, чи підходить воно йому і чи варто його купувати.
Вибрати назву рішення та категорію для розміщення у каталозі готових рішень.
Потрібно врахувати, що клієнти часто шукають рішення через пошук за назвою, а для зміни назви потрібно надсилати нові версії додатків до договору, тому важливо відразу правильно вибрати ємну і зрозумілу назву рішення.
Підготувати демо-майданчик.
Щоб покупцям простіше було зрозуміти, що ваше рішення - це саме те, що вони шукали, і визначитися з покупкою, потрібно підготувати онлайн-демонстрацію готового рішення.
Завантажити дистрибутив у власному кабінеті партнера.
Докладніше про завантаження можна прочитати на сайті Маркетплейс. Загальні питання розміщення можна знайти в особистому кабінеті в розділі «Маркетплейс».
Дочекайтеся модерації вашого рішення.
Врахуйте, що процес може зайняти досить тривалий час. Якщо буде виявлено невідповідності вимогам, то рішення буде повернено на доопрацювання і після усунення недоліків процес модерації повторюється наново. При цьому рішення повертається після першої знайденої невідповідності, таким чином модерацію можна не пройти кілька разів поспіль і втратити багато часу. Тому рекомендуємо відразу ознайомитися з вимогами та не пропускати етап тестування свого продукту.
Подумати про засоби залучення покупців рішення.
Тому що мало створити добрий продукт, Треба допомогти цільової аудиторії його знайти!
Розробка готових рішень дозволить вам вийти на більш високий рівеньрозробки. Ви зможете розробити продукт так, як бачите його ви, з урахуванням потреб клієнтів та отримаєте можливість збільшити кількість клієнтів, задоволеність яких залежить від якості вашого рішення, його супроводу та технічної підтримки. А для клієнтів це швидкий та досить бюджетний старт. Тому радимо придивитися до такого корисного інструменту від 1С-Бітрікс.
Марина Сеннікова
Технічний директор, якийAsoft