Dokumentace pro agentury

• Háčky ve značkováníAtributy data-blok a data-cast, podle kterých spolehlivě najdete blok nebo část obchodu, a co smí vlastní CSS na kořeni stránky.
• Bloky a jejich poleKaždý druh bloku stránky a jeho pole: texty, adresy, obrázky a volby.
• Předloha webuWeb uložený jako soubor JSON: téma, stránky, úvodní strana, podoba e-shopu a vlastní CSS. I volby podoby a šablony e-shopu.
• Webhooky a APIAPI klíče s rozsahem a podepsané webhooky pro ERP, sklad a Zapier.
• Frontend partneraKlíč frontendu, SDK, předání košíku do pokladny, vzhled v souborech, schéma bloků, bloky partnera a nahrání frontendu: jak postavit klientovi vlastní frontend.

Jak začít

1. Založte e-shop nebo web na stránce registrace. První obchod může být váš vlastní, na zkoušení.
2. Jako partner programu založíte obchod pro klienta přímo v Portálu partnera, pokud jste kontaktní osoba partnera: v části Obchody tlačítkem Založit obchod pro klienta vyplníte název, adresu, druh obchodu, trh, šablonu z knihovny, e-mail a firmu majitele a potvrdíte souhlas s podmínkami. Obchod vznikne hned, bez registrace na webu a bez ověřovacího e-mailu. Založit ho můžete i přes odkaz se svým kódem: při registraci z kontaktní adresy partnera zvolíte „Zakládám obchod pro klienta“ a zadáte e-mail majitele obchodu. Vznikne vývojový obchod: zákazníci ho nevidí, nic se v něm nekoupí, předplatné se za něj neúčtuje (funkce umělé inteligence jdou i tady z kreditu) a vy si ho prohlížíte přes náhled z obrazovky Předplatné. Vlastní CSS v něm máte zapnuté od začátku. Nečinný obchod platforma uspí, nic z něj nesmaže; uspat ho můžete i sami tlačítkem Uspat obchod na obrazovce Předplatné. Uspaný obchod se do limitu rozpracovaných obchodů nepočítá.
3. Majitel obchodu dostane hned při založení pozvánku do role Majitel a obchod vidí od začátku; vy v něm pracujete jako Developer. Až bude obchod hotový, majitel ho otevře zákazníkům na obrazovce Předplatné: zkontroluje fakturační údaje své firmy, souhlasí s podmínkami a předplatné si zapne sám. Obchod pro klienta zakládejte na trhu země, ve které má majitel firmu: země se po založení nemění.
4. Na admin.portican.com máte jako partner Portál partnera: obchody, které vám Portican přiřadil, a jejich stav, vaše kódy s odkazem na registraci, zapsané provize po měsících s tlačítkem Stáhnout CSV a šablony ve vaší knihovně. Přístup do něj dostanete pozvánkou od Porticanu. U kódu a u šablony z knihovny zůstává tlačítko Založit obchod pro klienta, které otevře registraci s vaším kódem, abyste odkaz mohli poslat dalším lidem partnera; obchod pro klienta z něj vznikne jen z kontaktní adresy partnera. Vzhled obchodu se ukládá jako verze: na obrazovce Verze vzhledu si prohlédnete náhled, verzi zveřejníte nebo vrátíte předchozí.
5. Administrace běží na admin.portican.com. V části Obchod › Vzhled nastavíte barvy, písma a zaoblení a šablonu webu Základ nebo Expert, u Expertu i styl. Obchod s e-shopem tam má i 19 šablon e-shopu. Šablona nastaví písma, zaoblení a barvy, skladbu úvodní strany a celou podobu e-shopu; barvy značky převezme jen na výslovnou volbu a obsah, logo ani fotky nemění. Před použitím ukáže, co se změní, a předchozí vzhled jde jedním tlačítkem vrátit. Část voleb podoby e-shopu (celkem jich je 17) změníte v bloku Podoba obchodu i jednotlivě. Šablony i volby s jejich atributy popisuje Předloha webu.
6. Stránky skládáte z bloků v části Obsah › Stránky webu. Web ji má od založení, e-shop si ji zapne na každém trhu v části Předplatné a doplňky › Enginy (engine Stránky webu); zveřejněná stránka s pořadím v nabídce se ukáže v záhlaví i v patičce obchodu. Zveřejněná stránka s prázdnou adresou nahradí úvodní stranu e-shopu a adresu cesty obchodu (košík, pokladna, produkt) stránka obsadit nemůže. Jaké bloky existují a jaká mají pole, najdete v části Bloky a jejich pole.
7. Hotový web nebo e-shop uložíte v části Obsah › Předloha webu jako soubor a u dalšího klienta ho použijete jako základ. E-shop bez stránek webu v ní uloží a použije vzhled, úvodní stranu a podobu e-shopu, s oprávněním k vlastnímu CSS i vlastní CSS; se stránkami webu i stránky, přijdou jako koncepty. Formát souboru popisuje Předloha webu. Jako partner tam vzhled obchodu, který stavíte, uložíte i tlačítkem Uložit do mé knihovny šablon; šablonu z knihovny pak použijete v dalším obchodě nebo s ní založíte obchod pro klienta.

Co platforma dovolí a co ne

• Jeden obchod pro všechny. Všichni klienti běží ve stejném sestaveném obchodě. Vlastní šablona ani kód pro jednoho klienta neexistuje; vzhled a skladbu webu měníte nastavením: tématem, šablonou, bloky a předlohou.
• Vlastní JavaScript do šablon ani bloků nevložíte. Blok nese texty, adresy a volby a obchod je vypisuje jako text, nikdy jako HTML. Adresu, která není bezpečný odkaz, platforma zahodí.
• Měřicí značky jen přes nastavení měření. Připojují se v části Marketing › Měření a reklama, a to jen sítě ze seznamu níže. Obchod je řídí souhlasem návštěvníka: Google před souhlasem dostane jen signál bez cookies (rozšířený režim souhlasu), ostatní sítě se spustí až po souhlasu s analytikou nebo marketingem.
• Google Tag Manager si souhlas hlídá sám. Kontejner dostane stav souhlasu dřív, než se spustí. Každá značka v něm musí mít zapnuté kontroly souhlasu (analytics_storage, ad_storage), jinak lištu se souhlasem obejde; to platforma za vás ohlídat neumí.
• Vlastní CSS jen nad háčky. S Enginem Vlastní CSS píšete styly v části Obchod › Vlastní CSS. Každé pravidlo začíná háčkem ze seznamu v části Háčky ve značkování; před háčkem smí stát kořen stránky s atributy šablony, tmavého režimu a podoby e-shopu a samotný kořen smí měnit proměnné tématu a nést vlastní proměnné (Háčky ve značkování). Obrázky jdou jen z knihovny médií obchodu, vlastní písmo (@font-face) neprojde. Server styly před zveřejněním pročistí a u každého nálezu řekne řádek a důvod; každé uložení je verze s náhledem. Zveřejnit i vypnout je můžete najednou i na dalších trzích obchodu; při zveřejnění se tam stejný zdroj pročistí a uloží jako nová verze. Na pokladně, při přihlášení, v účtu zákazníka, na právních textech a u formulářů s osobními údaji vlastní styly neplatí.
• O vypnutém vlastním CSS se dozvíte. Když ho v obchodě, který jste přivedli nebo ještě stavíte, vypne obsluha obchodu nebo Portican, každý z vás s přijatým přístupem do Portálu partnera dostane e-mail. Když ho vypnete sami, e-mail nepřijde.
• Pokladna, přihlášení a účet zákazníka háčky nemají. Tam, kde zákazník píše heslo nebo platí, platí vzhled platformy.
• Právní texty platforma nepíše. Obchodní podmínky, ochrana osobních údajů a reklamační řád mají v obchodě své místo, znění do něj vkládá obchodník se svým právníkem.

Měřicí sítě, které obchod umí připojit

• Google Tag Manager analytika
• Google Analytics 4 analytika
• Microsoft Clarity analytika
• Google Ads marketing
• Meta (Facebook, Instagram) marketing
• Reklama v ChatGPT marketing
• TikTok marketing
• Pinterest marketing
• LinkedIn marketing
• Microsoft Advertising marketing
• Sklik (Seznam) marketing
• Zákaznické recenze Google marketing
• Ecomail (newsletter) marketing

Z kódu platformy. Tento seznam se skládá přímo ze zdrojového kódu platformy a každé nasazení ověří, že s ním souhlasí.

Jak nahlásit chybu

Napište na info@portican.com. Chybu opravíme rychleji, když ve zprávě bude:

• adresa stránky, na které se chyba ukazuje,
• kdy se stala, s datem, časem a časovým pásmem,
• co jste čekali a co se stalo místo toho,
• snímek obrazovky, prohlížeč a zařízení,
• u háčku jeho hodnota, u předlohy soubor, který jste použili.

Háček ze seznamu, který na stránce chybí nebo stojí jinde, než říká popis, je chyba platformy. Nahlaste ji.