Asztrológiai widgetek a weboldalhoz

A nyilvános HTML-widgetek GET /v1/embed/* kész iframe-részletet adnak vissza – SVG-kerék, horoszkóp, numerológia stb. API-kulcs nélkül, IP-alapú korlát a látogató számára (120 kérés óránként, külön a /v1/public/*-tól, így több widgetet tartalmazó oldal nem ütközik a limitbe), cache public, max-age=300. Marketing oldalakhoz alkalmasak; nagy forgalmú produkcióhoz használd a SDK-t.

<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>

Hol kezdjünk

A beillesztés módja attól függ, hogy mivel készült a weboldalad. A tartalom ugyanaz, a különbség csak abban van, mennyi munka marad rád.

Weboldal	Mit kell elhelyezni
WordPress	A AstroWay plugin: 18 shortcode és 26 Gutenberg blokk. Tizenegy widget azonnal működik a telepítés után, API-kulcs nélkül.
WordPress Elementorral	AstroWay for Elementor: hét widget egyszerűen a szerkesztőben, húzd‑és‑ejtsd módszerrel.
Tilda, Squarespace, Wix, egyszerű HTML	Az alábbi script‑loader vagy egy kész <iframe> a galériából. Egy gombnyomással másolható.
Saját frontend	Ugyanazok az endpointok /v1/embed/*, vagy a SDK, ha teljes kontrollra van szükséged a megjelenítés felett.

A pluginek ugyanazt a tartalmat adják vissza, mint az endpointok ezen az oldalon, de a saját témád stílusában jelenítik meg, és nem igényelnek manuális magasság beállítást.

Külön widget: születési képlet kalkulátor

Az oldalon lévő widgetek azt jelenítik meg, amit már tudsz: a dátumot, időt és helyet te adod meg. Ha azt szeretnéd, hogy a látogató maga adja meg az adatokat, van egy másik widgetünk, a születési képlet kalkulátor (a @astroway/widget csomag). Ez egy űrlap, számítás és kerék egy beillesztéssel, tíz nyelven, világos és sötét témákkal.

A különbség nem a megjelenésben, hanem abban, hogy hol történik a számítás. A kalkulátor a látogató böngészőjében számol, és a születési adatok egyáltalán nem kerülnek a szerverre. A /v1/embed/* widgeteket mi számoljuk, ezért a paramétereik az iframe URL-jében láthatók.

Mit kell neked	Mit vegyél
A látogató adja meg a saját születési adatait	Kalkulátor @astroway/widget
A születési adatoknak nem szabad elhagyniuk a böngészőt	Kalkulátor @astroway/widget
Horoszkóp, tranzitok, tarot, numerológia, panchang és még tizenkét típus	Az oldalon lévő widgetek
Húsz nyelv a tíz helyett	Az oldalon lévő widgetek

Script‑loader

Ha nem akarod magad kiszámolni az iframe magasságát, csatlakoztasd a loadert: ő helyettesíti magát egy iframe‑el, és automatikusan igazítja a magasságot a tartalomhoz, mivel a widget a méretét a postMessage‑en keresztül jelzi.

<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>

Bármely data-* attribútum kérésparaméterré válik, így a data-theme="light" és a data-lang="en" ugyanúgy működik, mint az iframe példában. A data-height="500" rögzíti a magasságot és kikapcsolja az automatikus méretezést. Több widget egy oldalon nem zavarja egymást.

Kulcs nem szükséges és nem is elfogadott. A /v1/embed/* endpointok nyilvánosak, és a kulcs az attribútumban a oldal forráskódjába kerülne. A loader ezeket az attribútumokat figyelmen kívül hagyja, és figyelmeztetést ír a konzolra.

Melyik URL-t csatlakoztasd

Fájl	Cache	Kinek
https://cdn.astroway.info/embed.js	5 perc	Általános választás. A javítások automatikusan megérkeznek.
https://cdn.astroway.info/embed.v1.js	1 év, immutable	Ha állandóságra van szükség. Csak biztonsági okokból frissül; a viselkedés változásai a embed.v2.js‑be kerülnek.

Widget galéria

Élő előnézet az összes 16 widgetről. Válaszd ki a témát és a tartalom nyelvét, válts a snippet-et <iframe> és a <script> loader között, és másold ki a kész kódot.

Közös paraméterek

Minden widget elfogadja:

Paraméter	Érték	Alapértelmezett	Leírás
theme	dark · light · console	dark	Szín séma.
lang	uk · en · +18 nyelv	uk	A tartalom nyelve. Az Accept-Language fejlécből is olvasható.
disclaimer	1 · true · yes	kikapcsolva	Lábfejhez hozzáad egy nyilatkozatot, hogy a tartalom szórakoztató‑ismeretterjesztő jellegű (nem orvosi, pszichológiai, pénzügyi vagy jogi tanács).

Widgetek

Widget	Endpoint	Specifikus paraméterek
Napi horoszkóp	GET /embed/daily-horoscope	sign, date
Születési kerék	GET /embed/wheel (alias /embed/natal)	date, time, lat, lng, tz, city
Tranzit idővonal	GET /embed/transit-timeline	date, days (max. 30)
Bodygraph (Human Design)	GET /embed/bodygraph	date, time, lat, lng, tz
Védikus kundli	GET /embed/kundli	date, time, lat, lng, tz
Mini térkép	GET /embed/mini-chart	date, time, lat, lng, tz, city
Nap bolygója	GET /embed/planet-of-day	date
Holdfázis	GET /embed/moon-phase	date
Napi tarot	GET /embed/daily-tarot	date
Havi előrejelzés	GET /embed/monthly-forecast	sign, month (YYYY-MM)
Égi tranzitok	GET /embed/transit	date
Numerológia	GET /embed/numerology	name, date, system (pythagorean · chaldean)
Panchang	GET /embed/panchang	date, lat, lng, tz (koordináták kötelezőek)
Szinasztéria	GET /embed/synastry	date_a, time_a, lat_a, lng_a, tz_a, date_b, time_b, lat_b, lng_b, tz_b
Holdnaptár	GET /embed/moon-calendar	month (YYYY-MM), tz
Tarot elrendezés	GET /embed/tarot-spread	spread (single-card · three-card · decision · career), date, seed, reversed, art

Formátumok: dátum - YYYY-MM-DD, idő - HH:MM, tz - UTC offset órában. A nem megadott paraméterek okos alapértelmezéssel kerülnek kitöltésre (aktuális dátum, dél, egyenlítő).