Pro vývojáře

Tři volání: načtení loaderu (<script src>), předání identity (stromcom.user(...)) a inicializace vlákna (stromcom.thread(...)). Plný příklad na stránce Integrace podrobněji.

Identitu předáváte ze svého backendu. V praxi vyrenderujete stromcom.user({ id, name, ... }) až poté, co si ověříte přihlášení vlastní logikou.

Snippet pro něj prostě neinicializujete. Vlákno se nezobrazí. Stromcom je výhradně pro přihlášené zaměstnance.

Ano, ID je libovolný string. Typicky to je ID objednávky, faktury nebo zakázky. Doporučujeme prefixovat (order-12345, invoice-789), ať se nepletou vlákna napříč entitami.

Ano. stromcom.thread(selector, options) zavoláte pro každý kontejner zvlášť. Použití typicky na dashboardu, kde je v seznamu objednávek u každé řádky vlastní mini-vlákno.

Ano. Po změně routy zavoláte stromcom.thread() znovu pro nový kontejner. V Reactu typicky v useEffect navázaném na route paramy. Stromcom history API sám neodposlouchává, abychom nezasahovali do vašeho lifecyklu.

Ne. UI je vykreslené v Shadow DOM, takže izolované od stylů vaší stránky. Vlastní vzhled jde přidat skrz konfigurační volby snippetu, případně dodáním vlastní CSS.

Snippet má konfigurační option theme, kterou nastavíte při inicializaci. Pro detaily k podporovaným hodnotám a způsobu přepínání nás kontaktujte.

Ano. V conf() jde nastavit callback onNotification, který zavoláme, když má uživatel novou notifikaci — můžete tak třeba aktualizovat vlastní zvoneček v hlavičce vaší aplikace.

Soubory se ukládají u záznamu, takže zůstávají vázané na vlákno a jsou dostupné komukoliv, kdo má k záznamu přístup. Nepřenášejí se přes vaši aplikaci.

Loader se vkládá s async, takže neblokuje render stránky. Plné UI se nahrává až poté, co stránka doběhne.

Moderní evergreen prohlížeče (Chrome, Edge, Firefox, Safari). Pro IE a starší legacy prohlížeče podpora není.

Vytvoříte si druhý projekt s vlastním client key pro staging a v produkci máte samostatný. Klíče se nepřekrývají, vlákna jsou striktně oddělená per projekt.

Ano. Pro server-to-server scénáře (synchronizace uživatelů, hromadné operace, čtení historie) je k dispozici REST API zabezpečené client secretem. OpenAPI specifikace je na /docs/customer/.

Ano, oficiálně máme tři balíky — PHP generátor snippetu, PHP SDK pro Customer API a React komponenty. Detaily jsou v sekci SDK a balíky. REST API je standardní HTTP, takže klient si snadno napíšete i v jiném jazyce.

Snippet loguje do konzole s prefixem [stromcom], takže problémy s identitou nebo vlákny snadno odchytíte. Pokud to nepomůže, ozvěte se na support@stromcom.cz a podíváme se na to spolu.

Knihovna pro generování HTML snippetu na backendu. Vyrobí <script> tag s loaderem, identitou uživatele i inicializací vlákna. Nemusíte řešit escapování ani správné pořadí volání.

Repozitář: github.com/stromcom/php-snippet

Instalace: composer require stromcom/php-snippet

Server-to-server SDK nad Customer REST API. Pokrývá projekty, uživatele, vlákna, zprávy a notifikace. Typesafe rozhraní, modelové třídy pro requesty i response, ošetření chybových stavů.

Repozitář: github.com/stromcom/php-customer-sdk

Instalace: composer require stromcom/php-customer-sdk

Hotové komponenty a hooky pro React SPA. Řeší lifecycle při změně routy, předávání identity přes provider a typování přes TypeScript. Stačí obalit aplikaci providerem a v detailu záznamu vykreslit komponentu vlákna.

Repozitář: github.com/stromcom/react-snippet

Instalace: npm install @stromcom/react-snippet

Všechny tři balíky jsou veřejné na GitHubu. Issues a pull requesty vítáme. Pro citlivější věci pište na support@stromcom.cz.