Dokumentácia pre agentúry

• Háčiky v značkovaníAtribúty data-blok a data-cast, podľa ktorých spoľahlivo nájdete blok alebo časť obchodu, a čo smie vlastné CSS na koreni stránky.
• Bloky a ich poliaKaždý druh bloku stránky a jeho polia: texty, adresy, obrázky a voľby.
• Predvoľba webuWeb uložený ako súbor JSON: téma, stránky, úvodná strana, podoba e-shopu a vlastné CSS. Aj voľby podoby a šablóny e-shopu.
• Webhooky a APIAPI kľúče s rozsahom a webhooky s podpisom pre ERP, sklad a Zapier.
• Frontend partneraKľúč frontendu, SDK, odovzdanie košíka do pokladne, vzhľad v súboroch, schéma blokov, bloky partnera a nahratie frontendu: ako postaviť klientovi vlastný frontend.

Ako začať

1. Založte obchod alebo web na stránke registrácie. Prvý obchod môže byť váš vlastný, na skúšanie.
2. Ako partner programu založíte obchod pre klienta priamo v Portáli partnera, ak ste kontaktná osoba partnera: v časti Obchody tlačidlom Založiť obchod pre klienta vyplníte názov, adresu, druh obchodu, trh, šablónu z knižnice, e-mail a firmu majiteľa a potvrdíte súhlas s podmienkami. Obchod vznikne hneď, bez registrácie na webe a bez overovacieho e-mailu. Založiť ho viete aj cez odkaz so svojím kódom: pri registrácii z kontaktnej adresy partnera zvolíte „Zakladám obchod pre klienta“ a zadáte e-mail majiteľa obchodu. Vznikne vývojový obchod: zákazníci ho nevidia, nič sa v ňom nekúpi, predplatné sa zaň neúčtuje (funkcie umelej inteligencie idú aj tu z kreditu) a vy ho prezeráte cez náhľad z obrazovky Predplatné. Vlastné CSS v ňom máte zapnuté od začiatku. Nečinný obchod platforma uspí, nič z neho nezmaže; uspať ho viete aj sami tlačidlom Uspať obchod na obrazovke Predplatné. Uspaný obchod sa do stropu rozrobených obchodov nepočíta.
3. Majiteľ obchodu dostane hneď pri založení pozvánku na rolu Majiteľ a obchod vidí od začiatku; vy v ňom pracujete ako Developer. Keď je obchod hotový, majiteľ ho otvorí zákazníkom na obrazovke Predplatné: skontroluje fakturačné údaje svojej firmy, súhlasí s podmienkami a predplatné si zapne sám. Obchod pre klienta zakladajte na trhu krajiny, v ktorej má majiteľ firmu: krajina sa po založení nemení.
4. Na admin.portican.com máte ako partner Portál partnera: obchody, ktoré vám Portican priradil, a ich stav, vaše kódy s odkazom na registráciu, zapísané provízie po mesiacoch s tlačidlom Stiahnuť CSV a šablóny vo vašej knižnici. Prístup doň dostanete pozvánkou od Porticanu. Pri kóde a pri šablóne z knižnice ostáva tlačidlo Založiť obchod pre klienta, ktoré otvorí registráciu s vaším kódom, aby ste odkaz mohli poslať ďalším ľuďom partnera; obchod pre klienta z neho vznikne len z kontaktnej adresy partnera. Vzhľad obchodu sa ukladá ako verzie: na obrazovke Verzie vzhľadu si pozriete náhľad, verziu zverejníte alebo vrátite predošlú.
5. Administrácia beží na admin.portican.com. V časti Obchod › Vzhľad nastavíte farby, písma a zaoblenie a šablónu webu Základ alebo Expert, pri Experte aj štýl. Obchod s e-shopom tam má aj 19 šablón e-shopu. Šablóna nastaví písma, zaoblenie a farby, skladbu úvodnej strany a celú podobu e-shopu; farby značky prevezme len na výslovnú voľbu a obsah, logo ani fotky nemení. Pred použitím ukáže, čo sa zmení, a predošlý vzhľad sa dá jedným tlačidlom vrátiť. Časť volieb podoby e-shopu (spolu ich je 17) zmeníte v bloku Podoba obchodu aj jednotlivo. Šablóny aj voľby s ich atribútmi opisuje Predvoľba webu.
6. Stránky skladáte z blokov v časti Obsah › Stránky webu. Web ju má od založenia, e-shop si ju zapne na každom trhu v časti Predplatné a doplnky › Enginy (engine Stránky webu); zverejnená stránka s poradím v ponuke sa ukáže v hlavičke aj v pätičke obchodu. Zverejnená stránka s prázdnou adresou nahradí úvodnú stranu e-shopu a adresu cesty obchodu (košík, pokladňa, produkt) stránka zabrať nemôže. Aké bloky sú a aké polia majú, je v časti Bloky a ich polia.
7. Hotový web alebo e-shop uložíte v časti Obsah › Predvoľba webu ako súbor a u ďalšieho klienta ho použijete ako základ. E-shop bez stránok webu v nej uloží a použije vzhľad, úvodnú stranu a podobu e-shopu, s právom na vlastné CSS aj vlastné CSS; so stránkami webu aj stránky, prídu ako koncepty. Formát súboru opisuje Predvoľba webu. Ako partner tam vzhľad obchodu, ktorý staviate, uložíte aj tlačidlom Uložiť do mojej knižnice šablón; šablónu z knižnice potom použijete v ďalšom obchode alebo s ňou založíte obchod pre klienta.

Čo platforma dovolí a čo nie

• Jeden obchod pre všetkých. Všetci klienti bežia v tom istom zostavenom obchode. Vlastná šablóna ani kód pre jedného klienta neexistuje; vzhľad a skladbu webu meníte nastavením: témou, šablónou, blokmi a predvoľbou.
• Vlastný JavaScript do šablón ani blokov nevložíte. Blok nesie texty, adresy a voľby a obchod ich vypisuje ako text, nikdy ako HTML. Adresu, ktorá nie je bezpečný odkaz, platforma zahodí.
• Meracie značky len cez nastavenia merania. Pripájajú sa v časti Marketing › Meranie a reklama, a to len siete zo zoznamu nižšie. Obchod ich riadi súhlasom návštevníka: Google pred súhlasom dostane len signál bez cookies (rozšírený režim súhlasu), ostatné siete sa spustia až po súhlase s analytikou alebo marketingom.
• Google Tag Manager si súhlas stráži sám. Kontajner dostane stav súhlasu skôr, než sa spustí. Každá značka v ňom musí mať zapnuté kontroly súhlasu (analytics_storage, ad_storage), inak lištu súhlasu obíde; to platforma za vás nevie ustrážiť.
• Vlastné CSS len nad háčikmi. S Enginom Vlastné CSS píšete štýly v časti Obchod › Vlastné CSS. Každé pravidlo začína háčikom zo zoznamu v časti Háčiky v značkovaní; pred háčikom smie stáť koreň stránky s atribútmi šablóny, tmavého režimu a podoby e-shopu a samotný koreň smie meniť premenné témy a niesť vlastné premenné (Háčiky v značkovaní). Obrázky idú len z knižnice médií obchodu, vlastné písmo (@font-face) neprejde. Server štýly pred zverejnením prečistí a pri každom náleze povie riadok a dôvod; každé uloženie je verzia s náhľadom. Zverejniť aj vypnúť ich môžete naraz aj na ďalších trhoch obchodu; pri zverejnení sa tam ten istý zdroj vyčistí a uloží ako nová verzia. Na pokladni, pri prihlásení, v účte zákazníka, na právnych textoch a pri formulároch s osobnými údajmi vlastné štýly neplatia.
• O vypnutom vlastnom CSS sa dozviete. Keď ho v obchode, ktorý ste priviedli alebo ešte staviate, vypne obsluha obchodu alebo Portican, každý z vás s prijatým prístupom do Portálu partnera dostane e-mail. Keď ho vypnete sami, e-mail nepríde.
• Pokladňa, prihlásenie a účet zákazníka háčiky nemajú. Tam, kde zákazník píše heslo alebo platí, platí vzhľad platformy.
• Právne texty platforma nepíše. Obchodné podmienky, ochrana osobných údajov a reklamačný poriadok majú v obchode svoje miesto, znenie do neho vkladá obchodník so svojím právnikom.

Meracie siete, ktoré obchod vie pripojiť

• 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
• Google zákaznícke recenzie marketing
• Ecomail (newsletter) marketing

Z kódu platformy. Tento zoznam sa skladá priamo zo zdrojového kódu platformy a každé nasadenie overí, že s ním sedí.

Ako nahlásiť chybu

Napíšte na info@portican.com. Chybu opravíme rýchlejšie, keď v správe bude:

• adresa stránky, na ktorej sa chyba ukazuje,
• kedy sa stala, s dátumom, časom a časovým pásmom,
• čo ste čakali a čo sa stalo namiesto toho,
• snímka obrazovky, prehliadač a zariadenie,
• pri háčiku jeho hodnota, pri predvoľbe súbor, ktorý ste použili.

Háčik zo zoznamu, ktorý na stránke chýba alebo stojí inde, než hovorí popis, je chyba platformy. Nahláste ju.