Náhled kalkulátoru
Aktivace iframe kalkulačky
Před vložením kalkulačky do vaší webové stránky je nezbytné nejprve aktivovat přístup. Kvůli bezpečnostním omezením (CORS) nám prosím zašlete následující informace:- URL, na které bude kalkulačka umístěna (např.
https://www.vasespolecnost.cz) - Vaše IČO
Údaje pošlete na email
info@cubee.cz{IČO} vaším IČO.
HTML kód pro vložení kalkulačky
JavaScript pro přizpůsobení výšky a zachycení odeslání
<script> tagu.
K čemu slouží vaše IČO
IČO v URL iframe nemá jen roli bezpečnostního klíče. Cubee podle něj pozná, na čím webu výpočet vznikl, a chová se podle toho:- Leady zůstávají vám. Kalkulace z vašeho webu se nezařadí mezi obchodní leady Cubee.
- Studie úspor nese vaši značku. Když se k výpočtu generuje PDF studie, Cubee předá vaše IČO partnerskému API v hlavičce
X-Cubee-Cin. Podle ní se do studie doplní vaše logo a kontakt místo obecného Cubee brandingu. Neznámé IČO znamená obecnou studii — výpočet proběhne stejně.
Hlavičku
X-Cubee-Cin posílá Cubee sama za vás — je vyhrazená pro naši vlastní integraci a z partnerského tokenu ji použít nelze (API vrátí 403). Vy nastavujete jen IČO v URL iframe.Volitelné parametry
Kalkulátor umožňuje nastavit vlastní poplatky za nákup a prodej elektřiny, které se použijí při výpočtu Optimálního řešení. Tyto parametry se předávají jako query parametry v URL iframe.
Oba parametry jsou volitelné a nezávislé — můžete nastavit jen jeden, druhý, nebo oba. Pokud nejsou uvedeny, použijí se výchozí hodnoty.
Příklad použití
Časté dotazy
Mohu iframe vložit na více domén?
Mohu iframe vložit na více domén?
Ano, můžete. Stačí nám při aktivaci zaslat všechny URL adresy, kde bude iframe nasazen, a my je přidáme mezi povolené zdroje (CORS whitelist).
Mohu kalkulačku stylovat pomocí CSS?
Mohu kalkulačku stylovat pomocí CSS?
Kalkulačka běží v sandboxovaném iframe, takže ji nelze ovlivnit pomocí stylů z vaší stránky. Můžete ale stylovat její obalový kontejner (
div) – například šířku, zarovnání nebo ohraničení.Existuje callback po odeslání formuláře?
Existuje callback po odeslání formuláře?
Ano, iframe odešle událost přes
postMessage s typem calculatorSubmit. Událost obsahuje email zadaný uživatelem, který můžete dále zpracovat např. odesláním na vlastní backend.Podporuje iframe lazy-loading?
Podporuje iframe lazy-loading?
Ano. Pro optimalizaci načítání můžete do iframe elementu přidat atribut
loading="lazy":Jak často se kalkulačka aktualizuje?
Jak často se kalkulačka aktualizuje?
Kalkulačka je vždy načítána z našich serverů. Veškeré změny a aktualizace se projeví automaticky bez potřeby zásahu z vaší strany.
Funguje iframe i na localhostu při vývoji?
Funguje iframe i na localhostu při vývoji?
Ano. Pro účely vývoje je automaticky povolen přístup z následujících domén:
localhostlocalhost:3000localhost:5173127.0.0.1Díky tomu můžete iframe snadno testovat i v lokálním vývojovém prostředí (např. při použití Reactu, Vite, Next.js apod.).
⚠️ Po nasazení na produkční doménu je nutné nám tuto doménu nahlásit, jinak se iframe z bezpečnostních důvodů nezobrazí (CORS).