Αστρολογικά widget για ιστότοπο

Τα δημόσια HTML-widgets GET /v1/embed/* επιστρέφουν έτοιμο iframe-απόσπασμα - SVG-τροχό, ωροσκόπιο, αριθμολογία κ.λπ. Χωρίς API key, όριο ανά IP επισκέπτη (120 αιτήματα ανά ώρα, ξεχωριστά από το /v1/public/*, ώστε μια σελίδα με πολλά widgets να μην χτυπάει το όριο), cache public, max-age=300. Κατάλληλα για marketing σελίδες· για high-traffic production χρησιμοποίησε το 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>

Από πού να ξεκινήσεις

Ο τρόπος ενσωμάτωσης εξαρτάται από το πώς είναι φτιαγμένο το site σου. Το περιεχόμενο είναι ίδιο, η διαφορά είναι μόνο στο πόση δουλειά μένει σε σένα.

Site	Τι να βάλεις
WordPress	Το plugin AstroWay: 18 shortcodes και 26 blocks Gutenberg. Έντεκα widgets δουλεύουν αμέσως μετά την εγκατάσταση, χωρίς key.
WordPress με Elementor	AstroWay for Elementor: επτά widgets απευθείας στον editor, με drag-and-drop.
Tilda, Squarespace, Wix, απλό HTML	Το script-loader παρακάτω ή έτοιμο <iframe> από τη gallery. Αντιγράφεται με ένα κουμπί.
Δικό σου frontend	Τα ίδια endpoints /v1/embed/*, ή το SDK, αν χρειάζεσαι πλήρη έλεγχο του layout.

Τα plugins επιστρέφουν το ίδιο περιεχόμενο με τα endpoints αυτής της σελίδας, αλλά το σχεδιάζουν στο στυλ του theme σου και δεν απαιτούν χειροκίνητη ρύθμιση ύψους.

Ξεχωριστό widget: αριθμομηχανή γενέθλιου χάρτη

Τα widgets σε αυτή τη σελίδα σχεδιάζουν αυτό που ήδη ξέρεις: ημερομηνία, ώρα και τόπο τα περνάς εσύ. Αν θέλεις τα δεδομένα να τα εισάγει ο ίδιος ο επισκέπτης, υπάρχει ένα άλλο δικό μας widget, η αριθμομηχανή γενέθλιου χάρτη (πακέτο @astroway/widget). Είναι φόρμα, υπολογισμός και τροχός με μία ενσωμάτωση, δέκα γλώσσες, ανοιχτό και σκούρο theme.

Η διαφορά δεν είναι στο στυλ, αλλά στο πού γίνεται ο υπολογισμός. Η αριθμομηχανή υπολογίζει στον browser του επισκέπτη, και τα δεδομένα γέννησης δεν φεύγουν καν στον server. Τα widgets /v1/embed/* τα υπολογίζουμε εμείς, γι’ αυτό οι παράμετροί τους φαίνονται στη διεύθυνση του iframe.

Τι χρειάζεσαι	Τι να πάρεις
Ο επισκέπτης εισάγει τα δικά του δεδομένα γέννησης	Η αριθμομηχανή @astroway/widget
Τα δεδομένα γέννησης δεν πρέπει να φύγουν από τον browser	Η αριθμομηχανή @astroway/widget
Ωροσκόπιο, διελεύσεις, ταρώ, αριθμολογία, panchang και άλλοι δώδεκα τύποι	Τα widgets αυτής της σελίδας
Είκοσι γλώσσες αντί για δέκα	Τα widgets αυτής της σελίδας

Script-loader

Αν δεν θέλεις να υπολογίζεις μόνος σου το ύψος του iframe, σύνδεσε το loader: εισάγει το iframe στη θέση του και προσαρμόζει αυτόματα το ύψος στο περιεχόμενο, επειδή το widget ανακοινώνει το μέγεθός του μέσω 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>

Οποιοδήποτε attribute data-* γίνεται παράμετρος query, οπότε τα data-theme="light" και data-lang="en" δουλεύουν όπως στο παράδειγμα με το iframe. Το data-height="500" κλειδώνει το ύψος και απενεργοποιεί την αυτόματη προσαρμογή. Πολλά widgets στην ίδια σελίδα δεν παρεμβαίνουν το ένα στο άλλο.

Δεν χρειάζεται key και δεν γίνεται δεκτό. Τα endpoints /v1/embed/* είναι δημόσια, και ένα key σε attribute θα κατέληγε στον πηγαίο κώδικα της σελίδας. Το loader αγνοεί τέτοια attributes με προειδοποίηση στην κονσόλα.

Ποια διεύθυνση να συνδέσεις

Αρχείο	Cache	Για ποιον
https://cdn.astroway.info/embed.js	5 λεπτά	Η τυπική επιλογή. Παίρνεις διορθώσεις αυτόματα.
https://cdn.astroway.info/embed.v1.js	1 χρόνο, immutable	Αν χρειάζεσαι αμεταβλητότητα. Ενημερώνεται μόνο για λόγους ασφαλείας· αλλαγές συμπεριφοράς θα πάνε στο embed.v2.js.

Gallery widgets

Ζωντανή προεπισκόπηση και των 16 widgets. Διάλεξε theme και γλώσσα περιεχομένου, εναλλάξε το snippet μεταξύ <iframe> και loader <script> και αντίγραψε τον έτοιμο κώδικα.

Κοινές παράμετροι

Τις δέχονται όλα τα widgets:

Παράμετρος	Τιμές	Προεπιλογή	Περιγραφή
theme	dark · light · console	dark	Χρωματικό σχήμα.
lang	uk · en · +18 γλώσσες	uk	Γλώσσα περιεχομένου. Διαβάζεται επίσης από το header Accept-Language.
disclaimer	1 · true · yes	απενεργοποιημένο	Προσθέτει στο footer αποποίηση για τον ψυχαγωγικό-ενημερωτικό χαρακτήρα του περιεχομένου (όχι ιατρική, ψυχολογική, οικονομική ή νομική συμβουλή).

Widgets

Widget	Endpoint	Ειδικές παράμετροι
Ωροσκόπιο ημέρας	GET /embed/daily-horoscope	sign, date
Γενέθλιος τροχός	GET /embed/wheel (alias /embed/natal)	date, time, lat, lng, tz, city
Χρονογραμμή διελεύσεων	GET /embed/transit-timeline	date, days (μέγ. 30)
Bodygraph (Human Design)	GET /embed/bodygraph	date, time, lat, lng, tz
Βεδικό kundli	GET /embed/kundli	date, time, lat, lng, tz
Μίνι-χάρτης	GET /embed/mini-chart	date, time, lat, lng, tz, city
Πλανήτης της ημέρας	GET /embed/planet-of-day	date
Φάση Σελήνης	GET /embed/moon-phase	date
Ταρώ ημέρας	GET /embed/daily-tarot	date
Μηνιαία πρόβλεψη	GET /embed/monthly-forecast	sign, month (YYYY-MM)
Διελεύσεις ουρανού	GET /embed/transit	date
Αριθμολογία	GET /embed/numerology	name, date, system (pythagorean · chaldean)
Panchang	GET /embed/panchang	date, lat, lng, tz (συντεταγμένες υποχρεωτικές)
Συναστρία	GET /embed/synastry	date_a, time_a, lat_a, lng_a, tz_a, date_b, time_b, lat_b, lng_b, tz_b
Σεληνιακό ημερολόγιο	GET /embed/moon-calendar	month (YYYY-MM), tz
Ανάπτυγμα ταρώ	GET /embed/tarot-spread	spread (single-card · three-card · decision · career), date, seed, reversed, art

Μορφές: ημερομηνία - YYYY-MM-DD, ώρα - HH:MM, tz - μετατόπιση από UTC σε ώρες. Οι μη δοθείσες παράμετροι συμπληρώνονται με έξυπνο default (τρέχουσα ημερομηνία, μεσημέρι, ισημερινός).