Store Listing
Store Listing - описи в магазинах усіма мовами з одного місця
Виправте опис кожною мовою, перш ніж він потрапить до магазину.
Вебінструмент для учасників
Про застосунок
Store Listing веде описи в магазинах для розширень браузера та мобільних застосунків усіма мовами одночасно. Один опис, усі мови, один прохід замість того, щоб окремо заходити до консолі кожного магазину. Інструмент доступний після входу в акаунт, для акаунтів, яким POLPROG надав до нього доступ.
Як це працює
- Обираєте магазин, для якого готуєте опис.
- Вставляєте метадані - повний набір назв, коротких і повних описів усіма мовами в одному файлі JSON.
- Правите текст окремо для кожної мови - крок необовʼязковий, бо коректні метадані проходять далі без змін. Обмеження довжини рахуються для кожної мовної версії, помилки показуються біля поля, а поруч працює живий перегляд: Markdown відрендерений так, як це зробить Firefox, і звичайний текст так, як у Chrome.
- Вводите дані доступу до API магазину. Вони живуть виключно в сесії браузера і зникають після виходу з акаунта.
- Порівнюєте з магазином і публікуєте. Перш ніж щось піде далі, ви бачите зіставлення локальної версії з тією, яка зараз є в магазині - поле за полем, мова за мовою.
Що підтримує який магазин
| Магазин | Обсяг |
|---|---|
| Firefox AMOПовний цикл | Завантаження поточного опису, порівняння відмінностей, публікація і перевірка після збереження. |
| Chrome Web StoreЧастково | Валідація і попередній перегляд. Текст опису неможливо опублікувати через API: назва та описи походять з пакета розширення, а API не надає жодного текстового поля. |
| Apple App StoreПовний цикл | Мобільні застосунки та розширення Safari: завантаження описів, порівняння і публікація. Текст зберігається у версії, яку App Store Connect тримає в редагованому стані. |
| Google PlayПовний цикл | Застосунки для Android: завантаження описів, порівняння і публікація окремо для кожної мови. |
Що це змінює на практиці
POLPROG сьогодні підтримує близько сорока описів у магазинах: девʼять розширень, присутніх водночас у Chrome, Firefox і Edge, чотири з них додатково як розширення Safari, а також мобільні застосунки в App Store і Google Play. Виправлення одного речення в описі без інструмента означає стільки проходів через панель магазину, скільки є комбінацій магазину і мови. Тут це одна правка і одна публікація.
Друга вигода менш очевидна: порівняння з магазином відповідає на питання, чи опис в Edge досі збігається з тим, що в Chrome. Вручну перевірити це можна лише відкривши обидва і прочитавши.
Чого інструмент не робить
Не пише тексти і не перекладає. Скорочує клікання, а не мислення. Також не публікує до Chrome Web Store, бо це обмеження API Google, а не брак функції.
Ключові можливості
Майстер із пʼяти кроків
Вибір магазину, вставлення JSON опису, валідація і редагування для кожної мови, дані доступу, порівняння і публікація. Наступний крок відкривається лише тоді, коли попередній завершений.
Валідація окремо для кожної мови
Обмеження довжини назви, короткого опису та повного опису рахуються для кожної мовної версії окремо. Помилки зʼявляються біля конкретного поля разом з лічильником символів.
Живий перегляд
Панель поруч із редактором рендерить Markdown так, як це зробить AMO, і звичайний текст так, як покаже його Chrome. Ви бачите результат, перш ніж щось надіслати.
Firefox AMO: повний цикл
Завантаження поточного опису з магазину, порівняння відмінностей, публікація змін і перевірка збережених даних уже після надсилання.
Chrome Web Store: валідація і попередній перегляд
Текст опису неможливо опублікувати через API Google: назва та описи походять з manifest.json і каталогу _locales у ZIP-пакеті, а в API немає для них жодного поля. Інструмент перевіряє текст і показує попередній перегляд.
App Store і Google Play: мобільні застосунки
Той самий майстер веде описи застосунків для iOS та Android, не лише розширень браузера. Назва, короткий опис і повний опис ідуть окремо для кожної мови, із завантаженням стану з магазину і порівнянням перед публікацією. Розширення Safari веде той самий шлях, бо в App Store їх описує запис застосунку.
Порівняння з магазином перед публікацією
Зіставлення локальної версії з тією, що опублікована зараз, мова за мовою, з виділенням полів, які справді змінилися.
Дані доступу лише в сесії браузера
Ключі до API магазину зберігаються в sessionStorage, передаються через HTTPS, ніколи не записуються на сервері і видаляються після виходу з акаунта.
Доступ після входу в акаунт
Інструмент видно виключно для акаунтів, які увійшли в систему і яким POLPROG надав до нього доступ. Саме лише створення акаунта не відкриває його автоматично.
Спільне ядро валідації на Python
Ті самі правила валідації працюють у вебінструменті і в десктопному застосунку POLPROG. Валідація відбувається на сервері, а текст опису не зберігається.
Конфіденційність і безпека
Інструмент працює виключно після входу в акаунт, на акаунті з наданим доступом. Текст опису валідується на сервері POLPROG і не зберігається на ньому: не потрапляє ні до бази, ні до логів, ні на диск. Робоча версія опису і дані доступу до магазину живуть тільки в сесії браузера і зникають після виходу з акаунта.

