MERGADO Apps 0.3.2
Release date
8. března 2017
Přidané funkce
- Implementace měření konverzí v reklamních systémech AdWords, Sklik a Facebooku pro aplikace v MERGADO Store.
- Implementace Ecommerce Tracking v MERGADO Store po zapnutí aplikace.
- Podpora
medium
parametru u Google Analytics API endpointu.
Opravy
- Markdown v e-mailových notifikacích zvládne víc než jeden odkaz.
- Generování access tokenu pro offline režim u aplikací typu
user
. - Přepisování URL pravidla při releasu aplikace.
MERGADO Apps 0.3.3
Release date
24. května 2017
Přidané funkce
- Indikátor stavu spojení s napojenými službami a zbožáky (u GET Shop Info API endpointu).
- Nový API endpoint obsahující seznam všech dostupných tarifů v Mergadu.
- Nový API endpoint umožňující úpravu eshopu přes API.
- Nové API endpointy zobrazující seznam zapnutých aplikací pod uživatelem, u eshopu nebo u exportu.
- Možnost nahrávat obrázky v Developers u popisu aplikace v Markdown editoru přes drag&drop.
- Screenshoty a loga aplikací se nyní nahrávají přímo u aplikace v administraci v Developers.
Opravy
- Spouštění dlouhotrvajících úkolů na exportech jen pro čtení vrací správný HTTP status.
- Volání API endpointu s prázdnými hodnotami parametrů
limit
aoffset
nevrací chybu serveru. - Po úpravě nebo vytvoření nového pravidla přes API metodami PATCH nebo POST je změna v pravidlech zaznamenána na backendu a dané pravidlo je správně aplikováno na produkty v průběhu příští plánované aplikace pravidel.
- Opraveny výpadky spojení s Redisem v PHP kvůli chybě v RHELu 7.
MERGADO Apps 0.3.4
Release date
14. června 2017
Přidané funkce
- Vylepšení MERGADO Store - vyhledávání, filtrování, řazení appek
- Na stránce s detailem aplikace se nově zobrazují doporučené aplikace
- Nový formát Shoptet.cz
- Nový API endpoint - kolekce Google crecentials, která vrací například access token pro přístup do různých Google API
- Možnost přes API označit jednotlivé produkty jako změněné, aby je MERGADO rozpoznalo a zpracovalo v příštím automatickém přegenerování
Opravy
- API nepovoluje aplikacím vytvářet elementy a proměnné s nevalidními jmény. Místo toho server vrátí 400 HTTP status.
- Změny v popisu aplikace v Developers se neuložily správně, pokud byl zobrazený náhled Markdownu
MERGADO Apps 0.3.5
Release date
12. července 2017
Přidané funkce
- Eshopy v Mergadu lze spojit s účtem v Google Adwords. U propojených eshopů lze získat přes API access token.
- MERGADO podporuje nový formát Spartoo. Součástí podpory je i převodník.
- Aplikace mají nově možnost mít uživatelské hodnocení - a to jak číselné, tak i slovní. Hodnotit mohou momentálně ti uživatelé, kteří danou appku mají nějakou dobu zapnutou pod některou z jimi vlastněných entit.
- Aplikace mohou mít přiřazeny štítky pro lepší kategorizaci v MERGADO Store. Seznam možných štítků spravují administrátoři Mergada. Vývojáři mohou své appce přiřadit štítky v jejím profilu v Developers.
- U žádosti o vydání aplikace je nově možnost stručně popsat aktuální změny, což našim správům pomůže lépe zacílit následnou kontrolu a zjednodušit tak a urychlit schvalování žádosti o vydání aplikace.
Změny
- V horním menu aplikací je lépe vidět právě aktivní aplikace a nově je i na tomto místě rozlišena vývojová stage od produkční.
- Přidána nová vyhrazená fronta pro přegenerování exportů, které bylo vyvoláno aplikací přes API.
- K aplikacím jsou nově místo států přiřazené měny. Je to důsledek změn v interním fungování fakturačního procesu Mergada, kdy uživatelé mají explicitně nastavenou měnu a ta se tak již nedeterminuje jeho adresou, resp. sídlem společnosti. Řeši to tak nejasnosti při fakturaci appek, kdy např. uživatel sídlí ve Velké Británii, avšak zároveň platí v eurech.
Opravy
- Opraveny chyby s detekcí jazyka v MERGADO Store, kdy se některé popisy aplikací zobrazovaly ve špatném jazyce.
MERGADO Apps 0.3.6
Release date
10. srpna 2017
Přidané funkce
- IFrame API: MERGADO objekt má novou metodu
scrollTo(int px)
, která se dá použít k nastavení vertikálního scrollu rodičovského MERGADO okna. Pixely se udávají relativně k vnitřnímu oknu aplikace, o zbytek se postará okolní MERGADO. - Appcloud: Nově podporuje post-release skripty, které se spustí na závěr releasu aplikace. To se dá využít například pro spuštění databázových migrací či restart dlouhotrvajících workerů a podobně. Soubor
<app_home_dir>/app/mergado_post_release
(bez přípony, je možné použít shebang) se spustí jako poslední příkaz při releasu aplikace; spouští se pod uživatelem produkční stage appky. - Developers: Markdown nově podporuje přidání popisku k obrázkům pomocí tagu
images
. Příklad:{images=http://img.jpg#Popisek obrázku,http://img2.jpg#Druhý obrázek}
. Momentálně v popisu nelze použít znak čárky,
, protože je použitý jako oddělovač jednotivých URL obrázků.
Změny
- API endpoint Show Eshop Info zobrazuje navíc více informací o spojení s reklamními systémy v poli info.
- Z API endpointu Show Eshop Info byla odstraněna všechna deprecated pole
is_connected_to_<service>
.
MERGADO Apps 0.3.7
Release date
14. září 2017
Přidané funkce
- MERGADO opět podporuje několik nových formátů:
- Favi,
- Everysize,
- Shopzilla,
- Price grabber a
- Skrz.
- Audit feedů nově umí přijímat soubory ve formátu
CSV
. Audit byl také rozšířen o podporu několika nových specifikací: Shoptet, Spartoo, Price Grabber a Everysize. - Do detailu aplikace v Developers byla přidána záložka Releases, kde lze nalézt přehled vývojových fází a verzí aplikace.
- V detailu aplikace v Developers se zobrazuje “skóre vyplnění aplikace”. Jde o procentuální zhodnocení toho, jak kompletně máte vyplněné informace o vaší aplikaci. Dobře vyplněné informace vaší aplikaci pomáhají lépe se prezentovat v Mergado Store.
- Do nastavení aplikace přibyla možnost vyplnit odkaz na web aplikace, který se zobrazí v detailu aplikace v MERGADO Store.
- Na přehledu aplikací v Developers se zobrazuje uživatelské hodnocení aplikace.
- Prvek pro výběr formátů v editaci aplikace dostal hromadné akce.
- Nově se v každém requestu při aplikaci pravidla aplikace posílá společně pole apply_log_id.
- Počet možných jazyků pro lokalizaci aplikace ve Store byl “zredukován”, aby odpovídal jazykům, které reálně MERGADO aktuálně podporuje.
- Nově si MERGADO interně sbírá o něco více dat. Pro vývojáře to aspoň prozatím znamená nový graf s počtem zapnutých instancí na přehledu aplikací v Developers.
Opravy
- Obsah meta elementu description byl zkrácen, zobrazuje se pouze zkrácený popis aplikace bez markdown.
- Vylepšená detekce jazyka při zobrazování popisku aplikace ve Store.
MERGADO Apps 0.3.8
Release date
11. října 2017
Nově
- MERGADO podporuje nový formát Glami pro Maďarsko.
- Developers: V profilu aplikace je pro vývojáře k dispozici nová záložka se seznamem subjektů, u kterých je daná aplikace zapnutá (může ulehčit práci s řešením různých chyb aplikace).
- Store: Seznam aplikací se dá nově seřadit podle jejich uživatelského hodnocení.
Změny
- Seznam výběrů při voláni API endpointu pro zobrazení seznamu výběrů u projektu se nově řadí podle názvu. S tím, že na prvním místě je vždy výběr, který vybírá všechny produkty.
- Byl rozšířen API endpoint
Show Eshop Info
, který nově zobrazuje stav stažení jednotlivých zdrojů statistik. - API endpoint na spouštění tasků vrací HTTP status
423 Locked
u projektů, které jsou zrovna pouze pro čtení a nelze s nimi manipulovat (dříve se vracelo303 See Other
). - Připomenutí k ohodnocení aplikace se nyní posílá pouze uživatelům, kteří aplikaci zapnuli.
- Developers: Výchozí řazení aplikací je nově dle jejich názvu (dříve se řadilo dle stejné logiky jako ve Store.)
- Store: Výpis seznamu aplikací ve Store byl optimalizován a je nově několikrát rychlejší.
- Ikonka vývojové stage aplikace má nyní černobílý vzhled i v notifikacích. Dříve byla černobílá pouze v nabídce aplikací pod zeleným menu.
Opravy
- Při vytváření či úpravě pravidla přes příslušné API endpointy, mohla nastat chyba, pokud se daným requestem upravoval i seznam výběrů, na které bylo dané pravidlo vázané. Ta je nyní opravena.
- Opraveny chyby typu
"Rule type 'tagstripping' not found."
, které se projevovaly u některých projektů při volání seznamu pravidel přes API. - Store: Výchozí algoritmus, dle kterého se řadily aplikace ve Store obsahoval chybu. Ta je nyní opravena a do pozic jednotlivých aplikací se nyní různé (tajné) signály projevují správným způsobem.
- Store: V “doporučených aplikacích” na stránce s detailem aplikace se mohly objevit i profily zatím nevydaných aplikací. To je nyní opraveno.
MERGADO Apps 0.3.9
Release date
14. listopadu 2017
Nově
- V Developers je nová položka obsahující seznam vyúčtování vendorů, ke kterým má vývojář přístup.
- Nově si interně uchováváme chybové hlášky, které může appka při aplikaci pravidel vrátit. To může významně pomoci při potenciálním debugování chyb v komunikaci platformy s appkou, která poskytuje pravidla.
- Přidán API endpoint na úpravu projektu.
- Přidáno pole
is_dirty
doProject
resource. Pokud jeis_dirty=True
, tak to prakticky znamená, že během příštího přegenerování projektu budou aplikována všechna pravidla na všechny produkty. Toto je ekvivalentní spuštění Přegenerovat vše v UI Mergada.
V API endpointu pro získávání kategorií Heureky je nové poleheureka_id
, které kategorii unikátně označuje.
Změny
- Odstraněny API endpointy na vytváření tasků pro přegenerování exportů. Aplikace nyní nemohou v Mergadu vyvolat manuální přegnerování. Namísto toho se má
Project
(export) označit jako “špinavý” (viz výše), což způsobí, že se při následujícím zpracování exportu provede kompletní zpracování (zcela totožné chování, jako dříve posílání parametruforce=True
při vytváření tasků).
MERGADO Apps 0.3.10
Release date
29. listopad 2017
Nově
- Nový formát pro Řecko - Skroutz.gr.
- Po schválení žádosti o aktualizaci údajů aplikace v Mergado Store dojde vývojářům aplikace notifikace.
Změny
- Několikrát rychlejší zpracování dat u API endpointu /api/projects/<id>/stats/products/
Opravy
- Opravené rozházené pořadí v seznamu releasů v Developers. (Issue tracker: Developers - releases sorting · Issue #70 · mergado/mergado-apps · GitHub)
- Opravená editace existujícího pravidla v Developers - formulář byl prázdný. (Issue tracker: Broken rules editing in Developers · Issue #66 · mergado/mergado-apps · GitHub)
- Opraveno: V aktuálně provozovaných verzích prohlížeče Safari nešel zobrazovat IFRAME aplikací, protože vykreslovací jádro WebKit tento element odmítalo vykreslit, obsahoval-li jeho atribut
sandbox
hodnotuallow-modals
. Nově detekujeme prohlížeč Safari aallow-modals
jej neposíláme. To aplikacím v Safari znemožní používat výhody tohoto parametru sandboxování, nicméně alespoň se zobrazí aplikace jako taková. (V novějších verzích WebKitu by tato věc měla být ošetřena)
Nová URL pro přístup k MERGADO API
https://api.mergado.com
Release date
12. prosinec 2017
Informace o změně
K od nynějška zastaralé URL https://app.mergado.com/api
, na které bylo a stále je dostupné API platformy Mergado, se přidává nová adresa, na které je toto API dostupné: https://api.mergado.com.
Přístup přes tuto adresu je pro appky v Mergadu výhodnější; např. je této nové adrese nastaven mnohem volnější režim limitování počtů příchozích požadavků. Stará adresa zůstává funkční a přestože se tak nestane v dohledné době, je možné, že se v budoucnu přístup k API přes starou adresu https://app.mergado.com/api
zcela zruší.
Všechny vývojáře proto vyzýváme, aby ve svých aplikacích pro platformu MERGADO od této chvíle používali novou URL https://api.mergado.com
.
MERGADO Apps 0.3.11
Release date
- ledna 2018
Nově
- Při průběhu aplikace pravidel se u pravidel zobrazuje kromě názvu i jejich ikonka. U pravidel aplikací se tedy bude zobrazovat ikonka konkrétní appky.
- Podporujeme nové formáty:
Bestprice.gr
,Ladenzile.de
. - Data z analytiky vrácená z endpointu
/projects/<id>/google/analytics/
nově zohledňují případné uživatelské nastavení specifických analytických zdrojů v nastavení daného exportu. - V přehledu fakturace za vaše aplikace se u konečných měsíčních provizí nově zobrazuje i přesný počet spuštěných aplikací, ze kterých daná částka k provizi vyplývá.
- Formát
datetime
, který se v API na různých místech vrací, byl sjednocen do formy ISO 8601, tedy např."2016-11-02T09:12:09+00:00"
. - V
apply logu
získáném přes API je vývojářům nově k dispozici i seznam aplikovaných pravidel.... "rules": [ { "processed_products": 64, "products": 64, "rule_id": "1" }, { "processed_products": 64, "products": 64, "rule_id": "5" } ...
- Endpointy pro získání logů procesů exportu se změnily:
/projects/<id>/logs/import/
je nově/projects/<id>/importlogs/
/projects/<id>/logs/apply/
je nově/projects/<id>/applylogs/
/projects/<id>/logs/export/
je nově/projects/<id>/exportlogs/
/projects/<id>/logs/access/
je nově/projects/<id>/accesslogs/
- Pozor! Přestože jsou staré URL (kvůli zpětné kompatibilitě) prozatím zachovány, důrazně vás vyzýváme, abyste používali nové endpointy.
- V API endpointu vracejícím informace o exportu
/projects/<id>/info/
se nově vrací i další metadata daného exportu.
Opravy
- V Developers byla opravena drobná chyba výpisu subjektů aplikace, která způsobovala nesprávný výčet subjektů, pokud byla zapnuta i vývojová stage aplikace.
- Byla opravena chyba ve výpočtu správného odscollování v MAIA metodě
.scrollTo()
. (Issue tracker: MAIA - ScrollTo method is working weirdly · Issue #76 · mergado/mergado-apps · GitHub)
MERGADO Apps 0.3.12
Release date
24. leden 2018
Upgrade verze PHP na MERGADO Appcloud
- Verze PHP byla ze 7.0 zvýšena na 7.1.
Změny
- Pro appku je nově možné v Mergado Developers definovat náhledový obrázek
og:image
. - V API je nový endpoint, který vrací URL statistických zdrojů daného e-shopu:
/shops/{id}/stats/sources/
- Dokumentace: Mergado · Apiary
- Hodnotu
heureka_url
nově ukládáme i ze sortiment reportu. Ve statistikách produktu, dostupných např. na endpointu/products/{id}/stats/
, je tedyheureka_url
k dispozici, i když e-shop nemá XML z měření konverzí.- Dokumentace: Mergado · Apiary
- Issue platformy: stats - missing heureka_url,... · Issue #77 · mergado/mergado-apps · GitHub
- V logu z aplikování pravidel je v poli
applied_to_all_items
nově informace (true
/false
) o tom, zda byla pravidla aplikována na kompletní export (tedy na všechny jeho produkty).- Dokumentace: Mergado · Apiary
- Issue platformy: /logs/apply - add more data · Issue #55 · mergado/mergado-apps · GitHub
- Uživatel si nově může explicitně povolit či zakázat přijímání notifikací konkrétních aplikací.
- Nově podporované formáty:
designforumshop.com
evilia.sk
mojinterier.sk
mojoutfit.sk
- Formát
compari.ro
má kroměXML
výstupu i nový výstup typuCSV
.
Opraveno
- API nyní vrací časy opravdu v UTC (a ne tedy ne jen tak, že se čas jako UTC pouze tváří).
MERGADO Apps 0.3.13
Release date
28. únor 2018
Změny
-
Upravili jsme způsob, jakým pracujeme s API Google Analytics, což by mělo pomoci vyřešit občasné nenadálé a neočekávané odpojování spojení s Google Analytics v Mergado Keychain.
-
Nově je možné přesněji specifikovat umístění pravidla pomocí pole
placement
. Toto pole obsahuje klíč s hodnotou odkazující na ID pravidla, vůči kterému se má dané pravidlo umístnit. Použitím klíčebefore
resp.after
může vývojář specifikovat, před kterým či za kterým pravidlem se má vynutit umístění nově vytvářeného (či upravovaného) pravidla.Příklad:
... "placement": { "after": "123" // Nové pravidlo se _určitě_ umístí za pravidlo 123. } ...
- Dokumentace v API: Mergado · Apiary
-
Rozsah možných “priorit” pravidel se z
1 -> 255
zvýšil na možných1 -> 999999
. Pokud aplikace potřebuje zajistit, že se její pravidlo bude vykonávat jako “poslední”, může využít tohoto rozšířeného rozsahu.
MERGADO Apps 0.3.14
Release date
11. duben 2018
Změny
- (!!!) Opravena chyba, kdy se na endpoint pravidla aplikace občas, v určitých případech, posílal neúplný JSON.
- Issue platformy: Messed rule requests from Mergado #84
- Opravena chyba, kdy API endpoint
/projects/<id>/stats/products
nevracel stejné výsledky, jako endpoint/products/<id>/stats
. Chyba se projevovala v okamžiku, kdy v Keychainu bylo nastavené Mergado Analytické XML, ale přitom v něm pro některé produkty chyběly záznamy. Takové produkty potom na endpointu/projects/<id>/stats/products
chyběly, přestože na endpointu/products/<id>/stats
přítomné byly. - Opravena chyba v API, které vracelo špatná data z Google Analytics, pokud měl uživatel uložené prázdné zdroje v nastavení analytiky v Mergadu.
MERGADO Apps 0.3.15
Release date
25. duben 2018
Změny
- Nový API endpoint
/shops/{id}/statslogs/
(dokumentace)- Vrací data o importech statistik pro daný e-shop.
- Nový API endpoint
/statslogs/{id}/
(dokumentace)- Vrací informace o konkrétním importu statistik podle jeho
ID
.
- Vrací informace o konkrétním importu statistik podle jeho
- Informace z těchto dvou endpointů mohou pomoci diagnostikovat problémy se statistikami (které pro některý den třeba nejsou k dispozici).
- Issues platformy, kterých se tyto dva endpointy týkají:
- Opravena detekce stavu kampaně na Zboží.cz.
- Issue platformy: zbozi_is_campaign_activated vrací
null
#86
- Issue platformy: zbozi_is_campaign_activated vrací
MERGADO Apps 0.3.16
Release date
23. květen 2018
Změny
- Nově: V Developers jsou vidět logy chyb, které appka vrátila při aplikování pravidel. Pokud appka při jednom procesu aplikování pravidel u daného pravidla vrátí chybu vícekrát, v seznamu chyb se zobrazí jen jednou - ta první (její přesný čas a chybová zpráva). (U větších exportů by se jinak tento seznam chyb rychle a zbytečně zaplnil redundantními informacemi.)
- Issue platformy: Informations about errors during rule application #45
MERGADO Apps 0.3.17
Release date
13. červen 2018
Změny
- Nové atributy pro API endpoint
/shops/{id}/stats/
(dokumentace)- Atribut
heureka_total_sales
vrací data o celkových tržbách pro daný e-shop za zvolené období. - Atribut
heureka_total_orders
vrací data celkovém počtu objednávek pro daný e-shop za zvolené období. - Issue platformy: Add Heureka sales and orders to /shops/[id]/stats/ #83
- Atribut
- Endpointy, které vrací statistiky vztahující se na celý eshop, nyní mají scope
shop.stats.read
/shops/{id}/stats/
- Změněn scope z
project.stats.read
nashop.stats.read
- Změněn scope z
/products/{id}/stats/
- Vrací pouze obecné statistiky a statistiky vztahující se k danému projektu
project_id
se získá podleproduct_id
- Obecnými statistikami jsou id, item_id, date, shop, cost, is_starter a is_topseller
- Pokud by měl být field
product_id==null
, nevrátí se vůbec.
/projects/{id}/stats/products/
- Vrací pouze obecné statistiky a statistiky vztahující se k danému projektu
- Pokud se pro daný formát nestahují statistiky, je vrácen prázdný seznam
- Pokud by měl být field
product_id==null
, nevrátí se vůbec.
/shops/{id}/stats/products/
- Nový endpoint
- Vrací statistiky produktů ze všech zdrojů api
/projects/{id}/stats/categories/
- Odstraněn, nahrazen novým endpointem na URL
/shops/{id}/stats/categories/
- Vrací to samé, jako endpoint, který nahrazuje
- Vyžaduje scope
shop.stats.read
- Odstraněn, nahrazen novým endpointem na URL
/projects/{id}/stats/audits/
- Odstraněn, nahrazen novým endpointem na URL
/shops/{id}/stats/audits/
- Vrací to samé, jako endpoint, který nahrazuje
- Vyžaduje scope
shop.stats.read
- Odstraněn, nahrazen novým endpointem na URL
/stats/audits/{m3shop_id}-{date_id}/
- Změněn scope z
project.stats.read
nashop.stats.read
- Změněn scope z
/stats/audits/{m3shop_id}-{date_id}/issues/
- Změněn scope z
project.stats.read
nashop.stats.read
- Změněn scope z
MERGADO Apps 0.3.18
Release date
27. červen 2018
Změny
-
Aplikace nyní mohou používat jiné úložiště, než je MERGADO Appcloud.
- Většina dalších změn, které jsou uvedeny níže, vychází z této změny, která v některých oblastech zásadně mění paradigma, v jakém appky existují a fungují.
- U appky v Developers je nová stránka Úložiště, kterou může vývojář použít ke správě úložiště zvlášť vývojové a zvlášť produkční verze appky.
- Defaultní úložiště je vždy Appcloud. Potom lze každé verzi appky nastavovat jiné URL, které MERGADO používá:
- Při odesílání hook requestů.
- Při posílání payloadů na endpointy pravidel appky.
- Pro zobrazení
IFRAME
ů (widget i plná verze) při zobrazování appky v UI.
- Pokud alespoň jedna verze appky nepoužívá Appcloud úložiště, pak při vytváření nového vydání na stránce Releases není možné spouštět tradiční release proces na Appcloudu.
- Hook URL musí začínat stejnou URL, jako je Základní URL appky.
- Lze nastavovat způsob routingu aplikace. Oproti stávajícímu pretty routingu ve stylu:
… lze nově nastavit i jednodušší routing přes GET parametry:.../eshop/1/project/2
.../?eshop=1&project=2
- Defaultní úložiště je vždy Appcloud. Potom lze každé verzi appky nastavovat jiné URL, které MERGADO používá:
-
Přepracovaný a zjednodušený životní cyklus aplikace.
- Možnost “soběstačných” releasů aplikace.
- Umožňuje použití pokročilejších CI a CD nástrojů.
- Aplikace nově nepodléhá tradičnímu cyklickému
vývoj-žádost o release-potvrzení podporou-release-vývoj...
. - Nové verze si vývojář řeší a vydává sám, bez explicitního potvrzování podporou Mergada.
- Pokud vývojová i produkční verze aplikace užívá Appcloud úložiště, lze tradiční “appcloudovský” release spouštět i nadále - při vytvoření nového vydání na stránce Releases v Developers je k dispozici checkbox, který toto zajistí. (Více o této přepracované stránce níže.)
- Pokud alespoň jedna verze na Appcloudu nesídlí, celý releasovací proces si musí vývojáři řešit sami. To však zároveň vývojářům umožňuje integraci pokročilých build či CI systémů do jejich vývojové workflow. A toto vše je možné, protože…
- Nově má vývojář aplikace SSH přístup k oběma verzím appky (dříve byl přístup pouze k vývojové verzi).
- Autoři aplikace tak mají větší kontrolu nad tím, co se s aplikací děje - např. je potřeba mít přístup k logům, je potřeba urychleně vydat fix nějaké chyby, nebo si vývojáři chtějí nakonfigurovat složitější build procesy přes nějaké externí CI nástroje.
- Tradiční schvalovací proces toto zásadně brzdil či zcela znemožňoval.
- Informace v MERGADO Store se nyní “přelévají” tlačítkem Aktualizovat Store, bez předchozí kontroly podpory (je však o tomto aktu notifikována).
- Poznámka: Informace se přelejí automaticky i při vytvoření nového release.
- Přes to všechno má naše podpora v případě potřeby stále možnost zasáhnout a “zlobivou” aplikaci např. skrýt z Mergado Store, či ji u některého subjektu přímo vypnout.
- Možnost “soběstačných” releasů aplikace.
-
Přepracovaná stránka Releases v Developers.
- Namísto historie stavů mezi
vývoj-žádost o release-potvrzení podporou-release-vývoj...
jsou nyní na stránce s výdánímí appky vypsané běžné záznamy s novými verzemi aplikace, které vývojář může vytvářet, editovat i mazat. - Zatím se tato historie ukazuje jen v Developers a momentálně je především pro interní účely, aby podpora Mergada měla přehled o tom, co se v aplikaci kdy a jak změnilo.
- V editoru “poznámek v vydání” lze používat Markdown.
- Namísto historie stavů mezi
-
Přepracované zabezpečení hook requestů ze strany Mergada.
- V minulosti se o autentizaci hook requestů staral samotný Appcloud. Ten - pro vývojáře zcela transparentně - kontroloval, zda požadavky z Mergada obsahují správnou hodnotu speciální HTTP hlavičky. Pokud request na URL, kde appka přijímala hooky (
.../_mergado/hook/
), neobsahoval správnou hodnotu příslušné hlavičky, požadavek server vůbec nepustil dál. Protože nově appky mohou sídlit i jinde, než na Appcloudu, tento magický mechanismus se musel přepracovat a zjednodušit. - Nově se o autentizaci hook requestů musí starat samotná appka (resp. její vývojáři).
- Jak to funguje:
- Každá stage appky má vlastní náhodně vygenerovaný a tajný klíč, tedy
Webhook Secret
. Tento klíč je k dispozici u appky v Developers. - Daný klíč zná jen MERGADO a vývojáři appky.
- MERGADO tento klíč posílá v HTTP hlavičce
Mergado-Apps-Webhook-Secret
u všech requestů, které na appku míří - tj. všechny požadavky na hook endpoint a na endpointy pravidel aplikace. - Aplikace by při přijímání requestů na těchto endpointech měla kontrolovat správnou hodnotu tajného klíče - a odmítnout ty požadavky, které ji neobsahují.
- Takto je zabráněno neoprávněným requestům od třetích stran.
- Každá stage appky má vlastní náhodně vygenerovaný a tajný klíč, tedy
- V minulosti se o autentizaci hook requestů staral samotný Appcloud. Ten - pro vývojáře zcela transparentně - kontroloval, zda požadavky z Mergada obsahují správnou hodnotu speciální HTTP hlavičky. Pokud request na URL, kde appka přijímala hooky (
-
Nový hook
ping
, kterým se v Developers dá jednoduše otestovat funkčnost hook endpointu aplikace.-
U appky na stránce Přehled v Developers jsou dvě nová tlačítka (pro každou stage jedno), kterým se na hook endpoint appky dá odeslat testovací hook (POST request) v tomto formátu:
{ "action": "ping" }
Pokud se na tento request vrátí odpověď ve formátu …
{ "message": "pong" }
… považuje se hook za úspěšně vyřízený. Vrátí-li se cokoliv jiného, je to považováno za neúspěch. V obou případech se tento výsledek ihned zobrazí v UI.
-
-
Na Appcloudu je implementovaná možnost spouštět pre-release skript.
- Tato možnost je k dispozici pouze v případě, že celý release appky probíhá v rámci Appcloudu. To znamená, že aby se pre-release spouštěl, musí obě stage appky musí jako úložiště používat Appcloud.
- Jak to funguje:
- Vývojová verze appky v rootu svého zdrojového kódu (např.
/srv/production/apps/app_logbook.dev/app/
) může obsahovat soubor s názvemmergado_pre_release
. - Tento soubor se před přepsáním produkční verze verzí vývojovou zkopíruje do root adresáře se zdrojovým kódu produkční verze (např.
/srv/production/apps/app_logbook/app/
). - Zde se soubor spustí, pod uživatelem produkční verze appky. Respektuje se shebang, takže tento skript může být napsaný jak v bashi, tak třeba i v PHP.
- Release pokračuje až po skončení tohoto skriptu (bez ohledu na výsledek). Pokud tento skript neskončí do jedné hodiny, ukončí se, výsledek se ignoruje a release pokračuje dál.
- Vývojová verze appky v rootu svého zdrojového kódu (např.
-
V Developers je nově k dispozici anglická jazyková verze MERGADO Store banneru.
-
Aplikace lze nově označit jako “deprecated”.
- U “deprecated” appky bude na její stránce v Mergado Store vidět hláška, že již není ve vývoji.
- Lze nastavit jinou appku, jakožto nástupce, na kterou se u dané hlášky v MERGADO Store bude odkazovat.
- Je to marketing-friendly alternativa k úplnému smazání aplikace.
- Je k tomu potřeba kontaktovat podporu Mergada.
MERGADO Apps 0.3.19
Release date
18. červenec 2018
Změny
- MQL má nové operátory
CONTAINS
aNOT CONTAINS
.- Příklad:
{ "name": "Product has CZ country in square brackets", "query": "[PRODUCT] CONTAINS \"[cz]\"", "read_only": false, "search_output": true }
- Tyto operátory doplňují původní regulární operátory
~
a!~
, které by u výše uvedeného příkladu pravou stranu interpretovaly nikoliv jako čistý text, nýbrž (chybně) jako regulární výraz (buď znak “c” a nebo znak “z”).
- Příklad:
- Pravidlo nastavení dopravy nyní správně vytváří element
PRICE_COD
pro formát Favi.cz, Favi.sk a Favi.ro. - Opravena chyba, kdy převodník na Zboží.cz pomíchával pořadí elementů s obrázky.
- Opravena chyba, kde Google/Facebook převodník špatně vyplňoval měnu.