Astrologické widgety pro web
Veřejné HTML widgety GET /v1/embed/* vrací hotový iframe fragment – SVG kolo, horoskop, numerologii a podobně. Bez API klíče, limit podle IP návštěvníka (120 požadavků za hodinu, odděleně od /v1/public/*, takže stránka s několika widgety nenarazí na limit), cache public, max-age=300. Hodí se pro marketingové stránky; pro high-traffic produkci použij SDK.
<iframe src="https://api.astroway.info/v1/embed/wheel?date=1990-05-15&time=14:30&lat=50.45&lng=30.52&tz=2&theme=dark" width="460" height="560" style="border:0"></iframe>Jak začít
Sekce “Jak začít”Způsob vložení závisí na tom, na čem je tvůj web postavený. Obsah je stejný, rozdíl je jen v tom, kolik práce ti zbývá.
| Web | Co použít |
|---|---|
| WordPress | Plugin AstroWay: 18 shortcodů a 26 bloků Gutenberg. Jedenáct widgetů funguje hned po instalaci, bez klíče. |
| WordPress s Elementorem | AstroWay for Elementor: sedm widgetů přímo v editoru, přetažením. |
| Tilda, Squarespace, Wix, obyčejné HTML | Skript-loader níže nebo hotový <iframe> z galerie. Zkopíruje se jedním tlačítkem. |
| Vlastní frontend | Stejné endpointy /v1/embed/*, nebo SDK, pokud potřebuješ plnou kontrolu nad layoutem. |
Pluginy vrací stejný obsah jako endpointy na této stránce, ale vykreslují ho ve stylu tvé šablony a nevyžadují ruční nastavování výšky.
Samostatný widget: kalkulačka natální karty
Sekce “Samostatný widget: kalkulačka natální karty”Widgety na této stránce vykreslují to, co už znáš: datum, čas a místo předáváš ty. Pokud potřebuješ, aby údaje zadával sám návštěvník, existuje náš jiný widget, kalkulačka natální karty (balíček @astroway/widget). Je to formulář, výpočet a kolo v jednom vložení, deset jazyků, světlý i tmavý motiv.
Rozdíl není ve vzhledu, ale v tom, kde probíhá výpočet. Kalkulačka počítá v prohlížeči návštěvníka a údaje o narození na server vůbec neodcházejí. Widgety /v1/embed/* počítáme my, proto jsou jejich parametry vidět v adrese iframe.
| Co potřebuješ | Co zvolit |
|---|---|
| Návštěvník zadává vlastní údaje o narození | Kalkulačka @astroway/widget |
| Údaje o narození nesmí opustit prohlížeč | Kalkulačka @astroway/widget |
| Horoskop, tranzity, tarot, numerologie, pančang a dalších dvanáct typů | Widgety na této stránce |
| Dvacet jazyků místo deseti | Widgety na této stránce |
Skript-loader
Sekce “Skript-loader”Pokud nechceš sám počítat výšku iframe, připoj loader: vloží iframe místo sebe a automaticky přizpůsobí výšku obsahu, protože widget hlásí svou velikost přes postMessage.
<script src="https://cdn.astroway.info/embed.js" data-widget="wheel" data-date="1990-05-15" data-time="14:30" data-lat="50.45" data-lng="30.52" data-tz="3"></script>Jakýkoli atribut data-* se stane parametrem dotazu, takže data-theme="light" a data-lang="en" fungují stejně jako v příkladu s iframe. data-height="500" výšku zafixuje a vypne automatické přizpůsobení. Několik widgetů na jedné stránce si vzájemně nepřekáží.
Klíč není potřeba a není přijímán. Endpointy /v1/embed/* jsou veřejné a klíč v atributu by se dostal do zdrojového kódu stránky. Loader takové atributy ignoruje s varováním do konzole.
Jakou adresu připojit
Sekce “Jakou adresu připojit”| Soubor | Cache | Pro koho |
|---|---|---|
https://cdn.astroway.info/embed.js | 5 minut | Výchozí volba. Opravy dostáváš automaticky. |
https://cdn.astroway.info/embed.v1.js | 1 rok, immutable | Pokud potřebuješ neměnnost. Aktualizuje se jen kvůli bezpečnosti; změny chování přijdou v embed.v2.js. |
Galerie widgetů
Sekce “Galerie widgetů”Živý náhled všech 16 widgetů. Vyber motiv a jazyk obsahu, přepni snippet mezi <iframe> a loaderem <script> a zkopíruj hotový kód.
Společné parametry
Sekce “Společné parametry”Přijímají všechny widgety:
| Parametr | Hodnoty | Výchozí | Popis |
|---|---|---|---|
theme | dark · light · console | dark | Barevné schéma. |
lang | uk · en · +18 jazyků | uk | Jazyk obsahu. Čte se také z hlavičky Accept-Language. |
disclaimer | 1 · true · yes | vypnuto | Přidá do patičky upozornění na zábavně-informační charakter obsahu (nejde o lékařské, psychologické, finanční ani právní poradenství). |
Widgety
Sekce “Widgety”| Widget | Endpoint | Specifické parametry |
|---|---|---|
| Horoskop dne | GET /embed/daily-horoscope | sign, date |
| Natální kolo | GET /embed/wheel (alias /embed/natal) | date, time, lat, lng, tz, city |
| Páska tranzitů | GET /embed/transit-timeline | date, days (max. 30) |
| Bodygraph (Human Design) | GET /embed/bodygraph | date, time, lat, lng, tz |
| Védská kundli | GET /embed/kundli | date, time, lat, lng, tz |
| Mini-karta | GET /embed/mini-chart | date, time, lat, lng, tz, city |
| Planeta dne | GET /embed/planet-of-day | date |
| Fáze Měsíce | GET /embed/moon-phase | date |
| Tarot dne | GET /embed/daily-tarot | date |
| Měsíční předpověď | GET /embed/monthly-forecast | sign, month (YYYY-MM) |
| Tranzity nebe | GET /embed/transit | date |
| Numerologie | GET /embed/numerology | name, date, system (pythagorean · chaldean) |
| Pančang | GET /embed/panchang | date, lat, lng, tz (souřadnice povinné) |
| Synastrie | GET /embed/synastry | date_a, time_a, lat_a, lng_a, tz_a, date_b, time_b, lat_b, lng_b, tz_b |
| Měsíční kalendář | GET /embed/moon-calendar | month (YYYY-MM), tz |
| Výklad tarotu | GET /embed/tarot-spread | spread (single-card · three-card · decision · career), date, seed, reversed, art |
Formáty: datum – YYYY-MM-DD, čas – HH:MM, tz – posun od UTC v hodinách. Nezadané parametry se doplní rozumnou výchozí hodnotou (aktuální datum, poledne, rovník).