Event API الملحق

استخدم Event API الملحق أداة قوية مصممة لـ Modern Events Calendar يتيح لك ذلك عرض فعالياتك بسلاسة على تطبيقات ومنصات الويب الخارجية. من خلال إنشاء نصوص برمجية أو ملفات JSON، يمكنك مزامنة بيانات الفعاليات عبر نطاقات متعددة دون الحاجة إلى إعادة إدخالها يدويًا.

الإعداد الأولي والمتطلبات

التركيب

قبل البدء، تأكد من استيفاء المتطلبات التالية:

التنشيط: انتقل إلى قائمة إضافات ووردبريس وتأكد من كليهما MEC و مبادئ السلوك Event API الملحق نشطة.

MEC Lite أو Pro: على عكس بعض addonsأطلقت حملة Event API يعمل مع كلا الإصدارين من Modern Events Calendar.

باستخدام Event API

يمكنك إنشاء واجهة برمجة تطبيقات إما لمجموعة محددة من الأحداث (عبر الرموز المختصرة) أو لصفحة حدث فردية.

Event API للرموز المختصرة

لعرض عرض تقويم محدد على موقع ويب آخر:

1. انتقل إلى MEC > الرموز المختصرة.
2. حدد الرمز المختصر الذي تريده وانقر إنشاء API.

Event API للأحداث الفردية

لعرض تفاصيل حدث واحد على موقع ويب آخر:

1. انتقل إلى MEC > جميع الأحداث.
2. ابحث عن الفعالية التي اخترتها وانقر إنشاء API.

إدارة مركز واجهة برمجة التطبيقات (API)

بمجرد النقر على "إنشاء واجهة برمجة التطبيقات"، سيتم توجيهك إلى واجهة الإدارة. تنقسم هذه الصفحة إلى قسمين رئيسيين:

إدارة النطاقات (الجانب الأيسر)

• ترخيص النطاق: أدخل النطاق (النطاقات) المحدد الذي تريد عرض الحدث فيه. يمكنك أيضًا ضبط واجهة برمجة التطبيقات (API) للعمل على جميع النطاقات.
• إزالة الوصول: لإلغاء الوصول، حدد النطاق (النطاقات) وانقر فوق أيقونة سلة المهملات. يؤدي هذا إلى تعطيل واجهة برمجة التطبيقات (API) لتلك المواقع المحددة على الفور.
• إنهاء: انقر دائمًا على زر الإنشاء بمجرد ضبط إعدادات نطاقك.

استخراج البيانات (الجانب الأيمن)

يوفر الجانب الأيمن الأدوات اللازمة لموقعك الإلكتروني المقصود:

• حقل النص البرمجي: يحتوي على نص برمجي يمكنك نسخه إلى الحافظة. استخدمه لتضمين المحتوى مباشرةً في صفحة HTML لموقع آخر.
• حقل JSON: يوفر بيانات الأحداث بتنسيق JSON، وهو مثالي للمطورين الذين يرغبون في سحب البيانات الأولية إلى تطبيق ويب مخصص.

يمكنك رؤية عينات من واجهة برمجة التطبيقات المستخدمة أدناه:

---

تلميح احترافي: تأكد من أن مزود الاستضافة الخاص بك لديه نوافذ الأطر المدمجة تم تفعيل هذه الخاصية على موقعك الإلكتروني، حيث يتطلب البرنامج النصي هذه الوظيفة لعرض المحتوى بشكل صحيح.

الإعدادات العامة والتخصيص

يمكنك العثور على خيارات التكوين العامة من خلال الانتقال إلى إعدادات MEC > الإعدادات > Event API.

• تكامل المصدر: يمكنك اختيار تضمين موقع الويب المصدر الخاص بك رأس وتذييل الصفحة في مخرجات الموقع الإلكتروني المستهدف.
• حدود الحدث: تحكم في عدد الأحداث المعروضة في مخرجات الكود المختصر للحفاظ على اتساق التخطيط.

حالات الاستخدام (متى تكون هذه الإضافة مفيدة)

• النشر عبر المنصات المختلفة: مثالي للمؤسسات التي تدير تقويمًا رئيسيًا واحدًا للأحداث ولكنها تحتاج إلى عرض جداول زمنية محددة على مواقع الويب أو النطاقات الفرعية للشركاء.
• تكامل تطبيقات الهاتف المحمول: مثالي للمطورين الذين يستخدمون تنسيق JSON لتغذية تطبيق جوال أصلي ببيانات الأحداث في الوقت الفعلي.
• إدارة مركزية: مفيد للوكالات التي تدير مواقع عملاء متعددة وترغب في تحديث حدث ما مرة واحدة في مركز رئيسي وأن ينعكس ذلك في كل مكان على الفور.

قد لا تكون هذه الإضافة مثالية في بعض الحالات

• قيود الاستضافة: إذا كان مزود خدمة الاستضافة الخاص بك يحظر ذلك بشكل صارم نوافذ الأطر المدمجةلن تنجح طريقة البرمجة النصية القياسية.
• مواقع التحسين المكثف: إذا كان الموقع المستهدف يستخدم إضافات تحسين السرعة العدوانية، فقد تحظر روابط البرامج النصية الخارجية المطلوبة لتحميل واجهة برمجة التطبيقات (API).
• الامتثال الصارم للائحة العامة لحماية البيانات (GDPR): قد تنتقل إضافات الموافقة على ملفات تعريف الارتباط التابعة لجهات خارجية الموجودة على الموقع المصدر أحيانًا إلى الموقع الوجهة، الأمر الذي قد يتطلب تنسيقًا تقنيًا إضافيًا لحله.

استكشاف الأخطاء وإصلاحها للمبتدئين

• لا يتم تحميل الأحداث؟ إذا كنت تستخدم إضافات تحسين الأداء (مثل WP Rocket أو Autoptimize)، فيجب عليك استبعاد "الروابط الخارجية" ضمن تلك الإضافات حتى لا يتم تجاهل نص برمجة واجهة برمجة التطبيقات.
• هل البرنامج النصي لا يعمل؟ تأكد مرة أخرى من أنك قد نقرت على زر الإنشاء بعد إضافة نطاقاتك؛ وإلا، ستظل واجهة برمجة التطبيقات غير نشطة.
• هل توجد مشاكل في التنسيق؟ إذا بدت الشاشة "معطلة" على الموقع الجديد، فحاول تبديل رأس وتذييل الصفحة خيارات في Event API الإعدادات لمعرفة أيها يناسب CSS الوجهة بشكل أفضل.

الأسئلة الشائعة