Інтеграція плагіна Stripo: детальний гайд і FAQ

Плагін Stripo надає широкі можливості для розробки email-дизайну, полегшуючи вашій команді процес створення професійних і візуально привабливих шаблонів листів без глибоких навичок кодингу. Ось короткий перелік його переваг:

• drag-n-drop редактор: створюйте адаптивні листи, перетягуючи готові блоки та збережені модулі;
• гнучкість сховища шаблонів: шаблони листів можуть зберігатися як на вашому боці, так і на захищеному боці Stripo, залежно від налаштувань інтеграції;
• одночасне редагування в режимі реального часу: працюйте синхронно з членами команди;
• кастомні розширення: створюйте та інтегруйте власні блоки листів і кастомні компоненти (доступно в тарифному плані Prime);
• проста інтеграція: плагін розроблено як простий JavaScript-компонент для швидкого налаштування.

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

Технічні вимоги та сумісність

Старий плагін Stripo виконаний у вигляді простого JavaScript-компонента, тоді як новий плагін розроблений на базі Angular. Він призначений для вбудовування в будь-який сучасний веб-застосунок, незалежно від використовуваного фреймворка (React, Vue, Angular або інші). Він спрощує процес створення листів, забезпечуючи інтеграцію надійного редактора листів безпосередньо у вашу платформу. Ось як це працює з технічної точки зору:

• обробка HTML і CSS: інтегрований плагін Stripo отримує й обробляє HTML- і CSS-код, даючи змогу вашим користувачам редагувати шаблони листів у простому інтерфейсі. Після редагування він одразу повертає чистий оновлений код, готовий до використання.

Плагін Stripo легко інтегрується з такими популярними фреймворками, як Angular, React тощо. Незалежно від того, чи використовує ваш застосунок Angular, React або інший фреймворк на основі JavaScript, сумісність не є проблемою, оскільки Stripo розроблений для гнучкої інтеграції практично в будь-яку сучасну веб-платформу.

Більш детальні покрокові інструкції містяться в нашій документації до плагіну.

Огляд процесу інтеграції

Інтеграція плагіна Stripo у вашу систему здійснюється просто і швидко. Ось як зазвичай відбувається початкове налаштування:

Спочатку ваші розробники повинні визначити і підготувати спеціальні області «div» у застосунку, де розташовуватиметься редактор Stripo. Після визначення цих областей плагін ініціалізується за допомогою простого JavaScript. Після ініціалізації редактор Stripo органічно вбудовується у вибрану секцію, миттєво надаючи користувачам широкі можливості редагування листів.

Рекомендується розібратися в ключових відмінностях між старою і новою версіями плагіна Stripo, особливо в аспекті роботи з даними:

• старий плагін: раніше редактор функціонував без структурованої внутрішньої моделі. Він працював безпосередньо з необробленими HTML і CSS, сприймаючи їх просто як текст. Такий підхід, хоча й був функціональним, мав свої обмеження: різні браузери могли по-різному відображати один і той самий код, а розширення для браузерів могли ненавмисно змінювати контент під час редагування. Ці проблеми іноді впливали на надійність і візуальну цілісність шаблонів листів;
• новий плагін: новий плагін є побудованою на даних моделлю, яка створюється для кожного шаблону листа під час першої ініціалізації. Замість того щоб працювати з необробленим кодом у вигляді звичайного тексту, Stripo тепер генерує і керує структурованою моделлю під капотом. Це забезпечує цілісне відображення в браузерах, захищає код шаблону від небажаного втручання (наприклад з боку розширень браузера) і відкриває такі додаткові можливості, як одночасне редагування в режимі реального часу і коментування в редакторі.

У новому плагіні реалізовано низку серйозних доробок для поліпшення якості редагування листів:

1. Десктопний і мобільний вигляд: без проблем переглядайте і редагуйте листи, оптимізовані для десктопів і мобільних пристроїв, прямо в редакторі.
2. Одночасне редагування в режимі реального часу: працюйте спільно в реальному часі, забезпечуючи одночасний доступ декількох користувачів до шаблонів листів.
3. Спрощене керування базою даних: оскільки Stripo керує зберіганням HTML і CSS, навантаження на внутрішню базу даних значно знижується, що дає змогу вашій команді зосередитися на більш пріоритетних задачах.

Забезпечення плавного переходу багато в чому залежить від точності передавання вихідних даних HTML / CSS у Stripo під час першого налаштування. Цей крок дуже важливий, оскільки Stripo використовує ці дані як базову версію. Після цього ваші шаблони завжди будуть доступні та синхронізовані, що виключає необхідність у повторних оновленнях власноруч.

Міграція зі старого на новий плагін

Змінити старий плагін Stripo на новий простіше, ніж ви думаєте. Ми оптимізували процес, щоб забезпечити максимально комфортний перехід.

Етапи переходу

Міграція зі старого плагіна на новий вимагає кількох технічних оновлень з вашого боку. Йдеться не лише про зміну UI, логіка інтеграції також змінюється. Ось що необхідно налаштувати:

1. Вбудовування плагіна: у новій версії редактор вбудовується за допомогою одного контейнера <div>, а не двох окремих контейнерів, як було потрібно раніше. Це спрощує процес вбудовування.
2. Виклик ініціалізації: спосіб ініціалізації плагіна змінився. Структура виклику функції змінилася, і тепер вона містить нові параметри, необхідні для правильної поведінки плагіна.
3. Логіка автентифікації: параметр userId тепер є обов'язковим під час ініціалізації плагіна. Якщо ваша стара інтеграція не передбачала ідентифікацію на рівні користувача, то необхідно відповідним чином оновити процес автентифікації.
4. Експорт і збереження HTML: функції, що використовуються для отримання та збереження HTML (скомпільованого або необробленого), змінилися. Новий плагін використовує оновлені методи API, і вам також необхідно змінити конфігурацію запуску та виконання автозбереження.
5. Кастомні розширення (якщо можна застосувати): якщо ви створили кастомні блоки або розширення для старого плагіна, необхідно адаптувати або переписати їх, використовуючи оновлену документацію і структуру, розроблену для нового плагіна.
6. Метод перемикання ініціалізації: оновіть процес ініціалізації вашої системи, щоб під час подальшого редагування надсилати лише ID листа. З цього моменту Stripo буде автоматично обробляти отримання HTML і CSS.

Кастомізація та гнучкість на боці клієнта

Плагін Stripo дуже добре піддається налаштуванню, що дає повний контроль над тим, який він має вигляд і функціонує в рамках вашої платформи. Можна легко налаштувати дизайн, функціональність і навіть перевизначити стилі за допомогою власного CSS, щоб редактор виглядав як інтегрована частина вашої системи.

Ступінь доступності кастомізації

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

Редизайн продукту

Коли ви вирішите змінити дизайн свого продукту або платформи, адаптація плагіна Stripo не спричинить труднощів. Оскільки редактор надається у вигляді вбудованого компонента, ваша команда може легко оновити його зовнішній вигляд і конфігурацію відповідно до дизайну вашої платформи незалежно від використовуваного технологічного стека. Можна змінити візуальні елементи за допомогою CSS або невеликих виправлень JavaScript, щоб редактор продовжував відповідати вашому оновленому дизайну без необхідності масштабної реорганізації.

Додавання і видалення кастомних блоків

Доступність і гнучкість додавання та видалення кастомних блоків багато в чому залежать від тарифного плану:

• тарифний план Free / Basic: користувачі можуть видаляти або вимикати стандартні блоки, але додавання кастомних блоків недоступне;
• тарифний план Prime: клієнти можуть створювати та інтегрувати власні розширення, додаючи нові можливості в редактор для задоволення унікальних потреб.

Розробка кастомних розширень

Важливо розуміти, що створення та керування кастомними розширеннями — це відповідальність вашої команди. Хоча Stripo надає документацію і посібник, вашим розробникам необхідно створювати, тестувати і підтримувати ці кастомні блоки. Так ваша команда отримує повний контроль, але водночас потребує внутрішніх ресурсів для ефективного керування.

Основні проблеми під час інтеграції плагіна

Давайте розглянемо деякі поширені проблеми, які слід враховувати, щоб забезпечити плавний перехід.

Досвід і ресурси розробників

Одним з основних факторів, що впливають на процес інтеграції, є рівень кваліфікації та доступність вашої команди розробки. Однак якщо ресурси обмежені або фахівці менш досвідчені, це може призвести до затримок. Виділення достатньої кількості ресурсів для розробників на ранніх етапах допоможе прискорити процес і запобігти виникненню вузьких місць.

Сумісність із кастомними розширеннями

Багато клієнтів покладаються на кастомні розширення — специфічні блоки, розроблені з урахуванням конкретних потреб. Поки повна сумісність із кастомними блоками перебуває в активній розробці для нового плагіна Stripo, користувачі Prime вже можуть почати підготовку до інтеграції, оновивши свої кастомні блоки. Команда Stripo активно працює над забезпеченням повної підтримки кастомних розширень найближчим часом, що призведе до плавного й успішного переходу.

Майбутні рішення і терміни

Ми знаємо про це критичне обмеження, і наші розробники активно працюють над тим, щоб впровадити повну підтримку кастомних розширень до кінця другого кварталу. Ми очікуємо, що ці доопрацювання будуть готові приблизно наприкінці червня або на початку липня, що дасть змогу забезпечити безшовну інтеграцію навіть для найпросунутіших користувачів.

Обов'язки клієнта

Важливо знати, що хоч Stripo і додасть підтримку кастомних блоків, ваша команда відповідатиме за адаптацію наявних кастомних блоків до нового плагіна. Новий плагін має невеликі технічні відмінності, тому вашим розробникам необхідно буде оновити або переписати кастомні розширення. Хоча це потребує додаткових зусиль, утім забезпечить коректну роботу кожного блоку та найкращі можливості роботи в новій системі.

Тестування та контроль якості

У разі інтеграції або переходу на новий плагін Stripo ретельне тестування не просто рекомендується — воно необхідне. Всебічне тестування гарантує, що ваші користувачі не зіткнуться з будь-якими проблемами і що плагін легко інтегрується з вашими наявними системами. Якщо пропустити цей крок або поквапитися, це може призвести до несподіваних труднощів, які негативно позначаться на користувацькому досвіді.

Налаштування спеціального тестового оточення

Найкращий спосіб забезпечити плавний перехід — створити спеціальне тестове оточення. Ось наші рекомендації:

• окремі оточення: використовуйте спеціальні тестові плагіни та окремі від робочого оточення. Це дасть змогу вашій команді безпечно тестувати інтеграції, виявляти потенційні помилки та усувати їх до релізу на лайві;
• реалістичні сценарії: тестуйте реалістичні сценарії та шаблони листів, які дуже схожі на ті, що використовуються в реальному житті. Така практика допомагає виявити нестандартні ситуації, які в іншому випадку можуть залишитися непоміченими;
• безперервний цикл зворотного зв'язку: підтримуйте постійний зворотний зв'язок із тестувальниками або ранніми користувачами, щоб швидко розв'язувати будь-які проблеми та покращувати ефективність.

Підтримка Stripo в тестуванні

Ми в Stripo розуміємо, наскільки важливим є тестування, тому активно сприяємо вашій роботі з забезпечення якості:

• якщо ви користуєтеся тарифним планом Prime, ми надаємо додаткові оточення для тестування плагіна безплатно;
• ці оточення дублюють вашу основну систему, даючи змогу розробникам вільно тестувати нові інтеграції або оновлення без ризику порушити роботу активного робочого оточення.

Постійна технічна підтримка протягом усього процесу інтеграції

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

Канали технічної підтримки Stripo

Ми надаємо кілька зручних каналів підтримки, щоб ви завжди могли отримати необхідну допомогу:

• профільні зустрічі: клієнтам Prime доступні індивідуальні технічні зустрічі з нашими розробниками. Такі заплановані наради гарантують, що складні питання будуть негайно розглянуті фахівцями. Крім того, ми часто створюємо спільні канали Slack між вашою та нашою командою, що дає змогу спілкуватися в режимі реального часу та забезпечувати надшвидку підтримку. Така пряма лінія значно прискорює розв'язання технічних питань і завдань з інтеграції;
• підтримка через чат: миттєва підтримка в чаті доступна з понеділка по п'ятницю, з 8 до 24 години. Швидкі питання і проблеми зазвичай вирішуються в чаті протягом декількох хвилин;
• підтримка електронною поштою: якщо ваш запит не терміновий або не потребує детального вивчення, завжди можна зв'язатися з нашою службою підтримки електронною поштою. Ми відповідаємо швидко і детально, переважно протягом того ж робочого дня.

Коли необхідна пряма допомога розробників

У деяких сценаріях може знадобитися безпосередня участь розробників Stripo, наприклад:

• у складних питаннях інтеграції або усунення несправностей, які не вдається вирішити за допомогою стандартної документації або підтримки;
• у питаннях, пов'язаних із розробкою та функціональністю кастомних блоків або розширень;
• у разі виникнення технічних проблем під час великих оновлень, інтеграції або міграції плагіна.

У таких випадках наша служба підтримки організовує прямий зв'язок із розробниками, щоб ваші проблеми розв'язували фахівці, знайомі з кожною технічною деталлю.

Безперервна підтримка протягом усього циклу експлуатації

Наша технічна підтримка не припиняється після початкової інтеграції. Stripo залишається вашим партнером протягом усього життєвого циклу використання плагіна. Від початкового налаштування та усунення неполадок до постійних оновлень і поліпшень — наша команда завжди готова надати підтримку і дати рекомендації. Ми активно допоможемо розібратися зі змінами, оновленнями та будь-якими технічними питаннями, що виникають, щоб ви завжди отримували максимальну користь від нашого плагіну.

Використовуючи Stripo, ви отримуєте не просто функціональний плагін для редагування листів, а й команду технічних фахівців, яка підтримуватиме ваш безперервний успіх.

Контроль оновлень та усунення багів

Коли мова заходить про роботу з оновленнями та виправленнями багів у плагіні Stripo, у вас є два основні варіанти: автоматичні оновлення або ручний контроль версій. Кожен з них має свої переваги залежно від уподобань вашої команди та операційних вимог.

Автоматичне та ручне оновлення

Автоматичні оновлення («свіжа» версія)

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

Ручне керування версіями

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

Переваги та рекомендації щодо автоматичного оновлення

Плюси:

• негайний доступ до нових функцій і швидке виправлення критичних багів;
• зниження навантаження на розробників під час техобслуговування;
• завжди найоптимізованіша та найбезпечніша версія.

Мінуси:

• незначний ризик виникнення непередбачених проблем, якщо ваше оточення має специфічну кастомізацію або унікальні залежності;
• вимагає довіри до процесу безперервного функціонування Stripo.

Миттєве застосування виправлених помилок і оновлень

У разі використання автоматичних «свіжих» оновлень будь-які поліпшення або виправлення багів застосовуються миттєво. Ваші користувачі одразу ж бачать ці зміни без затримок. Якщо ви оновлюєтеся власноруч, необхідно спочатку перевірити і застосувати оновлення, щоб скористатися новими фіксами і поліпшеннями.

Іншими словами, автоматичні оновлення забезпечують зручність і швидкість, а ручне керування дає вашій команді додатковий контроль. Вибирайте, що є найкращим для вашого сценарію роботи.

Швидкість завантаження редактора та інформація про хостинг

Ще одне поширене запитання, особливо від клієнтів, які проживають за межами Європи: чи можна прискорити час завантаження редактора? За замовчуванням ресурси плагіну Stripo розташовуються на серверах AWS в Ірландії. Для користувачів, які отримують доступ до редактора з віддалених регіонів (наприклад, Азії або Південної Америки), час початкового завантаження може варіюватися залежно від швидкості інтернету і часу очікування мережі. Іноді це займає від 4 до 8 секунд.

Якщо швидке завантаження є критичною вимогою, можете підвищити продуктивність, самостійно захостивши ресурси фронтенду редактора. Ми надаємо відкритий доступ до файлів плагіна на GitHub, що дозволяє:

• скачати певну версію плагіну з нашого репозиторію GitHub;
• захостити ці файли на власній CDN, ближче до бази користувачів;
• замінити стандартний скрипт плагіну на власний.

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

На завершення

Успішна інтеграція плагіна Stripo у вашу платформу залежить від чіткої комунікації, структурованих процесів і проактивного тестування. Дотримуючись найкращих практик, описаних у цьому гайді, ви забезпечите зручність роботи користувачів, мінімальний час простою і плавнішу роботу загалом.

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

Головні висновки:

• підготовка та планування: почніть із чітко складених планів інтеграції та міграції;
• тестування: використовуйте спеціальні оточення, щоб виявляти й усувати проблеми на ранній стадії;
• кастомізація: використовуйте гнучкі можливості кастомізації, пам'ятаючи про те, що для створення кастомних блоків потрібні внутрішні ресурси розробників;
• оновлення: виберіть стратегію оновлення (автоматично або власноруч), яка найкраще відповідає вашим операційним потребам;
• підтримка: покладайтеся на надійні канали технічної підтримки Stripo протягом усього періоду експлуатації плагіна.