Публікування модулів - як працює версіонування

Як опублікувати модуль

Коли у вас готовий модуль (на основі сторінки CMS, застосунку Noe чи бази знань), ви можете подати його на публікацію. Модуль буде склоновано на системний обліковий запис і потрапить до черги очікування на затвердження адміністратором.

У формі публікації ви вказуєте:

• Код - унікальний ідентифікатор модуля (без скісних рисок)
• Шлях URL - адреса, під якою модуль буде доступний на інших облікових записах

Після затвердження модуль з’явиться в розділі Модулі (/account/modules) на всіх облікових записах. Адміністратор даного облікового запису може тоді його ввімкнути, і модуль з’явиться в меню.

Шлях URL - exact match і wildcard

URL модуля визначає, під якою адресою він буде доступний. Є два режими:

Exact match - модуль відповідає лише на точну адресу:

• raporty - працює лише під /raporty
• organize/panel - працює лише під /organize/panel

Wildcard - URL, що закінчується на /*, ловить саму базову адресу і всі підшляхи:

• myapp/* - працює під /myapp, /myapp/dashboard, /myapp/settings/profile тощо
• Підшлях (якщо є) потрапляє до модуля як контекст навігації

Wildcard корисний, коли модуль має власний внутрішній роутинг (напр. застосунок Noe з багатьма виглядами). Exact match - коли модуль це одна сторінка чи база знань.

Якщо існує модуль з точним URL-ом і водночас інший з wildcard - точний має пріоритет.

Що відбувається з вашою локальною копією

Публікація клонує ваш модуль - створює окрему копію на системному обліковому записі. Ваша локальна версія й далі існує, і ви можете її розвивати.

Якщо опублікований модуль використовує той самий URL, що й ваш локальний, то після активації публічної версії на вашому обліковому записі локальна перестане бути доступною під цією адресою (публічна має пріоритет). Це нормально - ваш модуль й далі існує, ви можете змінити йому URL або вимкнути його.

Оновлення опублікованого модуля

Зміни в локальному модулі не впливають на опубліковану версію. Якщо ви виправите контент сторінки, зміните код застосунку чи додасте нові підсторінки - користувачі інших облікових записів цього не побачать. Побачать лише після повторної публікації та затвердження.

Щоб оновити публічну версію:

1. Внесіть зміни в локальний модуль
2. Натисніть “Опублікувати” ще раз - система автоматично підкаже код і URL з попередньої публікації
3. Зачекайте на затвердження адміністратором
4. Після затвердження стара публічна версія архівується, а нова її замінює

Система пам’ятає, під яким кодом і URL-ом модуль публікувався, тож навіть якщо ви зміните локальний код чи URL, під час наступної публікації за замовчуванням запропонує ті самі значення, що й раніше.

Захист від перехоплення модуля

Раз опублікований модуль прив’язаний до облікового запису, який його створив. Ніхто з іншого облікового запису не може подати на публікацію модуль з тим самим кодом - система це заблокує. Лише обліковий запис, який опублікував оригінал, може надіслати оновлення.

Цей захист працює автоматично і не вимагає жодного налаштування.

Підсумок процесу