أدوات فلكية للموقع
تُعيد ودجت HTML العامة GET /v1/embed/* مقتطف iframe جاهزًا - عجلة SVG، برج يومي، علم الأرقام وغير ذلك. بدون مفتاح API، مع حدّ حسب IP الزائر (120 طلبًا في الساعة، بشكل منفصل عن /v1/public/*، لذا فإن صفحة تحتوي عدة ودجت لا تصطدم بالحدّ)، وتخزين مؤقت public, max-age=300. مناسبة لصفحات التسويق؛ أما للإنتاج عالي الزيارات فاستخدم 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>من أين تبدأ
Section titled “من أين تبدأ”تعتمد طريقة التضمين على ما بُني به موقعك. المحتوى واحد، والفرق فقط في مقدار العمل المتبقي عليك.
| الموقع | ماذا تستخدم |
|---|---|
| WordPress | إضافة AstroWay: 18 شورتكود و26 بلوك Gutenberg. أحد عشر ودجت تعمل فور التثبيت، بدون مفتاح. |
| WordPress مع Elementor | AstroWay for Elementor: سبعة ودجت مباشرة في المحرر، بالسحب والإفلات. |
| Tilda وSquarespace وWix وHTML عادي | سكربت التحميل أدناه أو <iframe> جاهز من المعرض. يُنسخ بضغطة زر واحدة. |
| واجهة أمامية خاصة بك | نفس نقاط النهاية /v1/embed/*، أو SDK إذا كنت تحتاج تحكمًا كاملًا في التنسيق. |
تُعيد الإضافات نفس المحتوى الذي تقدمه نقاط النهاية في هذه الصفحة، لكنها ترسمه بتصميم قالبك ولا تتطلب ضبط الارتفاع يدويًا.
ودجت منفصل: حاسبة الخريطة الفلكية
Section titled “ودجت منفصل: حاسبة الخريطة الفلكية”الودجت في هذه الصفحة ترسم ما تعرفه مسبقًا: أنت من يمرر التاريخ والوقت والمكان. أما إذا أردت أن يُدخل الزائر بياناته بنفسه، فلدينا ودجت آخر، حاسبة الخريطة الفلكية (الحزمة @astroway/widget). إنها نموذج وحساب وعجلة في تضمين واحد، بعشر لغات، وبثيم فاتح وداكن.
الفرق ليس في التصميم، بل في مكان إجراء الحساب. الحاسبة تحسب في متصفح الزائر، ولا تُرسل بيانات الميلاد إلى الخادم إطلاقًا. أما ودجت /v1/embed/* فنحسبها نحن، لذلك تظهر معاملاتها في عنوان iframe.
| ما تحتاجه | ما تختاره |
|---|---|
| الزائر يُدخل بيانات ميلاده بنفسه | حاسبة @astroway/widget |
| يجب ألا تغادر بيانات الميلاد المتصفح | حاسبة @astroway/widget |
| برج يومي، عبورات، تارو، علم أرقام، بانشانغ واثنا عشر نوعًا آخر | الودجت في هذه الصفحة |
| عشرون لغة بدلًا من عشر | الودجت في هذه الصفحة |
سكربت التحميل
Section titled “سكربت التحميل”إذا كنت لا تريد حساب ارتفاع iframe بنفسك، اربط المحمِّل: فهو يُدرج iframe مكانه ويضبط الارتفاع تلقائيًا حسب المحتوى، لأن الودجت يُبلغ عن حجمه عبر 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>أي سمة data-* تتحول إلى معامل استعلام، لذا فإن data-theme="light" وdata-lang="en" تعملان تمامًا كما في مثال iframe. وdata-height="500" تُثبّت الارتفاع وتُعطّل الضبط التلقائي. عدة ودجت في الصفحة نفسها لا تتعارض مع بعضها.
المفتاح غير مطلوب ولا يُقبل. نقاط النهاية /v1/embed/* عامة، وأي مفتاح في السمة سيظهر في الشيفرة المصدرية للصفحة. يتجاهل المحمِّل هذه السمات مع تحذير في وحدة التحكم.
أي عنوان تربط
Section titled “أي عنوان تربط”| الملف | التخزين المؤقت | لمن |
|---|---|---|
https://cdn.astroway.info/embed.js | 5 دقائق | الخيار الافتراضي. تحصل على الإصلاحات تلقائيًا. |
https://cdn.astroway.info/embed.v1.js | سنة واحدة، immutable | إذا كنت تحتاج الثبات. يُحدَّث فقط لأسباب أمنية؛ وتغييرات السلوك ستذهب إلى embed.v2.js. |
معرض الودجت
Section titled “معرض الودجت”معاينة حية لكل الودجت الـ16. اختر الثيم ولغة المحتوى، وبدّل المقتطف بين <iframe> ومحمِّل <script>، وانسخ الشيفرة الجاهزة.
المعاملات المشتركة
Section titled “المعاملات المشتركة”تقبلها جميع الودجت:
| المعامل | القيم | الافتراضي | الوصف |
|---|---|---|---|
theme | dark · light · console | dark | نظام الألوان. |
lang | uk · en · +18 لغة | uk | لغة المحتوى. تُقرأ أيضًا من ترويسة Accept-Language. |
disclaimer | 1 · true · yes | معطّل | يضيف في التذييل إخلاء مسؤولية بشأن الطابع الترفيهي والتعريفي للمحتوى (ليس استشارة طبية أو نفسية أو مالية أو قانونية). |
الودجت
Section titled “الودجت”| الودجت | Endpoint | المعاملات الخاصة |
|---|---|---|
| برج اليوم | GET /embed/daily-horoscope | sign, date |
| العجلة الفلكية | GET /embed/wheel (اسم بديل /embed/natal) | date, time, lat, lng, tz, city |
| شريط العبورات الزمني | GET /embed/transit-timeline | date, days (بحد أقصى 30) |
| مخطط الجسم (Human Design) | GET /embed/bodygraph | date, time, lat, lng, tz |
| كوندلي الفيدية | 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) |
| بانشانغ | 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 بالساعات. المعاملات غير المحددة تُملأ بقيم افتراضية ذكية (التاريخ الحالي، الظهر، خط الاستواء).